Skip to main content
O Workflow Canvas é um editor visual drag-and-drop para desenhar workflows no Flowker. Ele oferece uma superfície interativa onde você pode adicionar, conectar e configurar nodes para definir o fluxo de execução dos seus processos automatizados.

​
Acessando o Canvas

O canvas abre automaticamente ao criar ou editar um workflow. Navegue até Flowker → Workflows e crie um novo workflow ou clique em Editar Workflow em um já existente.

​
Noções básicas do canvas

O canvas oferece as seguintes interações:
  • Pan — clique e arraste o fundo do canvas para se mover.
  • Zoom — use a roda de rolagem ou o gesto de pinça para aproximar e afastar.
  • Select — clique em um node para selecioná-lo e visualizar o seu resumo.
  • Configure — dê um duplo clique em um node para abrir o painel de configuração do lado direito.
  • Connect — arraste do handle de saída de um node até o handle de entrada de outro para criar uma conexão.
  • Delete — selecione um node ou conexão e pressione a tecla delete, ou use o menu de contexto.

​
Tipos de node

Workflows do Flowker são compostos por quatro tipos de node, cada um com um papel distinto no fluxo de execução.

​
Trigger

O node Trigger define o evento que inicia o workflow. Um workflow ativo precisa ter pelo menos um trigger node; um workflow em draft pode ficar vazio ou sem trigger enquanto você o desenha, mas as validações de salvamento no nível dos nodes continuam sendo aplicadas. Ao dar um duplo clique em um trigger node, o painel Configurar Trigger abre com os seguintes campos: Após selecionar o tipo de trigger, campos de configuração adicionais podem aparecer, dependendo do schema do trigger. Para o trigger de webhook, esses campos são o path, o método e o contrato de entrada — veja Configurando um trigger de webhook para saber o que cada contrato aceita. Para o trigger de schedule, esses campos são a expressão cron, o fuso horário e o flag enabled — veja Executando um workflow em um agendamento. Tipos de trigger disponíveis:
Os tipos de trigger são carregados do catálogo do Flowker e podem variar conforme a configuração do seu ambiente. A lista acima reflete os triggers disponíveis por padrão.

​
Chamada de Executor

O node Chamada de Executor executa operações específicas chamando executors registrados no catálogo do Flowker. Cada executor representa uma integração pré-construída com produtos Lerian ou serviços externos. Ao dar um duplo clique em um executor call node, o painel Configurar Executor Call abre. Seus dois primeiros campos formam uma cascata: a configuração de provider que você escolhe primeiro decide quais executors o segundo campo oferece. Após selecionar um executor, campos de configuração adicionais aparecem de acordo com o schema do executor (ex.: parâmetros de mapeamento de dados). Executors disponíveis:
Os executors são carregados do catálogo do Flowker e podem variar com OPENAPI_NATIVE_PROVIDERS, a política de fixtures e a resolução bem-sucedida de providers e especificações. A tabela é ilustrativa; consulte o catálogo em execução para ver os executors disponíveis na sua implantação.
A configuração do node é validada tanto localmente quanto remotamente (pelo backend do Flowker) contra o JSON Schema do executor do catálogo antes de ser salva. Caso a configuração seja inválida, uma mensagem de erro aparecerá no painel.

​
Condicional

O node Condicional ramifica o workflow com base em condições avaliadas em runtime. Um conditional node contém uma condição estruturada composta de cases. Cada case tem uma ou mais regras e direciona a execução para o seu próprio caminho de saída quando corresponde; os cases são avaliados em ordem, e o primeiro case que corresponder vence. Um caminho default opcional captura execuções que não correspondem a nenhum case — assim, um conditional node tem uma conexão de saída por case, mais o caminho default quando habilitado. Ao dar um duplo clique em um conditional node, o painel de configuração abre com o construtor de condições visual, onde você define os cases e as regras dentro de cada case (o valor a avaliar, um operador de comparação e o valor contra o qual comparar).
Workflows salvos com uma expressão de condição de texto livre legada mantêm os caminhos de saída true/false originais. Novos condicionais usam o construtor de condições.
Use rótulos de case e nomes de node descritivos (ex.: “High Value Check”) para manter o workflow legível.

​
Ação

O node de Ação executa 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 o output final da execução — útil como passo terminal de um workflow, especialmente com respostas síncronas de webhook. Os valores do output suportam referências ${...} resolvidas contra o contexto do workflow (por exemplo, ${workflow.<campo>} para o payload do trigger, ou ${execution.id}). Para workflows disparados por um webhook síncrono, um node set_output também pode carregar um responseStatusCode (inteiro, 200–599) para sobrescrever o status HTTP da resposta sync.

​
Configurando nodes

Para configurar qualquer node, dê um duplo clique nele no canvas. Um painel de configuração desliza pelo lado direito. Cada tipo de node tem seu próprio layout de painel:
  • Trigger — campo Nome + dropdown de tipo de trigger + campos específicos do schema do trigger.
  • Chamada de Executor — dropdown de provider + dropdown de executor + nome preenchido automaticamente + campos específicos do schema do executor.
  • Condicional — campo Nome + o construtor de condições visual (cases e regras).
  • Ação — campo Nome + a configuração do output de set_output.
Depois de preencher a configuração, clique em Save & Close para aplicar as alterações e voltar ao canvas.

​
Conexões

Conexões definem a ordem em que os nodes são executados. Cada conexão é um edge direcionado que vai da saída de um node até a entrada de outro.
  • Um node pode ter várias conexões de saída (ex.: conditional nodes têm uma por case, mais o caminho default quando habilitado).
  • Um node pode receber input de várias origens.
  • Conexões circulares (loops) não são suportadas.
Mantenha seus workflows legíveis organizando os nodes da esquerda para a direita ou de cima para baixo. Use nomes descritivos nos nodes para deixar claro o que cada passo faz.