Dados e lógica

Estes nós trabalham os items que passam pelo fluxo — sem falar com sistemas externos. São a "cola" entre o gatilho e as ações.

Editar campos (Set)

Define ou altera campos de cada item. Use para montar a informação do jeito que o próximo passo precisa — renomear, calcular ou preencher um valor. Os campos aceitam placeholders ({{ … }}) com valores do próprio item.

Cada campo tem nome, tipo e valor:

• Tipo decide o formato do valor: Texto, Número, Booleano, Lista, Objeto ou Auto (deduz pelo resultado da expressão). Ex.: marcar Número garante que {{ quantidade }} vire um número de verdade, não texto.
• Nome aninhado (dot-notation): escreva cliente.endereco.cep para gravar um campo dentro de outro; itens[0].nome grava dentro de uma lista. Pode desligar para usar o nome literal.
• Ativar/desativar um campo sem apagá-lo (útil para testes).

Manter os campos de entrada controla o que sai do nó: Todos (mescla os novos sobre o item), Nenhum (só os campos definidos aqui), Apenas os listados ou Todos exceto os listados — ótimo para limpar a saída.

Para transformações maiores há o modo JSON: você escreve o objeto inteiro de uma vez (com {{ … }} por dentro) e o nó o monta para cada item.

IF (condição)

Separa os items em dois caminhos — as saídas true (os que atendem à condição) e false (os demais) — conforme uma condição (igual, diferente, contém, maior, menor, vazio…). Ligue cada saída a um trecho diferente do fluxo.

Switch (rotear)

Como o IF, mas com vários caminhos: você define casos (ex.: status = "aprovado", "pendente", "recusado") e cada item segue pela porta do caso que casar, ou pela porta padrão.

Filtrar

Mantém apenas os items que casam uma condição e descarta o resto. Útil para seguir só com o que interessa.

Limite

Mantém apenas os primeiros N items. Bom para amostras ou para conter o volume.

Ordenar

Ordena os items por um campo, crescente ou decrescente, como texto ou número.

Agregar

Junta todos os items num só (uma lista). Opcionalmente, coleta um campo específico de cada item num único campo de destino — por exemplo, transformar 50 items em uma lista de 50 e-mails.

Separar lista (Split Out)

O contrário do Agregar: quando um campo do item guarda uma lista, este nó transforma cada elemento dela num item próprio — por exemplo, desdobrar as equipes de um chamado em um item por equipe. Informe o Campo (lista) (aceita cliente.equipes); quando o elemento não é um objeto, ele vai para o campo que você indicar em Nome do campo. Marque Manter os demais campos do item para levar o resto do item junto em cada elemento.

Item sem esse campo, com lista vazia ou com valor que não é lista não gera saída.

Merge (juntar)

Junta items de caminhos diferentes num fluxo só. Pode simplesmente concatenar tudo, ou mesclar por uma chave (combinar registros que compartilham o mesmo identificador).

Loop Over Items (lotes)

Processa os items em lotes do tamanho que você escolher em Tamanho do lote. O nó tem duas saídas: loop, que roda o trecho ligado a ela uma vez por lote, e done, que segue com todos os items depois que os lotes acabam. Cada lote completa o ciclo inteiro antes de o próximo começar — bom para não empurrar milhares de registros de uma vez sobre um sistema externo.

JSON → XML

Converte o item (ou um campo dele) em XML e grava o resultado num campo de saída. Escolha a Entrada (JSON), o Elemento raiz, o Campo de saída e, se o destino exigir, marque para incluir a declaração <?xml ?>. Útil para montar o conteúdo que um sistema legado espera.

No-Op

Não faz nada — apenas repassa os items. Útil para organizar o desenho do fluxo ou como ponto de junção.

Data Lake (gravar e ler)

Guardam e recuperam items num armazenamento interno do NEXUS Flow — sem banco externo. O gravar acumula (ou atualiza) linhas num dataset; o ler traz de volta os items guardados (com filtro, ordem e limite). É a base para compartilhar dados entre fluxos e acumular histórico. Veja a página do Data Lake.

Há ainda o Data Lake (SQL), para consultar os seus datasets escrevendo a consulta você mesmo — juntar dados de vários datasets, somar e agrupar. No campo da consulta há o botão Gerar com IA: descreva em português o que você quer, revise o que ele propõe e insira no editor.

Para agir sobre os dados (chamar uma API, gravar, enviar e-mail), veja os nós de ação e os nós do TOTVS RM.