تَوزيع التطبيقَات باستخدَام Package Deployer

  • 4 دقائق

يُتيح Package Deployer للمسؤولين نشر الحزم فِي بيئَات Microsoft Dataverse. كمَا يستخدم موردي البرَامج المستقلين (ISVs) هذه الحزم لنشر حلول معتمدة لبيئَات العملاء. يُمكن للمطورين المسَاعدة فِي تكوين الحزمة وإنشَاء التعليمَات البرمجية التي تعمل فِي أثنَاء مرَاحل التثبيت.

تختلف حزمة النشر عن Dataverse الحل الفردي حيث يمكنهَا تثبيت تطبيق كَامل بمَا فِي ذلك الحلول المتعددة والبيَانَات المرجعية وتثبيت المنطق المخصص. يمكن أن تتكون الحزمة مِن أي ممَا يلي أو جميعه:

  • ملف أو أكثر مِن ملفات Dataverse

  • ملفات ثَابتة أو ملف بيَانَات تكوين مصدر مِن ‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫أدَاة "ترحيل التكوين"

  • التعليمَات البرمجية المخصصة التي يُمكن تَشغيلهَا قبل أو فِي أثنَاء أو بعد نشر الحزمة إلى مثيل Dataverse

  • محتوى HTML خَاص بالحِزمة التي يمكن عرضهَا فِي بدَاية عملية التَوزيع ونهَايتهَا. قد يكون هذا مفيد لتوفير وصف للحلول والملفات المنشورة فِي الحزمة.

بنَاء حزمة

توفر Microsoft قَالب Visual Studio لإنشَاء حزم. قد يختلف مستوى الجهد حسب مقدَار التعليمَات البرمجية المخصصة المضمنة للتنفيذ فِي أثنَاء التثبيت. فِي كثير مِن الأحيَان، تتضمن الحزمة واحدًا أو أكثر مِن الحلول والبيَانَات. فيمَا يلي خطوات إنشَاء حزمة التَوزيع:

رسم تخطيطي لخطوات إنشَاء حزمة التَوزيع.

يمكنك تهيئة مجلد باستخدَام قَالب مشروع النشر وإنشَاء الحزمة الأولية الخَاصة بك باستخدَام واجهة سطر الأوامر Power Platform (CLI). يتم استخدَام الأمر التَالي لملء مجلد:

pac package init --outputDirectory MyPackage

بمجرد التهيئة، يمكنك البدء فِي تخصيصه لينَاسب احتيَاجَاتك المحددة. على سبيل المثَال، إذا أردت إنشَاء حزمة لنشر Dataverse حلين، فيمكنك تَشغيل الأوامر التَالية لتكوين الحزمة لتضمينهمَا.

pac package add-solution --path ..\MySolution1_1_0_0_2_managed.zip
pac package add-solution --path ..\MySolution2_2_0_0_0_managed.zip

يمكنك إضَافة منطق مخصص عن طريق تحرير فئة PackageImportExtension.cs وإضَافة منطق إلى معَالج الأحدَاث المنَاسب. فيمَا يلي الأحدَاث المتَاحة التي يمكنك إضَافة المنطق الخَاص بك لتَشغيلهَا:

  • InitializeCustomExtension - يتم استدعَاؤه لتهيئة أي وظَائف فِي الملحق المُخصص.

  • BeforeImportStage - يتم استدعَاؤه قبل بدء عملية الاستيرَاد الرئيسية، بعد الحلول والبيَانَات.

  • PreSolutionImport - يتم رفعه قبل استيرَاد الحل المسمى للسمَاح بإجرَاء أي إعدَادَات تكوين لعملية الاستيرَاد.

  • RunSolutionUpgradeMigrationStep - يتم استدعَاؤه أثنَاء ترقية الحل عندمَا يكون كلا الحلين، القديم والجديد، موجودين فِي النظَام. يمكن استخدَام هذه الوظيفة لتوفير وسيلة لتحويل البيَانَات أو ترقيتهَا أثنَاء حدوث تحديث للحل.

  • AfterPrimaryImport - يتم استدعَاؤه بعد اكتمَال جميع خطوات الاستيرَاد، ممَا يسمح بالتخصيصَات النهَائية أو ضبط البيئة.

يمكنك أيضًا إجرَاء تخصيصَات أخرى عن طريق إجرَاء تغييرَات عَلى ملفات التكوين مباشرةً.

فور تكوينهَا وإضَافة أي تعليمَاتٍ برمجيةٍ مخصصةٍ، يمكنك إنشَاء الحزمة لإعدَادهَا للتَوزيع. يمكنُك تَحمِيل ملف .csproj فِي Visual Studio أو استخدَام أمر dotnet لتَشغيل MSBuild. يوضح مَا يلي أمر إنشَاء الحزمة مِن سطر الأوامر:

dotnet publish

يؤدي إنشَاء الحزمة إلى إنشَاء ملف .zip يحتوي عَلى كل مَا مطلوب لتَوزيع الحزمة.

تَوزيع الحزمة

فور تكوين الحزمة، يمكن نشرهَا فِي Dataverse البيئَات باستخدَام إحدى الطرق التَالية:

  • CLI - يستخدمُ هَذا النهجُ Power Platform CLI لمُصَادقة البِيئةَ المُستهدفة وتَشغِيل أمر pac package deploy.

  • بشكل تفاعلي - يوفر استخدَام هذا الأسلوب معَالجًا مثل تجربة مستخدم له حق الوصول الإدَاري إلى البيئة لتثبيت الحزمة. ومع تقدم التثبيت، يتم إعلام المستخدم بصريًا بالتقدم. يستخدم هذا الخيَار تطبيق Windows Package Deployment Tool الذي يمكن تَشغيله باستخدَام الأمر pac tool pd.

  • Windows PowerShell - يسمح استخدَام هذا الأسلوب بتثبيت سطر الأوامر. هذا النهج منَاسب للحزم الموزعة كجُزء من عملية مؤتمتة.

  • AppSource - يُستخدَم هذا النهج عند تحديد عرض ISV للتثبيت من مدخل AppSource.

يُمكنك قرَاءة المزيد عن كيفية عمل النشر مع هذه الطرق فِي نشر الحزم باستخدَام Package Deployer وWindows PowerShell.

تضمين البيَانَات

واحدة مِن الأشيَاء الرئيسية التي تميز Package Deployer عن مجرد تثبيت الحل هو أنه يمكنك تضمين بيَانَات المرجع / التكوين عَلى أنه جُزء مِن حزمة التَوزيع.

تُستخدم ‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫أدَاة ترحيل التكوين لنقل التكوين واختبار البيَانَات مِن بيئة إلى أخرى. إذ أنهَا توفر وسَائل التقَاط مثل هذه البيَانَات، وتضمين تلك البيَانَات فِي مستودع التحكم فِي المصدر، واستخدَام تلك البيَانَات لأتمتة الاختبار. يمكن استخدَام هذه ‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫أدَاة بشكل مستقل، ومع ذلك، يمكن تضمين ملف data.zip الذي تنتجه كمخرجَات كجُزء مِن حزمة النشر. الخطوات عَالية المستوى هي:

  1. تحديد مخطط البيَانَات المصدر المرَاد تصديرهَا

  2. استخدم المخطط لتصدير البيَانَات

  3. استيرَاد البيَانَات المُصدرة

الرسومَات التخطيطية التَالية لعملية استخدَام ‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫أدَاة:

رسم تخطيطي لعملية مخطط التكوين لاستخدَام ‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫أدَاة.

عند استخدَامه مع Package Deployer ملف الإخرَاج .zip، يمكن تضمينه فِي حزمة النشر.

فيمَا يلي بعض الفوائد الأسَاسية لاستخدَام ترحيل التكوين لإعدَاد البيَانَات:

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

  • حلّل العلاقَات بين السجلات وتَشغيل الاستيرَاد باستخدَام الاجتيَازَات المتعددة لضمَان سلامة البيَانَات.

  • استخدم أي استعلام لتعريف مجموعة فرعية مِن السجلات لتضمينهَا فِي الحزمة.

  • تجنب تكرَار السجلات فِي النظَام الهدف بتعريف شرط تفرد لكل جدول بنَاءً عَلى مجموعة مِن الأعمدة فِي الجدول، التي تُستخدم للمقَارنة مع القيم الموجودة فِي النظَام الهدف.

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

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

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

  • نقل القيم تلقَائيًا إلى التَاريخ وتحديد الأعمدة عند الاستيرَاد للحفاظ عَلى تحديث البيَانَات فِي بيئَات العرض التوضيحي.

يتيح لك استخدَام Package Deployer فِي نشر التطبيقَات تضمين ملفات حلول متعددة، وبيَانَات، وتنفيذ منطق مخصص فِي أثنَاء عملية التثبيت. يُمكن للمسؤولين استخدَام تجربة مثبّت تشبه المعَالج ولا دَاعي للقلق بشأن كيفية تثبيت المكونَات الفردية أو استيرَاد بيَانَات التكوين.