使用配置迁移工具跨环境和组织移动配置数据
可使用配置迁移工具跨环境和组织移动配置数据。 配置数据用于定义客户互动应用(Dynamics 365 Sales、Dynamics 365 Customer Service、Dynamics 365 Field Service、Dynamics 365 Marketing 和 Dynamics 365 Project Service Automation)中的自定义功能,并通常存储在自定义实体中。 配置数据有别于最终用户数据(如客户、联系人等)。 配置数据的一个典型示例是您在 Unified Service Desk for Dynamics 365 中定义的用来配置自定义呼叫中心代理应用程序的内容。 Unified Service Desk 实体和存储在实体中的配置数据定义一个代理应用程序。 有关 Unified Service Desk 的详细信息,请参阅 Unified Service Desk 指南。
可使用配置迁移工具:
从要导出配置数据的地方选择实体和字段。
通过根据实体中的字段组合为每个实体定义特有的条件来避免在目标系统上出现重复记录,这种方法也用于比较目标系统上的值。 如果没有匹配值,就会在目标系统中创建一个特有的记录。 如果找到匹配记录,该记录将更新在目标系统上。
备注
如果没有为要导出的实体指定重复检测(唯一性)条件,则该工具使用此实体的主要字段名称来与目标系统上现有的数据进行比较。
在导出数据之前禁用插件,然后在完成对所有实体或所选实体的导入之后,重新在目标系统上启用它们。
验证要导出的所选实体的架构,以确保包括所有必需的数据/信息。
重用现有架构,用以从源系统导出数据。
在导入演示环境时自动前移“日期时间”字段。
将从该工具创建的导出模块(架构和数据文件)嵌入到其他程序。 例如,您可以在 Package Deployer 中使用导出的数据和其他解决方案文件、数据一起在环境上创建和部署包。 详细信息:使用 Package Deployer 部署包
配置迁移工具作为 NuGet 包提供,或者您可以使用 Power Platform CLI 下载此工具。
配置迁移工具如何工作?
下图演示配置迁移工具如何用于迁移配置数据。
定义要导出的源数据的架构:架构文件(.xml)包含有关要导出的数据的信息,例如实体、属性、关系、数据唯一性的定义以及是否应在导出数据之前禁用插件。 详细信息:创建架构以导出配置数据
使用架构导出数据:使用架构文件将数据导出到包含数据和导出数据的架构的 a .zip 文件中。 详细信息:创建架构以导出配置数据
导入导出的数据:使用导出的数据(.zip 文件)导入到目标环境。 数据导入分多个步骤完成,首先导入基础数据,同时队列化从属数据,然后在后续步骤中导入从属数据,以处理所有数据的从属或链接。 这可以保证干净的数据导入。 详细信息:导入配置数据
解决使用日志文件配置数据迁移问题
配置迁移工具提供记录支持,以获取有关在使用工具登录环境时会发生的错误的详细信息;在架构定义和导出/导入配置数据期间工具执行的活动的详细信息;使用工具导入的数据的详细信息。 该工具生成了三个日志文件,这些文件位于运行该工具的计算机上的以下位置:c:\Users\<UserName>\AppData\Roaming\Microsoft\Microsoft Dataverse Configuration Migration Tool\Version<>。
Login_ErrorLog.log:提供有关使用该工具登录环境时出现的问题的信息。 在登录时,如果存在任何问题,工具的登录屏幕上会出现一条消息,当中含有一个指向此日志文件的链接。 此消息说明在处理登录请求时出现错误,用户也可以查看该错误日志。 您可以单击消息中的链接来查看该日志文件。 初次遇到该工具中的任何登陆问题,创建日志文件。 之后,每当发生登录问题时,日志文件都将被用于记录日志信息。
DataMigrationUtility.log:提供有关上次运行期间在工具中执行的每个任务的详细信息。 您可以通过单击主屏幕上的日志菜单,然后单击运行日志,从工具中查看日志文件。
ImportDataDetail.log:提供有关使用该工具在上次导入任务中导入的数据的详细信息。 每次使用此工具运行一个导入作业时,都会将日志文件中现有的详细信息移至同一目录中叫做 ImportDataDetail._old.log 的文件,而 ImportDataDetail.log 文件会显示有关使用该工具在上次运行的导入作业的信息。 您可以通过单击主屏幕上的日志菜单,然后单击上次的导入日志,从工具中查看此日志文件。
使用工具迁移配置数据的最佳实践
以下是您在使用该工具迁移配置数据时,应当考虑的事项:
在创建数据导出架构时,必须正确地为每个实体定义唯一性规则以避免在目标系统中出现意外的数据更新。
导入在预生产环境中导出的数据(最好是生产环境的镜像),以确保数据导入结果是您所需要的。
在导入数据之前,要先备份生产环境。
限制
- 不支持迁移日历实体。
- 不支持迁移图像列。