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 de quatre boutons : configurées avec la règle Workflow du déclencheur , pour lier le bouton à une opération arithmétique spécifique, qui est 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 que vous utilisez les versions 2023.4 et ultérieures de UiPath Studio, et les versions 2023.4 et ultérieures de UiPath Robot.

Si possible, nous vous recommandons de configurer le projet Studio pour qu'il démarre 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 comme 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é Communication Apps-Workflow . Dans le panneau Projet , ajoutez un nouveau workflow. Celle-ci contiendra les activités qui permettent d'activer le canal de communication entre UiPath Apps et UiPath Robot : les activités Déclencheur de demandes Apps et Gérer la demande d'Apps .

   Si vous utilisez le modèle de communication Apps-Workflow , passez à Créer les workflows de la calculatrice.

4. Ajoutez l’activité Déclencheur de demandes Apps . 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 d'Apps pour accéder aux données de la charge utile de réponse reçue après l'exécution du workflow.

5. Ajoutez une activité Si pour détecter le cas de perte de connexion avec le client Apps. Lorsque l'utilisateur ferme le client Apps, tous les déclencheurs doivent être arrêtés.

   1. Dans le champ Condition , écrivez l'expression suivante : ConditionTriggerEventArgs.ConnectionWithAppLost = true
   2. Dans la section Puis , ajoutez l'activité Arrêter les déclencheurs locaux .
   3. Dans la section Sinon , ajoutez l'activité Gérer la demande d'App .
   4. Dans les champs Arguments de l'activité Gérer la demande d'Apps , utilisez l'argument TriggerEventArgs qui a été automatiquement créé par l'activité Déclencheur de la demande d'Apps . Cet argument contient la charge utile du workflow reçue de l’activité Déclencheur de demandes Apps et la transmet à l’activité Gérer la demande d’Apps . Lors de l'exécution du workflow, l'activité Gérer la demande d'App utilise les informations de la charge utile pour appeler le workflow, puis renvoie les résultats de sortie du workflow lorsque le workflow se termine.
      Remarque :

      L'activité Handle Apps Request doit être utilisée dans la section Sinon 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 s'arrête.

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 auparavant, ajoutez l'activité Affecter . Configurez-la comme suit :

   Workflow	Enregistrer dans le champ	Valeur à 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. Marquez les workflows de la calculatrice comme points d'entrée : cliquez droit sur chaque workflow, puis sélectionnez l'option Activer le point d'entrée . Cela garantit que vos fichiers XAML sont affichés 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 , 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 sur un espace de travail personnel, le processus correspondant est automatiquement créé. Passez à Créer le projet Apps.

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

Créer le projet d'applications

Remarque :

Assurez-vous que vous utilisez UiPath Apps avec l'option Expressions VB activée.

Ajout de commandes

1. Sur la page d'accueil UiPath Apps > onglet Créer , cliquez sur Créer une nouvelle application.

2. Saisissez le nom de votre application. Par exemple, « Calculateur en temps réel ».

3. Pour Langage d’expression, sélectionnez VB.

4. Sur la PagePrincipale, ajoutez les contrôles suivants avec les propriétés générales 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é : "Second number" Texte de l'indice : "Saisissez 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 un contrôle et sélectionnez Processus.
2. Une liste des locataires du compte actuel s'affiche. Choisissez celui qui héberge les processus dont vous avez besoin, puis cliquez sur Suivant.
3. Dans le panneau latéral gauche, développez le dossier Orchestrator dans lequel vous avez créé votre processus, sélectionnez le processus, puis cliquez sur Ajouter. Par exemple, sélectionnez le processus « Calcul ».

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 WorkflowDéclencheur à chaque commande Bouton , vous indiquez à 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. L’assistant Configurer la règle s’ouvre.

3. Recherchez la règle TriggerWorkflow et sélectionnez-la.

4. Dans le champ Fichier de workflow , développez le processus précédemment ajouté « Calcul » et sélectionnez le workflow correspondant (.xaml). Par exemple, le bouton Somme doit référencer le fichier « calculator_Sum_xaml ».

5. Cliquez sur le champ Remplacement d'entrée , 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 , cliquez sur l'icône « tune » pour ouvrir l'éditeur d'expressions, et é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 , cliquez sur l'icône « tune » pour ouvrir l'éditeur d'expressions, et écrivez l'expression VB suivante : MainPage.number2.Value

      Remarque :

      « number1 » et « number2 » dans l'expression font référence aux contrôles TextBox(number) , qui ont été renommés respectivement en « number1 » et « number2 ». En définissant la valeur de ces commandes comme 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é et ajoutez la règle Définir la valeur .

   1. Pour le champ Élément à définir , cliquez sur l'icône « tune » afin d' ouvrir l'éditeur d'expression et 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 , cliquez sur l'icône « tune » pour ouvrir l'éditeur d'expression, et référencez 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 dans le champ Une fois terminé 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 tant que sortie après la fin de l'exécution du workflow.

      

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 pour 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 > Applications et cliquez sur Déployer l'application. L'assistant Déployer l'application s'ouvre.
4. Dans la liste déroulante Application , sélectionnez l'application précédemment publiée.
5. Cliquez sur Déployer. Votre application est maintenant disponible dans votre dossier Orchestrator pour être exécutée.

Exécuter votre application

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

1. Dans UiPath Assistant, sur le panneau Accueil , recherchez votre application dans la catégorie Applications .
2. Cliquez sur Exécuter. Vous êtes invité à accorder l’accès à l’Assistant UiPath Robot.
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.