UiPath Documentation
maestro
latest
false

Guide de l'utilisateur de Maestro

Dernière mise à jour 5 mai 2026

ID d’instance personnalisée

Vue d'ensemble (Overview)

Par défaut, Maestro identifie chaque instance de processus par un ID généré par le système. Un ID d’instance personnalisé vous permet de remplacer ce libellé par une valeur dynamique lisible par un humain, telle qu'un numéro de commande ou un nom de client, dérivée des données que le processus reçoit lors du runtime.

L’ID d’instance personnalisé est affiché directement dans la liste des instances afin que vous puissiez identifier la raison pour laquelle une instance s’est exécutée et pour quelle valeur, sans ouvrir l’instance.

Prérequis

  • Un processus agentique s'ouvre dans la zone de dessin Maestro.
  • Le processus a un événement de démarrage.

Configuration d’un ID d’instance personnalisé

  1. Sélectionnez l’événement de début sur la zone de dessin.

  2. Dans le panneau Propriétés, accédez à la section Général.

  3. Dans le champ ID d'instance personnalisé, définissez la valeur à l'aide de l'une des options suivantes :

    • Variable : sélectionnez une variable d'événement de démarrage ou un argument d'entrée.
    • Expression : créez une expression qui combine des variables ou des formats de sortie, par exemple : string.Format("Order: {0}", vars.OrderId).
    • Littéral : entrez une valeur de texte fixe.
  4. Publiez le processus.

Résultat

Lorsqu'une instance s'exécute, Maestro évalue l'expression ID d'instance personnalisée après la fin de l'événement de démarrage et affiche le résultat en tant que nom d'instance dans la liste des instances.

Si l’expression fait référence à des variables qui ne sont pas encore résolues au moment de l’évaluation, l’ID d’instance personnalisé s’affiche comme vide jusqu’à ce que la valeur soit disponible.

Limitations

  • Vous pouvez configurer des ID d’instance personnalisés sur les événements de démarrage uniquement. Les ID d’instance personnalisés sont évalués une fois, immédiatement après l’exécution de l’événement de démarrage. Les valeurs définies sur les activités ou les événements de fin ne sont pas appliquées.
  • La recherche et le filtrage des instances par ID d'instance personnalisé dans la gestion des instances, Insights et Process Mining ne sont pas encore pris en charge.

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

Connecter

Besoin d'aide ? Assistance

Vous souhaitez apprendre ? UiPath Academy

Vous avez des questions ? UiPath Forum

Rester à jour