通过

ImportConfig 引用

  • 项目

与 package deployer 一起使用的 ImportConfig.xml 文件包含有关要导入的解决方案和数据的信息。 示例如下：

<?xml version="1.0" encoding="utf-16"?>
<configdatastorage 
   installsampledata="true"
   waitforsampledatatoinstall="true"
   agentdesktopzipfile=""
   agentdesktopexename=""
   crmmigdataimportfile="data_1033.zip">
   <solutions>
      <configsolutionfile 
         solutionpackagefilename="SampleSolutionOne_1_0_managed.zip"
         overwriteunmanagedcustomizations="false"
         publishworkflowsandactivateplugins="true" />
      <configsolutionfile 
         solutionpackagefilename="SampleSolutionTwo_1_0_managed.zip"
         overwriteunmanagedcustomizations="false"
         publishworkflowsandactivateplugins="true" />
      <configsolutionfile 
         solutionpackagefilename="SampleSolutionThree_1_0_managed.zip" />
   </solutions>
   <filestoimport>
      <configimportfile filename="SampleOption.csv"
         filetype="CSV"
         associatedmap="SampleOption"
         importtoentity="sample_option"
         datadelimiter=""
         fielddelimiter="comma"
         enableduplicatedetection="true"
         isfirstrowheader="true"
         isrecordownerateam="false"
         owneruser=""
         waitforimporttocomplete="false" />
      <configimportfile filename="File.zip"
         filetype="ZIP"
         associatedmap="FileMapName"
         importtoentity="FileEntity"
         datadelimiter=""
         fielddelimiter="comma"
         enableduplicatedetection="true"
         isfirstrowheader="true"
         isrecordownerateam="false"
         owneruser=""
         waitforimporttocomplete="true" />
      <zipimportdetails>
         <zipimportdetail filename="subfile1.csv"
            filetype="csv"
            importtoentity="account" />
         <zipimportdetail filename="subfile2.csv"
            filetype="csv"
            importtoentity="contact" />
      </zipimportdetails>
   </filestoimport>
   <filesmapstoimport>
      <configimportmapfile filename="SampleOption.xml" />
   </filesmapstoimport>
   <cmtdatafiles>
      <cmtdatafile filename="data_1033.zip"
         lcid="1033"
         usermapfilename="UserMap.xml" />
      <cmtdatafile filename="data_1041.zip"
         lcid="1041"
         usermapfilename="" />
   </cmtdatafiles>
</configdatastorage>

以下部分提供了有关本文档的有效 XML 元素和属性的详细信息。

configdatastorage 元素

configdatastorage 是根元素。

configdatastorage 属性

所有这些属性都是可选的。

客户 Description
installsampledata 是否安装示例数据。 这是使用其他方法安装的相同示例数据：
- 添加或删除示例数据
- 使用代码添加和删除示例数据
waitforsampledatatoinstall 如果为 true，并且 installsampledata 也设置为 true，则在部署包之前会等待安装示例数据。 当 installsampledata 为 false 时，不要将此设置为 true。
agentdesktopzipfile 打开要解压缩的的压缩文件的文件名。 如果在此指定一个 .zip 文件名，在提示您选择一个要在其解压缩文件内容的位置的数据包部署过程期间，添加一个屏幕。

此属性通常用于为 Unified Service Desk for Dynamics 365 创建包。
agentdesktopexename 在部署过程快结束时调用位于压缩文件或 URL 中的 .exe 或 .msi 文件的名称。

此属性通常用于为 Unified Service Desk for Dynamics 365 创建包。
crmmigdataimportfile 使用配置迁移工具导出的默认配置数据文件 (.zip) 的文件名。

configdatastorage 元素

以下是有效的子元素：

元素 说明
solutions 包含 0 个或多个描述要导入的解决方案的 configsolutionfile 元素。
filestoimport 包含
- 1 个或多个 configimportfile 元素
- 0 或多个 zipimportdetails 元素，描述要导入的单个文件和 zip 文件。
filesmapstoimport 包含一个或多个 configimportmapfile元 素。 该元素中映射文件的的顺序指示文件的导入顺序。 了解有关创建用于导入的数据映射的更多信息
cmtdatafiles 包含一个或多个 cmtdatafile 元素，这些元素包含要导入的配置数据文件的本地化版本。

configsolutionfile 元素

描述要在 configdatastorage.solutions 元素中导入的解决方案。

configsolutionfile 属性

客户 Description
solutionpackagefilename 必需 指定解决方案的 .zip 文件名。
overwriteunmanagedcustomizations 可选 ：在导入目标环境中已存在的解决方案时是否覆盖任何非托管自定义项。 如果不指定此行为，现有解决方案中的非托管自定义项将保留在目标环境中。
publishworkflowsandactivateplugins 可选 ：导入解决方案后，是否在目标环境中发布工作流并激活插件。如果未指定此行为，则会发布工作流并激活插件。

configimportfile 元素

描述要在 configdatastorage.filestoimport 元素中导入的文件。

configimportfile 属性

客户 Description
filename 包含导入数据的文件名称。
filetype 该值可以是 csv、xml 或 zip。 如果文件是 .zip 文件，则对于 .zip 中的每个文件，zipimportdetails 元素必须与 zipimportdetail 元素一起出现。
associatedmap 使用此文件的 Dataverse 导入数据映射的名称。 如果为空，则 Dataverse 为此文件尝试使用系统决定的导入数据映射。
importtoentity 可以是压缩文件中的 exe、URL 或 .msi 文件名称，在过程末尾调用链接。
datadelimiter 导入文件中所使用的数据分隔符的名称。 有效值为“单引号”或“双引号”。
fielddelimiter 导入文件中所使用的字段分隔符的名称。 有效值为“逗号”或“冒号”或“单引号”。
enableduplicatedetection 是否对数据导入启用重复检测功能。 有效值是 true 或 false。
isfirstrowheader 导入文件的第一行是否包含字段名称。 有效值是 true 或 false。
isrecordownerateam 导入记录的所有者是否应该是团队。 有效值是 true 或 false。
owneruser 应该拥有记录的用户 ID。 默认值是当前登录用户。
waitforimporttocomplete 如果 true，则系统在继续之前等待导入完成。 如果 false，则对作业进行排队然后继续。

zipimportdetails 元素

描述当 configimportfile.filetype 为 zip 时要在 configdatastorage.filestoimport 元素中导入的 zip 文件。

包含一个或多个 zipimportdetail 元素，这些元素提供有关 configimportfile 元素中指定的 zip 文件中的单个文件的信息。

zipimportdetail 元素

提供有关 configimportfile 元素中指定的 zip 文件中的单个文件的信息。

zipimportdetail 属性

客户 Description
filename 包含导入数据的文件名称。
filetype 该值可以是 csv 或 xml。
importtoentity 可以是压缩文件中的 exe、url 或 MSI 文件名称，在过程末尾调用链接。

configimportmapfile 元素

包含有关要在 Dataverse 中导入的单个映射文件的信息。

configimportmapfile 属性

客户 Description
filename 包含映射数据的文件的名称。

cmtdatafile 元素

指定本地化的配置数据文件以及区域设置 ID（必需）和用户信息映射文件（可选）。

cmtdatafile 示例

<cmtdatafiles>
   <cmtdatafile filename="data_1033.zip"
      lcid="1033"
      usermapfilename="UserMap.xml" />
   <cmtdatafile filename="data_1041.zip"
      lcid="1041"
      usermapfilename="" />
</cmtdatafiles>

cmtdatafile 属性

客户 Description
filename 包含映射数据的文件的名称。
lcid LCID 语言代码标识符的字符串表示形式。
usermapfilename 仅针对 Dynamics 365 (on-premises)。 包含使用项目中的 Configuration Migration tool 生成的用户映射文件 (.xml)。 此文件是将用户信息导入不同域上的 Dynamics 365 (on-premises) 实例所必需的。