Acessando variáveis entre subprocessos

Nos fluxos de trabalho BPMN do Maestro, os subprocessos fornecem uma maneira estruturada de encapsular a lógica e reutilizar partes de um processo. Para garantir um fluxo de dados sem interrupções entre as atividades e entre limites de subprocessos, o Maestro usa um modelo de escopo semelhante ao escopo léxico em linguagens de programação.

Esta seção explica como as variáveis são acessadas dentro e entre subprocessos — quer você precise passar dados entre atividades no mesmo subprocesso, expor saídas internas a um processo pai ou recuperar valores de variáveis durante a depuração e o runtime.

Acessando entradas dentro de um subprocesso

Para acessar a saída de uma atividade anterior dentro do mesmo subprocesso, nenhuma configuração adicional é necessária.

Exemplo: se uma atividade foo definir uma variável de saída chamada foo_op, e uma atividade subsequente bar existir no mesmo subprocesso, bar poderá fazer referência a foo_op diretamente.

Regra principal: as variáveis definidas em uma atividade são acessíveis a qualquer atividade subsequente dentro do mesmo subprocesso, incluindo elementos aninhados. Você não precisa passá-los explicitamente como entradas de subprocesso.

Exposição de saídas de um subprocesso

Quando um processo pai precisa de acesso aos dados de saída de uma atividade dentro de um subprocesso aninhado, você pode expor esses dados usando uma de duas abordagens.

Abordagem 1: uso de variáveis de saída

1. No subprocesso interno, defina uma variável de saída (por exemplo, inner_sp_op) e atribua a ela o valor da saída da atividade interna (bar_op).
2. No subprocesso externo (ou processo pai), defina outra variável de saída (por exemplo, outer_sp_op) e atribua a ela o valor da saída do subprocesso interno (inner_sp_op).
3. As atividades posteriores (por exemplo, qux) no processo pai agora podem fazer referência a outer_sp_op.

Abordagem 2: uso de variáveis de evento final

1. No subprocesso interno, configure o evento final para declarar uma variável de saída, como ee_inner_op, e atribua a ela o valor de bar_op.
2. No subprocesso externo, configure o evento final correspondente para declarar uma variável de saída, como ee_outer_op, e atribua a ela o valor de ee_inner_op.
3. A atividade qux no processo pai agora pode fazer referência a ee_outer_op.

Dica: as variáveis do evento final se propagam automaticamente para o escopo pai sem a necessidade de configuração de variáveis de saída separadas.

Inspecionando variáveis de subprocesso

Você pode inspecionar os valores das variáveis durante o momento de design (por meio da API de depuração) ou no runtime (por meio da API de instância) para verificar o escopo e a propagação de dados.

API de depuração - Visualizar variáveis

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

Variáveis disponíveis:

• foo_op
• inner_subprocess_op
• ee_outer_op

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

Variáveis disponíveis:

• bar_op
• ee_inner_op

API de runtime – Visualizar variáveis

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

Variáveis disponíveis:

• foo_op
• inner_subprocess_op
• ee_outer_op

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

Variáveis disponíveis:

• bar_op
• ee_inner_op