Conceitos

Poucos conceitos explicam tudo no NEXUS Flow. Vale ler antes de montar o primeiro fluxo.

Fluxo

Um fluxo é a automação que você monta: um conjunto de passos ligados, com um ponto de partida (o gatilho) e um ou mais caminhos até o resultado. Cada fluxo tem um nome, pode ser ativado ou desativado pelo interruptor Ativo / Inativo na barra do editor, e guarda o histórico das suas execuções.

Nó (passo)

Cada caixa do fluxo é um nó — um passo que faz uma coisa. Há nós que iniciam o fluxo (gatilhos) e nós que agem sobre os dados (editar campos, decidir um caminho, chamar uma API, enviar um e-mail, gravar no RM...). Você liga um nó ao outro arrastando uma conexão entre eles.

Item

O item é a unidade de informação que percorre o fluxo — pense numa "linha" ou num "registro". Um fluxo normalmente trabalha com vários itens ao mesmo tempo: se uma consulta retorna 50 linhas, são 50 itens, e os passos seguintes agem sobre cada um deles.

Porta

Alguns nós têm mais de uma saída (porta), e você liga cada uma a um caminho diferente. O nó IF (condição), por exemplo, tem as saídas true (os itens que atendem à condição) e false (os demais). Os nós que falam com sistemas externos costumam ter success e error. O editor mostra, ao lado de cada saída, quantos itens passaram por ela.

Expressão

Sempre que um campo do nó precisar de um valor que vem dos dados, escreva uma expressão entre chaves duplas. É assim que quase todo campo aproveita o que os passos anteriores produziram:

{{ $json.NOME }}          o campo NOME do item que está passando
{{ $json.VALOR * 1.1 }}   contas, comparações e condições
{{ $now }}                o momento da execução

Você não precisa digitar tudo: na aba Parâmetros do nó, os campos do item que chegou aparecem como etiquetas para arrastar até o campo que está preenchendo, e o editor mostra o resultado enquanto você escreve. Veja O editor.

Gatilho

O gatilho é o nó que dá a partida e define quando o fluxo roda: no clique de Executar, em horários agendados, ao receber uma chamada de outro sistema, ao encontrar registros novos no TOTVS RM ou no Data Lake, ao chegar uma marcação de acesso, quando outro fluxo falha, quando um assistente de IA pede, ou quando um sistema da LBHM avisa de um acontecimento. Todo fluxo começa por um gatilho — veja Gatilhos para escolher o seu.

Execução

Cada vez que o fluxo roda é uma execução. Ela registra o horário de início e de fim, a duração, o resultado de cada passo e a situação:

Uma execução pendente ou em andamento pode ser cancelada. Acompanhe tudo em Execuções.

Credencial

Para falar com sistemas externos (RM, APIs, banco, e-mail), o fluxo usa uma credencial cadastrada uma vez e reaproveitada pelos nós. Os dados sensíveis ficam guardados de forma cifrada. Veja Credenciais.