Mover dados de configuração entre ambientes e organizações com a Configuration Migration Tool

A Configuration Migration Tool permite-lhe mover dados de configuração entre ambientes e organizações. Os dados de configuração são utilizados para definir a funcionalidade personalizada nas aplicações de interação com os clientes (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 de dados de utilizador final (contas, contactos, etc.) Um exemplo normal de dados de configuração é o que define no Unified Service Desk for Dynamics 365 para configurar uma implementação personalizada do agente do centro de atendimento telefónico. As entidades do Unified Service Desk, juntamente com os dados de configuração armazenados nas entidades, definem a aplicação de um agente. Para mais informações sobre o Unified Service Desk, consulte o Guia do Unified Service Desk.

A Configuration Migration Tool permite-lhe:

• Selecione entidades e campos do qual pretende exportar os dados de configuração.

• Evite registos duplicados no sistema de destino definir uma condição de unicidade para cada entidade com base numa combinação dos campos na entidade, que é utilizada para comparar perante os valores no sistema de destino. Se nenhum valor correspondente, um registo de documentos é criado no sistema de destino. Se um registo correspondente é satisfeito, o registo é atualizado no sistema de destino.

  Nota

  Se a condição de deteção de duplicados (unicidade) é especificada para uma entidade que está a ser exportada, a ferramenta utiliza o nome do campo primário da entidade para comparar perante os dados existentes no sistema de destino.

• Desativar plug-ins antes de exportar dados e voltar permita-os no sistema de destino depois de concluída a importação para todas as entidades ou entidades selecionadas.

• Validar o esquema para que as entidades selecionadas serão exportadas para assegurar que todos os dados/informações estão presentes.

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

• Avançar os campos de Data e Hora na importação para ambientes de demonstração automaticamente.

• Plug-in módulos exportados criados desta ferramenta (ficheiros de dados do esquema e) em outros programas. Por exemplo, pode utilizar os dados exportados no Package Deployer juntamente com outros ficheiros de soluções e os dados para criar e implementar pacotes num ambiente. Mais informações: Implementar pacotes utilizando o Package Deployer

A Ferramenta de Migração da Configuração está disponível como um pacote NuGet ou pode transferir a ferramenta utilizando o Power Platform CLI.

Como funciona a Configuration Migration Tool?

O diagrama seguinte ilustra como a Configuration Migration Tool é utilizada para migrar dados de configuração.

Definir o esquema dos dados de origem a serem exportados: o ficheiro de esquema (.xml) contém informações sobre os dados que pretende exportar como entidades, atributos, relações, definição de unicidade de dados, os plug-ins e se devem ser desativados antes de exportar os dados. Mais informações: Criar um esquema para exportar dados de configuração

Utilizar o esquema de exportação de dados: utilize o ficheiro de esquema para exportar os dados para um ficheiro.zip que contém os dados e o esquema de dados exportados. Mais informações: Criar um esquema para exportar dados de configuração

Importar dados exportados: utilize os dados exportados (ficheiro.zip) para importar para o ambiente de destino. A importação de dados é efetuada em várias passagens primeiro para importar os dados de fundação enquanto coloca em fila os dados dependentes e, em seguida, importando os dados dependentes nas passagens subsequentes para processar as dependências ou enlaces de dados. Isto assegura uma importação de dados limpa. Mais informações: Importar dados de configuração

Resolver problemas de migração de dados de configuração utilizar ficheiros de registo

A Configuration Migration Tool fornece suporte de registo para obter informações detalhadas sobre os erros que podem ocorrer ao iniciar sessão no ambiente utilizando a ferramenta, atividades efetuadas pela ferramenta durante a definição de esquema e a importação/exportação de dados de configuração e informações sobre os dados que foram importados utilizando a ferramenta. Existem três ficheiros de registo gerados pela ferramenta disponíveis na localização seguinte no computador que executa a ferramenta: c:\Users\<UserName>\AppData\Roaming\Microsoft\Microsoft Dataverse Configuration Migration Tool\<Version>.

• Login_ErrorLog.log: Fornece informações sobre problemas que ocorreram quando utilizou a ferramenta para iniciar sessão no ambiente. Se existir quaisquer problemas no início de sessão, uma mensagem apresentadas no ecrã de início de sessão de ferramentas com uma hiperligação para o ficheiro de registo. A mensagem indica que um erro ao processar o pedido de início de sessão e o utilizador pode ver o registo de erros. Pode clicar na hiperligação na mensagem para ver o ficheiro de registo. O ficheiro de registo é criado a primeira vez que encontrar problemas de início de sessão na ferramenta. Depois, o ficheiro de registo é utilizado para registar informações sobre problemas de início de sessão sempre que estes ocorrerem.

• DataMigrationUtility.log: Fornece informações detalhadas sobre cada tarefa efectuada a ferramenta durante a execução da última vez. Pode ver o ficheiro de registo clicando no menu ferramentas de Registos no ecrã principal e de Executar registo, clique em.

• ImportDataDetail.log: Fornece informações detalhadas sobre os dados importados na última tarefa de importação utilizando a ferramenta. Sempre que executar uma tarefa de importação utilizando esta ferramenta, os detalhes existentes no ficheiro de registo são movidos para um ficheiro denominado ImportDataDetail._old.log no mesmo diretório e o ficheiro ImportDataDetail.log apresenta informações sobre a importação mais recente efetuada utilizando a ferramenta. Pode ver o ficheiro de registo clicando no menu ferramentas de Registos no ecrã principal e de Último Registo de Importação, clique em.

Melhores práticas para migrar os dados de configuração utilizar a ferramenta

São os seguintes aspetos que deve considerar a utilizar esta ferramenta para migrar os dados de configuração:

• Quando criar o esquema de dados da exportação, terá de definir regras de unicidade adequadamente de cada entidade permite que as atualizações involuntárias de dados no sistema de destino.

• Importar dados exportados num ambiente de pré-produção (reverter uma imagem de preferência do ambiente de produção) para assegurar que os resultados da importação de dados à medida que pretendeu.

• Suporte o ambiente de produção antes de importar os dados.

Limitações

• Migrar a entidade Calendário não é suportado.
• Migrar a coluna Imagem não é suportado.

Consulte também

Transferir ferramentas a partir de NuGet
Criar um esquema para exportar dados de configuração
Modificar um esquema de dados de configuração
Importar dados de configuração
Gerir a configuração do catálogo de produtos