مرجع 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

كل هذه السمات اختيارية.

الاسم	الوصف
installsampledata	ما إذا كان يجب تثبيت عينة بيانات. هذه هي عينة البيانات نفسها المثبتة باستخدام هذه الطرق الأخرى: - إضافة بيانات عينة أو إزالتها - إضافة بيانات نموذجية وإزالتها باستخدام التعليمات البرمجية
waitforsampledatatoinstall	إذا تم تعيين true وأيضًا installsampledata إلى true، فانتظر تثبيت عينة البيانات قبل نشر الحزمة. لا تعيّن هذا إلى true عندما يكون installsampledatafalse.
agentdesktopzipfile	اسم الملف الخاص بملف zip لفك الحزمة. إذا قمت بتحديد اسم ملف zip. هنا، فسيضيف شاشة اثناء عملية نشر الحزمة التي تطالبك بتحديد موقع حيث تريد فك حزمة محتويات الملف. وتُستخدم هذه السمة عادةً لإنشاء حزم Unified Service Desk لـ Dynamics 365.
agentdesktopexename	اسم ملف exe. أو msi. الموجودين في ملف zip أو URL لاستدعائه في نهاية عملية النشر. وتُستخدم هذه السمة عادةً لإنشاء حزم Unified Service Desk لـ Dynamics 365.
crmmigdataimportfile	اسم الملف لملف بيانات التكوين الافتراضي (zip.) الذي تم تصديره باستخدام أداة ترحيل التكوين.

عناصر configdatastorage

هذه هي العناصر التابعة غير الصالحة:

العنصر	الأوصاف
solutions	يتضمن 0 أو العديد من عناصر configsolutionfile التي تصف الحلول التي يتم استيرادها.
filestoimport	يحتوي على - 1 أو العديد من عناصر configimportfile - 0 أو العديد من عناصر zipimportdetails التي تصف الملفات الفردية والملفات المضغوطة التي سيتم استيرادها.
filesmapstoimport	يحتوي على عنصر واحد أو العديد من عناصر configimportmapfile. يشير ترتيب ملفات الخرائط في هذا العنصر إلى الترتيب الذي يتم استيرادها به. مزيد من المعلومات حول إنشاء خرائط البيانات للاستيراد
cmtdatafiles	يحتوي على عنصر واحد أو العديد من عناصر cmtdatafile التي تحتوي على إصدار مترجم من ملف بيانات التكوين الذي سيتم استيراده.

configsolutionfile عنصر

يصف الحلول التي يتم استيرادها في العنصر configdatastorage.solutions.

سمات configsolutionfile

الاسم	الوصف
solutionpackagefilename	مطلوب حدد اسم الملف .zip للحل الخاص بك.
overwriteunmanagedcustomizations	اختياري ما إذا كنت تريد الكتابة فوق أي تخصيصات غير مدارة عند استيراد حل موجود بالفعل في البيئة الهدف. إذا لم تحدد هذا السلوك، فسيتم الاحتفاظ بالتخصيصات غير المدارة في الحل الموجود في البيئة الهدف.
publishworkflowsandactivateplugins	اختياري ما إذا كنت تريد نشر مهام سير العمل وتنشيط المكونات الإضافية في البيئة الهدف بعد استيراد الحل. إذا لم تحدد هذا السلوك، يتم نشر سير العمل وتنشيط المكونات الإضافية.

configimportfile عنصر

يصف الملفات التي يتم استيرادها في العنصر configdatastorage.filestoimport.

سمات configimportfile

الاسم	الوصف
filename	اسم الملف الذي يحتوي على البيانات المستوردة.
filetype	بإمكان هذه القيمة أن تكون csv أو xml أو zip. إذا كان الملف عبارة عن ملف zip.، فيلزم وجود عنصر zipimportdetails مع عنصر zipimportdetail لكل ملف في ملف zip.
associatedmap	اسم مخطط بيانات الاستيراد في Dataverse الذي سيتم استخدامه مع هذا الملف. إذا كان فارغًا، فسيحاول Dataverse استخدام اسم مخطط بيانات الاستيراد المحدد بواسطة النظام لهذا الملف.
importtoentity	بإمكانه أن يكون اسم ملف exe في ملف zip أو عنوان URL أو ملف msi. لتوفير ارتباط لاستدعائه في نهاية العملية.
datadelimiter	اسم محدِّد البيانات المستخدم في ملف الاستيراد. القيم الصالحة هي علامات اقتباس مفردة أو علامات اقتباس مزدوجة.
fielddelimiter	اسم محدِّد الحقل المستخدم في ملف الاستيراد. القيم الصالحة هي الفاصلة أو النقطتين أو علامة الاقتباس الفردية.
enableduplicatedetection	ما إذا كان يجب تمكين قواعد الكشاف عن التكرارات عند استيراد البيانات. القيم الصالحة هي true أو false.
isfirstrowheader	ما إذا كان الصف الأول من ملف الاستيراد يحتوي على أسماء الحقول. القيم الصالحة هي true أو false.
isrecordownerateam	ما إذا كان يجب على مالك السجل الذي سيتم استيراده أن يكون فريقًا. القيم الصالحة هي true أو false.
owneruser	معرف المستخدم الذي يجب أن يمتلك السجلات. القيمة الافتراضية هي المستخدم الذي سجل دخوله في الوقت الحالي.
waitforimporttocomplete	إذا كانت القيمة true، ينتظر النظام حتى اكتمال الاستيراد قبل المتابعة. وإذا كانت القيمة false، فسيضع المهام في قائمة انتظار ويتابع.

zipimportdetails عنصر

وصف ملفات zip لاستيرادها في العنصر configdatastorage.filestoimport عندما يكون configimportfile.filetypezip.

يحتوي على عنصر واحد أو المزيد من عناصر zipimportdetail التي توفر معلومات حول ملف فردي ضمن ملف zip المحدد في عنصر configimportfile.

zipimportdetail عنصر

توفير معلومات حول ملف فردي ضمن ملف zip المحدد في عنصر configimportfile.

سمات zipimportdetail

الاسم	الوصف
filename	اسم الملف الذي يحتوي على البيانات المستوردة.
filetype	بإمكان هذه القيمة أن تكون csv أو xml.
importtoentity	بإمكانه أن يكون اسم ملف exe في ملف zip أو عنوان URL أو ملف msi. لتوفير ارتباط لاستدعائه في نهاية العملية.

configimportmapfile عنصر

يحتوي على معلومات حول ملف مخطط فردي لاستيراده في Dataverse.

سمات configimportmapfile

الاسم	الوصف
filename	اسم الملف الذي يحتوي على بيانات التعيين.

cmtdatafile عنصر

تحديد ملفات بيانات التكوين المترجمة إلى جانب معرف الإعدادات المحلية (مطلوب) وملف خريطة معلومات المستخدم (اختياري).

مثال cmtdatafile

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

سمات cmtdatafile

الاسم	الوصف
filename	اسم الملف الذي يحتوي على بيانات التعيين.
lcid	تمثيل السلسلة لمعرف رمز لغة LCID.
usermapfilename	من أجل Dynamics 365 (on-premises) فقط. يتضمن ملف مخطط المستخدم (xml.) الذي تم إنشاؤه باستخدام أداة ترحيل التكوين في المشروع. هذا الملف مطلوب لاستيراد معلومات المستخدم إلى مثيل Dynamics 365 (on-premises) على مجال مختلف.