Acceder a variables en todos los subprocesos

En los flujos de trabajo BPMN de Maestro, los subprocesos proporcionan una forma estructurada de encapsular la lógica y reutilizar partes de un proceso. Para garantizar un flujo de datos fluido entre actividades y a través de los límites de subprocesos, Maestro utiliza un modelo de ámbito similar al ámbito léxico en lenguajes de programación.

Esta sección explica cómo se accede a las variables dentro de los subprocesos y a través de ellos: si necesitas pasar datos entre actividades en el mismo subproceso, exponer salidas internas a un proceso principal o recuperar valores de variables durante la depuración y el runtime.

Acceder a entradas dentro de un subproceso

Para acceder a la salida de una actividad anterior dentro del mismo subproceso, no se requiere ninguna configuración adicional.

Ejemplo: si la actividad foo establece una variable de salida llamada foo_op, y existe una actividad posterior bar en el mismo subproceso, bar puede hacer referencia a foo_op directamente.

Regla clave: las variables definidas en una actividad son accesibles para cualquier actividad posterior dentro del mismo subproceso, incluyendo los elementos anidados. No es necesario pasarlos explícitamente como entradas de subprocesos.

Exponer las salidas de un subproceso

Cuando un proceso principal necesita acceso a los datos de salida de una actividad dentro de un subproceso anidado, puedes exponer esos datos utilizando uno de dos enfoques.

Enfoque 1: uso de variables de salida

1. En el subproceso interno, define una variable de salida, por ejemplo inner_sp_op, y asígnale el valor de la salida de la actividad interna (bar_op).
2. En el subproceso externo (o proceso principal), define otra variable de salida, por ejemplo outer_sp_op, y asígnale el valor de la salida del subproceso interno (inner_sp_op).
3. Las actividades posteriores (por ejemplo, qux) en el proceso principal ahora pueden hacer referencia a outer_sp_op.

Enfoque 2: uso de variables de evento de final

1. En el subproceso interno, configura el evento de fin para declarar una variable de salida como ee_inner_op, y asígnale el valor de bar_op.
2. En el subproceso externo, configura el evento de salida correspondiente para declarar una variable de salida como ee_outer_op, y asígnale el valor de ee_inner_op.
3. La actividad qux en el proceso principal ahora puede hacer referencia a ee_outer_op.

Consejo: las variables de evento final se propagan automáticamente al ámbito principal sin necesitar una configuración de variable de salida independiente.

Inspección de variables de subproceso

Puedes inspeccionar los valores de las variables en tiempo de diseño (a través de la API de depuración) o en runtime (a través de la API de instancia) para verificar el ámbito y la propagación de datos.

API de depuración: ver 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: ver 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