Partager via

Types d’activités d’automatisation HAT dans Unified Service Desk

  • Article

Il existe plusieurs types d’activités d’automatisation de HAT que vous pouvez utiliser pour automatiser vos applications hébergées. Pour afficher et utiliser les activités d’automatisation HAT, voir Utiliser les activités d’automatisation HAT.

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. Voici les différentes activités d’action disponibles.

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, voir 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. Voici les différentes activités de contexte disponibles.

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 de l’utilisateur.

  • Password : Mot de passe.

Note

Pour récupérer les informations d’identification d’une banque personnalisée, le développeur doit fournir une classe qui implémente l’interface Microsoft.Uii.AifServices.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 de plateforme Microsoft Dataverse 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, voir 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. Voici les différentes activités DDA.

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 et le diagnostic dans Unified Service Desk.

    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.

Note

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.

Note

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.

Note

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.

Note

  • 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__): Posted implicit action exception:  Microsoft.Uii.HostedApplicationToolkit.DataDrivenAdapter.DataDrivenAdapterException: DDA0301: Web browser is busy and cannot be stopped.   

WF/Automation <GUID> exception: Microsoft.Uii.HostedApplicationToolkit.DataDrivenAdapter.DataDrivenAdapterException: DDA0301: Web browser is busy and cannot be stopped.
    • 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 Unified Service Desk, voir Créer et gérer des applications hébergées UII.

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 depuis Unified Service Desk. Pour plus d’informations sur les diverses options, voir 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