Mover datos de configuración entre entornos y organizaciones con la herramienta Migración de la configuración
La herramienta Migración de la configuración permite mover datos de configuración entre entornos y organizaciones. Los datos de configuración se utilizan para definir la funcionalidad personalizada en aplicaciones de involucración del cliente (Dynamics 365 Sales, Dynamics 365 Customer Service, Dynamics 365 Field Service, Dynamics 365 Marketing y Dynamics 365 Project Service Automation) y normalmente se almacenan en entidades personalizadas. Los datos de configuración son diferentes de los datos de usuario final (cuentas, contactos, etc.). Un ejemplo típico de datos de configuración es lo que se define en Unified Service Desk para Dynamics 365 para configurar una aplicación personalizada de agente de centro de atención telefónica. Las entidades de Unified Service Desk, junto con los datos de configuración que se almacenan en las entidades, definen una aplicación de agente. Para obtener más información sobre Unified Service Desk, consulte Guía de Unified Service Desk.
La herramienta Configuration Migration permite hacer lo siguiente:
Seleccionar las entidades y campos de dónde desea exportar los datos de configuración.
Evitar registros duplicados en el sistema de destino definiendo una condición de exclusividad para cada entidad basada en una combinación de campos de la entidad, que se usa para compararlos con los valores del sistema de destino. Si no hay valores coincidentes, se crea un registro único en el sistema de destino. Si se encuentra un registro coincidente, el registro se actualiza en el sistema de destino.
Nota
Si no se especifica ninguna condición de detección de duplicados (exclusividad) para una entidad que se está exportando, la herramienta usa el nombre del campo principal de la entidad para compararlo con los datos existentes en el sistema de destino.
Deshabilite complementos antes de exportar los datos y, a continuación, vuelva a habilitarlos en el sistema de destino después de que la importación finalice para todas las entidades o entidades seleccionadas.
Valide el esquema para que las entidades seleccionadas se exporten para asegurarse de que todos los datos/información necesarios se encuentran presentes.
Reutilice un esquema existente para exportar datos desde un sistema de origen.
Desplazar automaticamente campos de fecha y hora en la importación para entornos de demostración.
Incruste los módulos exportados creados con esta herramienta (esquema y archivos de datos) en otros programas. Por ejemplo, puede usar los datos exportados en Package Deployer junto con otros archivos de soluciones y datos para crear e implementar paquetes en un entorno. Más información:Implementar paquetes usando Package Deployer
La herramienta de migración de configuración está disponible como un paquete de NuGet o puede descargarla utilizando la CLI de Power Platform.
¿Cómo funciona la herramienta de Configuration Migration?
El siguiente diagrama muestra cómo se usa la herramienta Configuration Migration para migrar datos de configuración.
Defina el esquema de los datos de origen que se exportarán: el archivo del esquema (.xml) contiene información acerca de los datos que desea exportar, por ejemplo, entidades, atributos, relaciones, definición de la exclusividad de los datos, y si los complementos deben deshabilitarse antes de exportar los datos. Más información: Crear un esquema para exportar datos de configuración
Use el esquema para exportar datos: use el archivo de esquema para exportar los datos a un archivo .zip que contiene los datos y el esquema de los datos exportados. Más información: Crear un esquema para exportar datos de configuración
Importar los datos exportados: use los datos exportados (archivo .zip) para importar en el entorno de destino. La importación de datos se realiza en múltiples pasos para importar primero los datos de base mientras se sitúan en cola los datos dependientes, y después se importan los datos dependientes en las pasadas posteriores para administrar las vinculaciones o dependencias de datos. Esto asegura la importación de datos limpios. Más información: Importar datos de configuración
Solución de problemas de migración de datos de configuración utilizando archivos de registro
La herramienta Migración de la configuración ofrece soporte de registro para obtener información detallada sobre los errores que pueden producirse al iniciar sesión en el entorno utilizando la herramienta, las actividades realizadas por la herramienta durante la definición del esquema y la exportación/importación de los datos de configuración, además de información sobre los datos que se han importado usando la herramienta. La herramienta genera tres archivos de registro que están disponibles en la siguiente ubicación del equipo donde se ejecuta la herramienta: c:\Users<Nombre_de_usuario>\AppData\Roaming\Microsoft\Microsoft Dataverse Configuration Migration Tool\<Versión>.
Login_ErrorLog.log: Proporciona información sobre los problemas que se han producido cuando se usa la herramienta para iniciar sesión en el entorno. Si hay un problema al iniciar sesión, aparecerá un mensaje en la pantalla de inicio de sesión de la herramienta con un vínculo a este archivo de registro. El mensaje indica que se ha producido un error al procesar la solicitud de inicio de sesión y el usuario puede ver el registro de error. Puede hacer clic en el vínculo del mensaje para ver este archivo de registro. El archivo de registro se crea la primera vez que se encuentran problemas de inicio de sesión en la herramienta. Después de eso, el archivo de registro se usa para registrar información sobre un problema de inicio de sesión, siempre que aparece.
DataMigrationUtility.log: Proporciona información detallada sobre cada tarea realizada en la herramienta durante la última ejecución. Puede ver el archivo de registro desde la herramientas haciendo clic en el menú Registros de la pantalla principal, y haciendo clic en Registro en ejecución.
ImportDataDetail.log: Proporciona información detallada sobre los datos importados en el último trabajo de importación utilizando la herramienta. Cada vez que ejecuta un trabajo de importación utilizando esta herramienta, los detalles existentes del archivo de registro pasan a un archivo denominado ImportDataDetail._old.log en el mismo directorio, y el archivo ImportDataDetail.log muestra información sobre el último trabajo de importación realizado utilizando la herramienta. Puede ver este archivo de registro desde la herramientas haciendo clic en el menú Registros de la pantalla principal, y luego haciendo clic en Último registro de importación.
Prácticas recomendadas para migrar los datos de configuración utilizando la herramienta
Los siguientes son factores que debe tener en cuenta cuando use esta herramienta para migrar los datos de configuración:
Mientras crea el esquema de datos de la exportación, debe definir las reglas de la exclusividad adecuadamente para cada entidad para evitar actualizaciones no intencionadas de datos en el sistema de destino.
Importe los datos exportados en un entorno de preproducción (preferiblemente una imagen reflejada del entorno de producción) para asegurarse de que los resultados de la importación de los datos son los deseados.
Realice una copia de seguridad del entorno de producción antes de importar los datos.
Limitaciones
- No se admite la migración de la entidad Calendario.
- No se admite la migración de la columna Imagen.
Consulte también
Descargar herramientas de NuGet
Crear un esquema para exportar datos de configuración
Edición de un esquema de datos de configuración
Importar datos de configuración
Administración de la configuración del catálogo de productos