Pular para o conteúdo principal
O Workflow Canvas é um editor visual de arrastar e soltar para desenhar workflows no Flowker. É uma superfície interativa onde você pode adicionar, conectar e configurar nós para definir o fluxo de execução dos seus processos automatizados.

​
Acessando o canvas

O canvas abre quando você cria ou abre um workflow. Vá para Flowker → Workflows, depois crie um workflow novo ou clique no nome de um que já existe. Um workflow que não está em Rascunho abre somente para leitura até você clicar em Editar. Veja Editar um workflow.

​
Noções básicas do canvas

O canvas tem as seguintes interações:
  • Mover: clique e arraste no fundo do canvas para se deslocar.
  • Zoom: use a roda de rolagem ou o gesto de pinça para aproximar e afastar.
  • Selecionar: clique em um nó para selecionar ele.
  • Configurar: dê dois cliques em um nó para abrir o painel de configuração dele no lado direito.
  • Conectar: arraste do handle de saída de um nó até o handle de entrada de outro nó para criar uma conexão.
  • Excluir: selecione um nó ou uma conexão e pressione Delete ou Backspace. Você também pode clicar no ícone de lixeira de um nó ou no × de uma conexão.

​
Tipos de nó

Os workflows do Flowker têm quatro tipos de nó.

​
Nó Trigger

O nó Trigger define o evento que começa o workflow. Um workflow ativo deve ter pelo menos um nó de gatilho. Um workflow em rascunho pode ficar vazio ou não ter um gatilho enquanto você o desenha. A validação de salvamento no nível do nó continua valendo. Quando você dá dois cliques em um nó de gatilho, o painel Configurar Trigger abre com os seguintes campos: Depois de selecionar um tipo de gatilho, campos de configuração adicionais podem aparecer conforme o schema do gatilho. Para o gatilho de webhook, esses campos são o caminho, o método, o contrato de entrada, o modo de resposta, a visão de resposta e os headers aceitos. Veja Configurando um gatilho de webhook para saber o que cada contrato aceita. Para o gatilho de agendamento, são a expressão cron, o fuso horário, o flag de habilitado e os dados de entrada com que cada execução começa. Veja Rodando um workflow em um agendamento.

​
Nó Executor Call

Os nós Executor Call fazem operações específicas chamando executores registrados no catálogo do Flowker. Cada executor é uma integração pronta com produtos Lerian ou serviços externos. Quando você dá dois cliques em um nó de chamada de executor, o painel Configurar Executor Call abre. Os dois primeiros campos dele formam uma cascata: a configuração de provedor que você escolhe primeiro decide quais executores o segundo campo oferece. Depois de selecionar um executor, campos de configuração adicionais aparecem conforme o schema do executor (por exemplo, parâmetros de mapeamento de dados). Os executores disponíveis incluem:
Os executores vêm do catálogo do Flowker. A tabela é ilustrativa. Consulte o catálogo em execução para saber quais executores estão disponíveis no seu deploy.
Se a configuração for inválida, uma mensagem de erro vai aparecer no painel.

​
Nó Conditional

Os nós Conditional ramificam o workflow com base em condições avaliadas em tempo de execução. Um nó condicional guarda uma condição estruturada feita de casos. Cada caso tem uma ou mais regras e roteia a execução para o próprio caminho de saída quando corresponde. O nó condicional avalia os casos em ordem, e o primeiro caso que corresponde vence. Um caminho padrão opcional captura as execuções que não correspondem a nenhum caso. Então um nó condicional tem uma conexão de saída por caso, mais o caminho padrão quando habilitado. Quando você dá dois cliques em um nó condicional, o painel de configuração dele abre com o construtor de condições visual, onde você define os casos e as regras dentro de cada caso (o valor testado, um operador de comparação e o valor com que comparar).
Workflows salvos com uma expressão de condição legada em texto livre mantêm os caminhos de saída originais true/false. Condicionais novos usam o construtor de condições.
Use rótulos de caso e nomes de nó descritivos (por exemplo, “High Value Check”) para manter o workflow legível.

​
Nó Action

Os nós Action fazem uma ação no nível do workflow sem chamar um serviço externo. O tipo de ação disponível é set_output, que define a saída final da execução. Ele serve como etapa terminal de um workflow, principalmente com respostas síncronas de webhook. Os valores de saída aceitam referências ${...} resolvidas contra o contexto do workflow (por exemplo, ${workflow.<field>} para o payload do gatilho, ou ${execution.id}). Para workflows disparados por um webhook síncrono, um nó set_output também pode levar um responseStatusCode (inteiro, 200–599) para sobrescrever o status HTTP da resposta síncrona.

​
Configurando nós

Para configurar qualquer nó, dê dois cliques nele no canvas. Um painel de configuração desliza a partir do lado direito. Cada tipo de nó tem o próprio layout de painel:
  • Trigger: campo Nome + lista suspensa de tipo de gatilho + campos de schema específicos do gatilho.
  • Executor Call: lista suspensa Provider + lista suspensa Executor + nome preenchido automaticamente + campos de schema específicos do executor.
  • Conditional: campo Nome + o construtor de condições visual (casos e regras).
  • Action: campo Nome + a configuração de saída do set_output.
Depois de preencher a configuração, clique em Salvar & Fechar para aplicar as mudanças e voltar ao canvas.

​
Conexões

As conexões definem a ordem em que os nós executam. Cada conexão forma uma aresta direcionada da saída de um nó até a entrada de outro nó.
  • Um nó pode ter várias conexões de saída (por exemplo, nós condicionais têm uma por caso, mais o caminho padrão quando habilitado).
  • Um nó pode receber entrada de várias origens.
  • Conexões circulares (loops) não são aceitas.
Mantenha seus workflows legíveis organizando os nós da esquerda para a direita ou de cima para baixo. Use nomes de nó descritivos para deixar claro o que cada etapa faz.