Pular para o conteúdo principal
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 Fluxo 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 três 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. Todo workflow precisa ter pelo menos um trigger node. Ao dar um duplo clique em um trigger node, o painel Configurar Trigger abre com os seguintes campos:
CampoDescrição
NomeUm rótulo descritivo para o trigger (ex.: “Webhook Trigger”).
TriggerUm dropdown para selecionar qual tipo de trigger usar. As opções são carregadas dinamicamente a partir do catálogo do Flowker.
Após selecionar o tipo de trigger, campos de configuração adicionais podem aparecer, dependendo do schema do trigger. Tipos de trigger disponíveis:
TriggerDescrição
WebhookO workflow começa quando uma requisição HTTP externa é recebida em um endpoint gerado.
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 Chamada de Executor abre com os seguintes campos:
CampoDescrição
ExecutorUm dropdown para selecionar qual executor usar. As opções são carregadas dinamicamente a partir do catálogo do Flowker.
NomePreenchido automaticamente com a categoria do executor após a seleção, mas editável.
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:
ExecutorDescrição
Create AccountCria uma nova conta no Midaz.
Create TransactionCria uma nova transação no Midaz.
Get AccountRecupera detalhes de uma conta no Midaz.
Get Account BalanceRecupera o saldo de uma conta específica.
List ValidationsLista validações de transação do Tracer.
Validate TransactionValida uma transação pelas regras de risco do Tracer.
Os executors são carregados do catálogo do Flowker e podem variar conforme o seu ambiente e os produtos habilitados. A lista acima reflete os executors disponíveis por padrão com Midaz e Tracer.
A configuração do executor é validada tanto localmente (contra o schema do executor) quanto remotamente (pelo backend do Flowker) 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 uma expressão condicional. Ele avalia a expressão em runtime e direciona a execução para um de dois caminhos:
  • Caminho verdadeiro — seguido quando a condição é avaliada como verdadeira.
  • Caminho falso — seguido quando a condição é avaliada como falsa.
Ao dar um duplo clique em um conditional node, o painel Configurar Condicional abre com os seguintes campos:
CampoDescrição
NomeUm rótulo descritivo para o passo condicional.
CondiçãoUma expressão de texto livre que avalia dados de nodes anteriores.
Expressões condicionais usam notação de ponto para referenciar dados de passos anteriores do workflow. Exemplos:
ExpressãoDescrição
data.amount > 1000Verifica se o valor é maior que 1000.
data.status == "approved"Verifica se o status é “approved”.
data.risk_score >= 80Verifica se o risk score é igual ou superior a 80.
Nodes condicionais têm sempre exatamente duas conexões de saída — uma para o true path e outra para o false path. Use nomes descritivos (ex.: “High Value Check”) para manter o workflow legível.

​
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 executor + nome preenchido automaticamente + campos específicos do schema do executor.
  • Condicional — campo Nome + área de texto para a expressão da condição.
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 é uma aresta direcionada 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 sempre têm duas).
  • 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.