Créer et afficher une légende simple

Ce tutoriel vous montre comment créer et afficher une légende pendant 10 secondes, chaque fois qu'un certain élément d'IU apparaît lors de l'automatisation. Nous utiliserons l'application Window Window comme exemple, où une légende sera affichée à côté de son logo. Le contenu à l'intérieur de la légende utilise un argument In 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 dans la liste déroulante Nouveau et sélectionnez Formulaire 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 , développez la section Basique et faites glisser un composant Libellé/En-tête dans le fichier de légende.
   4. Enregistrez le composant et le fichier de légende.
2. Ouvrez le workflow principal de 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 . Cela active tous les workflows de déclencheur et leur permet de s’exécuter lorsque leur événement de déclenchement se produit.
3. Créez un nouveau workflow nommé Afficher la légende de base et ajoutez une activité Déclencheur d'événement d'application .
   1. Sélectionnez Indiquer la cible à l'écran et indiquez le logo Windowy pour que l'automatisation démarre la surveillance. Pour cet exemple, nous indiquons le logo Window, que nous voulons surveiller.
   2. Dans la liste déroulante Event type , sélectionnez Apparu.
   3. Ajoutez une activité 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 , 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 , saisissez l'élément d'IU indiqué pour l'activité Déclencheur d'événement d'application , qui est le logo Windowy, 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 génère l'argument.

      3. Ouvrez le dictionnaire d’arguments et, dans le champ Valeur 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é de type Délai et définissez-la sur 10 secondes.
   5. Ajoutez une activité Fermer le formulaire pour fermer la légende après 10 secondes. Dans la liste déroulante Sélectionner un formulaire , sélectionnez le fichier de légende que vous avez précédemment créé (par exemple : Basic callout).
   6. Ajoutez une activité Arrêter les déclencheurs locaux 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 Windowy et déclenche le workflow Afficher la légende de base une fois le logo affiché. Ce workflow affiche la légende pendant 10 secondes, puis la ferme. L’image interactive suivante illustre ce scénario au moment de l’exécution :

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

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 Window.