Création d'une calculatrice en temps réel

Vue d'ensemble (Overview)

Pour observer la communication instantanée entre UiPath Apps et un Robot UiPath, vous aurez besoin de :

• Créez un projet dans UiPath Studio composé des éléments suivants :

  • Main.Xaml : le workflow principal utilisé pour exécuter les déclencheurs

  • Plusieurs workflows déclenchés par l'application : utilisés pour les opérations arithmétiques de base. Ces workflows doivent être configurés comme points d'entrée.

    Opération arithmétique	Workflow Studio
    ajout	Sum.xaml
    Soustraction	Subtract.xaml
    Multiplication	Multiply.xaml
    Division	Divide.xaml

  • Le workflow déclencheur : ce workflow est disponible en tant que modèle, mais vous pouvez également le créer et le personnaliser en fonction des besoins de votre entreprise

• Créez une application dans UiPath Apps composée des éléments suivants :

  • Deux commandes d'entrée, où vous saisissez vos nombres

  • Commandes des quatre boutons : configurées avec la règle Déclencheur de workflow ( Trigger Workflow ), pour lier le bouton à une opération arithmétique spécifique, représentée par un workflow Studio

  • Quatre commandes de zones de texte - où le résultat des opérations arithmétiques est envoyé

Construire le projet UiPath Studio

Remarque : Assurez-vous d'utiliser les versions UiPath Studio 2023.4 et supérieures, et les versions UiPath Robot 2023.4 et supérieures.

Si possible, nous vous recommandons de configurer le projet Studio sur Démarrer en tant que processus d'arrière-plan. Il est utile que la même application s'exécute simultanément dans plusieurs fenêtres de navigateur, sans générer d'erreurs.

Création du workflow de déclencheur (modèle)

1. Ouvrez UiPath Studio et créez un nouveau processus.
   1. Sélectionnez la langue.
   2. Sélectionnez Windows pour la compatibilité.
2. Assurez-vous de disposer des versions de package d'activités suivantes :

   • UiPath.WorkflowEvents.Activities 2.0

   • UiPath.System.Activities 23.4+

3. Commencez par le modèle appelé Apps-Workflow communication/Dans le panneau Projet (Project), ajoutez un nouveau workflow. Celui-ci contiendra les activités qui activent le canal de communication entre UiPath Apps et UiPath Robot : activités Apps Request Trigger et Handle Apps Request .

   Si vous utilisez le modèle de communication Apps-Workflow , passez à la création des workflows de la calculatrice.

4. Ajoutez l'activité Apps Request Trigger . Il doit s'agir de la première activité du workflow.

   Lorsque vous ajoutez l'activité Apps Request Trigger à votre workflow, l'argument TriggerEventArgs est automatiquement créé. Utilisez-le dans l'activité Gérer la demande des applications pour accéder aux données de la charge utile de la réponse reçue après l'exécution du workflow.

5. Ajoutez une activité Si (If) pour détecter le cas de perte de connexion avec le client Apps. Lorsque l'utilisateur ferme le client d'Apps, tous les déclencheurs doivent être arrêtés.
   1. Dans le champ Condition (Condition), écrivez l'expression suivante : ConditionTriggerEventArgs.ConnectionWithAppLost = true
   2. Dans la section Puis (Then), ajoutez l'activité Arrêter les déclencheurs locaux (Stop Local Triggers ).
   3. Dans la section Sinon ( Else ), ajoutez l'activité Gérer la demande d'applications ( Hande Apps Request ).
   4. Dans les champs Arguments (Arguments) de l'activité Gérer la demande d'applications (Manage Apps Request ), utilisez l'argument TriggerEventArgs qui a été automatiquement créé par l'activité Déclencheur de demande d'application ( Apps Request Trigger ). Cet argument contient la charge utile du workflow reçue de l'activité Apps Request Trigger et la transmet à l'activité Gérer la demande d'Apps. Lors de l'exécution du workflow, l'activité Gérer la demande des applications ( Hande Apps Request ) utilise les informations de la charge utile pour appeler le workflow, puis renvoie les résultats de sortie du workflow lorsque celui-ci se termine.
      Remarque :

      L'activité Handle Apps Request doit être utilisée dans la section Sinon (Else) de la condition pour la perte de connexion. Cela garantit que l'activité est invoquée lors d'une connexion active entre UiPath Apps et UiPath Robot. Par conséquent, lorsque la connexion est perdue, l'exécution du processus se termine.

Construire les workflows de la calculatrice

1. Créez un dossier dans votre projet et nommez-le « Calculatrice ». C’est là que vous stockez les workflows de la calculatrice.
2. Dans le dossier, créez un workflow pour chaque opération arithmétique :

   Opération arithmétique	Workflow Studio
   ajout	Sum.xaml
   Soustraction	Subtract.xaml
   Multiplication	Multiply.xaml
   Division	Divide.xaml

3. Dans tous les workflows créés précédemment, définissez les arguments suivants :

   Argument name	Direction	Types d'arguments
   number1	dans	Int32
   number2	dans	Int32
   Résultat	Sortie	Int32 Double - pour la division

   Les arguments "number1" et "number2" sont les données saisies par l'utilisateur d'Apps.

   L'argument « résultat » est la sortie reçue après l'exécution du workflow.

4. Dans tous les workflows créés précédemment, ajoutez l'activité Attribuer (Assign). Configurez-le comme suit :

   Workflow	Enregistrer dans le champ	ChampValeur à enregistrer
   Sum.xaml	Résultat	number1 + number2
   Subtract.xaml	Résultat	number1 - number2
   Multiply.xaml	Résultat	number1 * number2
   Divide.xaml	Résultat	Cint(Math.Truncate(Decimal.Divide(number1,number2)))

5. Enregistrez vos workflows.
6. Pour marquer les workflows du calculateur comme points d'entrée : cliquez avec le bouton droit sur chaque workflow, puis sélectionnez l'option Activer le point d'entrée (Enable Entry Point) . Cela garantit l'affichage de vos XAML dans votre application.

Construire le workflow principal

Remarque :

Si vous utilisez le modèle de communication Apps-Workflow , ignorez cette étape.

Dans le fichier Main.xaml, ajoutez simplement l'activité Exécuter les déclencheurs locaux (Run Local Triggers ), puis enregistrez le fichier.

Gestion du projet dans Orchestrator

1. Dans Studio, publiez votre package de projet dans un dossier Orchestrator.
   Remarque :

   Si vous publiez le projet dans un espace de travail personnel, le processus correspondant est automatiquement créé. Passez à la création du projet d' application.

2. Dans votre locataire Orchestrator, accédez au dossier dans lequel vous avez publié le package Studio.
3. Accédez à Automatisation (Automation) > Processus(Processes) et cliquez sur Ajouter un processus (Add process).
4. Dans la liste déroulante Nom de la source du package (Package Source Name) , sélectionnez le projet Studio.
5. Dans la liste déroulante Point d'entrée ( Entry point ), sélectionnez Main.xaml.
6. Sur les pages suivantes, configurez votre processus comme vous le souhaitez, puis cliquez sur Créer ( Create). Votre projet Studio est désormais disponible en tant que processus Orchestrator.

Créer le projet d'applications

Remarque : assurez-vous d'utiliser UiPath Apps avec l'option Expressions VB (VB Expressions) activée.

Ajout de commandes

1. Sur la page d'accueil d'UiPath Apps > onglet Créer ( Build ), cliquez sur Créer une nouvelle application ( Create new app) .
2. Saisissez le nom de votre application. Par exemple, « Calculatrice en temps réel ».
3. Pour Langage d'expression (Expression Language), sélectionnez VB.
4. Sur la MainPage, ajoutez les contrôles suivants avec les propriétés Général suivantes :

   Contrôle	Propriété générale : valeur	Description
   1. Libellé	Texte : « Calculatrice en temps réel »	Ajoute un titre à votre application.
   2. Zone de texte (numéro) (Textbox (Number)) - renommez-la en « numéro1 »	Libellé : « Premier nombre » Texte de l'indice : « Saisir le premier nombre entier »	Permet aux utilisateurs de saisir leurs données.
   3. Zone de texte (numéro) (Textbox (Number)) - renommez-la en « numéro2 »	Libellé : « Deuxième nombre » Texte de l'indice : « Saisir le deuxième nombre entier »	Permet aux utilisateurs de saisir leurs données.
   4. Bouton - renommez-le en « somme »	Texte : « Somme »	Déclenche l'exécution du fichier Sum.xaml.
   5. Zone de texte - renommez-le en « sum_result »	NA	Génère la réponse du fichier Sum.xaml.
   6. Bouton - renommez-le en « soustraire »	Texte : « Soustraire »	Déclenche l'exécution du fichier Subtract.xaml.
   7. Zone de texte - renommez-le en « subtract_result »	NA	Génère la réponse du fichier Subtract.xaml.
   8. Bouton - renommez-le en « multiplier »	Texte : « Multiplier »	Déclenche l'exécution du fichier Multiply.xaml.
   9. Zone de texte - renommez-le en « multiplier_resultat »	NA	Génère la réponse du fichier Multiply.xaml.
   10. Bouton - renommez-le en « Diviser »	Texte : « Diviser »	Déclenche l'exécution du fichier Diviser.xaml.
   11. Zone de texte - renommez-la en « diviser_résultat »	NA	Émet la réponse du fichier Diviser.xaml.

Ajout du processus

Ajoutez le processus en tant que ressource pour lier les workflows Studio aux commandes Apps.

1. Dans votre application, développez la liste déroulante Ajouter une commande (Add control) et sélectionnez Processus(Process).
2. Une liste des locataires du compte actuel s'affiche. Choisissez celle qui héberge les processus dont vous avez besoin, puis cliquez sur Suivant ( Next).
3. Dans le panneau latéral gauche, développez le dossier Orchestrator dans lequel vous avez créé votre processus, sélectionnez-le, puis cliquez sur Ajouter ( Add). Par exemple, sélectionnez le processus « Calculatrice ».

   Une fois que vous avez ajouté le processus dans votre application, il affiche le workflow principal et les workflows marqués comme points d'entrée, ainsi que leurs arguments d'entrée et de sortie, tels que définis dans le projet Studio.

Ajout de règles aux commandes Bouton

En ajoutant la règle TriggerWorkflow à chaque commande Bouton (Button), vous demandez à l'application d'exécuter un workflow spécifique chaque fois que l'utilisateur d'Apps clique sur le bouton.

Répétez les étapes suivantes pour chaque commande de bouton :

1. Sélectionnez la commande du bouton.
2. Sur le côté droit, dans le panneau Événements , cliquez sur Créer une règle ( Create rule) . L'assistant Configurer la règle (Configure rule) s'ouvre.
3. Recherchez la règle TriggerWorkflow et sélectionnez-la.
4. Dans le champ Fichier de workflow (Workflow file ), développez le processus ajouté précédemment (« calculatrice ») et sélectionnez le workflow correspondant (fichier .xaml). Par exemple, le bouton Somme (Sum) doit référencer le fichier « calculatrice_Somme_xaml ».
5. Cliquez sur le champ Remplacement d'entrée ( Input Override ), puis développez le workflow précédemment sélectionné.
   1. Double-cliquez sur « number1 » pour le sélectionner comme premier argument d'entrée.
   2. Pour le champ Saisir une valeur (Enter value), cliquez sur l'icône "tune" pour ouvrir l'éditeur d'expressionset écrivez l'expression VB suivante :
      MainPage.number1.Value
   3. Double-cliquez sur « number2 » pour sélectionner comme deuxième argument d'entrée.
   4. Pour le champ Saisir une valeur (Enter value), cliquez sur l'icône "tune" pour ouvrir l'éditeur d'expressionset écrivez l'expression VB suivante :
      MainPage.number2.Value
   Remarque : « numéro1 » et « numéro2 » dans l'expression font référence aux commandes Zone de texte (numéro) , qui ont été renommées respectivement « numéro1 » et « numéro2 » et « numéro2 ». En définissant la valeur de ces commandes en tant que valeurs des arguments d'entrée, vous transmettez les entrées utilisateur d'Apps au workflow Studio.

   
6. Développez le champ Une fois terminé ( When completed ) et ajoutez la règle Définir la valeur (Set Value ).
   1. Pour le champ Élément à définir ( Item To Set ), cliquez sur l'icône « ajuster » pour ouvrir l' éditeur d'expressionset référencer la commande de résultat. Par exemple, pour le résultat de la somme, écrivez l'expression VB suivante :
      MainPage.sum_result.Value
   2. Pour le champ Valeur (Value), cliquez sur l'icône « Tune » pour ouvrir l' éditeur d'expressionset référencer le résultat du workflow. Par exemple, pour l'opération de somme, écrivez l'expression VB suivante :
      Processes.Calculator.calculator_Sum_xaml.result.ToString
   Remarque : l'ajout de la règle Définir la valeur ( Set Value ) dans le champ Une fois terminé ( When completed ) garantit que la valeur utilisée pour lier le résultat du workflow au contrôle de résultat correspondant est correcte, car elle utilise les valeurs renvoyées en sortie une fois l'exécution du workflow terminée.

   
7. Répétez les étapes précédentes pour les boutons restants :

   Contrôle des boutons	Fichier de workflow
   Soustraire	calculator_Subtract_xaml
   Multiplier	calculator_Multiply_xaml
   Diviser	calculator_Divide_xaml

Publier et déployer votre application dans Orchestrator

Pour préparer votre application à l'exécution, vous devez la publier dans le flux de locataire Orchestrator, puis la déployer.

1. Dans Apps, cliquez sur Publier dans la barre de navigation supérieure.
2. Basculez vers Orchestrator et accédez au dossier souhaité.
3. Accédez à Automatisations (Automations) > Applications (Apps ) et cliquez sur Déployer l'application ( Deploy app). L'assistant Déployer l'application ( Deploy app ) s'ouvre.
4. Dans la liste déroulante Application ( App ), sélectionnez l'application précédemment publiée.
5. Cliquez sur Déployer (Deploy). Votre application peut maintenant être exécutée dans votre dossier Orchestrator.

Exécuter votre application

Vous êtes prêt à exécuter votre application.

1. Dans l'Assistant UiPath, dans le panneau Accueil (Home), recherchez votre application dans la catégorie Applications (Apps).
2. Cliquez sur Exécuter ( Run). Vous êtes invité à accorder l'accès à UiPath Robot Assistant.
3. Saisissez deux nombres.
4. Cliquez sur un bouton pour l'opération arithmétique souhaitée.

Le premier calcul prend plus de temps car il s'agit de la première instanciation de la tâche. Après cela, la tâche poursuit son exécution et renvoie instantanément les résultats. Lorsque vous fermez la session Apps, la tâche se termine.