مشاركة عبر

مرجع 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) على مجال مختلف.