Créer et afficher une légende de compte à rebours

Ce tutoriel vous montre comment créer et afficher une légende pendant 10 secondes, tout en affichant le décompte, chaque fois qu'un certain élément d'IU apparaît pendant l'automatisation. Nous utiliserons l'application Window Window comme exemple, où une légende sera affichée à côté de son logo.

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 trois composants Libellé/En-tête dans le fichier de légende.
      • Pour le premier composant, saisissez un texte par défaut, par exemple : Welcome to Windy.com!
      • Pour le deuxième composant, saisissez un texte par défaut, tel que : This pop-up will close in 10 seconds.
      • Pour le troisième composant, laissez inchangé. Il s’agit du compte à rebours, qui sera modifié au moment du runtime.
   4. Enregistrez les composants 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. 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.
4. 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.

   4. Accédez au Gestionnaire de données et créez une variable globale, nommée secondsLeft. Cette variable est utilisée pour suivre le temps restant pour afficher la légende.
   5. Ajoutez une activité Attribuer pour attribuer la durée d'affichage de votre légende. Dans le champ Enregistrer vers , saisissez la variable globale nouvellement créée (secondsLeft), et dans le champ Valeur à enregistrer , saisissez 10.
5. Créez un autre workflow de déclencheur, nommé Mettre à jour le compteur, qui déclenche la mise à jour des secondes restantes à l'intérieur de la légende.

   1. Ajoutez une activité Déclencheur de modification de variable globale pour exécuter ce workflow chaque fois que la variable globale secondsLeft change.

      Dans la liste déroulante Sélectionner la variable globale , sélectionnez secondsLeft et définissez le Mode de planification sur Séquentiel.

   2. Ajoutez une activité Faire pendant pour mettre à jour le nombre de secondes restantes pour l'affichage de la légende jusqu'à ce que la variable secondsLeft devienne 0.

      1. Dans le corps de l'activité Faire pendant , ajoutez une activité Définir les valeurs du formulaire . Dans la liste déroulante Sélectionner un formulaire , sélectionnez le fichier Basic Callout . Ouvrez le dictionnaire d' arguments et, pour le champ Valeur de la clé secondsValue , saisissez l'expression suivante : "secondsLeft.ToString+" second(s) left."
      2. Ajoutez une activité de type Délai et définissez-la sur une seconde.
      3. Ajoutez une activité Assign pour soustraire une seconde de la variable globale secondsLeft .
      4. Définissez la condition de l' activité Do While sur secondsLeft <> 0.

   3. Ajoutez une activité Fermer le formulaire et sélectionnez le fichier Basic Callout .

   4. 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é. Lorsque la variable globale est définie sur 10, le workflow de mise à jour du compteur commence à s'exécuter, en soustrayant une seconde de la variable globale et en l'affichant dans la légende pour une seconde. Cela continue jusqu'à ce qu'il ne reste aucune seconde. Ce processus de runtime est visualisé dans l’image interactive suivante :

Figure 1. Image interactive montrant une légende affichant un minuteur

Exemple de workflow

Pour vérifier comment les étapes de ce tutoriel sont implémentées, téléchargez l'exemple de projet suivant : Affichage du nombre de légendes pour Window.