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

| 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 e o contrato de entrada. Veja [Configurando um gatilho de webhook](/pt/products/flowker/configuring-a-webhook-trigger) 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](/pt/products/flowker/running-a-workflow-on-a-schedule).

Os tipos de gatilho disponíveis incluem:

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

<Note>
  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.
</Note>

### 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](/pt/products/flowker/console/providers-overview), 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 a organização ainda não tem 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](/pt/products/flowker/connecting-your-own-api).                                                                                                                                                                     |
| **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 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.
</Note>

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

<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.
</Note>

<Tip>
  Use rótulos de caso e nomes de nó descritivos (por exemplo, "High Value Check") para manter o workflow legível.
</Tip>

### 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](/pt/products/flowker/integration-guide#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.
</Tip>