Types d’activités d’automatisation HAT

 

Date de publication : novembre 2016

S’applique à : Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2013, Dynamics CRM 2015, Dynamics CRM 2016

Il existe plusieurs types d’activités d’automatisation de la Boîte à outils d'applications hébergées (HAT) que vous pouvez utiliser pour automatiser vos applications hébergées. Pour afficher et utiliser les activités d’automatisation HAT, consultez Utiliser les activités d’automatisation HAT.

Contenu de la rubrique

Activités d’action de l’Environnement d’intégration applicative (EIA)

Activités de contexte EIA

Activités DDA

Activités d’action de l’Environnement d’intégration applicative (EIA)

Les activités d’action fournissent des fonctionnalités pour accéder et gérer les Actions UII. Le tableau suivant décrit les différentes activités d’action disponibles.

Activité

Description

DoAction

Exécute une action dans la même application ou dans une autre application hébergée. Cette action possède les propriétés suivantes :

  • ApplicationName : application sur laquelle exécuter DoAction. Obligatoire.

  • ActionData : données requises pour effectuer l’action. Facultatif.

  • ActionName : nom de l’action enregistrée avec l’application hébergée spécifiée dans la propriété ApplicationName. Obligatoire.

GetActionData

Récupère les données de l’action qui a appelé le workflow ou l’automatisation. La valeur sera retournée dans la propriété ActionData.

SetActionData

Ajoute des données à l’action actuelle.

Spécifiez les données requises pour l’action dans le paramètre ActionData.

RegisterActionForEvent

Enregistre une action à effectuer chaque fois qu’un événement se produit. Cette action possède les propriétés suivantes :

  • ActionApplication : nom de l’application avec laquelle l’action UII est enregistrée. Obligatoire.

  • ActionName : nom de l’action pour l’application qui sera exécutée lorsque l’événement est déclenché. Obligatoire.

  • ApplicationName : nom de l’application qui déclenche l’événement. Obligatoire.

  • ControlName : nom du contrôle qui déclenche l’événement. Facultatif.

  • EventName : nom de l’événement déclenché par l’application ou le contrôle.

UnRegisterActionForEvent

Annule l’enregistrement d’une action précédemment enregistrée à l’aide de l’activité RegisterActionForEvent. L’événement non enregistré ne sera plus exécuté. Cette action possède les propriétés suivantes :

  • ActionApplicationName : nom de l’application avec laquelle l’action UII est enregistrée.

  • ActionName : nom de l’action pour l’application qui aurait été exécutée lorsque l’événement a été déclenché.

  • ApplicationName : nom de l’application qui déclenche l’événement.

  • ControlName : nom du contrôle qui déclenche l’événement.

  • EventName : nom de l’événement déclenché par l’application ou le contrôle.

CloseDynamicApp

Ferme une application hébergée dynamique à partir de l’automatisation. Vous pouvez utiliser cette action pour fermer par programme une application hébergée dynamique dans le Unified Service Desk.

Spécifiez le nom de l’application hébergée dynamique dans le paramètre ApplicationName que vous souhaitez fermer.

Pour plus d’informations sur les applications hébergées dynamiques, consultez Applications hébergées UII dynamiques.

StartDynamicApp

Démarre une application hébergée dynamique à partir de l’automatisation.

Spécifiez le nom de l’application hébergée dynamique dans le paramètre ApplicationName que vous souhaitez démarrer.

FocusApp

Définit le focus sur une application à partir de l’automatisation.

Spécifiez le nom de l’application hébergée dans le paramètre ApplicationName sur lequel vous souhaitez définir le focus.

Activités de contexte EIA

Les activités de contexte permettent d’accéder au contexte EIA à partir de l’automatisation. Le tableau suivant décrit les différentes activités de contexte disponibles.

Activité

Description

GetContext

Récupère une valeur pour la clé spécifiée à partir du contexte. La valeur est retournée dans la propriété ContextValue.

Spécifiez la clé du contexte à récupérer dans la propriété ContextKey.

SetContext

Définit la valeur de la clé spécifiée dans le contexte. Cette action possède les propriétés suivantes :

  • ContextKey : clé du contexte à définir.

  • ContextData : entrez éventuellement les données à définir sur le contexte spécifié dans ContextKey.

GetCredential

Récupère les informations d’identification de l’utilisateur à partir du contexte pour l’application spécifiée. Cette action possède les propriétés suivantes :

  • ApplicationName : nom de l’application.

  • UserName : nom d’utilisateur.

  • Password : mot de passe.

Notes

Pour récupérer les informations d’identification à partir d’un magasin personnalisé, le développeur doit fournir une classe qui implémente l’interface ISsoLookupService.

HostApplication

Héberge l’interface utilisateur de l’application. Elle utilise les données de configuration Hébergement d’application spécifiées lors de la configuration du contrôle hébergé dans le Unified Service Desk du serveur Microsoft Dynamics 365 pour déterminer le mode d’hébergement. Pour plus d’informations sur la spécification du mode d’hébergement d’une application dans le Unified Service Desk, consultez Créer et gérer des applications hébergées UII.

Activités DDA

Les activités DDA permettent d’accéder aux contrôles spécifiés dans les liaisons. Le tableau suivant décrit les différentes activités DDA.

Activité

Description

ControlFinder

Recherche un contrôle dans l’application hébergée. L’action retourne True si le contrôle est trouvé dans la propriété ControlFound ; sinon, retourne False. Vous pouvez définir la propriété ExceptionsMask si vous souhaitez utiliser le gestionnaire d’exceptions pour exécuter des activités connexes. Cette action possède les propriétés suivantes :

  • ApplicationName : nom de l’application qui héberge le contrôle. Obligatoire.

  • ControlName : nom du contrôle dans l’application.

  • ExceptionsMask : indique si vous souhaitez afficher une exception si le contrôle est introuvable. Le paramètre par défaut est False.

Notes

Si un workflow que vous avez configuré bloque le thread d’interface utilisateur et que vous avez spécifié les paramètres SleepInterval et Timeout pour l’activité ControlFinder, l’action doit être configurée pour s’exécuter de manière asynchrone.

ExecuteControlAction

Exécute l’action par défaut d’un contrôle. Par exemple, si le contrôle est un bouton, l’action par défaut est un clic. Cette action possède les propriétés suivantes :

  • ApplicationName : nom de l’application qui héberge le contrôle.

  • ControlName : nom du contrôle dans l’application.

GetControlValue

Récupère la valeur d’un contrôle dans l’application. La valeur est retournée dans la propriété ControlValue. Cette action possède les propriétés suivantes :

  • ApplicationName : nom de l’application qui héberge le contrôle.

  • ControlName : nom du contrôle dans l’application dont la valeur doit être récupérée.

Notes

Lorsque vous utilisez l’activité GetControlValue avec un contrôle de texte multiligne, tous les caractères de nouvelle ligne sont ignorés et une chaîne unique est retournée.

SetControlValue

Définit la valeur d’un contrôle dans l’application. Cette action possède les propriétés suivantes :

  • ApplicationName : nom de l’application qui héberge le contrôle.

  • ControlName : nom du contrôle dans l’application dont la valeur doit être définie.

  • ControlValue : entrez la valeur à définir.

Notes

Lorsque vous utilisez l’activité SetControlValue avec un contrôle de texte multiligne, tous les caractères de nouvelle ligne sont ignorés et une chaîne unique est retournée.

Navigate

Spécifie une URL à laquelle une application Web accède. Par exemple, vous pouvez utiliser l’activité Navigate pour forcer une application Web à accéder à une URL spécifique lorsqu’un utilisateur effectue une tâche. Cette action possède les propriétés suivantes :

  • ApplicationName : nom de l’application qui héberge le contrôle.

  • URL : spécifiez l’URL avec la chaîne de requête.

Notes

  • L’activité Navigate ne doit pas être appelée simultanément sur le navigateur Web. Si tel est le cas, vous recevrez les erreurs suivantes :

    AutomationAdapter (app=Contact,action=__SetControlValue__) : exception de l'action implicite publiée :  Microsoft.Uii.HostedApplicationToolkit.DataDrivenAdapter.DataDrivenAdapterException : DDA0301 : le navigateur Web est occupé et ne peut pas être arrêté. Exception WF/Automatisation <GUID>: Microsoft.Uii.HostedApplicationToolkit.DataDrivenAdapter.DataDrivenAdapterException: DDA0301 : le navigateur Web est occupé et ne peut pas être arrêté.

  • Pour que l’activité Navigate fonctionne sur l’application cible, vous devez configurer l’application hébergée dans le Unified Service Desk pour utiliser l’Adaptateur d’automatisation (HAT), et fournir la liaison suivante dans le champ XML d’automatisation :

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

    Pour plus d’informations sur la configuration des contrôles hébergés dans le Unified Service Desk, consultez Créer et gérer des applications hébergées UII.

Audit

Crée des entrées d’audit à partir de l’automatisation. Cette action possède les propriétés suivantes :

  • Audit Flag : nom de l’indicateur d’audit.

  • Log data : valeur de l’indicateur d’audit.

Pour plus d’informations sur les différents indicateurs d’audit du Unified Service Desk, consultez Configurer l’audit dans le Centre de services unifié dans le Guide d’administration du Unified Service Desk.

ConfigReader

Lit une valeur de configuration à partir de l’automatisation. Cette activité lit la configuration à partir des paramètres Option du Unified Service Desk ou du fichier de configuration de l’application. Cette action possède les propriétés suivantes :

  • OptionKey en tant que chaîne : utilisée pour lire le paramètre Option à partir du Unified Service Desk. Pour plus d'informations sur les diverses options, voir TechNet : Gérer les options de Unified Service Desk.

  • XPath en tant que chaîne : utilisée pour lire le fichier de configuration de l’application.

  • QueryResult en tant que chaîne : résultats de la recherche.

InitstringReader

Vous permet de lire le contenu InitString à partir de l’automatisation. Cette action possède les propriétés suivantes :

  • XPath en tant que chaîne : utilisée pour lire le fichier de configuration de l’application.

  • QueryResult en tant que chaîne : résultats de la recherche.

Voir aussi

Créer une automatisation HAT
Environnement d’intégration applicative UII
Utiliser des adaptateurs DDA

Unified Service Desk 2.0

© 2017 Microsoft. Tous droits réservés. Copyright

  • Last updated on