Créer une automatisation HAT dans Unified Service Desk

Vous pouvez utiliser les activités d’automatisation de la Boîte à outils d’applications hébergées (HAT) pour créer des automatisations pour votre projet d’application hébergée. Vous pouvez utiliser l’inspecteur User Interface Integration (UII) pour effectuer les contrôles une application mis à disposition dans l’automatisation. Bien qu’une automatisation soit démarrée par une action définie sur une application, elle peut accéder aux contrôles définis dans toutes les applications qui s’exécutent dans la session. Les automatisations peuvent également interagir avec les applications activées pour la non-automatisation via des activités telles que des activités de contexte DoAction ou Apppplication Integration Framework (AIF). Plus d’information: Types d’activités d’automatisation HAT

Avant d’ajouter une automatisation à votre application, assurez-vous d’inspecter tous les contrôles requis dans votre application. Pour ce faire, voir Utiliser l’Inspecteur UII pour créer des liaisons pour l’application hébergée.

Créer une automatisation HAT

1. Ouvrez le projet d’application que vous avez créé précédemment à l’aide de HAT dans lequel vous souhaitez ajouter des automatisations. Plus d’informations : tiliser la fabrique logicielle HAT pour créer une application hébergée. Vous pouvez aussi créer un workflow dans un projet distinct, puis l’ajouter à votre application hébergée existante créée à l’aide de HAT.

2. Dans l’Explorateur de solutions, cliquez avec le bouton droit sur le nom du projet, puis sélectionnez Ajouter>Nouvel élément.

3. Dans la boîte de dialogue Ajouter un nouvel élément, sélectionnez Visual C#>Workflow dans le volet gauche, sélectionnez Activité comme type de projet, entrez un nom approprié, puis cliquez sur Ajouter.

   

4. Cela ajoute le workflow d’activité (XAML) dans votre projet, et ouvre le XAML dans la zone du concepteur d’activité de workflow où vous pouvez insérer les activités d’automatisation HAT ainsi que d’autres activités pour créer votre automatisation.

   

5. Créez votre automatisation à l’aide des activités HAT, enregistrez votre projet, puis générez-le.

   L’étape suivante consiste à configurer une action pour l’application HAT que vous avez créée précédemment, puis à l’associer à l’automatisation que vous venez de créer.

Configurer une action pour exécuter l’automatisation

Dans cette section, nous allons configurer une action sur l’application pour l’associer à l’automatisation que nous avons créée dans la section précédente.

1. Ouvrez le projet d’application HAT dans Visual Studio, s’il n’est pas déjà ouvert. Plus d’informations : tiliser la fabrique logicielle HAT pour créer une application hébergée.

2. Dans l’Explorateur de solutions, cliquez avec le bouton droit sur le nom du projet d’application HAT, puis sélectionnez Configuration de l’action.

3. Dans la boîte de dialogue Configuration de l’action, indiquez le nom de l’action et d’autres informations, si nécessaire. Pour plus d’informations sur ces champs, voir Configurer une action pour l’application hébergée.

4. Sous Automatisation, dans la liste Mode, sélectionnez Utiliser l’assembly de workflow ou Utiliser XAML de workflow pour associer une automatisation à l’action.

   

5. Cliquez sur Sélectionner le workflow pour spécifier l’automatisation.

6. Dans la boîte de dialogue Sélecteur de workflow, développez le nom de votre projet, puis sélectionnez le workflow (.xaml) à associer à l’action, puis cliquez sur OK.

   

7. Si vous avez sélectionné :

   1. Utilisez l’assembly de workflow à l’étape 4, les informations de type apparaissent dans le champ Type pour l’automatisation sélectionnée (workflow).

   

   Note

   Comme le chemin absolu vers l’assembly de workflow n’est pas mentionné dans le champ Type, vous devez copier le fichier d’assemblage de workflow dans le répertoire d’installation du client Unified Service Desk pour tester et utiliser l’application hébergée et l’automatisation.

   2. Utiliser XAML de workflow à l’étape 4, le workflow XAML s’affiche dans le champ XAML pour l’automatisation sélectionnée (workflow).

   

8. Si vous souhaitez exécuter l’automatisation en mode asynchrone, activez la case à cocher Async. L’automatisation peut être exécutée de manière synchrone ou asynchrone.

   • En mode synchrone, l’automatisation s’exécute dans le thread d’interface utilisateur de Unified Service Desk, et bloque l’interface utilisateur jusqu’à ce que l’exécution soit terminée. Le blocage de l’interface utilisateur peut être utile, car il permet de mettre à jour l’état de l’interface utilisateur de l’application indépendamment. Pour éviter que l’interface utilisateur ne réponde pas, définissez des délais d’exécution de l’automatisation les plus courts possibles.

   • En mode asynchrone, l’automatisation ne s’exécute pas dans le thread d’interface utilisateur de Unified Service Desk tant qu’il n’est pas nécessaire qu’elle interagisse avec l’interface utilisateur.

9. Sélectionnez Enregistrer pour créer l’action permettant de déclencher l’automatisation.

10. Enregistrez le projet, puis générez-le (Générer>Générer la solution).

Vérifier le contrôle hébergé HAT avec l’automatisation

1. Déployez l’application HAT vers Unified Service Desk sur le serveur Microsoft Dataverse. Plus d’informations : Déployer l’application hébergée dans Unified Service Desk

2. Copiez les fichiers requis (assemblys du workflow et de l’application HAT) dans le répertoire de l’application cliente Unified Service Desk (généralement C:\Program Files\Microsoft Dynamics CRM USD\USD).

3. Exécutez le client Unified Service Desk et utilisez le débogueur pour tester votre application hébergée HAT et l’action à l’aide de l’automatisation. Dans l’onglet Débogueur, cliquez sur la flèche vers le bas au-dessus de l’onglet Appels à l’action pour afficher la zone où vous pouvez tester les appels à l’action et les actions d’User Interface Integration (UII).

4. Cliquez sur l’onglet Action directe :

   1. Sélectionnez le contrôle hébergé et l’action que vous souhaitez vérifier.

   2. Cliquez sur l’icône d’exécution pour la tester.

   

   Pour plus d’informations sur l’utilisation du contrôle hébergé Débogueur, consultez Problèmes de débogage dans Unified Service Desk dans le Guide d’administration d’Unified Service Desk.

Afficher les exemples d’automatisation

1. Téléchargez le Kit de développement logiciel (SDK) d’UII et extrayez-le.

2. Dans le dossier <ExtractedFolder>\UII\SampleCode\UII\Hat\QsAutomationProject, ouvrez le fichier Microsoft.Uii.QuickStarts.QsAutomationProject.csproj dans Visual Studio.

3. Corrigez les références d’assembly manquantes dans le projet en définissant le chemin de référence de votre projet (Projet>Propriétés [Project>]Chemins d’accès des références) sur le dossier <ExtractedFolder>\UII\Bin\UII ou sur le répertoire de l’application cliente Unified Service Desk (généralement C:\Program Files\Microsoft Dynamics CRM USD\USD).

4. Générez le projet (Générer>Générer la solution) pour afficher les exemples d’automatisation (XAML). Une fois que le projet a été correctement généré, double-cliquez sur un fichier XAML de l’Explorateur de solutions pour afficher la définition d’automatisation.

Voir aussi

Utiliser les activités d’automatisation HATTypes d’activités d’automatisation HATConfigurer une action pour l’application hébergée