ID d’instance personnalisée

Remplacez le libellé d’instance généré par le système par une valeur dynamique et lisible par un humain dérivée des données d’exécution, telles qu’un numéro de commande ou le nom du client.

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é

Pour configurer un ID d'instance personnalisé, définissez l'expression dans les propriétés de l'événement de démarrage avant de publier le processus.

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.
• Searching and filtering instances by custom instance ID in Insights, and Process Mining is not yet supported.