Executar Fluxo de Trabalho

• Tipo de Tarefa: runworkflow

A tarefa Executar Fluxo de Trabalho é um componente fundamental para a criação de processos complexos e modulares. A sua função é lançar a execução de um Fluxo de Trabalho "filho" a partir de um Fluxo de Trabalho "pai", permitindo passar dados e parâmetros do pai para o filho.

Esta abordagem permite:

• Reutilizar lógicas complexas: Um Fluxo de Trabalho que executa uma operação comum (ex: recuperar dados do utilizador) pode ser criado uma vez e chamado por muitos outros Fluxos de Trabalho.
• Simplificar diagramas: Divide um processo monolítico e complexo em subprocessos mais pequenos, simples e fáceis de manter.
• Gerir fluxos de trabalho em paralelo ou em sequência: Iniciar uma automação secundária após o término de uma primária.

Configuração

A configuração da Tarefa é dividida em duas áreas principais.

1. Fluxo de Trabalho a Executar

• Filtrar Fluxos de Trabalho: Permite filtrar a lista de Fluxos de Trabalho a serem iniciados.
• Fluxo de Trabalho a Executar: Permite selecionar o Fluxo de Trabalho "filho" a ser iniciado. A lista mostra todos os fluxos de trabalho disponíveis com base nas permissões do utilizador.

2. Configuração de Parâmetros

Esta secção gere a troca de dados entre o Fluxo de Trabalho pai e o Fluxo de Trabalho filho. Os parâmetros disponíveis nesta área derivam exclusivamente dos parâmetros declarados no Fluxo de Trabalho filho: apenas os parâmetros previamente definidos no Fluxo de Trabalho filho podem ser preenchidos nesta secção.

Para cada parâmetro, é possível especificar:

• Parâmetro: Indica o nome do parâmetro tal como foi definido no Fluxo de Trabalho filho. O nome não é modificável e serve para garantir a correta associação do valor passado.
• Tipo: Mostra o tipo de dado do parâmetro (ex: String, Number, Boolean, etc.), coerente com a definição no Fluxo de Trabalho filho.
• Valor: Define o valor que será passado para o parâmetro no momento do início do Fluxo de Trabalho filho. O valor pode ser preenchido manualmente (ex: 123, "Errore") ou através de parâmetros e variáveis do fluxo de trabalho.

Parâmetros de Saída

Os Parâmetros de Saída da Tarefa são:

• targetWorkflow: Retorna o nome do Fluxo de Trabalho "Filho" que foi executado.
• result: Retorna uma mensagem de texto que descreve o resultado da operação de início do Fluxo de Trabalho filho.
• resultJson: Representa o resultado da execução da tarefa em formato JSON, incluindo informações gerais, configurações e detalhes da execução.
• resultJsonTarget: Representa o resultado da execução do Fluxo de Trabalho filho em formato JSON, incluindo informações gerais, configurações e detalhes da execução. Este parâmetro permite reutilizar os dados processados pelo Fluxo de Trabalho filho dentro do Fluxo de Trabalho pai. O conteúdo JSON pode ser consultado através da Tarefa Consulta JSONPath ou utilizado pela Tarefa JSON para Tabela para escrever os dados numa tabela de um base de dados.

Notas Importantes

Apenas podem ser executados os fluxos de trabalho que não estejam bloqueados em edição no momento da execução. Se um utilizador estiver a editar o fluxo de trabalho filho quando o pai tentar iniciá-lo, a operação pode falhar.

Exemplo resultJson

{
  "run_info": {
    "status": "Completed",
    "run_result": "Success"
  },
  "output_parameters": {
    "exitStatus": "0"
  }
}