Skip to main content
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 automaticamente quando você cria ou edita um workflow. Vá para Flowker → Workflows, depois crie um workflow novo ou clique em Editar workflow em um que já existe.

​
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 e ver o resumo dele.
  • 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 a tecla delete, ou use o menu de contexto.

​
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 e o contrato de entrada. 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 e o flag de habilitado. Veja Rodando um workflow em um agendamento. Os tipos de gatilho disponíveis incluem:
Os tipos de gatilho vêm do catálogo do Flowker e podem variar conforme a configuração do seu ambiente. A lista acima reflete os gatilhos disponíveis por padrão.

​
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 e podem variar conforme OPENAPI_NATIVE_PROVIDERS, a política de fixtures e a resolução bem-sucedida de provedor e especificação. A tabela é ilustrativa. Consulte o catálogo em execução para saber quais executores estão disponíveis no seu deploy.
A configuração do nó é validada local e remotamente (pelo backend do Flowker) contra o JSON Schema do executor de catálogo antes de salvar. 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.