Créer une 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

Vous pouvez utiliser les types d’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 d’User Interface Integration (UII) pour mettre les contrôles d’une application à disposition d’une 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).Pour plus d'informations :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.

Contenu de la rubrique

Créer une automatisation HAT

Configurer une action pour exécuter l’automatisation

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

Afficher les exemples d’automatisation

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.Pour plus d'informations :Utiliser 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.Pour plus d'informations :Utiliser 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, consultez 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).

      

      Notes

      Comme le chemin d’accès absolu à l’assembly de workflow n’est pas indiqué dans le champ Type, vous devez copier le fichier d’assembly 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 du 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 du 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 sur le Unified Service Desk du serveur Microsoft Dynamics 365.Pour plus d'informations :Déployer l’application hébergée dans le Centre de services unifié

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 le Centre de services unifié dans le Guide d’administration du Unified Service Desk.

[Tip]

Pour déboguer l’automatisation, démarrez Visual Studio en tant qu’administrateur, ouvrez votre projet d’application HAT et définissez le fichier exécutable du client Unified Service Desk (UnifiedServiceDesk.exe) en tant que programme de démarrage externe dans les propriétés du projet. En outre, définissez le chemin de sortie de la génération du projet sur le répertoire d’installation du client Unified Service Desk. Chaque fois que vous déboguez le projet, les assemblys seront copiés dans le répertoire d’installation du client Unified Service Desk, et le client démarrera.

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 Microsoft 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 de [projet] > 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 HAT
Types d’activités d’automatisation HAT
Configurer une action pour l’application hébergée

Unified Service Desk 2.0

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