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

Ce didacticiel montre comment créer et afficher une légende pendant 10 secondes, tout en affichant le compte à rebours correspondant, 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.

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 trois composants Libellé/En-tête (Label/Header) 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 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. 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.
4. 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.
   4. Accédez au Gestionnaire de données (Data Manager) 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 (Assign) pour attribuer la durée d'affichage de votre légende. Dans le champ Enregistrer vers (Save to) , entrez la variable globale nouvellement créée (secondsLeft), et dans le champ Valeur à enregistrer (Value to save) , entrez 10.
5. Créez un autre workflow de déclencheur, nommé Mettre à jour le compteur (Update counter), qui déclenche la mise à jour des secondes restantes dans la légende.
   1. Ajoutez une activité Déclencheur de modification de variable globale (Global Variable Changed Trigger ) pour exécuter ce workflow chaque fois que la variable globale secondsLeft change.
      Dans la liste déroulante Sélectionner une variable globale (Select Global Variable) , sélectionnez secondsLeft et définissez le Mode de planification (Scheduling Mode) sur Séquentielle (Sequential).
   2. Ajoutez une activité de type Faire pendant (Do While) 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 (Do While ), ajoutez une activité Définir les valeurs du formulaire (Set Form Values) . Dans la liste déroulante Sélectionner un formulaire (Select Form) , sélectionnez le fichier Basic Callout . Ouvrez le dictionnaire d'arguments et pour le champ Valeur (Value) de la clé secondsValue , saisissez l'expression suivante : "secondsLeft.ToString+" second(s) left."
      2. Ajoutez une activité Delay et réglez-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é Faire pendant (Do While) sur secondsLeft <> 0.
   3. Ajoutez une activité Fermer le formulaire (Close Form) et sélectionnez le fichier Basic Callout .
   4. 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é. Lorsque la variable globale est définie sur 10, le workflow Mettre à jour le compteur (Update counter) commence à s'exécuter, soustrayant une seconde de la variable globale et l'affichant dans la légende pendant une seconde. Cela continue jusqu'à ce qu'il ne reste plus de secondes. 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 : Display Callout Countdown for Winy.