Nó de CRUD

Um nó de CRUD (Create, Read, Update, Delete) executa operações diretas na base de dados do sistema. Ele permite criar, consultar, atualizar ou deletar registros automaticamente durante a execução do fluxo.

Ações do CRUD

Criação (create)

O nó de Criação executa a ação de inserir um novo registro na base de dados. Ele utiliza os dados mapeados nos campos do modelo para gerar dinamicamente um novo registro na entidade selecionada.

Configuração do Create

• Nome do Nó (Obrigatório): Identificação única do nó no fluxo.
• Tipo / Categoria de Referência (Obrigatório): Selecione a categoria que servirá como alvo da ação (ex: "Contratos").
• Ação (Obrigatório): Selecione "Criar".
• Campos do Modelo / Mapeamento (Obrigatório): Mapeie os campos que serão preenchidos automaticamente.

Saída do Nó

O nó de create terá como saída os dados do item criado.

Ler um item (readOne)

O nó de Leitura recupera os dados de um registro específico da base de dados, localizando-o a partir dos parâmetros definidos.

Configuração do ReadOne

• Nome do Nó (Obrigatório)
• Tipo (Obrigatório)
• Ação (Obrigatório): Selecione "ReadOne".
• Parâmetros (Obrigatório): Mapeie os campos usados para localizar o item (ex: ID ou CPF).

Saída do Nó

Retorna os dados do item localizado a partir dos parâmetros definidos.

Ler múltiplos itens (readMany)

(Funcionalidade em breve) — Permitirá a recuperação de uma lista de registros baseada em filtros para uso no fluxo.

Atualização (update)

Modifica um registro existente na base de dados. O fluxo localiza o item de referência e atualiza seus campos com os valores definidos no mapeamento.

Configuração do Update

• Nome do Nó (Obrigatório)
• Tipo (Obrigatório)
• Ação (Obrigatório): Selecione "Atualizar".
• Item de referência: Selecione qual item pré-existente no fluxo será atualizado.
• Campos do Modelo (Obrigatório): Mapeie os novos valores dos campos.

Saída do Nó

Retorna os dados do item com os valores já atualizados.

Exclusão (delete)

Executa uma exclusão lógica do item. O sistema não apaga o registro permanentemente de imediato, mas altera seu status para inativo e registra a data da ação.

• Recuperação: O item pode ser reativado em até 30 dias.
• Definitivo: Após 30 dias, o item pode ser excluído permanentemente conforme as regras do sistema.

Configuração do Delete

• Nome do Nó, Tipo e Ação.
• Item de referência: Selecione o item que será removido.

Saída do Nó

• Mensagem: Confirmação da execução.
• Referência do Item: Identificação do item removido.
• Excluído em: Data e hora da exclusão.

Mapeamento de Campos e Variáveis Aninhadas

Para as ações de Criar e Atualizar, o sistema permite o uso de variáveis dinâmicas e o tratamento de estruturas complexas.

Uso de Variáveis

Para preencher campos com dados de outros nós, abra a aba Entrada, localize o dado e arraste-o para o campo correspondente. A chave da variável será inserida automaticamente.

Campos Aninhados (Ex: Endereço)

Campos estruturados possuem agrupamentos internos. Você tem duas formas de mapeá-los:

1. Mapeamento Individual: Arraste subcampos específicos (ex: apenas o CEP) para preencher campos de texto simples.
2. Mapeamento Agrupado: Arraste uma variável de endereço inteira diretamente para o título de um campo de endereço no mapa. O sistema preencherá automaticamente todos os subcampos compatíveis.