maestro
latest
false
Important :
La localisation du contenu nouvellement publié peut prendre 1 à 2 semaines avant d’être disponible.
UiPath logo, featuring letters U and I in white

Guide de l'utilisateur de Maestro

Dernière mise à jour 19 mai 2025

Exécuter un processus simple

Dans cet exemple, vous allez implémenter un processus agentique simple qui vous montrera les fonctionnalités principales de Maestro permettant de 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 semblable à celui de l'image suivante :

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.
Remarque : la configuration du projet de processus agentique 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, tant lors du débogage que de la publication.

Modéliser un processus

Commencez tout d'abord par modéliser le processus de bout en bout, puis configurez les composants.
  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'arrivée de Maestro, sélectionnez Get Started (Commencer).
    Conseil : vous pouvez également commencer par créer un nouveau processus agentique dans Studio Web.
    Votre nouveau processus agentique s'ouvre.
  4. Dans l'angle supérieur gauche de l'interface de conception, sélectionnez Get Started (Commencer).
  5. Renommez le projet Projet simple et le processus Processus simple.


  6. Fermez l'explorateur de projet.
  7. Sélectionnez l'élément Start Event (Événement de démarrage) sur le canevas pour afficher la barre d'outils des éléments. Choisissez Add: Text annotation (Ajouter : annotation textuelle) dans la barre d'outils des éléments.
  8. Sélectionnez l'élément Start Event (Événement de démarrage) et choisissez Add : Intermediate event (Ajouter : événement intermédiaire) dans la barre d'outils des éléments.
    1. Double-cliquez sur l'élément intermédiaire pour le renommer. Renommez-le Retard.
      Conseil : vous pouvez également utiliser le champ Name (Nom) de l'onglet Propriétés situé à droite de l'écran pour renommer un élément.
    2. Transformez l'événement intermédiaire Retard en événement intermédiaire de capture de minuterie (Timer intermediate catch event).


  9. Sélectionnez l'événement intermédiaire de capture de minuterie Retard et choisissez Add: Exclusive gateway (Ajouter : passerelle exclusive).
    1. Nommez la passerelle exclusive Quel chemin ?.
  10. Sélectionnez la passerelle exclusive Quel chemin ? et choisissez Add: Task (Ajouter : tâche).
    1. Nommez la tâche Une tâche.
    Conseil : alors que vous dessinez et configurez votre processus, des erreurs de validation s'affichent sur le canevas. Sélectionnez Hide validation errors (Masquer les erreurs de validation) dans le menu Tools (Outils) situé dans l'angle supérieur droit si vous souhaitez masquer ces visualisations


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


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


  13. Sélectionnez Une tâche et choisissez Add: End event (Ajouter : événement de fin) dans la barre d'outils des événements.
    1. Nommez l'événement Fin A.
    Conseil : la meilleure pratique consiste à créer une fin explicite pour votre processus. Pour déterminer rapidement le chemin suivi par votre processus et une fin explicite pour chacun d'eux.
  14. Sélectionnez Tâche B et choisissez Add: End event (Ajouter : événement de fin) dans la barre d'outils des événements.
    1. Nommez l'événement de fin Fin B.


Implémenter un processus

Suivez cette procédure pour ajouter des fonctionnalités au processus créé dans la section Modéliser un processus.
  1. Sélectionnez l'élément Start event (Événement de début) et renommez-le Démarrage manuel.
  2. Sélectionnez Add new (Ajouter nouveau) dans la section Inputs (Entrées) de l'onglet Propriétés.


  3. Créez la nouvelle variable comme suit :
    • Name (Nom) : chemin
    • Type : chaîne de caractères
    • Value (Valeur) : A


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


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


    2. Utilisez Insérer variable (Insérer la variable) pour trouver et insérer la variable de sortie Manual start (Démarrage manuel) path.
    3. Définissez la valeur égal à "A".
    4. Sélectionnez Enregistrer (Save).


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


    Conseil : 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 configuré correctement. Étant donné que la valeur par défaut de la variable path est définie sur A, le processus doit passer par Tâche A et Fin A.
Placez votre curseur sur l'angle supérieur gauche d'un élément et sélectionnez Click to add a breakpoint (Cliquez pour ajouter un point d'arrêt) pour configurer des points 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 seront conservés entre les exécutions.

  1. Sélectionnez Test (Tester) pour déboguer le processus.


    Une animation s'exécute lors de l'exécution de chaque étape. Vous pouvez interagir avec le diagramme. Consultez les onglets Execution trail (Piste d'exécution) et Global variables (Variables globales) pour obtenir d'autres détails.

  2. Sélectionnez Back to design mode (Retour au mode de conception) pour quitter le débogage.
  3. Sélectionnez Test step-by-step (Tester étape par étape) pour manipuler la variable path afin de tester la route B.
  4. Sélectionnez Next step (Étape suivante) pour passer à l'exécution de l'événement intermédiaire de capture de minuterie Retard.
  5. Mettez à jour la valeur Manual start (Démarrage manuel) de la variable path sur B dans l'onglet Global variables (Variables globales).


    Attention : en raison d'un problème connu, aucun indicateur visuel ne permet de distinguer 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 précède 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 Update 1 variables (Actualiser 1 variable), puis Update variables (Actualiser les variables) dans la boîte de dialogue pour valider les modifications.
  7. Sélectionnez Continue (Continuer) pour terminer l'exécution.
    Une animation s'exécute lors de l'exécution de chaque étape. Vous pouvez interagir avec le diagramme. Consultez les onglets Execution trail (Piste d'exécution) et Global variables (Variables globales) pour obtenir d'autres détails. Cette fois, le processus suit la route B.

  8. Sélectionnez Back to design mode (Retour au mode de conception) pour quitter le débogage.
Vous avez maintenant complètement débogué votre premier processus.

Publier, déployer et démarrer un processus

  1. Sélectionnez Publish (Publier) pour publier le processus agentique.
    1. Choisissez Orchestrator Personal Workspace Feed (Flux d'espace de travail personnel Ochestrator) dans le champ Location (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 dans le cadre d'une étape distincte.
    Remarque : dans les nouveaux locataires, la configuration par défaut ne fournit qu'un robot dans l'espace de travail personnel. Si vous exécutez votre premier processus dans un dossier normal (pas votre espace de travail personnel), une configuration supplémentaire est nécessaire.
    Pour exécuter la tâche dans un autre dossier, vous devez :
    1. Créer et affecter un robot (utilisateur ou sans assistance) à ce dossier.
    2. Vérifier que votre utilisateur ou votre machine dispose des autorisations et des licences de runtime requises.

    Pour de plus amples informations sur la configuration des robots et des dossiers, consultez la section Gérer des tâches dans Orchestrator.

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


  5. Sélectionnez Start a Job (Démarrer un travail) pour l'entrée Simple.Process.
  6. Sélectionnez Démarrer.


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

Gérer un processus agentique

  1. Accédez au service Maestro.
  2. Sélectionnez Simple Process (Processus simple) dans la liste des processus pour ouvrir la vue All instances (Toutes les instances) de votre processus.
    Conseil : vous pouvez également utiliser le champ de recherche pour filtrer la liste, le cas échéant.
  3. Sélectionnez la dernière instance pour ouvrir la visionneuse d'instances.
    Vous pouvez visualiser l'exécution de chaque étape du processus en direct.

    Sélectionnez l'arrière-plan du modèle pour vérifier les variables globales (Global variables) et l'historique des actions (Action History), ainsi que la piste d'exécution (Execution trail). Sélectionnez une étape du modèle ou de 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.

Rompre et corriger 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.
  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 Start a Job (Démarrer un travail) pour l'entrée Simple.Process.
  5. Remplacez la valeur de la variable path par C.


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



  10. Sélectionnez l'étape de la passerelle exclusive Quel chemin ? pour examiner l'erreur No outgoing flow for gateway (Aucun flux sortant pour la passerelle).
    Cette erreur est attendue, car path == "C" n'est pas configuré.

  11. Sélectionnez la première étape dans le panneau Status & Step (Statut et étape) pour afficher les variables globales (Global variables).


  12. Mettez à jour la deuxième valeur de sortie Manual start (Démarrage manuel) (deuxième ligne) de la variable path définie sur A afin de suivre une condition configurée.


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


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


  17. Accédez à l'onglet Action history (Historique des actions) pour consulter la piste d'audit de vos modifications.
Vous avez corrigé avec succès une instance défectueuse.

Migrer entre les versions d'un processus

La logique actuelle du flux du processus n'est pas suffisamment robuste pour gérer tous les scénarios de cheminement. 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 Start a Job (Démarrer un travail) 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 le processus Simple Process (Processus simple).
  8. Sélectionnez la passerelle exclusive Quel chemin ?.
  9. Remplacez l'étiquette B par Not A (Non A) et la condition par vars.path != A.


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


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


  18. Accédez à l'onglet Action history (Historique des actions) pour consulter la piste d'audit de vos modifications.
Vous avez réussi à migrer une instance défectueuse vers une nouvelle version du processus.

Cette page vous a-t-elle été utile ?

Obtenez l'aide dont vous avez besoin
Formation RPA - Cours d'automatisation
Forum de la communauté UiPath
Uipath Logo White