Criar/Alterar Registro

1. Geral

O passo “Criar/Alterar Registro” permite adicionar novos registros ou modificar registros existentes em um cadastro específico. Ele é ideal para operações de inserção e atualização de dados de forma automatizada e controlada.

2. Configuração Inicial

Escolha do Cadastro: Primeiro, selecione o cadastro onde os registros serão criados ou alterados. Esse cadastro determina a estrutura dos dados que serão manipulados.

Método de Transformação: Escolha entre utilizar uma query SQL ou uma das views no-code do Mitra (VIEW de Análise de Dados ou VIEW de Cadastro) para definir os dados que serão processados.

3. Definição da Chave de Alteração

Chave de Alteração: Decida se os registros afetados serão novos ou se você deseja alterar registros existentes.

Opções de Chave:

• ID: Use o ID como chave para identificar e modificar registros específicos. Esta opção é obrigatória para cadastros com ID inteiro ou varchar.

• Descrição: Como alternativa, você pode utilizar a descrição como chave de alteração, dependendo da estrutura do seu cadastro.

4. Mapeamento de Atributos

Após definir a query ou a view que retornará os dados, você precisará mapear as colunas do resultado aos atributos do cadastro selecionado.

Mapeamento de Colunas: As colunas da sua query ou view serão listadas, e você poderá associá-las aos atributos correspondentes do cadastro. Por exemplo, se você estiver manipulando o cadastro “Parceiros”, com atributos como “ID”, “Descrição”, “Valor Mensalidade”, e “Data de Entrada”, você pode mapear cada coluna do resultado para o atributo correspondente.

Importante:

• Adição de Membros em Cadastros com ID Auto-Incremental: Para cadastros com ID auto-incremental, o campo “ID” não será mapeável, pois o sistema gerará o ID automaticamente.

• Adição de Membros em Cadastros com ID Inteiro ou Varchar: Nesses casos, o “ID” deve ser fornecido e mapeado obrigatoriamente.

• Edição de Membros Existentes: Quando a chave de alteração for o “ID”, será necessário mapear o campo “ID” do cadastro específico para garantir que os registros corretos sejam alterados.

5. Log de Execução

O passo “Criar/Alterar Registros” possui um log detalhado que acompanha todas as execuções, incluindo:

• Usuário Executor: Quem iniciou a ação.

• Data e Hora: Quando a ação foi executada.

• Tempo de Execução: Duração da operação.

• Resumo: Mostra o que foi aceito ou rejeitado durante o processo.

• Motivos das Rejeições: Detalha por que certos registros não foram processados, permitindo correções e ajustes.