Mover dados de configuração entre ambientes e organizações com a ferramenta de Migração de Configuração

A ferramenta de Migração de Configuração permite que você mova dados de configuração entre ambientes e organizações. Os dados de configuração são usados para definir a funcionalidade personalizada em aplicativos de Customer Engagement (Dynamics 365 Sales, Dynamics 365 Customer Service, Dynamics 365 Field Service, Dynamics 365 Marketing e Dynamics 365 Project Service Automation) e normalmente são armazenados em entidades personalizadas. Os dados de configuração são diferentes dos dados de usuário final (contas, contatos etc.). Um exemplo típico de dados de configuração são definidos no Unified Service Desk para Dynamics 365 para configurar um aplicativo do agente de call center personalizado. As entidades do Unified Service Desk, juntamente com os dados de configuração que são armazenados nas entidades, definem um agente do aplicativo. Para mais informações sobre Unified Service Desk, consulte Guia do Unified Service Desk.

A ferramenta Migração de Configuração permite:

• Selecionar as entidades e os campos onde você deseja exportar os dados de configuração.

• Evite registros duplicados no sistema de destino definindo uma condição de exclusividade para cada entidade com base em uma combinação de campos na entidade, que é usada para fazer uma comparação com os valores de destino no sistema. Se não houver valores correspondentes, um registro único será criado no sistema de destino. Se um registro correspondente for encontrado, o registro é atualizado no sistema de destino.

  Nota

  Se nenhuma condição de detecção de duplicidades (exclusividade) é especificada para uma entidade que está sendo exportada, a ferramenta usa o nome do campo principal da entidade para fazer uma comparação com os dados existentes no sistema de destino.

• Desabilitar plug-ins antes de exportar dados e reabilitar no sistema de destino depois que a importação estiver concluída para todas as entidades ou as entidades selecionadas.

• Valide o esquema para as entidades selecionadas para serem exportados para garantir que todos os dados necessários/informações estão presentes.

• Reutilizar um esquema existente para exportar dados de um sistema de origem.

• Move automaticamente os campos data/hora na importação para ambientes de demonstração.

• Inserir módulos exportados criados essa ferramenta (esquema e arquivos de dados) em outros programas. Por exemplo, você pode usar os dados exportados no Package Deployer com outros arquivos e dados de solução para criar e implantar pacotes em uma instância de um ambiente. Mais Informações: Implantar pacotes usando Package Deployer

A ferramenta Configuration Migration está disponível como um Pacote NuGet ou é possível baixar a ferramenta usando a CLI da Power Platform.

Como a ferramenta Migração de Configuração funciona?

O diagrama a seguir ilustra como a ferramenta Migração de Configuração é usada para migrar dados de configuração.

Defina o esquema dos dados de origem a serem exportados: O arquivo de esquema (.xml) contém informações sobre os dados que você deseja exportar, como entidades, atributos, relacionamentos, definição de exclusividade dos dados e se os plug-ins devem ser desabilitados antes de exportar os dados. Mais informações: Criar um esquema para exportar dados de configuração

Use o esquema para exportar dados: Use o arquivo de esquema para exportar os dados para um arquivo .zip que contém os dados e o esquema dos dados exportados. Mais informações: Criar um esquema para exportar dados de configuração

Importar os dados exportados: Use os dados exportados (arquivo .zip) para importar para o ambiente de destino. A importação de dados é feita em várias etapas para importar primeiro os dados da fundação enquanto coloca em fila os dados dependentes e importa os dados dependentes nas etapas subsequentes para lidar com qualquer dependência ou vínculo de dados. Isso garante uma importação de dados limpa. Mais informações: Importar dados de configuração

Solucionar problemas de migração de dados usando arquivos de log

A ferramenta de Migração de Configuração oferece suporte ao registro em log a fim de obter informações detalhadas sobre erros que podem ocorrer ao entrar no ambiente usando a ferramenta, atividades executadas pela ferramenta durante a definição do esquema e a exportação/importação de dados de configuração e informações sobre os dados importados com a ferramenta. There são três arquivos de log gerados pela ferramenta que estão disponíveis no seguinte local no computador onde você executa a ferramenta: c:\Users\<UserName>\AppData\Roaming\Microsoft\Microsoft Dataverse Configuration Migration Tool\<Version>.

• Login_ErrorLog.log: Fornece informações sobre os problemas que ocorreram quando você usou a ferramenta para efetuar login no ambiente. Se houver problemas durante a entrada, uma mensagem aparece na tela de logon da ferramenta com um link para este arquivo de log. A mensagem indica que um erro ocorreu ao processar a solicitação de logon e o usuário pode exibir o log de erros. Você pode clicar no link na mensagem para exibir este arquivo de log. O arquivo de log é criado na primeira vez que você encontra qualquer problemas de logon na ferramenta. Depois disso, o arquivo de log é usado para registrar as informações sobre problemas de login, sempre que ocorrerem.

• DataMigrationUtility.log: Fornece informações detalhadas sobre cada tarefa executado na ferramenta durante a última execução. Você pode exibir o arquivo de log da ferramenta clicando no menu Logs na tela principal e em Log em Execução.

• ImportDataDetail.log: Fornece informações detalhadas sobre os dados importados no último trabalho de importação usando a ferramenta. Sempre que você executar um trabalho de importação com essa ferramenta, os detalhes existentes do arquivo de log são movidos para um arquivo chamado ImportDataDetail.log no mesmo diretório e o arquivo ImportDataDetail.log exibe as informações sobre a última importação realizada com a ferramenta. Você pode exibir o arquivo de log da ferramenta clicando no menu Logs na tela principal e em Log da Última Importação.

Práticas recomendadas para migrar os dados de configuração com a ferramenta

Estes são fatores que devem ser considerados ao usar essa ferramenta para migrar os dados de configuração:

• Ao criar o esquema de exportação de dados, é necessário definir as regras de exclusividade adequadamente para cada entidade para evitar qualquer atualização involuntária de dados no sistema de destino.

• Importe os dados exportados em um ambiente de pré-produção (preferência uma imagem espelhada do ambiente de produção) para garantir que os resultados da importação de dados sejam aqueles pretendidos.

• Faça backup do ambiente de produção antes de importar os dados.

Limitações

• A migração da entidade Calendário não é compatível.
• Não há suporte para migração da coluna Imagem.

Confira também

Baixe ferramentas de NuGet
Crie um esquema para exportar dados de configuração
Modificar um esquema de dados de configuração
Importar dados de configuração
Gerenciar configuração do catálogo de produtos