Implémenter un processus simple

Vue d'ensemble (Overview)

Démarrer dans Maestro peut être aussi simple ou aussi avancé que votre scénario d'utilisation l'exige.Un processus simple peut impliquer quelques étapes connectées, telles que la réception d'une entrée, l'exécution d'une automatisation et le retour d'un résultat, ce qui est idéal pour les preuves de concept rapides ou les flux métier simples. Cette section vous présente un flux simple afin de vous familiariser avec les bases du processus.

Ce guide montre comment implémenter un processus simple qui met en évidence les fonctionnalités de base de l'orchestration agentique : modélisation, implémentation, débogage, publication, déploiement et gestion. Le processus ne couvre pas l'intégration avec d'autres produits UiPath. Pour obtenir des instructions sur la configuration et la mise en œuvre de dépendances telles que Data Fabric, Integration Service, Studio Web, Agents et Action Center, consultez la section Comment procéder – Processus complexe.

L'objectif est de créer un processus de routage simple semblable à celui de l'image suivante :

Modéliser un processus

Remarque :

• La configuration du projet de processus agentique est actuellement liée au locataire. Veillez à rester dans le même locataire entre les sessions de modification.
• La configuration du projet de processus agentique ne prend actuellement en charge qu'un seul fichier de processus métier (.bpmn). Bien que vous puissiez ajouter plusieurs fichiers au projet, cela entraîne des problèmes inattendus, tant lors du débogage que de la publication.

Commencez par modéliser le processus de bout en bout, puis configurez les composants.

Créez un processus agentique en tant que nouveau type de projet Studio.

1. Accédez à votre locataire Automation Cloud™.

2. Sur le rail situé à gauche, dans la liste des produits, sélectionnez Maestro.

3. Sur la page d'accueil de Maestro, sélectionnez Démarrer la modélisation. Votre nouveau processus agentique s'ouvre.

   Vous pouvez également commencer par créer un nouveau Processus d'agent dans Studio Web.

   

4. Cliquez avec le bouton droit pour renommer le projet Processus Simple et le processus Processus Simple. Votre processus agentique fait, par défaut, partie d'une solution. Lisez les solutions dans le Guide utilisateur de Studio Web.

   

5. Sélectionnez l'élément de démarrage, puis cliquez sur Ajouter : Annotation de texte dans la boîte à outils et saisissez le chemin de la variable d'entrée.

   

6. Sélectionnez l'élément de démarrage et cliquez sur Ajouter : Événement intermédiaire dans la boîte à outils.

   

7. Sélectionnez Modifier l'élément dans la barre d'outils, puis sélectionnez Événement de capture – Minuteur intermédiaire et saisissez Délai pour le nom de l'événement intermédiaire.

   

8. Sélectionnez l'élément de minuterie et cliquez sur Ajouter : Passerelle exclusive dans la boîte à outils et saisissez Quel chemin ? pour le nom de la passerelle.

   

9. Sélectionnez la passerelle, cliquez sur Ajouter : Tâche et saisissez Tâche A pour le nom.

   

   Les erreurs de validation sont affichées dans le coin inférieur gauche de la zone de dessin.

   

10. Sélectionnez à nouveau la passerelle, cliquez sur Ajouter : Tâche et saisissez Tâche B pour le nom.

    

11. Sélectionnez la passerelle et développez la première condition. Elle portera un nom généré commençant par edge_Gateway_{randomcharacters} et saisissez A dans le champ Étiquette. Développez la deuxième condition et saisissez B dans le champ Étiquette.

    

    

12. Nous vous recommandons d'utiliser la meilleure pratique consistant à créer une fin explicite à votre processus. Pour identifier rapidement le chemin que le processus a suivi, créez une fin explicite pour chacun d'eux. Sélectionnez la Tâche A, puis cliquez sur Ajouter : Événement de fin dans la boîte à outils et saisissez Fin A pour le nom.

    

13. Sélectionnez la Tâche B, puis cliquez sur Ajouter : Événement de fin dans la boîte à outils et saisissez Fin B pour le nom.

    

Félicitations ! Vous avez maintenant créé votre premier processus BPMN de bout en bout !

Ajoutez maintenant des fonctionnalités au processus.

Implémenter un processus

Démarrer l’événement

1. Sélectionnez l'élément de démarrage et, dans le panneau Propriétés, tapez Démarrage manuel pour le Nom et, dans la section Arguments, sélectionnez Ajouter nouveau pour ajouter une variable que nous pouvons utiliser lorsque nous démarrons le processus.

   

2. Configurer la variable avec ces valeurs et cliquez sur Enregistrer. Une variable de sortie sera automatiquement créée.

   • Name (Nom) : chemin
   • Type: String
   • Value (Valeur) : A

   

   

3. Sélectionnez l'événement Délai, ouvrez le panneau Propriétés et, dans la section Minuterie, sélectionnez Type=Durée et 5 secondes dans la configuration des valeurs.

   

4. Sélectionnez la passerelle et développez la section Conditions pour entrer la condition des chemins Non et Oui, puis sélectionnez le sélecteur de saisie de texte pour ouvrir l'Éditeur d'expressions et entrer les conditions.

   

5. Utilisez Insérer variable pour trouver et insérer la variable de sortie Manual start path.

   

   Définissez la valeur sur « A » et sélectionnez Enregistrer.

   

6. Ouvrez l'Éditeur d'expressions pour la condition B et insérez le chemin de la variable de sortie de Démarrage manuel, définissez la valeur sur « B » et cliquez sur Enregistrer.

   

   Vous pouvez également simplement copier/coller les expressions ci-dessous dans l'éditeur d'expressions :

   • A

     vars.path == "A"
     

   • B

     vars.path == "B"
     

Félicitations ! Vous avez maintenant entièrement configuré votre premier processus.

Remarque :

Vous pouvez télécharger le BPMN afin de l'utiliser dans d'autres projets en cliquant droit sur le nom du fichier .bpmn .

Déboguer un processus

Vous pouvez configurer des points d'arrêt en survolant l'angle supérieur gauche d'un élément et en sélectionnant Cliquer pour ajouter un point d'arrêt. Actuellement, les points d'arrêt ne peuvent être définis qu'une fois que vous commencez à déboguer un processus. Cependant, ils sont conservés entre les exécutions. En savoir plus sur le débogage et les points d’arrêt.

Déboguer directement

Tout d'abord, exécutez votre processus directement pour vous assurer de l'avoir configuré correctement. Définissez la valeur par défaut de votre variable path sur A afin que vous puissiez la voir passer à la Tâche A et à la Fin A.

1. Sélectionnez Déboguer pour tester votre processus.

   

2. Regardez comment chaque étape est exécutée. Naviguez dans les sections Piste d'exécution et Variables globales/Incidents pour afficher d'autres détails.

3. Sélectionnez Back to design mode (Retour au mode de conception) pour quitter le débogage.

Déboguer étape par étape

Exécutez votre processus étape par étape afin de pouvoir manipuler la variable path pour tester la route B

1. Sélectionnez Déboguer étape par étape.

   

2. Sélectionnez Étape suivante pour déplacer l'exécution vers la minuterie

   

3. Mettez à jour la variable globale path de la source d'événement Démarrage manuel sur B. Sélectionnez la touche Entrée ou Tabulation pour valider la modification.

   

4. Sélectionnez Mettre à jour la variable 1 et Mettre à jour les variables dans la boîte de dialogue suivante pour valider les modifications.

5. Sélectionnez Continue (Continuer) pour terminer l'exécution.

6. Regardez comment chaque étape est exécutée. Accédez aux sections Piste d'exécution et Variables/Incidents globaux pour afficher des détails supplémentaires. Cette fois, le processus suit la route B.

   

7. Sélectionnez Back to design mode (Retour au mode de conception) pour quitter le débogage.

.

Publier et déployer un processus simple

1. Sélectionnez Publier.

2. Choisissez l' Emplacement et sélectionnez Publier.

   

3. Consultez la section Publication et mise à niveau des processus agentiques pour connaître les étapes à publier sur Orchestrator.

Félicitations ! Vous avez maintenant entièrement publié, déployé et lancé votre premier processus.

Il est maintenant temps de gérer les instances de runtime.

Gérer un processus métier

1. Depuis le portail Automation Cloud, accédez au service Maestro.

2. Sélectionnez Processus simple dans la liste des processus pour ouvrir l'affichage Toutes les instances de votre processus. Vous pouvez utiliser la fonction de recherche pour filtrer la liste, le cas échéant.

   

3. Sélectionnez la dernière instance pour ouvrir la visionneuse d'instances. Vous verrez le processus s'exécuter en direct à chaque étape (en supposant que le minuteur de 5 secondes s'exécute toujours).

   

Vous pouvez cliquer sur l'arrière-plan du modèle pour voir les Variables globales et l'historique des actions ainsi que la piste d'exécution. Vous pouvez cliquer sur un nœud dans le modèle ou sur la piste d'exécution pour inspecter les détails et les variables de cette étape d'exécution. Félicitations ! Vous avez maintenant entièrement géré votre premier processus. Maintenant, arrêtez notre processus pour pouvoir le réparer !

Interrompre et réparer un processus

Dans cette procédure, nous allons provoquer une erreur dans l'exécution afin d'utiliser la gestion des instances pour récupérer.

1. Accédez à Orchestrator, à l'onglet Automatisations du dossier Mon espace de travail et recherchez Simple.Process dans la liste Processus.

2. Sélectionnez Démarrer une tâche pour l'entrée Simple.Process, mais cette fois, modifiez les arguments avant de commencer à l'interrompre.

3. Sélectionnez l'onglet Arguments et modifiez la variable path . Définissez la valeur sur C et sélectionnez Enregistrer.

   

4. Sélectionnez Démarrer.

5. Accédez à Maestro et sélectionnez Processus simple dans la liste des Processus pour ouvrir l'affichage Toutes les instances de votre processus.

   

6. Sélectionnez le champ Quel chemin ? pour voir l'erreur Aucun flux sortant pour la passerelle qui doit être attendu, car nous n'avons pas configuré pour path==”C”.

   

7. Cliquez sur le conteneur de la première étape ou sur l'arrière-plan du modèle pour afficher les variables globales.

   

8. Assurez-vous que le flux suivra une condition configurée en mettant à jour la path variable de la sortie de démarrage manuel (la seconde) sur A.

   

9. Sélectionnez Mettre à jour 1 variable pour mettre à jour la variable et ajoutez un commentaire destiné à l'audit.

   

10. Sélectionnez Réessayer, ajoutez un commentaire et choisissez Réessayer l'instance pour réessayer l'étape avec la nouvelle variable et regarder l'instance s'exécuter.

    :::note
    You might need to refresh the page to see the instance complete.
    :::
    
    ![retry instance](https://dev-assets.cms.uipath.com/assets/images/maestro/maestro-retry-instance-597470-64bdf93f.webp)
    

11. Consultez l'Historique des actions pour voir la piste d'audit de nos modifications.

    

Félicitations ! Vous avez corrigé avec succès une instance défectueuse.

Migrer entre les versions d'un processus

La logique de flux de processus actuelle n'est pas suffisamment robuste pour gérer tous les scénarios de chemin. Vous résolvez ce problème en publiant une nouvelle version du processus. Cette version mise à jour prendra efficacement en charge non seulement les nouvelles instances de processus, mais rectifiera également les instances problématiques existantes. Pour vous assurer de gérer efficacement tous les scénarios dont la valeur path n'est pas égale à A, remplacez la route B par une route Not A (Non A).

Dans cette procédure, vous allez provoquer une erreur dans l'exécution afin de la résoudre avec une nouvelle version.

1. Accédez à Orchestrator.
2. Accédez à My Workspace (Mon espace de travail).
3. Accédez à l'onglet Automations (Automatisations) et recherchez Simple.Process dans la liste Processes (Processus).
4. Sélectionnez Démarrer une tâche pour l'entrée Simple.Process et choisissez Démarrer.
5. Sélectionnez l'onglet Arguments et modifiez la variable path .
6. Définissez la valeur sur C et choisissez Enregistrer.
7. Sélectionnez Démarrer.

Corrigez maintenant votre processus afin de pouvoir migrer cette instance défectueuse.

1. Ouvrez votre processus simple dans UiPath Studio.

2. Sélectionnez l'étape de la passerelle exclusive Quel chemin ? et ouvrez le panneau Propriétés.

3. Remplacez l'étiquette B par Not A et changez la condition par vars.path != A

   

4. Remplacez le nom de la Tâche B par Tâche Non A.

5. Remplacez le nom de l'événement de fin Fin B par Fin Non A.

6. Cliquez sur Publier, sélectionnez Flux d'espace de travail personnel Orchestrator, puis cliquez sur Publier.

Migrez maintenant votre instance défectueuse vers la nouvelle version.

1. Accédez à Maestro, sélectionnez Instances du processus, puis choisissez Processus simple dans la liste des Processus pour ouvrir l'affichage Toutes les instances de votre processus.

2. Cliquez sur la dernière instance pour ouvrir l'observateur d'instance. Vous verrez que le processus a un état d'échec au niveau de la passerelle exclusive Quel chemin ? .passerelle.

   Remarque :

   Vous devrez peut-être cliquer sur le bouton Actualiser de la liste pour voir la dernière instance.

3. Sélectionnez Migrer, choisissez la Version cible du processus que vous venez de publier (ce devrait être 1.0.1, mais pourrait être différente dans votre cas), fournissez un commentaire et sélectionnez Migrer l'instance.

   

4. Sélectionnez Réessayer, ajoutez un commentaire et cliquez sur Réessayer l'instance pour réessayer l'étape avec la nouvelle variable et regardez l'instance s'exécuter.

   Remarque :

   Vous devrez peut-être actualiser la page pour voir l’instance terminée.

   

5. Consultez l'Historique des actions pour voir la piste d'audit de vos modifications.

Félicitations ! Vous avez migré avec succès une instance défectueuse vers une nouvelle version du processus !

Processus final

Voici le processus final :