Guide de l’utilisateur de Studio

Dernière mise à jour 17 déc. 2024

Vue d'ensemble (Overview)

Les automatisations Attended basées sur des déclencheurs peuvent impliquer les éléments suivants :

Formulaires : créés à l’aide du générateur de formulaires et gérés via le package Form.Activities.
Légendes : créées à l’aide du générateur de formulaires et gérés via le package Callout.Activities.
Déclencheurs : en utilisant les packages System.Activities et UIAutomation.Activities.
Variables globales : créées à partir du gestionnaire de données.

Les formulaires et les légendes constituent une fonctionnalité essentielle de l’automatisation Attended. Leur exécution à l'aide de déclencheurs vous permet de créer des scénarios complexes. Ces scénarios impliquent que plusieurs événements se produisent en même temps. Par ailleurs, la possibilité de déclencher des actions en fonction des valeurs de variables globales vous permet de couvrir encore plus de scénarios Attended.

Le diagramme ci-dessous est relatif à un processus construit à l'aide de formulaires, de déclencheurs d'événement de formulaire et de déclencheurs d'événement d'application. Vous pouvez également créer des processus similaires qui seront basés sur des déclencheurs d'événements utilisateur et des légendes.

Prérequis

Afin de pouvoir concevoir et exécuter des automatisations Attended basées sur des déclencheurs :

Installez les packages d'activités suivants :
- Form.Activities version 23.4
- System.Activities 23.4
- UIAutomation.Activities 23.4
- Callout.Activities 23.4
Si vous rencontrez l'erreur suivante en essayant de créer un fichier Form : Impossible de trouver une installation Webview2 Runtime compatible pour héberger des WebViews, installez Microsoft Edge WebView2.

Formulaires

Dans les automatisations Attended, les formulaires servent à collecter et à traiter les entrées des utilisateurs ou des applications. Avec les fonctionnalités de formulaire actuelles, vous pouvez :

Créez des formulaires en dehors des activités à l'aide d'un formulaire (fichier uiform) à l'intérieur de votre projet. Vous pouvez les créer ou les modifier ultérieurement indépendamment de toute activité utilisant les formulaires. Cela vous permet de séparer le processus de création de formulaires et d'utiliser ceux-ci dans la même automatisation.
Créez des formulaires en utilisant des fichiers HTML personnalisés. Vous pouvez travailler avec des formulaires HTML de la même manière qu'avec des fichiers uiform.
Affichez plusieurs formulaires en même temps à l'aide de l'activité Afficher le formulaire. Ajoutez plusieurs activités Afficher le formulaire et saisissez un nom unique dans le champ Nom de l'instance pour chacune d'entre elles. La propriété Nom de l'instance est disponible pour la plupart des activités du package Form.Activities et peut être utilisée pour :
- Affichez ou effectuez des actions sur plusieurs instances d'un même formulaire en fournissant des noms d'instance uniques pour chaque formulaire affiché.
- Affichez ou effectuez des Actions sur toutes les instances, en laissant vide le champ Nom de l'instance.
Définissez un déclencheur à démarrer en fonction d'événements de formulaire. Il peut s'agir de la fermeture du formulaire ou de la modification d'un élément du formulaire. Pour cela, vous pouvez utiliser l'activité Déclencheur d'événement de formulaire.
Choisissez d'afficher uniquement un formulaire ou de l'afficher lors de l'exécution du reste du workflow. Vous pouvez faire cela en activant ou en désactivant la propriété Continuer l'exécution du workflow.
Modifiez et récupérez les valeurs du formulaire lors de l'exécution à l'aide des activités Définir les valeurs du formulaire et Obtenir les valeurs du formulaire.
Modifiez les propriétés du formulaire lors de l'exécution en utilisant l'activité Modifier les propriétés du formulaire.
Injecter du code JavaScript personnalisé dans le formulaire à l'aide de l'activité Exécuter le script de formulaire.

Légendes

Dans une automatisation Attended, les légendes servent à diriger l’utilisateur vers un élément d'IU spécifique dans une application, un site Web, un produit, et même un formulaire. Vous pouvez également utiliser des légendes pour créer des validations personnalisées pour les applications, préremplir des champs et déclencher plusieurs automatisations en fonction des entrées utilisateur.

Grâce aux fonctionnalités de légende, vous pouvez :

Créez une légende en utilisant un fichier formulaire (uiform) et configurez-la à l' aide du générateur de formulaires.
Indiquez l’élément d'IU à côté de l’endroit où vous souhaitez que la légende s’affiche, en utilisant l’activité Afficher la légende.
Transmettre des valeurs aux éléments situés à l'intérieur d'une légende.

Remarque : une légende est un formulaire lié à un élément d'IU et affiché à côté de celui-ci, à l'aide de l'activité Afficher la légende.

Bien qu'il existe un package Callout.Activities dédié aux légendes, il est également possible de gérer les légendes à l'aide du package Form.Activities, car les légendes sont des fichiers uiform tout comme les formulaires standard. Cela signifie que si vous utilisez le package Form.Activities, vous pouvez travailler avec des légendes de même qu'avec un formulaire normal.

Déclencheurs (Triggers)

Dans les automatisations Attended, les déclencheurs servent à effectuer les choses suivantes :

Pour démarrer des workflows en fonction d'événements d'application ou d'utilisateur. De plus, vous pouvez définir via le mode de planification comment exécuter les actions lorsqu'un déclencheur est exécuté :

Séquentiel (Sequential) : les actions sont exécutées les unes après les autres.
Simultané (Concurrent) : l'exécution des actions peut se chevaucher.
Unique (OneTime) : exécute une action et quitte la surveillance.
Réduction séquentielle (Sequential Collapse) : ignore tous les événements à venir, sauf le plus récent, jusqu’à ce que l’exécution de l’événement actuel soit terminée.
Arrêt séquentiel (Sequential Drop) : arrête l’exécution de l’événement précédent et démarre l’événement suivant.

Pour déclencher des workflows en fonction d'événements d'application ou d'utilisateur, utilisez les activités suivantes :

Activité	Description
Déclencheur d'événement de formulaire	Déclenche des workflows en fonction d'un événement qui se produit dans un formulaire.
Application event trigger	Configure un déclencheur basé sur un événement natif de n'importe quel type d'élément (fenêtre de niveau supérieur ou tout autre élément d'IU indiqué).
Répéter le déclencheur	Cette activité vous permet de configurer une Période en tant que InArgument. À l'expiration de cette période, le déclencheur s'exécute et peut être répété en fonction des paramètres.
Keypress Event Trigger	Permet de configurer un déclencheur d'événement de touche enfoncée sur l'élément d'IU indiqué.
Click Event Trigger	Configurer un déclencheur d'événement de clic sur l'élément d'IU indiqué.
Déclencheur de raccourci (Hotkey Trigger)	Surveille un événement de touche spécifié au niveau du système.
Déclencheur de souris (Mouse Trigger)*	Surveille un événement de combinaison souris-clavier spécifié au niveau du système.
Déclencheur de clic image (Click Image Trigger)*	Surveille l’objet Image défini par l’élément d’IU cible pour la saisie à la souris.
Déclencheur système (System Trigger)*	Surveille un événement de touche et/ou de souris spécifié au niveau du système.
SAP Session Attributes Changed Trigger*	Surveille les modifications apportées aux attributs de session SAP spécifiés.

* Peut être utilisé à la fois seul et dans une activité Étendue du déclencheur.

Pour automatiser plusieurs scénarios Attended qui peuvent se produire une fois ou de façon séquentielle, ou bien simultanément. Pour cela, vous pouvez utiliser les activités suivantes :

Activité	Description
Exécuter les déclencheurs locaux	Initialise et démarre tous les déclencheurs locaux qui écoutent les événements sur la machine de l'utilisateur.
Arrêter les déclencheurs locaux	Termine l'exécution des déclencheurs locaux. Lorsqu'elle est exécutée, elle annule toutes les actions en cours, y compris les workflows déclenchés par des événements. Lorsque l'option Arrêter les déclencheurs locaux (Stop Local Triggers) s'exécute, les workflows déclenchés par événements en cours sont annulés, mais les activités du workflow principal continuent comme d'habitude.
Désactiver le déclencheur local	Désactive un ou plusieurs déclencheurs locaux actifs qui avaient été démarrés avec l'activité Exécuter les déclencheurs locaux.
Activer le déclencheur local	Active un ou plusieurs déclencheurs locaux actifs qui avaient été démarrés avec l'activité Exécuter les déclencheurs locaux.

Afin de démarrer des workflows basés sur le comportement des variables globales, que vous créez dans le gestionnaire de données. Pour cela, vous pouvez utiliser les activités suivantes :

Activité	Description
Déclencheur de modification de variable globale	Envoie une notification à tous les abonnés lorsque la valeur d'une variable globale change.
Notifier la modification de la variable globale	Déclencheur qui démarre lorsque la valeur d'une variable globale change.

Exécuter les déclencheurs locaux

L'activité Exécuter les déclencheurs locaux (Run Local Triggers) permet de déclencher plusieurs événements simultanément. Dans le backend, il génère un workflow distinct en lecture seule appelé Triggereventargs au moment du runtime ou lors du débogage. Ce workflow contient plusieurs activités de Étendue du déclencheur (Trigger scope) qui exécutent tous les déclencheurs en parallèle dans votre projet.

Lorsque vous exécutez le projet pour la première fois, chaque déclencheur de workflow capture le workflow Triggereventargs en tant qu'argument dans le panneau Arguments. Chaque déclencheur de workflow a son propre argument Triggereventargs, qui contient des informations le concernant. Au fur et à mesure que vous exécutez le projet, les arguments Triggereventargs sont mis à jour avec les dernières informations d'exécution.

L'argument Triggereventargs fournit principalement les informations suivantes spécifiques à chaque workflow de déclencheur :

Type de déclencheur
Nom du déclencheur
Élément cible qui a activé le déclencheur
Composants de formulaire (dans le cas d'une Activité Déclencheur de formulaire (Form Trigger))
Nom de l'instance de formulaire (dans le cas d'une Activité Déclencheur de formulaire (Form Trigger))

Pour accéder aux informations de l'argument Triggereventargs, vous pouvez appliquer différentes méthodes en fonction du type de déclencheur. Pour les déclencheurs d'événement utilisateur, les méthodes suivantes sont disponibles :

ÉlémentCible (TargetElement) : récupère des informations sur l'élément cible surveillé
1. Attributs (Attributes) : permet d'obtenir les attributs de l'élément cible surveillé
2. AfficherFacteurÉchelleDPI (DisplayDpiScaleFactor) : détermine la taille de l’élément cible en pixels
3. ImageBase64 : convertit l'image de l'élément cible en image Base64
4. Sélecteur (Selector) : récupère les informations sur le sélecteur utilisé sur l'élément cible
Type de déclencheur

Pour les déclencheurs de formulaire, vous pouvez utiliser les méthodes suivantes :

IDSourceFormulaire (FormSourceId) : permet d'accéder à l'ID du formulaire où le déclencheur s'est activé
Nom d'instance (Instance Name) : permet de récupérer le nom de l'instance du formulaire où le déclencheur s'est activé

Comportement du déclencheur

Les workflows de déclencheur sont des workflows démarrés par un déclencheur. Ceux-ci peuvent être débogués soit dans le contexte du projet dans son ensemble, soit indépendamment.
Si vous pensez qu'un nombre élevé de déclencheurs aura un impact sur vos performances, vous pouvez activer ou désactiver certains déclencheurs à l'aide des activités Activer le déclencheur local et Désactiver le déclencheur local.
Les activités Activer le déclencheur local (Enable Local Trigger) et Désactiver le déclencheur local (Disable Local Trigger) sont utiles dans les scénarios où plusieurs workflows surveillent les événements utilisateur qui sont déterminés par la phase de l'automatisation que l'utilisateur a atteinte.
- Par exemple, vous pouvez utiliser l'activité Activer le déclencheur local (Enable Local Trigger) pour activer un déclencheur après que l'utilisateur a saisi son nom d'utilisateur dans un formulaire.
- D'autre part, l'activité Désactiver le déclencheur local (Disable Local Trigger) peut être utilisée pour désactiver un déclencheur qui était planifié pour s'exécuter de manière séquentielle une fois que l'utilisateur a atteint une étape spécifique lors d'une visite guidée du produit, par exemple.

Variables globales

Dans les automatisations Attended, les variables globales servent à enregistrer des informations sur les événements de l'utilisateur ou de l'application, puis de les stocker dans une variable que vous pouvez utiliser ultérieurement en tant qu'entrée ou en tant que déclencheur pour d'autres activités. Cela vous permet de partager facilement des données entre plusieurs workflows. Grâce aux fonctionnalités des variables globales, vous pouvez :

Avertir lorsque la valeur d'une variable globale change, via l'activité Notifier la modification de la variable globale
Déclenchez un workflow ou une activité lorsque la valeur d'une variable globale change, via l'activité Déclencheur de modification de variable globale .

Sommaire de la page