Regras de Migração

Regras de migração são um tipo de regra que é executada quando uma versão de App Builder é instalado em um servidor. As regras de migração são configuradas na área Business SQL da camada de lógica de negócios.

Regras de migração são usadas para manipular ou limpar dados em um aplicativo existente e também são usadas para migrar dados após executar uma alteração de esquema. Regras de migração permitem que um usuário modifique um banco de dados usando as ações Cram, Delete, Insert ou Update. Regras de migração são definidas de forma semelhante a uma Regra CRUD e executadas no ambiente de desenvolvimento. Regras de migração (diferentemente de Regras CRUD) são adicionadas às etapas de gerenciamento de alterações que são executadas em ordem ao enviar um LP para um novo ambiente. App Builder registra a regra e a executa durante uma atualização.

As regras de migração devem ser específicas para uma Execução. Se você precisar executar regras de migração semelhantes duas vezes, a melhor prática é criar uma nova regra para a segunda execução. Quando você Executa uma regra de migração (ou seja, clica no botão Executar para uma regra de migração), App Builder tira um instantâneo da Regra e a incorpora no changeset. Nada será adicionado ao changeset até que a Regra de Migração tenha sido Executada. Após Executar a Regra, a Regra de Migração pode ser excluída.

Tutorial de Regras de Migração

Notas Importantes Sobre Regras de Migração

As regras de migração não suportam Enum
O XP CRUD não é suportado para regras de migração
Os dados não podem ser migrados de/para colunas criptografadas usando uma regra de migração. Os desenvolvedores devem usar regras de negócios CRUD para mover dados de/para colunas criptografadas.
Atualmente, você não pode modificar uma regra CRUD para torná-la uma regra de migração. Se você fizer isso, ela não será acionada.

Ações de Regras de Migração

A Ação selecionada para uma Regra de Migração é baseada no que a Regra pretende fazer. As opções de ação são:

Cram – insere registros distintos/únicos com base nos campos marcados como Chaves Primárias
Excluir – exclui Colunas de uma Tabela
Inserir – cria Colunas dentro de uma Tabela
Atualizar – atualiza Colunas dentro de uma Tabela

Crie uma Regra de Migração para Abarrotar Dados

Navegue até App Workbench > Rules
Confirme se a App Data Source selecionada é onde você deseja adicionar a Rule
Clique em + Rule
Atribua um Name para a Migration Rule. Por exemplo: EventDate (EventDate Migration)
Selecione Migration como Purpose
Defina a Action como Cram
Defina o Target para a Table a ser atualizada. Por exemplo: EventDate
Clique em Save
Clique em + Tables e traga a tabela Target. Por exemplo: EventDate
No painel Columns adicione a Primary Key, a Expression para descrever o que está sendo atualizado, junto com o Target que é a coluna de destino para a Expression
Dependendo da sua Rule, você pode precisar de lógica adicional definida
Clique em Validate e verifique se as informações estão conforme o esperado (sem erros)

Crie uma Regra de Migração para Excluir Dados

Navegue até App Workbench > Rules
Confirme se a App Data Source selecionada é onde você deseja adicionar a Rule
Clique em + Rule
Atribua um Name para a Migration Rule. Por exemplo: Contact (Delete Orphaned Contacts)
Selecione Migration como Purpose
Defina a Action como Delete
Defina o Target para a Table a ser atualizada. Por exemplo: Contact
Clique em Save
Clique em + Table e traga a tabela Target
No painel Columns adicione a Primary Key, a Expression para descrever o que está sendo atualizado, junto com o Target que é a coluna de destino para a Expression.

Importante

A Chave Primária deve ser mapeada com um Alvo para que as Regras de Exclusão funcionem, ou então a Regra excluirá tudo na Tabela.
Clique em Validar e verifique se as informações estão conforme o esperado (sem erros)

Crie uma Regra de Migração para Inserir Dados

Regras de migração com o tipo de ação Inserir podem criar novas colunas dentro de uma tabela. Todos os campos obrigatórios para a tabela onde uma nova coluna está sendo criada devem ser mapeados da tabela de origem.

Navegue até App Workbench > Rules
Confirme se a fonte de dados do aplicativo selecionada é onde você deseja adicionar a regra
Clique em + Rule
Atribua um Nome para a regra de migração. Por exemplo: Sessão (Inserir sessão)
Selecione Migração como o Propósito
Defina a ação como Inserir
Defina o Destino para a tabela a ser atualizada. Por exemplo: Sessão
Clique em Salvar
Clique em + Tabela e traga a tabela Destino
No painel Colunas insira a Expressão para descrever o que está sendo inserido, junto com o Destino que é a Coluna de destino para a Expressão
Clique em Validar e verifique se as informações estão conforme o esperado (sem erros)

Crie uma Regra de Migração para Atualizar Dados

Navegue até App Workbench > Rules
Confirme se a App Data Source selecionada é onde você deseja adicionar a Rule
Clique em + Rule
Atribua um Name para a Migration Rule. Por exemplo: Reach (AuditID Migration)
Selecione Migration como Purpose
Defina a Action como Update
Defina o Target para a Table a ser atualizada. Por exemplo: Reach
Clique em Save
Clique em + Table e traga a tabela Target
No painel Columns adicione a Primary Key, a Expression para descrever o que está sendo atualizado, junto com o Target que é a coluna de destino para a Expression
Clique em Validate e verifique se as informações estão conforme o esperado (sem erros)