Condividi tramite

Tipi di attività di automazione HAT

 

Data di pubblicazione: novembre 2016

Si applica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2013, Dynamics CRM 2015, Dynamics CRM 2016

Sono disponibili vari tipi di attività di automazione del Toolkit dell'applicazione ospitata (HAT, Hosted Application Toolkit) che consentono di automatizzare le applicazioni ospitate. Per visualizzare e utilizzare le attività di automazione HAT, vedere Utilizzare le attività di automazione HAT.

In questo argomento

Attività di azione del framework di integrazione applicazioni (AIF, Application Integration Framework)

Attività di contesto AIF

Attività DDA

Attività di azione del framework di integrazione applicazioni (AIF, Application Integration Framework)

Le attività di azione forniscono la funzionalità per l'accesso e la gestione delle Azioni di UII. Nella tabella seguente sono descritte le varie attività di azione disponibili.

Impegno

Descrizione

DoAction

Esegue un'azione nella stessa applicazione o in un'altra applicazione ospitata. Questa azione ha le proprietà seguenti:

  • ApplicationName: l'applicazione in cui eseguire DoAction. Obbligatorio.

  • ActionData: dati necessari per eseguire l'azione. (Facoltativo).

  • ActionName: nome dell'azione che viene registrato con l'applicazione ospitata specificata nella proprietà ApplicationName. Obbligatorio.

GetActionData

Recupera i dati dall'azione che ha richiamato il flusso di lavoro o l'automazione. Il valore verrà restituito nella proprietà ActionData.

SetActionData

Aggiunge i dati all'azione corrente.

Specificare i dati necessari per l'azione nel parametro ActionData.

RegisterActionForEvent

Registra un'azione da avviare quando si verifica un evento. Questa azione ha le proprietà seguenti:

  • ActionApplication: nome dell'applicazione con cui è registrata l'azione UII. Obbligatorio.

  • ActionName: nome dell'azione per l'applicazione che verrà eseguita all'avvio dell'evento. Obbligatorio.

  • ApplicationName: nome dell'applicazione che avvia l'evento. Obbligatorio.

  • ControlName: nome del controllo che avvia l'evento. (Facoltativo).

  • EventName: nome dell'evento avviato dall'applicazione o dal controllo.

UnRegisterActionForEvent

Annulla la registrazione di un'azione che è stata registrata in precedenza utilizzando l'attività RegisterActionForEvent. L'evento per cui viene annullata la registrazione non verrà più eseguito. Questa azione ha le proprietà seguenti:

  • ActionApplicationName: nome dell'applicazione con cui è registrata l'azione UII.

  • ActionName: nome dell'azione per l'applicazione che sarebbe stata eseguita all'avvio dell'evento.

  • ApplicationName: nome dell'applicazione che avvia l'evento.

  • ControlName: nome del controllo che avvia l'evento.

  • EventName: nome dell'evento avviato dall'applicazione o dal controllo.

CloseDynamicApp

Chiude un'applicazione dinamica ospitata direttamente dall'automazione. È possibile utilizzare questa azione per chiudere a livello di programmazione un'applicazione dinamica ospitata in Unified Service Desk.

Specificare il nome dell'applicazione dinamica ospitata nel parametro ApplicationName che si desidera chiudere.

Per ulteriori informazioni sulle applicazioni dinamiche ospitate, vedere Applicazioni ospitate UII dinamiche.

StartDynamicApp

Avvia un'applicazione dinamica ospitata direttamente dall'automazione.

Specificare il nome dell'applicazione dinamica ospitata nel parametro ApplicationName che si desidera avviare.

FocusApp

Imposta lo stato attivo di un'applicazione direttamente dall'automazione.

Specificare il nome dell'applicazione dinamica ospitata nel parametro ApplicationName di cui si desidera impostare lo stato attivo.

Attività di contesto AIF

Le attività di contesto consentono di accedere al contesto AIF direttamente dall'automazione. Nella tabella seguente sono descritte le varie attività di contesto disponibili.

Impegno

Descrizione

GetContext

Recupera un valore per la chiave specificata dal contesto. Il valore viene restituito nella proprietà ContextValue.

Specificare la chiave del contesto da recuperare nella proprietà ContextKey.

SetContext

Imposta il valore per la chiave specificata nel contesto. Questa azione ha le proprietà seguenti:

  • ContextKey: chiave del contesto da impostare.

  • ContextData: facoltativamente, immettere i dati da impostare nel contesto specificato in ContextKey.

GetCredential

Recupera le credenziali utente dal contesto per l'applicazione specificata. Questa azione ha le proprietà seguenti:

  • ApplicationName: nome dell'applicazione.

  • UserName: nome dell'utente.

  • Password: password.

Nota

Per recuperare le credenziali da un archivio personalizzato, lo sviluppatore deve fornire una classe che implementi l'interfaccia ISsoLookupService.

HostApplication

Ospita l'interfaccia utente dell'applicazione. Utilizza i dati di configurazione di Hosting applicazione specificati durante la configurazione del controllo ospitato in Unified Service Desk nel server Microsoft Dynamics 365 per determinare la modalità di hosting. Per ulteriori informazioni sulla specifica della modalità di hosting per un'applicazione in Unified Service Desk, vedere Creare e gestire le applicazioni ospitate UII.

Attività DDA

Le attività dell'adapter guidato dai dati (DDA, Data-Driven Adapter) forniscono l'accesso ai controlli specificati nei binding. Nella tabella seguente sono descritte le diverse attività DDA.

Impegno

Descrizione

ControlFinder

Individua un controllo nell'applicazione ospitata. L'azione restituisce True se il controllo è disponibile nella proprietà ControlFound; in caso contrario, restituisce False. È possibile impostare la proprietà ExceptionsMask se si desidera utilizzare il gestore eccezioni per eseguire attività di dipendenza. Questa azione ha le proprietà seguenti:

  • ApplicationName: nome dell'applicazione che ospita il controllo. Obbligatorio.

  • ControlName: nome del controllo presente nell'applicazione.

  • ExceptionsMask: indica se si desidera visualizzare un'eccezione quando il controllo non è disponibile. L'impostazione predefinita è False.

Nota

Se un flusso di lavoro configurato sta bloccando il thread UI e sono stati specificati i parametri SleepInterval e Timeout per l'attività ControlFinder, l'azione deve essere configurata per essere eseguita in modalità asincrona.

ExecuteControlAction

Esegue l'azione predefinita di un controllo. Ad esempio, se il controllo è un pulsante, l'azione predefinita è il clic. Questa azione ha le proprietà seguenti:

  • ApplicationName: nome dell'applicazione che ospita il controllo.

  • ControlName: nome del controllo presente nell'applicazione.

GetControlValue

Recupera un valore da un controllo presente nell'applicazione. Il valore viene restituito nella proprietà ControlValue. Questa azione ha le proprietà seguenti:

  • ApplicationName: nome dell'applicazione che ospita il controllo.

  • ControlName: nome del controllo presente nell'applicazione il cui valore deve essere recuperato.

Nota

Quando si utilizza l'attività GetControlValue con un controllo di testo su più righe, tutti i caratteri di nuova riga vengono ignorati e viene restituita un'unica stringa.

SetControlValue

Imposta il valore di un controllo presente nell'applicazione. Questa azione ha le proprietà seguenti:

  • ApplicationName: nome dell'applicazione che ospita il controllo.

  • ControlName: nome del controllo presente nell'applicazione il cui valore deve essere impostato.

  • ControlValue: immettere il valore da impostare.

Nota

Quando si utilizza l'attività SetControlValue con un controllo di testo su più righe, tutti i caratteri di nuova riga vengono ignorati e viene restituita un'unica stringa.

Navigate

Specifica l'URL di una pagina che viene esplorata da un'applicazione Web. Ad esempio, è possibile utilizzare l'attività Navigate per forzare un'applicazione Web a passare a un URL specifico quando un utente esegue un'attività. Questa azione ha le proprietà seguenti:

  • ApplicationName: nome dell'applicazione che ospita il controllo.

  • URL: specificare l'URL insieme alla stringa di query.

Nota

  • L'attività Navigate non deve essere chiamata contemporaneamente nel Web browser. Nel caso accadesse, vengono visualizzati i seguenti errori:

    AutomationAdapter (app=Contact,action=__SetControlValue__): Pubblicata eccezione di azione implicita:  Microsoft.Uii.HostedApplicationToolkit.DataDrivenAdapter.DataDrivenAdapterException: DDA0301: Il browser Web è occupato e non può essere arrestato.Eccezione WF/Automation <GUID>: Microsoft.Uii.HostedApplicationToolkit.DataDrivenAdapter.DataDrivenAdapterException: DDA0301: Il browser Web è occupato e non può essere arrestato.

  • Per utilizzare l'attività Navigate con l'applicazione di destinazione, è necessario configurare l'applicazione ospitata in Unified Service Desk per utilizzare l'adapter di automazione (HAT) e fornire i seguenti binding nel campo XML automazione:

    <DataDrivenAdapterBindingsCollection>    <DataDrivenAdapterBindings>       <Type>Microsoft.Uii.HostedApplicationToolkit.DataDrivenAdapter.WebDataDrivenAdapter, Microsoft.Uii.HostedApplicationToolkit.DataDrivenAdapter</Type>       <Controls/>    </DataDrivenAdapterBindings> </DataDrivenAdapterBindingsCollection>

    Per ulteriori informazioni sulla configurazione dei controlli ospitati in Unified Service Desk, vedere Creare e gestire le applicazioni ospitate UII.

Audit

Crea le voci di controllo direttamente dall'automazione. Questa azione ha le proprietà seguenti:

  • Audit Flag: nome del flag di controllo.

  • Log data: valore del flag di controllo.

Per informazioni sui vari flag di controllo di Unified Service Desk, vedere Configurare il controllo in Unified Service Desk nella Guida all'amministrazione di Unified Service Desk.

ConfigReader

Legge un valore di configurazione direttamente dall'automazione. L'attività legge la configurazione dalle impostazioni di Opzione in Unified Service Desk o dal file di configurazione dell'applicazione. Questa azione ha le proprietà seguenti:

  • OptionKey come stringa: utilizzato per leggere l'impostazione di Opzione da Unified Service Desk. Per ulteriori informazioni sulle diverse opzioni, vedi TechNet: Gestire le opzioni per Unified Service Desk.

  • XPath come stringa: utilizzato per leggere il file di configurazione dell'applicazione.

  • QueryResult come stringa: risultato della ricerca.

InitstringReader

Consente di leggere il contenuto di InitString direttamente dall'automazione. Questa azione ha le proprietà seguenti:

  • XPath come stringa: utilizzato per leggere il file di configurazione dell'applicazione.

  • QueryResult come stringa: risultato della ricerca.

Vedere anche

Creare l'automazione HAT
Application Integration Framework UII
Utilizzare adapter guidati dai dati (DDA)

Unified Service Desk 2.0

© 2017 Microsoft. Tutti i diritti sono riservati. Copyright

  • Last updated on