Um workflow não precisa de nós Final para funcionar. Se você não declarar saídas, o workflow termina como sempre e o nó Workflow que o invoca continua se comportando como um salto simples.
O que é uma saída
Uma saída é o contrato de término do workflow. Cada saída tem:Tipos de saída
Sucesso
O workflow termina como bem-sucedido.
Erro
O workflow termina como falho, em uma falha controlada.
Neutro
O workflow termina sem ser marcado como bem-sucedido nem como falho.
Criar uma saída
Você pode criar uma saída pelo Gerenciador de saídas ou diretamente pelo painel de um nó Final. Você precisa de permissão de escrita no canvas.1
Abra o formulário
No nó Final, abra o seletor Output e clique em Criar output. Se o workflow ainda não tem saídas, o painel mostra a mensagem “Este workflow ainda não tem outputs” com o mesmo botão.Você também pode abrir o Gerenciador de saídas pelo menu da barra superior do canvas e clicar em Criar output.
2
Preencha os dados gerais
Escreva o Nome e a Variável, escolha o Tipo de saída (Sucesso, Erro ou Neutro) e adicione a Descrição. A variável é sugerida automaticamente a partir do nome até você editá-la.
3
Defina os dados que devolve
Em Dados que devolve você tem dois modos:
- Campos: adicione uma linha por dado com Adicionar variável. A variável é o caminho que o pai vai ler (por exemplo,
pedido.total) e o nome é o rótulo visível dela (por exemplo, “Total do pedido”). - JSON: cole um JSON de exemplo e cada chave vira um campo. Os valores do exemplo não são salvos.
4
Salve
A saída fica disponível para todos os nós Final do workflow e aparece imediatamente nos nós Workflow que o referenciam. Se você a criou a partir de um nó Final, ela é atribuída a esse nó automaticamente.
A variável deve ser única no workflow e não pode conter espaços nem pontos. Além disso, o esquema precisa de pelo menos um dado, e cada dado deve ter caminho e nome.
Usar o nó Final no canvas
1
Arraste o nó
No painel de nós, abra o grupo Final e arraste o nó para o canvas.
2
Escolha a saída
Clique no nó para abrir o painel e selecione uma saída em Output. A lista agrupa as saídas por tipo (Sucesso, Erro e Neutro) e permite buscá-las pelo nome. O nó assume a cor do tipo dessa saída e mostra o nome dela e a quantidade de dados que devolve. Enquanto você não escolher nenhuma, ele aparece como Final.
3
Conecte a rota
Conecte ao nó Final cada ramificação que deva terminar com essa saída. Vários nós Final podem apontar para a mesma saída.
Detalhe da saída no painel
Ao selecionar uma saída, o painel mostra a ficha dela com:- Nome e tipo, com o botão Editar output para modificá-la sem sair do nó.
- Descrição da saída.
- Variável, com um botão para copiá-la.
- Valor, que indica qual nó escreve o valor da saída (veja abaixo).
- Dados que devolve, com a quantidade de dados e um seletor para vê-los como JSON ou como Lista. Logo abaixo, é indicado como eles são lidos no workflow que chama.
- Uso, que indica se a saída é usada só neste nó ou em vários nós Final.
Escrever o valor da saída
Os dados que uma saída devolve são escritos com$output.set em um nó Código, API ou SOAP:
Nó Código
Gerenciar as saídas
Abra o Gerenciador de saídas pelo menu da barra superior do canvas, pelo botão Gerenciar outputs do painel do nó Final ou pelo menu ⋮ do workflow na barra lateral. A partir dali você pode:- Ver todas as saídas do workflow com a quantidade total.
- Reordenar as saídas arrastando-as ou com o teclado. A ordem é salva e define como as saídas aparecem no nó Workflow do pai.
- Localizar uma saída no canvas com o ícone de localização, que indica em quantos nós Final ela é usada ou se não é usada.
- Editar ou excluir cada saída pelo menu dela.
- Visualizar como fica o nó Workflow em outro workflow, com uma saída para cada output e a cor do tipo dela.
Consumir as saídas no workflow pai
Quando um workflow declara saídas, o nó Workflow que o referencia as desenha como pontos de conexão, um por saída:- Conecte cada saída à ramificação correspondente no workflow pai.
- As variáveis do esquema ficam disponíveis no seletor de variáveis do pai como
$memory.response.<variável>. Por exemplo, um esquema com a variáveltotalé lido como{{$memory.response.total}}.
Excluir uma saída
Antes de confirmar, a janela de exclusão mostra quais nós Final serão removidos no canvas atual, com o nó que os precede (“Final depois de «Código»”) ou como “Final sem conexão”. Os nós Final que usam a saída em outros canais do mesmo workflow também são removidos. A plataforma também verifica se algum workflow do projeto tem essa saída conectada no nó Workflow dele:- Se algum usar, a exclusão é bloqueada. A mensagem informa quais workflows a têm conectada: desconecte a rota em cada um e tente de novo.
- Se nenhum usar, a saída é excluída junto com os nós Final que a tinham selecionada e as rotas que chegavam a eles.
A validação olha a conexão, não a referência: um nó Workflow que aponta para este workflow mas não tem essa saída conectada não bloqueia a exclusão.
Testar o workflow no Tester
Quando o nó Workflow tem saídas conectadas, o workflow filho é executado dentro da execução do pai: o pai espera que ele termine e continua pela saída que o filho tomou. No Tester isso aparece de duas formas:- Suas respostas são enviadas ao workflow filho enquanto ele estiver em andamento.
- O nó não mostra o botão “Ir para o workflow” nem o separador de início de execução, porque não se trata de uma execução à parte para visitar.
Próximos passos
Nó Workflow
Invoca outro workflow e continua pela saída que ele tomou.
Nó Código
Escreve o valor de uma saída com
$output.set.