Créer et afficher une légende simple

Ce didacticiel montre comment créer et afficher une légende pendant 10 secondes, chaque fois qu'un certain élément d'IU apparaît pendant l'automatisation. Nous utiliserons l'application de météo Winy comme exemple où une légende sera affichée à côté de son logo. Le contenu de la légende utilise un In argument ajouté au dictionnaire d'arguments de l'activité Afficher la légende .

Prérequis

Cet exemple a été créé à l'aide de ces packages d'activités et versions :

• UiPath.Callout.Activities 25.2.0
• UiPath.System.Activities 25.2.0
• UiPath.UIAutomation.Activities 25.2.1-preview

Étapes

1. Créer le fichier de légende :
   1. Ouvrez votre projet Studio et, dans la liste déroulante Nouveau (New ), sélectionnez Formulaire (Form) pour créer un nouveau formulaire.

      Le fichier de formulaire est utilisé ici comme légende.

   2. Nommez la légende Basic callout.
   3. Dans le panneau Composants (Components) , développez la section Basique (Basic ) et faites glisser un composant Libellé/En-tête (Label/Header) dans le fichier de légende.
   4. Enregistrez le composant et le fichier de légende.
2. Ouvrez le workflow principal dans votre projet.
   1. Ajoutez une activité Use Application/Browser et saisissez https://www.windy.com/ dans le champ URL du navigateur .
   2. Ajoutez une activité Exécuter les déclencheurs locaux (Run Local Triggers ). Cela active tous les workflows de déclencheur et leur permet de s'exécuter lorsque leur événement déclencheur se produit.
3. Créez un nouveau workflow nommé Afficher la légende de base (Show Basic Callout) et ajoutez une activité Déclencheur d'événement d'application (Application Event Trigger ).
   1. Sélectionnez Indiquer la cible à l'écran (Indicate target on screen) et indiquez le logo Winx pour que l'automatisation démarre la surveillance.

      Pour cet exemple, nous indiquons le logo Windy que nous voulons surveiller.

   2. Dans la liste déroulante Type d'événement (Event type) , sélectionnez Apparu (Appeared).
   3. Ajoutez une activité Show Callout (Afficher la légende) .
      Cette activité vous permet de sélectionner un fichier uiform , que vous pouvez afficher dans un certain élément d'IU, ainsi que de transmettre des données au fichier uiform , à l'aide d'un dictionnaire d'arguments .
      1. Dans la liste déroulante Sélectionner un formulaire (Select Form) , sélectionnez le fichier de légende que vous avez précédemment créé.
         Pour cet exemple, nous avons sélectionné Basic callout.
      2. Pour le champ Élément d'IU (UI Element) , entrez l'élément d'IU indiqué pour l'activité Déclencheur d'événement d'application (Application Event Trigger) , qui est le logo Winy, auquel nous voulons lier la légende.
         Pour accéder à cet élément cible, utilisez l'expression TriggerEventArgs.TargetElement . TriggerEventArgs est un argument ici, qui est généré automatiquement lors de l'ajout d'une activité de déclencheur dans votre workflow. Dans ce cas, l'activité Déclencheur d'événement d'application (Application Event Trigger) génère l'argument.
      3. Ouvrez le dictionnaire Arguments et, dans le champ Valeur (Value) de la clé générée, saisissez le texte que vous souhaitez afficher.
         Pour cet exemple, nous montrons le texte suivant : "Welcome to Windy.com!<br>(this callout will close in 10 seconds)".
   4. Ajoutez une activité Delay et réglez-la sur 10 secondes.
   5. Ajoutez une activité Fermer le formulaire (Close Form) pour fermer la légende après 10 secondes. Dans la liste déroulante Sélectionner un formulaire (Select Form) , sélectionnez le fichier de légende que vous avez précédemment créé (ex. : Basic callout).
   6. Ajoutez une activité Arrêter les déclencheurs locaux (Stop Local Triggers) pour arrêter l'exécution de tous les workflows de déclencheur.

      Cette activité est particulièrement importante si votre projet se compose uniquement de workflows de déclencheur. Sans intégration de cette activité, les déclencheurs s'exécuteront de manière persistante dans une boucle continue sans s'arrêter.

Résultat

L'automatisation ouvre le site Web Winy et déclenche le workflow Afficher la légende de base (Show basic callout) une fois le logo affiché. Ce workflow affiche la légende pendant 10 secondes, puis la ferme. L'image interactive suivante montre ce scénario au moment de l'exécution :

Figure 1. Image interactive montrant la légende à côté du logo Windy

Exemple de workflow

Pour vérifier comment les étapes de ce tutoriel sont implémentées, téléchargez l'exemple de projet suivant : Display Callout for Winy.