การอ้างอิง ImportConfig

ไฟล์ ImportConfig.xml ที่ใช้กับ Package Deployer มีข้อมูลเกี่ยวกับโซลูชันและข้อมูลที่จะนำเข้า ดังตัวอย่างต่อไปนี้:

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

แอ็ตทริบิวต์ทั้งหมดเหล่านี้เป็นทางเลือก

Name	Description
installsampledata	ไม่ว่าจะติดตั้งข้อมูลตัวอย่าง นี่เป็นข้อมูลตัวอย่างเดียวกันกับที่ติดตั้งโดยใช้วิธีอื่นเหล่านี้: - เพิ่มหรือลบข้อมูลตัวอย่าง - เพิ่มและลบข้อมูลตัวอย่างด้วยโค้ด
waitforsampledatatoinstall	ถ้า true และถ้า installsampledata ถูกตั้งค่าเป็น true รอข้อมูลตัวอย่างที่จะติดตั้งก่อนที่จะปรับใช้แพคเกจ อย่าตั้งค่านี้เป็น true เมื่อ installsampledata เป็น false
agentdesktopzipfile	ชื่อไฟล์ของไฟล์ zip ที่จะขยาย หากคุณระบุชื่อไฟล์ .zip ที่นี่ จะเป็นการเพิ่มหน้าจอในระหว่างกระบวนการปรับใช้แพคเกจที่พร้อมท์ให้คุณเลือกตำแหน่งที่คุณต้องการขยายเนื้อหาของไฟล์ แอตทริบิวต์นี้มักใช้ในการสร้างแพคเกจสำหรับ Unified Service Desk for Dynamics 365
agentdesktopexename	ชื่อของไฟล์ .exe หรือ .msi ในไฟล์ zip หรือ URL ที่จะเรียกใช้เมื่อสิ้นสุดกระบวนการปรับใช้ แอตทริบิวต์นี้มักใช้ในการสร้างแพคเกจสำหรับ Unified Service Desk for Dynamics 365
crmmigdataimportfile	ชื่อไฟล์ของไฟล์ข้อมูลการกำหนดค่าเริ่มต้น (.zip) ที่ส่งออกโดยใช้เครื่องมือการโอนย้ายการตั้งค่าคอนฟิก

องค์ประกอบ configdatastorage

เหล่านี้เป็นองค์ประกอบลูกที่ถูกต้อง:

องค์ประกอบ	คำอธิบาย
solutions	มีองค์ประกอบ 0 หรือหลาย configsolutionfile องค์ประกอบ ที่อธิบายโซลูชันที่จะนำเข้า
filestoimport	มี - 1 หรือหลาย configimportfile องค์ประกอบ - 0 หรือหลาย zipimportdetails องค์ประกอบ ที่อธิบายแต่ละไฟล์ และไฟล์ zip ที่จะนำเข้า
filesmapstoimport	มี 1 หรือหลาย configimportmapfile องค์ประกอบ ลำดับของไฟล์แผนผังในองค์ประกอบนี้บ่งบอกถึงลำดับการนำเข้า เรียนรู้เพิ่มเติมเกี่ยวกับการสร้างแผนที่ข้อมูลสำหรับการนำเข้า
cmtdatafiles	มี 1 หรือหลาย cmtdatafile องค์ประกอบ ที่มีเวอร์ชันภาษาท้องถิ่นของไฟล์ข้อมูลการกำหนดค่าที่จะถูกนำเข้า

configsolutionfile องค์ประกอบ

อธิบายโซลูชันที่จะนำเข้าในองค์ประกอบ configdatastorage.solutions

แอตทริบิวต์ configsolutionfile

Name	Description
solutionpackagefilename	ที่จำเป็น ระบุชื่อไฟล์ .zip ของโซลูชันของคุณ
overwriteunmanagedcustomizations	ไม่จำเป็น ไม่ว่าจะเขียนทับการปรับแต่งที่ไม่ได้รับการจัดการใดๆ เมื่อนำเข้าโซลูชันที่มีอยู่แล้วในสภาพแวดล้อมเป้าหมาย หากคุณไม่ระบุลักษณะการทำงานนี้ การปรับแต่งที่ไม่มีการจัดการในโซลูชันที่มีอยู่จะถูกคงไว้ในสภาพแวดล้อมเป้าหมาย
publishworkflowsandactivateplugins	ไม่จำเป็น ว่าจะเผยแพร่เวิร์กโฟลว์และเปิดใช้งานปลั๊กอินในสภาพแวดล้อมเป้าหมายหลังจากนำโซลูชันเข้ามาหรือไม่ หากคุณไม่ระบุลักษณะการทำงานนี้ เวิร์กโฟลว์จะถูกเผยแพร่และเปิดใช้งานปลั๊กอิน

configimportfile องค์ประกอบ

อธิบายไฟล์ที่จะนำเข้าในองค์ประกอบ configdatastorage.filestoimport

แอตทริบิวต์ configimportfile

Name	Description
filename	ชื่อของไฟล์ที่มีข้อมูลการนำเข้า
filetype	ค่านี่อาจเป็น csv, xml หรือ zip หากไฟล์นั้นเป็นไฟล์ .zip zipimportdetails องค์ประกอบ จะต้องแสดงพร้อม zipimportdetail องค์ประกอบ สำหรับแต่ละไฟล์ในไฟล์ .zip
associatedmap	ชื่อของ Dataverse นำเข้าแผนผังข้อมูลเพื่อใช้กับไฟล์นี้ หากว่างเปล่า Dataverse จะพยายามใช้ระบบกำหนดชื่อแผนผังข้อมูลการนำเข้าสำหรับไฟล์นี้
importtoentity	สามารถเป็นชื่อของไฟล์ exe ในไฟล์ zip หรือ URL หรือไฟล์ .ms เพื่อให้ลิงก์สำหรับเรียกใช้เมื่อสิ้นสุดกระบวนการ
datadelimiter	ชื่อของตัวคั่นข้อมูลที่ใช้ในไฟล์นำเข้า ค่าที่ถูกต้องคือ เครื่องหมายอัญประกาศเดี่ยวและอัญประกาศคู่
fielddelimiter	ชื่อของตัวคั่นฟิลด์ที่ใช้ในไฟล์นำเข้า ค่าที่ถูกต้องคือ เครื่องหมายจุลภาคหรือจุดคู่ หรืออัญประกาศเดี่ยว
enableduplicatedetection	ว่าให้เปิดใช้งานกฏการตรวจหารายการซ้ำในการนำเข้าข้อมูลหรือไม่ ค่าที่ใช้ได้คือ true หรือ false
isfirstrowheader	ว่าแถวแรกของไฟล์นำเข้ามีชื่อฟิลด์หรือไม่ ค่าที่ใช้ได้คือ true หรือ false
isrecordownerateam	ว่าเจ้าของเรกคอร์ดที่นำเข้าควรเป็นทีมหรือไม่ ค่าที่ใช้ได้คือ true หรือ false
owneruser	รหัสผู้ใช้ที่ควรเป็นเจ้าของเรกคอร์ด ค่าเริ่มต้นคือ ผู้ใช้ที่เข้าสู่ระบบในปัจจุบัน
waitforimporttocomplete	ถ้า true ระบบจะรอให้การนำเข้าเสร็จสมบูรณ์ก่อนดำเนินการต่อ ถ้า false จะจัดคิวงานและทำต่อไป

zipimportdetails องค์ประกอบ

อธิบายไฟล์ zip ที่จะนำเข้าในองค์ประกอบ configdatastorage.filestoimport เมื่อ configimportfile.filetype เป็น zip

มี 1 หรือมากกว่า zipimportdetail องค์ประกอบ เพื่อจัดเตรียมข้อมูลเกี่ยวกับแต่ละไฟล์ในไฟล์ภายในไฟล์ zip ที่ระบุใน configimportfile องค์ประกอบ

zipimportdetail องค์ประกอบ

ให้ข้อมูลเกี่ยวกับแต่ละไฟล์ในไฟล์ภายในไฟล์ zip ที่ระบุใน configimportfile องค์ประกอบ

แอตทริบิวต์ zipimportdetail

Name	Description
filename	ชื่อของไฟล์ที่มีข้อมูลการนำเข้า
filetype	ค่านี่อาจเป็น csv หรือ xml
importtoentity	สามารถเป็นชื่อของไฟล์ exe ในไฟล์ zip หรือ URL หรือไฟล์ .ms เพื่อให้ลิงก์สำหรับเรียกใช้เมื่อสิ้นสุดกระบวนการ

configimportmapfile องค์ประกอบ

มีข้อมูลเกี่ยวกับไฟล์แผนที่แต่ละไฟล์ที่จะนำเข้าใน Dataverse

แอตทริบิวต์ configimportmapfile

Name	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

Name	Description
filename	ชื่อของไฟล์ที่มีข้อมูลการแมป
lcid	การแสดงสตริงของตัวระบุรหัสภาษา LCID
usermapfilename	สำหรับ Dynamics 365 (on-premises) เท่านั้น ประกอบด้วยไฟล์แผนผังผู้ใช้ (.xml) ที่สร้างขึ้นโดยใช้ Configuration Migration tool ในโปรเจ็กต์ของคุณ ไฟล์นี้จำเป็นสำหรับการนำเข้าข้อมูลผู้ใช้ไปยังอินสแตนซ์ Dynamics 365 (on-premises) บนโดเมนอื่น