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 檔案的名稱。 如果您在此處指定 .zip 檔案名稱，則會在套件部署程序中新增畫面，提示您選取要解壓縮檔案內容的位置。 此屬性通常用於建立 Dynamics 365 的 Unified Service Desk 套件。
agentdesktopexename	要在部署程序結束時叫用的 ZIP 檔案中 .exe 或 .msi 檔案的名稱或 URL。 此屬性通常用於建立 Dynamics 365 的 Unified Service Desk 套件。
crmmigdataimportfile	使用 Configuration Migration Tool 所匯出之預設組態資料檔 (.zip) 的檔案名稱。

configdatastorage 元素

以下是有效的子元素：

元素	Description
solutions	包含 0 個或多個 configsolutionfile 元素，用於描述要匯入的解決方案。
filestoimport	包含 - 1 或多個 configimportfile 元素 - 0 或多個 zipimportdetails 元素，用於描述要匯入的個別檔案和 ZIP 檔案。
filesmapstoimport	包含 1 個或多個 configimportmapfile 元素。 元素中的對應檔順序表示匯入這些對應檔所依照的順序。 瞭解有關創建用於導入的數據映射的更多資訊
cmtdatafiles	包含 1 個或多個 cmtdatafile 元素，其中包含要匯入的設定資料檔案的當地語系化版本。

configsolutionfile 元素

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

configsolutionfile 屬性

姓名	Description
solutionpackagefilename	必需 指定解決方案的 .zip 檔名。
overwriteunmanagedcustomizations	可選 ：在導入目標環境中已存在的解決方案時是否覆蓋任何非託管自定義項。 如果未指定此行為，則現有解決方案中的非受控自訂項目將保留在目標環境中。
publishworkflowsandactivateplugins	可選 是否在導入解決方案後在 Target 環境中發佈工作流和啟動外掛程式。如果未指定此行為，則會發佈工作流並啟動外掛程式。

configimportfile 元素

描述要在 configdatastorage.filestoimport 元素中匯入的檔案。

Configimportfile 屬性

姓名	Description
filename	包含匯入資料之檔案的名稱。
filetype	此值可以是 csv、xml 和 zip。 如果檔案是 ZIP 檔案，則 zipimportdetails 元素必須存在，而且 ZIP 檔案中的每個檔案都有 zipimportdetail 元素。
associatedmap	要用於這個檔案的 Dataverse 匯入資料對應的名稱。 如果空白，Dataverse 會嘗試為這個檔案使用系統決定的匯入資料對應名稱。
importtoentity	可以是 ZIP 檔案中 exe 的名稱、URL 或 .msi，以便提供要在程序結束時叫用的連結。
datadelimiter	用於匯入檔案的資料分隔符號名稱。 有效值為單引號或雙引號。
fielddelimiter	用於匯入檔案的欄位分隔符號名稱。 有效值為逗號、冒號或單引號。
enableduplicatedetection	是否對資料匯入啟用重複資料偵測規則。 有效值為 true 或 false。
isfirstrowheader	匯入檔案的第一列是否包含欄位名稱。 有效值為 true 或 false。
isrecordownerateam	匯入時的記錄負責人是否必須為團隊。 有效值為 true 或 false。
owneruser	應該擁有記錄的使用者識別碼。 預設值為目前登入的使用者。
waitforimporttocomplete	如果為 true，系統會等待匯入完成後，再繼續執行。 如果為 false，則將工作排入佇列並繼續進行。

zipimportdetails 元素

描述當 configimportfile.filetype 為 zip 時，要在 configdatastorage.filestoimport 元素中匯入的 zip 檔案。

包含 1 個或多個 zipimportdetail 元素，其提供 configimportfile 元素指定之 ZIP 檔案中個別檔案的相關資訊。

zipimportdetail 元素

提供 configimportfile 元素指定之 ZIP 檔案中個別檔案的相關資訊。

Zipimportdetail 屬性

姓名	Description
filename	包含匯入資料之檔案的名稱。
filetype	此值可以是 csv 或 xml。
importtoentity	可以是 ZIP 檔案中 exe 的名稱、URL 或 .msi，以便提供要在程序結束時叫用的連結。

configimportmapfile 元素

包含有關要匯入 Dataverse 中的單一對應檔的資訊。

configimportmapfile 屬性

姓名	Description
filename	包含對應資料之檔案的名稱。

cmtdatafile 元素

指定在地語系化的設定資料檔案與地區設定識別碼 (必要) 和使用者資訊對應檔 (選用)。

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) 執行個體。