نقل بيانات التكوين عبر البيئات والمؤسسات باستخدام أداة ترحيل التكوين

  • مقالة

تتيح لك أداة ترحيل التكوين نقل بيانات التكوين عبر البيئات والمؤسسات. يتم استخدام بيانات التكوين لتعريف الوظائف المخصصة في تطبيقات مشاركة العميل (وهي Dynamics 365 Sales وDynamics 365 Customer Service وDynamics 365 Field Service وDynamics 365 Marketing وDynamics 365 Project Service Automation)، ويتم تخزينها عادةً في كيانات مخصصة. تختلف بيانات التكوين عن بيانات المستخدم النهائي (العميل وجهات اتصال هكذا). مثال نموذجي لبيانات التكوين هو ما قمت بتعريفه في Unified Service Desk لـ Dynamics 365 لتكوين تطبيق مندوب مركز الاتصال. تحدد كيانات Unified Service Desk for Dynamics 365، إلى جانب بيانات التكوين المخزنة في الكيانات، تطبيق مندوب. لمزيد من المعلومات حول Unified Service Desk، راجع دليل Unified Service Desk.

تتيح لك أداة Configuration Migration ما يلي:

  • تحديد الكيانات والحقول التي تريد تصدير بيانات التكوين منها.

  • تجنب السجلات المكررة في النظام الهدف عن طريق تعريف شرط فريد لكل كيان استناداً إلى مجموعة حقول في الكيان، والتي تستخدم لمقارنتها بالقيم الموجودة في النظام الهدف. في حالة عدم وجود قيم مطابقة، يتم إنشاء سجل فريد في النظام الهدف. إذا تم العثور على سجل مطابق، يتم تحديث السجل على النظام الهدف.

    ‏‫ملاحظة‬

    إذا لم يتم تحديد شرط (تفرد) الكشف عن التكرارات للكيان الذي يتم تصديره، فإن الأداة تستخدم اسم الحقل الأساسي للكيان لمقارنتها بالبيانات الموجودة على النظام الهدف.

  • تعطيل المكونات الإضافية قبل تصدير البيانات ومن ثم إعادة تمكينها على النظام الهدف بعد اكتمال عملية الاستيراد لكافة الوحدات أو الكيانات المحددة.

  • التحقق من صحة مخطط الكيانات المحددة ليتم تصديرها للتأكد من وجود كافة البيانات/المعلومات المطلوبة.

  • إعادة استخدام مخطط موجود لتصدير بيانات من نظام المصدر.

  • نقل حقول DateTime إلى الأمام في الاستيراد لبيئات العرض التوضيحي تلقائيًا.

  • تضمين الوحدات المصدرة التي تم إنشاؤها من هذه الأداة (ملفات المخطط والبيانات) في البرامج الأخرى. على سبيل المثال، يمكنك استخدام البيانات التي تم تصديرها إلى Package Deployer مع ملفات وبيانات الحلول الأخرى لإنشاء ونشر حزم على بيئة. مزيد من المعلومات: نشر حزم باستخدام Package Deployer

تتوفر أداة ترحيل التكوين كحزمة NuGet أو يمكنك تنزيل الأداة باستخدام Power Platform CLI.

كيف تعمل أداة Configuration Migration؟

يوضح الرسم التخطيطي التالي كيف يتم استخدام أداة Configuration Migration لترحيل بيانات التكوين.

الرسم التخطيطي لتدفق عمليات ترحيل التكوين.

رمز الخطوة 1تعريف مخطط بيانات المصدر ليتم تصديره: يحتوي ملف المخطط (xml.) على معلومات عن البيانات التي تريد تصديرها مثل الكيانات والسمات والعلاقات وتعريف تفرد البيانات وما إذا كانت المكونات الإضافية يجب تعطيلها قبل تصدير البيانات. مزيد من المعلومات: إنشاء مخطط لتصدير بيانات التكوين

رمز الخطوة 2استخدام المخطط لتصدير البيانات: استخدم ملف المخطط لتصدير البيانات إلى ملف zip. يحتوي على البيانات ومخطط البيانات المصدّرة. مزيد من المعلومات: إنشاء مخطط لتصدير بيانات التكوين

رمز الخطوة 3استيراد البيانات المصدّرة: استخدم البيانات المصدّرة (ملف zip.) لاسترادها إلى البيئة الهدف. يتم استيراد البيانات في عدة مسارات، الأول استيراد بيانات أساس أثناء انتظار إعداد البيانات التابعة، والثاني استيراد البيانات التابعة في المسارات اللاحقة لمعالجة أية تبعيات أو روابط للبيانات. وهذا يضمن استيراد بيانات نظيف. مزيد من المعلومات: استيراد بيانات التكوين.

استكشاف مشكلات ترحيل بيانات التكوين باستخدام ملفات السجل

توفر أداة ترحيل التكوين دعم تسجيل للحصول على معلومات مفصلة حول الأخطاء التي تحدث أثناء تسجيل الدخول إلى البيئة باستخدام الأداة، والأنشطة التي تنفذها الأداة أثناء تعريف المخطط وتصدير/استيراد بيانات التكوين، والمعلومات حول البيانات التي تم استيرادها باستخدام الأداة. توجد ثلاثة ملفات سجل تم إنشاؤها بواسطة الأداة وهي متوفرة في الموقع التالي على الكمبيوتر حيث تقوم بتشغيل الأداة: c:\Users\<UserName>\AppData\Roaming\Microsoft\Microsoft Dataverse Configuration Migration Tool\<Version>.

  • Login_ErrorLog.log: يوفر معلومات عن المشكلات التي حدثت عند قيامك باستخدام الأداة لتسجيل الدخول إلى البيئة. وإذا كان هناك أي مشكلات أثناء تسجيل الدخول، فستظهر رسالة على شاشة تسجيل دخول الأداة مع ارتباط إلى ملف السجل هذا. وتفيد الرسالة أنه حدث خطأ أثناء معالجة طلب تسجيل الدخول ويمكن للمستخدم عرض سجل الخطأ. يمكنك النقر فوق الارتباط الموجود في الرسالة لعرض ملف السجل هذا. يتم إنشاء ملف السجل في المرة الأولى لمواجهتك أية مشكلات خاصة بتسجيل الدخول في الأداة. ولذلك، يُستخدم ملف السجل لتسجيل المعلومات التي تخص المشكلات الخاصة بتسجيل الدخول، متى تحدث.

  • DataMigrationUtility.log: يوفر معلومات مفصلة حول كل مهمة يتم إجراؤها في الأداة أثناء التشغيل الأخير. يمكنك عرض ملف السجل من الأداة بالنقر فوق قائمة سجلات على الشاشة الرئيسية، والنقر فوق سجل التشغيل.

  • ImportDataDetail.log: يوفر معلومات مفصلة حول البيانات المستوردة في آخر مهمة استيراد باستخدام الأداة. في كل مرة تشغيل استيراد مهمة باستخدام هذه الأداة، يتم نقل التفاصيل الموجودة من ملف السجل إلى ملف يسمى ImportDataDetail._old.log في نفس الدليل، وملف ImportDataDetail.log يعرض معلومات حول أحدث استيراد مهمة باستخدام الأداة. يمكنك عرض ملف السجل هذا من الأداة بالنقر فوق قائمة سجلات على الشاشة الرئيسية، ثم النقر فوق آخر سجل استيراد.

أفضل الممارسات لترحيل بيانات التكوين الخاص بك باستخدام الأداة

وفيما يلي أشياء يجب أخذها في الاعتبار أثناء استخدام هذه الأداة لترحيل بيانات التكوين الخاص بك:

  • أثناء إنشاء مخطط تصدير البيانات، يجب عليك تعريف قواعد تفرد مناسب لكل كيان لتجنب أية تحديثات بيانات غير مقصود على النظام الهدف.

  • استيراد البيانات التي تم تصديرها في بيئة ما قبل الإنتاج (يفضل صورة معكوسة لبيئة الإنتاج) للتأكد من أن نتائج استيراد البيانات كما تريد.

  • إجراء نسخة احتياطية من بيئة الإنتاج الخاصة بك قبل استيراد البيانات.

القيود

  • ترحيل كيان التقويم غير مدعوم.
  • ترحيل عمود الصورة غير مدعوم.

(راجع أيضًا)

تنزيل الأدوات من NuGet
إنشاء مخطط لتصدير بيانات التكوين
تعديل مخطط بيانات تكوين
استيراد بيانات التكوين
إدارة تكوين كتالوج المنتج