> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Editor de canvas

> Desenhe workflows no Flowker Canvas arrastando nós Trigger, Executor Call, Conditional e Action, depois conectando e configurando cada um deles.

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](https://docs.lerian.studio/pt/products/flowker/console/editing-a-workflow.md).

## 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:

| Campo | Descrição |
| - | - |
| **Nome** | Um rótulo descritivo para o gatilho (por exemplo, "Webhook Trigger"). |
| **Trigger** | Uma lista suspensa para selecionar qual tipo de gatilho usar. As opções são carregadas dinamicamente do catálogo do Flowker. |

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](https://docs.lerian.studio/pt/products/flowker/configuring-a-webhook-trigger.md) 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](https://docs.lerian.studio/pt/products/flowker/running-a-workflow-on-a-schedule.md).

| Gatilho | Descrição |
| - | - |
| **Webhook** | O workflow começa quando o Flowker recebe uma requisição HTTP externa no caminho e no método configurados. |
| **Agendamento** | O workflow começa em um agendamento por tempo definido por uma expressão cron padrão de 5 campos (granularidade mínima de 1 minuto), com um fuso horário IANA opcional (o padrão é UTC). |

### 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.

| Campo | Descrição |
| - | - |
| **Provider** | O primeiro campo, e o que define a conexão. Ele lista as configurações de provedor salvas na página [Providers](https://docs.lerian.studio/pt/products/flowker/console/providers-overview.md), cada uma mostrada pelo nome com o provedor de catálogo dela ao lado. Escolher uma vincula a etapa àquela conexão (a URL base e as credenciais dela) e restringe a lista suspensa **Executor** abaixo ao mesmo provedor. Quando ainda não existe configuração de provedor, a lista suspensa mostra **Nenhuma conexão ainda — crie uma em Flowker → Providers**. Um workflow não salva enquanto um nó de chamada de executor está sem configuração de provedor. |
| **Executor** | O segundo campo. Ele lista os executores de catálogo do provedor ao qual a configuração selecionada pertence, e fica desabilitado até você escolher um **Provider**, mostrando **Selecione um provider primeiro**. Quando a configuração selecionada foi montada a partir da sua própria spec OpenAPI, este campo é substituído por **Operação**, que lista as operações dessa spec. Veja [Conectando a sua própria API](https://docs.lerian.studio/pt/products/flowker/connecting-your-own-api.md). |
| **Nome** | Preenchido automaticamente com a categoria do executor depois da seleção, mas editável. |

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:

| Executor | Descrição |
| - | - |
| **Create Account** | Cria uma nova conta no Midaz. |
| **Create Transaction** | Cria uma nova transação no Midaz. |
| **Get Account** | Obtém os detalhes de uma conta no Midaz. |
| **Get Account Balance** | Obtém o saldo de uma conta específica. |
| **List Validations** | Lista as validações de transação do Tracer. |
| **Validate Transaction** | Valida uma transação pelas regras de risco do Tracer. |

> [!NOTE]
>
> 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).

> [!NOTE]
>
> 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.

> [!TIP]
>
> 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](https://docs.lerian.studio/pt/products/flowker/integration-guide.md#synchronous-response-mode).

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.

> [!TIP]
>
> 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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.