Accès aux variables dans tous les sous-processus

Dans les workflows BPMN de Maestro, les sous-processus fournissent un moyen structuré d'encapsuler la logique et de réutiliser des parties d'un processus. Pour garantir un flux de données fluide entre les activités et entre les sous-processus, Maestro utilise un modèle de portée similaire à la portée lexicale dans les langages de programmation.

Cette section explique comment les variables sont accessibles au sein et entre les sous-processus, qu'il s'agisse de transmettre des données entre les activités d'un même sous-processus, de rendre visibles les sorties internes à un processus parent ou de récupérer des valeurs de variables lors du débogage et du runtime.

Accès aux entrées d'un sous-processus

Pour accéder à la sortie d'une activité précédente dans le même sous-processus, aucune configuration supplémentaire n'est nécessaire.

Exemple : si une activité foo définit une variable de sortie appelée foo_op, et qu'une activité ultérieure bar existe dans le même sous-processus, bar peut la référencer foo_op directement.

Règle clé : les variables définies dans une activité sont accessibles à toute activité en aval dans le même sous-processus, y compris les éléments imbriqués. Vous n'avez pas à les transmettre explicitement en tant qu'entrées de sous-processus.

Exposition des sorties d'un sous-processus

Lorsqu'un processus parent a besoin d'accéder aux données de sortie d'une activité dans un sous-processus imbriqué, vous pouvez exposer ces données à l'aide de l'une des deux approches suivantes.

Approche 1 : utilisation de variables de sortie

1. Dans le sous-processus interne, définissez une variable de sortie, par exemple inner_sp_op, et attribuez-lui la valeur de la sortie de l'activité interne (bar_op).
2. Dans le sous-processus externe (ou processus parent), définissez une autre variable de sortie, par exemple outer_sp_op, et attribuez-lui la valeur de la sortie du sous-processus interne (inner_sp_op).
3. Les activités en aval (par exemple, qux) dans le processus parent peuvent désormais utiliser outer_sp_op.

Approche 2 : utilisation de variables d'événement de fin

1. Dans le sous-processus interne, configurez l’événement de fin pour déclarer une variable de sortie telle que ee_inner_op, et attribuez-lui la valeur de bar_op.
2. Dans le sous-processus externe, configurez l’événement de fin correspondant pour déclarer une variable de sortie telle que ee_outer_op, et attribuez-lui la valeur de ee_inner_op.
3. L’activité qux dans le processus parent peut désormais utiliser ee_outer_op.

Conseil : les variables d'événement de fin se propagent automatiquement vers l'étendue parente sans nécessiter une configuration distincte des variables de sortie.

Vérification des variables de sous-processus

Vous pouvez inspecter les valeurs des variables au temps de conception (via l'API de débogage) ou lors du runtime (via l'API d'instance) pour vérifier la portée et la propagation des données.

API de débogage - Affichage des variables

GET /v1/debug-instances/{instanceId}/variables?parentElementId=outer_subprocess

Variables disponibles :

• foo_op
• inner_subprocess_op
• ee_outer_op

GET /v1/debug-instances/{instanceId}/variables?parentElementId=inner_subprocess

Variables disponibles :

• bar_op
• ee_inner_op

API de runtime - Affichage des variables

GET /v1/instances/{instanceId}/variables?parentElementId=outer_subprocess

Variables disponibles :

• foo_op
• inner_subprocess_op
• ee_outer_op

GET /v1/instances/{instanceId}/variables?parentElementId=inner_subprocess

Variables disponibles :

• bar_op
• ee_inner_op