Modélisez, implémentez, puis exploitez un processus simple

Dans cet exemple, vous allez implémenter un processus agent simple qui vous guidera à travers les fonctionnalités de base de Maestro pour modéliser, implémenter, déboguer, publier, déployer et gérer un processus. Cet exemple de processus simple n’utilise aucun autre produit UiPath®.

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

Remarque : la configuration de projet Processus d'agent est actuellement liée au locataire. Assurez-vous que vous restez dans le même locataire entre les sessions de modification.

Remarque : la configuration de projet Processus d'agent ne prend actuellement en charge qu'un seul fichier de processus métier (BPMN). Bien que plusieurs fichiers puissent être ajoutés au projet, cela entraîne des problèmes inattendus au niveau du débogage et de la publication.

Modélisation d'un processus

Tout d'abord, commencez à modéliser le processus de bout en bout, puis configurez les composants.

1. Accédez à votre locataire Automation Cloud™.
2. Sur la barre de gauche, dans la liste des produits, sélectionnez Maestro.
3. Sur la page de destination Maestro , sélectionnez Démarrer (Get Started).
   Astuce : Vous pouvez également commencer par créer un nouveau Processus d'agent (Agentic Process) dans Studio.
   Votre nouveau processus d'agent s'ouvre.
4. Dans le coin supérieur gauche de l'interface de conception, sélectionnez Démarrer (Get Started).
5. Renommez le projet en Projet simple (Simple Project) et le processus en Processus simple (Simple process).
   
   

   

   
   
6. Fermez l'explorateur de projets.
7. Sélectionnez l'élément de l'événement de démarrage sur la zone de dessin pour afficher la barre d'outils de l'élément. Choisissez Ajouter : annotation de texte dans la barre d'outils de l'élément.
8. Sélectionnez l'élément d'événement de début et choisissez Ajouter : événement intermédiaire (Add: Intermediate event) dans la barre d'outils de l'élément.
   1. Double-cliquez sur l'élément intermédiaire pour le renommer. Renommez-la en Délai.
      Astuce : Vous pouvez également utiliser le champ Nom (Name) depuis l'onglet Propriétés (Properties) sur le côté droit de l'écran pour renommer un élément.
   2. Remplacez l'événement intermédiaire Délai par un événement de capture intermédiaire Minuterie.
   
   

   

   
   
9. Sélectionnez l'événement de capture intermédiaire Analyseur de délai (Delay timer between Filtre Intermédiaire) et choisissez Ajouter : Passerelle exclusive (Add: exclusive gateway).
   1. Nommez la passerelle exclusive comme quel chemin ?.
10. Sélectionnez l' option Quel chemin ? passerelle exclusive et choisissez Ajouter : Tâche (Add: Task).
    1. Nommez la tâche en tant que tâche.
    Astuce : lorsque vous dessinez et configurez votre processus, les erreurs de validation s’affichent sur la zone de dessin. Sélectionnez Masquer les erreurs de validation (Hide validation error) dans le menu des outils en haut à droite si vous souhaitez masquer ces visualisations

    
    

    

    
    
11. Sélectionnez l' option Quel chemin ? à nouveau la passerelle exclusive et choisissez Ajouter : Tâche (Add: Task).
    1. Nommez la tâche en tant que Tâche B.
    
    

    

    
    
12. Sélectionnez l' option Quel chemin ? passerelle exclusive.
    1. Développez la première condition de la section Conditions de l'onglet Propriétés .
       Le nom de la condition généré commence par edge_Gateway_{randomcharacters}.
    2. Saisissez A dans le champ Libellé (Label) de la première condition.
    3. Développez la deuxième condition.
    4. Tapez B dans le champ Libellé (Label) de la deuxième condition.
    
    

    

    
    
13. Sélectionnez une tâche et choisissez Ajouter : Terminer l'événement (Add: End event) dans la barre d'outils de l'événement.
    1. Nommez l'événement de fin comme Fin A (End A).
    Astuce : Comme meilleure pratique, créez une fin explicite pour votre processus. Pour déterminer rapidement le chemin suivi par votre processus et la fin explicite de chacun.
14. Sélectionnez la tâche B et choisissez Ajouter : Événement de fin (Add: End event) dans la barre d'outils de l'événement.
    1. Nommez l'événement de fin comme Fin B (End B).
    
    

    

    
    

Implémenter un processus

Suivez cette procédure pour ajouter des capacités au processus créé dans la section Modélisation d'un processus (Modeling a process) .

1. Sélectionnez l'élément d'événement Démarrer (Start) et renommez-le en tant que Démarrage manuel (Manual Start).
2. Sélectionnez Ajouter nouveau (Add new) dans la section Entrées (Inputs) de l'onglet Propriétés (Properties) .
   
   

   

   
   
3. Créez la nouvelle variable comme suit :
   • Nom : chemin
   • Type : Chaîne
   • Valeur : A
   
   

   

   
   
4. Sélectionnez Enregistrer (Save).
   La nouvelle variable est créée.
5. Sélectionnez l'événement de capture intermédiaire Délai (Delay timer).
6. Accédez à la section Minuterie (Timer) de l'onglet Propriétés (Properties) et ajoutez les valeurs suivantes :
   • Type : Durée
   • Valeur : ajoutez 5 secondes à partir de la configuration de la valeur.
   
   

   

   
   
7. Sélectionnez l' option Quel chemin ? passerelle exclusive.
8. Développez les conditions à partir de la section Conditions de l'onglet Propriétés .
9. Configurez la première condition.
   1. Sélectionnez Ouvrir l'éditeur d'expression (Open expression editor) pour la première condition.
      
      

      

      
      
   2. Utilisez Insérer une variable (Insert variable) pour rechercher et insérer la variable de sortie Démarrage manuel (Manual Start) path.
   3. Définissez une valeur égale à "A".
   4. Sélectionnez Enregistrer (Save).
   
   

   

   
   
10. Configurez la deuxième condition.
    1. Sélectionnez Ouvrir l'éditeur d'expression (Open expression editor) pour la deuxième condition.
    2. Utilisez Insérer une variable (Insert variable) pour rechercher et insérer la variable de sortie Démarrage manuel (Manual Start) path.
    3. Définissez une valeur égale à "B".
    4. Sélectionnez Enregistrer (Save).
    
    

    

    
    

    Astuce : Vous pouvez également simplement copier et coller les expressions suivantes dans l'éditeur d'expressions :

    • Expression A: vars.path == "A"
    • Expression B: vars.path == "B"

Déboguer un processus

Vous allez d’abord exécuter votre processus directement pour vous assurer qu’il est correctement configuré. Étant donné que la valeur par défaut de la variable path est définie sur A, le processus doit passer à une tâche et à une fin d'A.

Pointez votre curseur sur le coin supérieur gauche d’un élément et sélectionnez Cliquer pour ajouter un point d’arrêt pour configurer les points d’arrêt. Actuellement, les points d'arrêt ne peuvent être définis qu'une fois que vous avez démarré le débogage d'un processus. Cependant, ils seront conservés entre les exécutions.

1. Sélectionnez Tester pour déboguer le processus.
   
   

   

   
   
   Une activité est en cours d'exécution à chaque fois qu'une étape est exécutée. Vous pouvez interagir avec le diagramme. Consultez les onglets Piste d'exécution (Execution trail) et Variables globales (Global variables) pour plus de détails.
   

   

   
   
2. Sélectionnez Revenir au mode de conception pour quitter le débogage.
3. Sélectionnez Tester étape par étape (Test step-by-step) pour manipuler la variable path afin de tester la route B.
4. Sélectionnez Étape suivante (Next step) pour déplacer l'exécution vers l'événement de capture intermédiaire Délai (Delay time).
5. Mettez à jour la valeur de démarrage manuel de la variable path sur B dans l'onglet Variables globales .
   
   

   

   
   

   Remarque : en raison d’un problème connu, il n’existe aucun indicateur visuel pour aider à faire la distinction entre les variables d’entrée et de sortie portant le même nom lors du débogage. Lorsque vous voyez les deux dans la liste, l'entrée passera avant la sortie. Vous devez modifier la première, qui est l'entrée, et non la sortie, qui aura une valeur nulle.
6. Sélectionnez Mettre à jour 1 les variables (Update 1 variables) , puis Mettre à jour les variables (Update variables) dans la boîte de dialogue pour valider les modifications.
7. Sélectionnez Continuer (Continue) pour terminer l'exécution.
   Une activité est en cours d'exécution à chaque fois qu'une étape est exécutée. Vous pouvez interagir avec le diagramme. Consultez les onglets Piste d'exécution (Execution trail) et Variables globales (Global variables) pour plus de détails. Cette fois, le processus suit la route B.
   

   

   
   
8. Sélectionnez Revenir au mode de conception pour quitter le débogage.

Vous avez maintenant entièrement débogué votre premier processus.

Publier, déployer et démarrer un processus

1. Sélectionnez Publier (Publish) pour publier le processus d'agent.
   1. Choisissez Flux d’espace de travail personnel Orchestrator (Orchestrator Personal Workspace Feed) dans le champ Emplacement .
   2. Sélectionnez Publier ( Publish).
   
   

   

   
   

   Remarque : Les processus publiés dans un flux d'espace de travail personnel Orchestrator sont automatiquement déployés, mais ceux publiés dans un flux de locataire ou de dossier doivent toujours être déployés dans Orchestrator en tant qu'étape distincte.
2. Accédez à Orchestrator.
3. Accédez à Mon espace de travail (My Workspace).
4. Accédez à l'onglet Automatisations et recherchez Simple.Process dans la liste Processus .
   
   

   

   
   
5. Sélectionnez Démarrer une tâche pour l'entrée Simple.Process .
6. Sélectionnez Démarrer.
   
   

   

   
   

Vous avez maintenant entièrement publié, déployé et démarré votre premier processus.

Gérer un processus d'agent

1. Accédez au service Maestro .
2. Sélectionnez Processus simple (Simple Process) dans la liste des processus afin d'ouvrir la vue Toutes les instances (All instances) pour votre processus.
   Astuce : Vous pouvez également utiliser le champ de recherche pour filtrer la liste si nécessaire.
3. Sélectionnez la dernière instance pour ouvrir la visionneuse d'instances.
   Vous pouvez voir le processus exécuté en direct à travers chaque étape.
   

   

   
   

   Sélectionnez l'arrière-plan du modèle pour vérifier les variables globales et l'historique des actions, ainsi que la piste d'exécution. Sélectionnez une étape dans le modèle ou la piste d'exécution pour inspecter les détails et les variables de cette étape d'exécution.

Vous avez maintenant entièrement géré votre premier processus.

Arrêter et réparer un processus

Dans cette procédure, nous allons provoquer un échec de l’exécution afin d’utiliser la gestion des instances pour se rétablir.

1. Accédez à Orchestrator.
2. Accédez à Orchestrator.
3. Accédez à Mon espace de travail (My Workspace).
4. Accédez à l'onglet Automatisations et recherchez Simple.Process dans la liste Processus .
   
   

   

   
   
5. Sélectionnez Démarrer une tâche pour l'entrée Simple.Process .
6. Remplacez la valeur de la variable path par C.
   
   

   

   
   
7. Sélectionnez Démarrer.
8. Accédez àMaestro.
9. Sélectionnez Processus simple (Simple Process) dans la liste des processus afin d'ouvrir la vue Toutes les instances (All instances) pour votre processus.
10. Sélectionnez la dernière instance pour ouvrir la visionneuse d'instances.
    Le processus est dans un état d'échec au niveau du chemin d'accès ? passerelle exclusive.
    

    

    
    
    

    

    
    
11. Sélectionnez l' option Quel chemin ? l'étape de passerelle exclusive pour vérifier l'erreur Aucun flux sortant pour la passerelle (No outgoing flow for gateway) .
    Cette erreur est prévue car il n'existe aucune configuration pour path == "C".
    

    

    
    
12. Sélectionnez la première étape dans le panneau Statut et étape pour afficher les variables globales.
    
    

    

    
    
13. Mettez à jour la deuxième valeur de sortie Démarrage manuel (Manual Start) (deuxième ligne) pour la variable path sur A pour suivre une condition configurée.
    
    

    

    
    
14. Sélectionnez Mettre à jour les variables 1 (Update 1 variables) pour mettre à jour la variable.
15. Ajoutez un commentaire dans le champ Commentaire (Comment ) à des fins d'audit.
    
    

    

    
    
16. Sélectionnez Réessayer.
17. Ajoutez un commentaire et sélectionnez Réessayer l’instance (Retry instance) pour réessayer l’étape avec la nouvelle variable et terminer l’instance.
    
    

    

    
    
18. Consultez l'onglet Historique des actions (Action history) pour afficher la piste d'audit de vos modifications.

Vous avez corrigé avec succès une instance endommagée.

Migrer entre les versions d'un processus

La logique de flux de processus telle qu'elle existe actuellement n'est pas suffisamment robuste pour gérer tous les scénarios de chemin d'accès. Vous résolvez ce problème en publiant une nouvelle version du processus. Cette version mise à jour s’adaptera efficacement non seulement aux nouvelles instances de processus, mais rectifiera également les instances problématiques existantes. Pour vous assurer de gérer efficacement tous les scénarios où path n'est pas égal A, modifiez la route B en une route Pas A.

Dans cette procédure, vous provoquerez un échec dans l'exécution afin de la corriger avec une nouvelle version.

1. Accédez à Orchestrator.
2. Accédez à Mon espace de travail (My Workspace).
3. Accédez à l'onglet Automatisations et recherchez Simple.Process dans la liste Processus .
4. Sélectionnez Démarrer une tâche pour l'entrée Simple.Process .
5. Remplacez la valeur de la variable path par C.
   
   

   

   
   
6. Sélectionnez Démarrer.
7. Accédez à Studio et ouvrez Processus simple (Simple Process).
8. Sélectionnez l' option Quel chemin ? passerelle exclusive.
9. Remplacez le libellé B par Pas A et la condition par vars.path != A.
   
   

   

   
   
10. Remplacez le nom de la tâche B Task par Pas une tâche (Not A Task).
11. Remplacez l'événement de fin Fin B (End B) par Fin N'est pas A (End Not A).
12. Sélectionnez Publier (Publish) pour publier le projet.
    1. Choisissez Flux d’espace de travail personnel Orchestrator (Orchestrator Personal Workspace Feed) dans le champ Emplacement .
    2. Sélectionnez Publier ( Publish).
13. Accédez àMaestro.
14. Sélectionnez Processus simple (Simple Process) dans la liste des processus afin d'ouvrir la vue Toutes les instances (All instances) pour votre processus.
15. Sélectionnez la dernière instance pour ouvrir la visionneuse d'instances.
    Le processus est dans un état d'échec au niveau du chemin d'accès ? passerelle exclusive.
16. Sélectionnez Migrer pour migrer le processus.
    1. Sélectionnez la Version cible (Target version) pour le processus que vous venez de publier.
       Dans le contexte de cet exemple, il doit s'agir de la version 1.0.1.
    2. Fournir un commentaire.
    3. Sélectionnez Migrer l'instance (Migrate instance).
    
    

    

    
    
17. Sélectionnez Réessayer pour réessayer l'étape avec la nouvelle variable.
    1. Fournir un commentaire.
    2. Sélectionnez Réessayer l'instance.
    
    

    

    
    
18. Consultez l'onglet Historique des actions (Action history) pour afficher la piste d'audit de vos modifications.

Vous avez migré avec succès une instance endommagée vers une nouvelle version du processus.