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 :

• Agentic process project configuration is currently tenant-bound. Make sure that you remain in the same tenant between editing sessions.
• Agentic process project configuration currently supports only one business process (.bpmn) file. Although you can add multiple files to the project, this leads to unexpected issues for both debugging and publishing.

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.
   You can also start by creating a new Agentic Process in 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.
   
   
   
   
   Validation errors are shown in the lower-left corner of the canvas.
   

   

   
   
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 (Insérer la variable) pour trouver et insérer la variable de sortie Manual start (Démarrage manuel) 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 fichier BPMN pour l'utiliser dans d'autres projets en cliquant avec le bouton droit sur le nom du fichier .bpmn.

Déboguer un processus

You can configure breakpoints by hovering over the upper left of an element and selecting Click to add a breakpoint. Currently, breakpoints can only be set once you start debugging a process. However, they are retained between runs. Read about debugging and breakpoints.

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. Accédez aux sections Piste d'exécution et Variables/Incidents globaux pour afficher des détails supplémentaires.
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 ( Publish).
2. Choisissez l' Emplacement et sélectionnez Publier.
   
   
   
   
3. Read Publishing and upgrading agentic processes for the steps to publish to 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 afficher les Variables globales et l'Historique des actions, ainsi que la Piste d'exécution. Vous pouvez cliquer sur un nœud du modèle ou sur le traçage Exécution pour inspecter les Détails et les variables de cette étape d'exécution.

   Félicitations ! Vous avez désormais entièrement géré votre premier processus.

   Cesser notre processus pour que vous puissiez le corriger !

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 path variable. 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 l'étape de la passerelle exclusive Quel chemin ? Étape de la passerelle pour afficher l'erreur Aucun flux sortant pour la passerelle, ce qui est normal car nous n'avons aucune configuration 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.
    Remarque : Vous devrez peut-être actualiser la page pour voir l'instance s'exécuter.
    
    
    
    
    
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 Non A et 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 la visionneuse d'instances. Vous verrez que le processus est dans un état d'échec à la passerelle Quel chemin ?.
   Remarque : Vous devrez peut-être cliquer sur le bouton Actualiser de la liste pour afficher 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 s'exécuter.
   
   
   
   
   
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 :