Tham chiếu ImportConfig

Tệp ImportConfig.xml được sử dụng với trình triển khai gói chứa thông tin về các giải pháp và dữ liệu cần nhập. Sau đây là một ví dụ:

<?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>

Các phần sau đây cung cấp thông tin chi tiết về các thành phần và thuộc tính XML hợp lệ cho tài liệu này.

configdatastorage yếu tố

configdatastorage là phần tử gốc.

Thuộc tính configdatastorage

Tất cả các thuộc tính này đều là tùy chọn.

Tên	Description
installsampledata	Có nên cài đặt dữ liệu mẫu không. Đây là dữ liệu mẫu tương tự được cài đặt bằng các phương pháp khác sau: - Thêm hoặc xóa dữ liệu mẫu - Thêm và xóa dữ liệu mẫu bằng mã
waitforsampledatatoinstall	Nếu true và nếu installsampledata cũng được đặt thành true, đợi dữ liệu mẫu được cài đặt trước khi triển khai gói. Không đặt thành true khi installsampledata là false.
agentdesktopzipfile	Tên tệp của tệp zip để giải nén. Nếu bạn chỉ định tên tệp .zip ở đây, nó sẽ thêm một màn hình trong quá trình triển khai gói. Màn hình sẽ nhắc bạn chọn một vị trí mà bạn muốn giải nén nội dung của tệp. Thuộc tính này thường được sử dụng để tạo các gói cho Unified Service Desk for Dynamics 365.
agentdesktopexename	Tên của tệp .exe hoặc .msi trong tệp zip hoặc URL sẽ được gọi khi kết thúc quá trình triển khai. Thuộc tính này thường được sử dụng để tạo các gói cho Unified Service Desk for Dynamics 365.
crmmigdataimportfile	Tên tệp của tệp dữ liệu cấu hình mặc định (.zip) được xuất bằng Configuration Migration Tool.

Các thành phần configdatastorage

Đây là các phần tử con hợp lệ:

Yếu tố	Mô tả
solutions	Chứa 0 hoặc nhiều configsolutionfile phần tử mô tả các giải pháp cần nhập.
filestoimport	Chứa - 1 hoặc nhiều configimportfile phần tử - 0 hoặc nhiều zipimportdetails phần tử mô tả từng tệp riêng lẻ và tệp zip sẽ được nhập.
filesmapstoimport	Chứa 1 hoặc nhiều configimportmapfile phần tử. Thứ tự của các tệp bản đồ trong phần tử này cho biết thứ tự chúng được nhập. Tìm hiểu thêm về việc tạo bản đồ dữ liệu để nhập
cmtdatafiles	Bao gồm 1 hoặc nhiều cmtdatafile phần tử chứa phiên bản bản địa hóa của tệp dữ liệu cấu hình cần nhập.

configsolutionfile yếu tố

Mô tả các giải pháp để nhập vào phần tử configdatastorage.solutions .

Thuộc tính configsolutionfile

Tên	Description
solutionpackagefilename	Bắt buộc Chỉ định tên tệp .zip cho giải pháp của bạn.
overwriteunmanagedcustomizations	Tùy chọn Có ghi đè bất kỳ tùy chỉnh không được quản lý nào khi nhập giải pháp đã tồn tại trong môi trường đích hay không. Nếu bạn không chỉ định hành vi này, các tùy chỉnh không được quản lý trong giải pháp hiện tại sẽ được duy trì trên môi trường đích.
publishworkflowsandactivateplugins	Tùy chọn Có nên công bố quy trình làm việc và kích hoạt plug-in trong môi trường đích sau khi giải pháp được nhập hay không. Nếu bạn không chỉ định hành vi này, quy trình làm việc sẽ được công bố và plug-in sẽ được kích hoạt.

configimportfile yếu tố

Mô tả các tệp để nhập vào phần tử configdatastorage.filestoimport .

Thuộc tính configimportfile

Tên	Description
filename	Tên của tệp có chứa dữ liệu nhập.
filetype	Giá trị này có thể là csv, xml hoặc zip. Nếu tệp là tệp .zip, thì phải có một zipimportdetails phần tử với một zipimportdetail phần tử cho mỗi tệp trong tệp .zip.
associatedmap	Tên của bản đồ dữ liệu nhập Dataverse để sử dụng với tập tin này. Nếu để trống, Dataverse sẽ cố gắng sử dụng tên bản đồ dữ liệu nhập khẩu do hệ thống xác định cho tệp này.
importtoentity	Có thể là tên của tệp exe trong tệp zip, URL hoặc tệp .msi để cung cấp một liên kết để gọi khi kết thúc quá trình triển khai.
datadelimiter	Tên của dấu tách dữ liệu được dùng trong tệp nhập. Giá trị hợp lệ là dấu ngoặc đơn hoặc dấu ngoặc kép.
fielddelimiter	Tên của dấu tách trường được dùng trong tệp nhập. Giá trị hợp lệ là dấu phẩy, dấu hai chấm hoặc dấu ngoặc đơn.
enableduplicatedetection	Có nên bật quy tắc phát hiện trùng lặp khi nhập dữ liệu hay không. Các giá trị hợp lệ là true hoặc false.
isfirstrowheader	Hàng đầu tiên của tệp nhập có chứa tên trường không. Các giá trị hợp lệ là true hoặc false.
isrecordownerateam	Liệu chủ sở hữu của bản ghi khi nhập có phải là một nhóm hay không. Các giá trị hợp lệ là true hoặc false.
owneruser	ID người dùng sở hữu hồ sơ. Giá trị mặc định là người dùng hiện đang đăng nhập.
waitforimporttocomplete	Nếu true, hệ thống chờ quá trình nhập hoàn tất trước khi tiến hành. Nếu false, hệ thống xếp hàng đợi các công việc và tiếp tục.

zipimportdetails yếu tố

Mô tả các tệp zip để nhập vào phần tử configdatastorage.filestoimport khi configimportfile.filetype là zip.

Bao gồm 1 hoặc nhiều zipimportdetail phần tử cung cấp thông tin về một tệp riêng lẻ trong tệp zip được chỉ định trong configimportfile phần tử.

zipimportdetail yếu tố

Cung cấp thông tin về một tệp riêng lẻ trong tệp zip được chỉ định trong phần tử configimportfile .

Thuộc tính zipimportdetail

Tên	Description
filename	Tên của tệp có chứa dữ liệu nhập.
filetype	Giá trị này có thể là csv hoặc xml.
importtoentity	Có thể là tên của tệp exe trong tệp zip, URL hoặc tệp .msi để cung cấp một liên kết để gọi khi kết thúc quá trình triển khai.

configimportmapfile yếu tố

Chứa thông tin về từng tệp bản đồ để nhập vào Dataverse.

Thuộc tính configimportmapfile

Tên	Description
filename	Tên của tệp chứa dữ liệu ánh xạ.

cmtdatafile yếu tố

Chỉ định các tệp dữ liệu cấu hình bản địa hóa cùng với ID ngôn ngữ (bắt buộc) và tệp bản đồ thông tin người dùng (tùy chọn).

Ví dụ cmtdatafile

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

Thuộc tính cmtdatafile

Tên	Description
filename	Tên của tệp chứa dữ liệu ánh xạ.
lcid	Chuỗi biểu diễn mã định danh ngôn ngữ LCID.
usermapfilename	Chỉ dành cho Dynamics 365 (on-premises) . Chứa tệp bản đồ người dùng (.xml) được tạo bằng công cụ Di chuyển cấu hình trong dự án của bạn. Tệp này là bắt buộc để nhập thông tin người dùng vào một phiên bản Dynamics 365 (on-premises) trên một miền khác.