Mover datos de configuración entre ambientes e organizacións coa ferramenta Migración da configuración

A ferramenta Migración da configuración permite mover datos de configuración entre ambientes e organizacións. Os datos de configuración úsanse para definir a funcionalidade personalizada nas aplicacións de interacción cos clientes (Dynamics 365 Sales, Dynamics 365 Customer Service, Dynamics 365 Field Service, Dynamics 365 Marketing e Dynamics 365 Project Service Automation) e normalmente almacénase en entidades personalizadas. Os datos de configuración son diferentes aos datos do usuario final (conta, contactos, etc.). Un exemplo habitual de datos de configuración é o que se define en Unified Service Desk for Dynamics 365 para configurar unha aplicación de axente de centro de chamadas personalizado. As entidades de Unified Service Desk, xunto cos datos de configuración que se almacenan nas entidades, definen unha aplicación de axente. Para obter máis información acerca de Unified Service Desk, consulte Guía de Unified Service Desk.

A ferramenta Migración da configuración permite facer o seguinte:

• Seleccionar as entidades e campos de onde quere exportar os datos de configuración.

• Evitar rexistros duplicados no sistema de destino mediante a definición dunha condición única para cada entidade segundo unha combinación dos campos na entidade, que se usa para comparar fronte aos valores no sistema de destino. Se non hai valores coincidentes, créase un rexistro único no sistema de destino. Se se atopa un rexistro coincidente, o rexistro se actualiza no sistema de destino.

  Nota

  Se non se especifica unha condición de detección de duplicados (única) para unha entidade que se está a exportar, a ferramenta usa o nome do campo primario da entidade para comparar fronte aos datos existentes no sistema de destino.

• Desactivar os complementos antes de exportar datos e, a seguir, volver activalos no sistema de destino unha vez concluída a importación para todas as entidades ou as entidades seleccionadas.

• Validar o esquema das entidades seleccionadas que se van exportar para asegurar que todos os datos ou información requirida están presentes.

• Reutilizar un esquema existente para exportar datos dun sistema de orixe.

• Mova automaticamente os campos de Datahora cara adiante na importación de ambientes de demostración.

• Incorporar os módulos exportados que se crearon mediante esta ferramenta (esquema e ficheiros de datos) noutros programas. Por exemplo, pode utilizar os datos exportados en Package Deployer con outros ficheiros de solucións e datos para crear e despregar paquetes nun ambiente. Máis información: Aplicar paquetes usando Package Deployer

A ferramenta de migración de configuración está dispoñible como NuGet paquete ou pode descargala mediante Power Platform CLI.

Como funciona a ferramenta Configuration Migration?

O seguinte diagrama ilustra como se usa a ferramenta Configuration Migration para migrar datos de configuración.

Defina o esquema dos datos de orixe que se van exportar: o ficheiro de esquema (.xml) contén información sobre os datos que quere exportar, como as entidades, atributos, relacións, definición de singularidade dos datos., e se os complementos deben desactivarse antes de exportar os datos. Máis información: Crear un esquema para exportar datos de configuración

Use o esquema para exportar datos: use o ficheiro de esquema para exportar os datos a un ficheiro .zip que conteña os datos e o esquema dos datos exportados. Máis información: Crear un esquema para exportar datos de configuración

Importar os datos exportados: utiliza os datos exportados (ficheiro .zip) para importalos ao contorno de destino. A importación de datos realízase en varias fases para importar primeiro os datos base mentres os datos dependentes fan cola e, a seguir, importar os datos dependentes nas fases seguintes para xestionar as ligazóns e dependencias de datos. Isto asegura unha importación de datos limpa. Máis información: Importar datos de configuración

Resolución de problemas de migración de datos de configuración mediante ficheiros de rexistro

A ferramenta Migración de configuración fornece soporte de inicio de sesión para obter información detallada acerca dos erros que poden ocorrer ao iniciar sesión no ambiente mediante a ferramenta, actividades executadas pola ferramenta durante a definición de esquema e a exportación e importación dos datos de configuración, e información acerca dos datos que se importaron mediante a ferramenta. Hai tres ficheiros de rexistro xerados pola ferramenta que están dispoñibles na seguinte localización do ordenador onde executa a ferramenta: c:\Users\<UserName>\AppData\Roaming\ Microsoft\Microsoft Dataverse Configuration Migration Tool\<Versión>.

• Login_ErrorLog.log: ofrece información sobre os problemas que se produciron ao utilizar a ferramenta para iniciar sesión no contorno. Se hai calquera problema durante o inicio de sesión, aparece unha mensaxe na pantalla de inicio de sesión da ferramenta cunha ligazón a este ficheiro de rexistro. A mensaxe indica que un erro ocorreu ao procesar a solicitude de inicio de sesión e o usuario pode ver o rexistro do erro. Pode premer na ligazón da mensaxe para ver este ficheiro de rexistro. O ficheiro de rexistro créase por primeira vez cando se atopa con calquera problema de inicio de sesión na ferramenta. A partir de aí, o ficheiro de rexistro úsase para rexistrar información acerca do problema de inicio de sesión, cando este se produza.

• DataMigrationUtility.log: ofrece información detallada sobre cada tarefa realizada na ferramenta durante a última execución. Pode ver o ficheiro de rexistro desde a ferramenta se preme no menú Rexistros da pantalla principal e, a seguir, Rexistro de execución.

• ImportDataDetail.log: ofrece información detallada sobre os datos importados no último traballo de importación mediante a ferramenta. Cada vez que executa un traballo de importación mediante esta ferramenta, os detalles existentes do ficheiro de rexistro se moven a un ficheiro denominado ImportDataDetail._old.log no mesmo directorio e o ficheiro ImportDataDetail.log mostra información acerca da execución do traballo de importación máis recente mediante a ferramenta. Pode ver este ficheiro de rexistro desde a ferramenta se preme no menú Rexistros da pantalla principal e, a seguir, Rexistro da última importación.

Prácticas recomendadas para migrar datos de configuración mediante a ferramenta

A continuación se enumeran as cousas que debe considerar mentres usa esta ferramenta para migrar os datos de configuración:

• Ao crear o esquema de datos de exportación, defina regras únicas apropiadas para cada entidade para evitar calquera actualización de datos accidental no sistema de destino.

• Importe os datos exportados nun ambiente de produción previa (preferiblemente nunha imaxe reflectida do ambiente de produción) para asegurar que os resultados da importación de datos son os esperados.

• Realice unha copia de seguranza do ambiente de produción antes de importar os datos.

Limitacións

• Non se admite a migración da entidade Calendario.
• Non se admite a migración da columna Imaxe.

Consulte tamén

Descargar ferramentas de NuGet
Crea un esquema para exportar datos de configuración
Modificar un esquema de datos de configuración
Importar datos de configuración
Xestionar a configuración do catálogo de produtos