نشر الحزم باستخدام CRM Package Deployer وWindows PowerShell

تاريخ النشر: صفر, 1438

ينطبق على: Dynamics CRM 2015

يمكّن Microsoft Dynamics CRM Package Deployer المسؤولين من توزيع الحزم على مثيل Microsoft Dynamics CRM (محلي) أو Microsoft Dynamics CRM Online. يمكن أن تتكون "المجموعة" من أي من أو كل الإجراءات التالية:

• ملف حلول CRM واحدًا أو أكثر.

• ملفات ثابتة أو ملفات بيانات تم تصديرها من أداة ترحيل التكوين. لمزيد من المعلومات عن أداة ترحيل التكوين، راجع إدارة بيانات التكوين.

• يتم نشر التعليمات البرمجية المخصصة التي يمكن تشغيلها أثناء أو بعد الحزمة إلى ‏‏Microsoft Dynamics CRM.

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

يقوم المطورون بإنشاء الحزم باستخدام قالب نشر الحزمة في Microsoft Visual Studio.مزيد من المعلومات:MSDN: إنشاء الحزم لأداة CRM Package Deployer

بعد إنشاء حزمة، يمكنك نشرها إما عن طريق تشغيل أداة نشر الحزمة لـ CRM أو باستخدام Windows PowerShell cmdlets للأداة.

في هذا الموضوع

استخدام CRM Package Deployer لنشر الحزم

استخدام Windows PowerShell لنشر الحزم

استكشاف مشكلات نشر الحزمة وإصلاحها باستخدام ملفات السجل

‏‫أفضل الممارسات لنشر الحزم

استخدام CRM Package Deployer لنشر الحزم

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

1. قم بالحصول على الحزمة لنشرها. الحزمة عبارة عن مجموعة من الملفات والمجلدات التي تم إنشاؤها في مجلد مشروع Visual studio الخاص بك (< Project >\Bin\Debug) عند قيامك بإنشاء حزمة المشروع الخاص بك في Visual Studio. انسخ ما يلي من مجلد تصحيح المشروع الخاص بك:

   • < اسم الحزمة > مجلد: يحتوي هذا المجلد على الحلول، قم باستيراد التكوين ومحتويات الحزمة الخاصة بك.

   • < اسم الحزمة >.dll: التجميع الذي يحتوي على التعليمات البرمجية للحزمة الخاصة بك. يكون اسم التجميع بشكل افتراضي هو نفس اسم مشروع Visual Studio الخاص بك.

   للحصول على معلومات مفصلة حول إنشاء حزمة باستخدام Visual Studio، راجع MSDN: إنشاء حزمة لأداة Package Deployer.

   بالنسبة لهذا الموضوع، لنفترض أن مجلد الحزمة والتجميع من مجلد تصحيح المشروع Visual Studio (< المشروع > \Bin\Debug) يتم نسخها إلى مجلد c:\DeployPackage.

2. قم بتنزيل حزمة SDK لـ Microsoft Dynamics CRM. ثم قم بتشغيل الملف القابل للتنفيذ الذي تم تنزيله لاستخراج محتويات الحزمة..

3. استعرض إلى المجلد SDK\Tools\PackageDeployer وانسخ مجلد الحزمة والتجميع من c:\DeployPackage إلى المجلد SDK\Tools\PackageDeployer.

4. وبعد نسخ الملفات، قم بتشغيل الأداة من خلال النقر بشكل مزدوج فوق ملف PackageDeployer.exe في المجلد SDK\Tools\PackageDeployer.

5. انقر فوق متابعة في الشاشة الرئيسية للأداة.

6. في الشاشة اتصال بـ Microsoft Dynamics CRM قم بتوفير تفاصيل المصادقة للتوصيل بخادم CRM الخاص بك حيث تريد توزيع الحزمة. إذا كان لديك مؤسسات متعددة، وترغب في تحديد المؤسسة حيث تريد نشر الحزمة، فحدد خانة الاختيار عرض قائمة المؤسسات المتوفرة دائمًا. انقر فوق تسجيل الدخول.

7. إذا كان لديك مؤسسات متعددة في خادم CRM الخاص بك، وقمت بتحديد خانة الاختيار عرض قائمة المؤسسات المتوفرة دائما، فستظهر لك الشاشة التالية لتحديد المؤسسة المراد التوصيل بها. حدد إحدى منظمات CRM للاتصال بها.

8. ستطالبك الشاشة التالية بتحديد الحزمة ليتم نشرها. فحدد اسم الحزمة الخاصة بك، ثم انقر فوق التالي.

   

9. واتبع الإرشادات على الشاشات اللاحقة لإكمال نشر الحزمة الخاصة بك.

   وتظهر الشاشات استناداً إلى تعريف الحزمة المحددة للنشر. للنشر المتكامل للحزمة التي تستخدم أداة نشر الحزمة، شاهد الموضوع الخاص بنشر حزم Unified Service Desk: نشر عينة تطبيقات مكتب الخدمة الموحد إلى CRM Server باستخدام أداة توزيع الحزم

استخدام Windows PowerShell لنشر الحزم

يوفر أداة نشر الحزمة أيضًا دعم Windows PowerShell لنشر حزم.

قم بتنفيذ الخطوات التالية لاستخدام PowerShell cmdlets لنشر الحزم:

المتطلبات المسبقة

تسجيل أوامر cmdlets

استخدام cmdlet لاسترداد الحزم

استخدام cmdlet للاتصال بخادم CRM الخاص بك

استخدام cmdlet لنشر الحزم

الحصول على تعليمات مفصلة حول cmdlets

المتطلبات المسبقة

فيما يلي المتطلبات الأساسية لاستخدام PowerShell cmdlet:

• ويتطلب الحصول على إصدار 3.0 أو أحدث من PowerShell لنشر الحزمة باستخدام PowerShell. للتحقق من إصدار PowerShell، قم بتشغيل نافذة PowerShell ، ومن ثم تشغيل الأمر التالي: $Host.

• قم بتعيين نهج التنفيذ لتشغيل البرامج النصية لـ PowerShell المسجَّلة. للقيام بذلك، قم بتشغيل النافذة‬ PowerShell كمسؤول، ثم قم بتشغيل الأمر التالي: Set-ExecutionPolicy -ExecutionPolicy AllSigned

تسجيل أوامر cmdlets

يجب عليك تسجيل Windows PowerShell cmdlets لـ أداة نشر الحزمة قبل أن تتمكن من استخدامه. لتسجيل أوامر cmdlets:

1. إذا لم تكن قد فعلت ذلك بالفعل، قم بتنزيل حزمة CRM SDKمن مركز التنزيل لـ Microsoft، وتشغيل ملف الحزمة لاستخراج محتويات الحزمة. لنفترض أنك قمت باستخراج الحزمة إلى المجلد c:\CRM على الكمبيوتر الخاص بك. يصبح أداة نشر الحزمة والملفات الموجودة الأخرى متوفرة في المكان التالي: c:\CRM\SDK\Tools\PackageDeployer.

2. قم ببدء تشغيل Windows PowerShell على جهاز الكمبيوتر الخاص بك مع الامتيازات العالية (تشغيل كمسؤول).

3. في الموجه في النافذة Windows PowerShell، قم بتغيير الدليل إلى المجلد Windows PowerShell ضمن المجلد PackageDeployer. وفي هذه الحالة:

   cd c:\CRM\SDK\Tools\PackageDeployer\PowerShell
   

4. قم بتشغيل البرنامج النصي RegisterXRMTooling.ps1 لتسجيل مجموعة أداة توزيع الحزم Windows PowerShell(dll)، وتثبيت الأداة الإضافية Windows PowerShell لـ أداة نشر الحزمة. للقيام بذلك، اكتب الأمر التالي، واضغط مفتاح الإدخال ENTER:

   .\RegisterXRMTooling.ps1
   

5. قم بإضافة Windows PowerShell للأدوات XRM. وسوف يقوم هذا بتسجيل cmdlets التالية: Get-CrmConnection وGet-CrmOrganizations.

   Add-PSSnapin Microsoft.Xrm.Tooling.Connector
   

6. قم بإضافة Windows PowerShell الإضافية لنشر الحزم. وسوف يقوم هذا بتسجيل cmdlets التالية: Get-CrmPackages وImport-CrmPackage.

   Add-PSSnapin Microsoft.Xrm.Tooling.PackageDeployment
   

وأنت الآن جاهز لاستخدام هذه Windows PowerShell cmdlets. ولسرد cmdlets الذي قمت بتسجيلها، قم بتشغيل الأمر التالي في الموجه في النافذة Windows PowerShell:

Get-Help “Crm”

استخدام cmdlet لاسترداد الحزم

قبل استخدام cmdlet، تأكد أنك قمت بنسخ الحزمة الخاصة بك إلى المجلد PackageDeployer‎ (في هذه الحالة، c:\CRM\SDK\Tools\PackageDeployer). الحزمة عبارة عن مجموعة من الملفات والمجلدات التي تم إنشاؤها في مجلد مشروع Visual Studio الخاص بك (<Project>\Bin\Debug) عندما تقوم بإنشاء المشروع الخاص بك في Visual Studio. قم بنسخ المحتويات الكاملة لمجلد تصحيح المشروع الخاص بك إلى المجلد PackageDeployer‎. للحصول على معلومات تفصيلية حول إنشاء حزمة باستخدام Visual Studio، راجع MSDN: إنشاء الحزم لأداة CRM Package Deployer.

1. في النافذة PowerShell، استخدم cmdlet التالية لإرجاع قائمة بالحزم المتوفرة للاستيراد في الدليل المحدد (في هذه الحالة، c:\CRM\SDK\Tools\PackageDeployer):

   Get-CrmPackages –PackageDirectory c:\CRM\SDK\Tools\PackageDeployer
   

2. إذا كنت تريد معلومات حول حزمة ما في دليل، يمكنك استخدام Get-CrmPackages cmdlet جنبا إلى جنب مع المعلمة – اسم الحزمة لتعيين اسم التجميع في الدليل الذي يحتوي على تعريف الحزمة.

   Get-CrmPackages –PackageDirectory c:\CRM\SDK\Tools\PackageDeployer –PackageName SampleCRMPackage.dll
   

استخدام cmdlet للاتصال بخادم CRM الخاص بك

1. قم بتوفير بيانات الاعتماد الخاصة بك للاتصال بمثيل Microsoft Dynamics CRM Online أو Microsoft Dynamics CRM (محلي). سوف يطلب منك تشغيل الأمر التالي كتابة اسم المستخدم وكلمة المرور للاتصال بمثيل CRM، وسيتم تخزينها في المتغير $Cred، واستخدامها فيما بعد للاتصال بخادم CRM الخاص بك.

   $Cred = Get-Credential
   

2. واستخدم الأمر التالي للحصول على اتصال بمثيل Microsoft Dynamics CRM Online أو Microsoft Dynamics CRM (محلي). وسوف نقوم بتخزين معلومات الاتصال في المتغير $CRMConn:

   • إذا كنت تتصل بالمثيل Microsoft Dynamics CRM (محلي):

     $CRMConn = Get-CrmConnection -ServerUrl http://<your_CRM_Server> -OrganizationName <your_Org_Name> -Credential $Cred
     

   • إذا كنت تتصل بالخادم Microsoft Dynamics CRM Online:

     $CRMConn = Get-CrmConnection -DeploymentRegion NorthAmerica –OnlineType Office365 –OrganizationName <your_Org_Name> -Credential $Cred
     

     ملاحظة

     بالنسبة للمعلمة DeploymentRegion، تكون القيم الصالحة هي أمريكا الشمالية، أوروبا والشرق الأوسط، و أباك. بالنسبة للمعلمة OnlineType‎، تكون القيم الصالحة هي Office365 وLiveID.

3. ويتم التحقق من بيانات الاعتماد التي قمت بتوفيرها عند تشغيل الأمر في الخطوة 2.

استخدام cmdlet لنشر الحزم

بعد ذلك، استخدم معلومات اتصال CRM المخزنة في المتغير $CRMConn لنشر الحزم إلى المثيل CRM. قم بتشغيل الأمر التالي لنشر الحزمة الخاصة بك:

Import-CrmPackage –CrmConnection $CRMConn –PackageDirectory c:\CRM\SDK\Tools\PackageDeployer –PackageName SampleCRMPackage.dll –UnpackFilesDirectory c:\UnpackedFiles -Verbose

الحصول على تعليمات مفصلة حول cmdlets

في النافذة PowerShell، استخدم Get-Help cmdlet باسم "cmdlet" لعرض تعليمات مفصلة عن cmdlet. على سبيل المثال، للحصول على تعليمات مفصلة حول Import-CrmPackage cmdlet:

Get-Help Import-CrmPackage -full

لعرض التعليمات عبر الإنترنت لأوامر cmdlets، راجع مرجع CRM PowerShell.

استكشاف مشكلات نشر الحزمة وإصلاحها باستخدام ملفات السجل

يوفر أداة نشر الحزمة دعم التسجيل للحصول على معلومات تفصيلية حول الأخطاء التي يمكن أن تحدث أثناء تسجيل دخول شخص ما إلى المثيل Microsoft Dynamics CRM باستخدام الأداة وتوزيع الحزم. تقوم الأداة بإنشاء ثلاثة ملفات تسجيل تكون متوفرة في الموقع التالي على الكمبيوتر حيث تقوم بتشغيل الأداة: c:\Users\<اسم المستخدم>\AppData\Roaming\Microsoft\PackageDeployer\<الإصدار>.

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

• PackageDeployer.log: يوفر معلومات تفصيلية حول كل مهمة يتم تنفيذها في الأداة أثناء توزيع الحزم. يمكنك عرض ملف السجل من الأداة بالنقر فوق ارتباط عرض ملف السجل أسفل الشاشة.

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

‏‫أفضل الممارسات لنشر الحزم

أثناء نشر الحزم، يلزم على مسؤولي CRM أن:

• الإصرار على تجميع حزمة تم تسجيل دخولها بحيث يتمكن من تتبع تجميع ما إلى مصدره.

• اختبار الحزمة على مثيل ما قبل الإنتاج (يفضل أن يكون صورة طبق الأصل من مثيل الإنتاج) قبل القيام بتشغيلها على خادم إنتاج.

• القيام بالنسخ الاحتياطي لمثيل الإنتاج قبل نشر الحزمة.

انظر أيضا

MSDN: إنشاء الحزم لأداة CRM Package Deployer
إدارة CRM 2015

‎© 2016 Microsoft Corporation. جميع الحقوق محفوظة. حقوق النشر