Conectores e Condicionais

Os Conectores são as arestas (edges) que ligam as etapas no Editor Visual, estabelecendo o fluxo de execução e a transição de estado entre os runners.

Quando um runner é executado com sucesso, a Engine aciona o mecanismo de resolução de caminhos para calcular qual é o próximo nó a ser processado no pipeline.

Mecânica de Resolução de Caminhos

A Engine não executa scripts em conectores. A escolha do destino é calculada a partir de duas estruturas possíveis de transição de etapa:

┌────────────────────────────────────────────────────────────────────────┐
│                      MECÂNICA DE TRANSIÇÃO DE ETAPA                    │
└───────────────────────────────────┬────────────────────────────────────┘
                                    │
            ┌───────────────────────┴───────────────────────┐
            ▼                                               ▼
┌──────────────────────────────────────┐  ┌──────────────────────────────────────┐
│       1. CAMINHO ÚNICO (PADRÃO)      │  │        2. CAMINHOS CONDICIONAIS      │
│  - Apensas 1 destino possível        │  │  - Múltiplos destinos mapeados       │
│  - Sem regra de avaliação atrelada   │  │  - Avaliação estruturada por regras  │
│  - Transição direta e incondicional  │  │  - Regra: Exatamente 1 deve ser TRUE │
└──────────────────────────────────────┘  └──────────────────────────────────────┘

Tipos de Transição

1. Transição por Caminho Único (Caminho Padrão)

Comportamento: A etapa possui apenas um conector de saída mapeado e este não está configurado para avaliação de regra.
Execução: A Engine segue diretamente para a próxima etapa sem executar nenhuma checagem ou interpolação lógica adicional.

2. Transição por Caminho Condicional (Regras Estruturadas)

Comportamento: A etapa possui mais de um destino possível. Cada conector de saída possui uma regra fixa de avaliação configurada no formulário visual.
Execução: A Engine avalia a expressão de todos os conectores associados àquela saída.
Regra do Único Válido: Exatamente um conector deve ser avaliado como true.
Tratamento de Exceções:
Se nenhum conector for avaliado como verdadeiro ou se múltiplos conectores forem avaliados como true simultaneamente, a Engine lança uma exceção de roteamento e interrompe a sessão de execução.

Estrutura das Regras de Avaliação

Em vez de código livre, os conectores condicionais utilizam uma estrutura guiada composta por três elementos:

1. Atributo de Avaliação

A variável ou propriedade a ser inspecionada no contexto, declarada via sintaxe de interpolação (ex: ${dados.idade}, ${entrada.body.tipoPessoa}, ${historico.buscaCliente.status}).

2. Operação

O operador lógico fixo selecionado no formulário.

3. Valor Comparado

O valor estático ou dinâmico utilizado como referência para a comparação (quando aplicável).

Operações Disponíveis no Formulário

Operação	Descrição	Exemplo de Aplicação
`Igual a`	Valida se o atributo possui valor exatamente idêntico ao esperado.	`${entrada.body.tipoPessoa}` igual a `'JURIDICA'`
`Diferente de`	Valida se o atributo possui valor distinto do esperado.	`${historico.pagamento.status}` diferente de `'RECUSADO'`
`Maior que`	Valida se o valor numérico do atributo é estritamente maior.	`${dados.idade}` maior que `18`
`Menor que`	Valida se o valor numérico do atributo é estritamente menor.	`${dados.valorTotal}` menor que `100.00`
`Nulo`	Valida se o atributo é `null` ou inexistente no contexto.	`${historico.buscaEndereco.body}` nulo
`Não Nulo`	Valida se o atributo foi preenchido e está presente no contexto.	`${entrada.headers['x-token']}` não nulo