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 et lisible par un humain, telle qu'un numéro de commande ou un nom de client, dérivée des données reçues par le processus lors du runtime.

L'ID d'instance personnalisée s'affiche directement dans la liste d'instances, afin que vous puissiez identifier pourquoi une instance s'est exécutée et pour quelle valeur, sans ouvrir l'instance.

Prérequis

• Un processus agentique ouvert dans le canevas Maestro.
• Le processus comporte un événement de démarrage.

Configuration d'un ID d'instance personnalisé

1. Sélectionnez l'événement de début sur le canevas.

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ébut 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 : saisissez une valeur de texte fixe.

4. Publiez le processus.

Résultat

Lorsqu'une instance s'exécute, Maestro évalue l'expression Custom Instance ID après la fin de l'événement de démarrage et affiche le résultat sous forme de nom d'instance dans la liste d'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ée s'affiche comme vide jusqu'à ce que la valeur soit disponible.

Limitations

• Vous pouvez configurer des ID d'instance personnalisés uniquement lors des événements de démarrage. Les ID d'instances personnalisées sont évalués une seule 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 instance management and Insights is not yet supported.