مهام Microsoft Power Platform Build Tools
تصف الأقسام التالية مهام البناء المتوفرة. بعد ذلك، نعرض بعض الأمثلة على استخدام Azure Pipelines لهذه المهام. للحصول على معلومات حول أدوات الإنشاء وكيفية تنزيلها، راجع Microsoft Power Platform Build Tools لـ Azure Pipelines.
مهمة المساعد
يوجد وصف المهام المساعدة المتوفرة أدناه.
برنامج تثبيت أداة Power Platform
يجب إضافة هذه المهمة مرة واحدة قبل أي مهام Power Platform Build Tools أخرى في البنية الأساسية لبرنامج ربط العمليات التجارية للإنشاء والإصدار. تقوم هذه المهمة بتثبيت مجموعة من أدوات Power Platform المعينة التي يحتاج إليها المندوب لتشغيل مهام البناء في Microsoft Power Platform. لا تتطلب هذه المهمة أي مزيد من التكوين عند إضافتها. تحتوي هذه المهمة على معلمات للإصدارات المحددة لكل من الأدوات التي يتم تثبيتها.
لمتابعة التحديث بإصدارات الأدوات بمرور الوقت، تأكد من مطابقة هذه المعلمات لإصدارات الأدوات اللازمة لتشغيل البنية الأساسية لبرنامج ربط العمليات التجارية بصورة صحيحة.
قصاصة برمجية YAML (المثبت)
# Installs default Power Platform Build Tools
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.tool-installer.PowerPlatformToolInstaller@2
displayName: 'Power Platform Tool Installer'
# Installs specific versions of the Power Platform Build Tools
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.tool-installer.PowerPlatformToolInstaller@2
displayName: 'Power Platform Tool Installer'
inputs:
DefaultVersion: false
XrmToolingPackageDeploymentVersion: 3.3.0.928
المعلمات (المثبت)
المعلمات | الوصف |
---|---|
DefaultVersion استخدام إصدارات الأدوات الافتراضية |
قم بالتعيين إلى صواب لاستخدام الإصدار الافتراضي لجميع الأدوات، وإلا خطأ. مطلوب (و خطأ) عندما يتم تحديد أية إصدارات أدوات. |
PowerAppsAdminVersion XrmToolingPackageDeploymentVersion MicrosoftPowerAppsCheckerVersion CrmSdkCoreToolsVersion إصدار الأداة |
الإصدار المحدد من الأداة التي يجب استخدامها. |
Power Platform WhoAmI
تتحقق من اتصال خدمة بيئة Power Platform من خلال الاتصال وإجراء طلب WhoAmI. يمكن أن تكون هذه المهمة مفيدة لتضمينها في البنية الأساسية لبرنامج ربط العمليات التجارية مبكرًا، للتحقق من الاتصال قبل بدء المعالجة.
قصاصة برمجية YAML (WhoAmI)
# Verifies an environment service connection
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.whoami.PowerPlatformWhoAmi@2
displayName: 'Power Platform WhoAmI'
inputs:
# Service Principal/client secret (supports MFA)
authenticationType: PowerPlatformSPN
PowerPlatformSPN: 'My service connection'
# Verifies an environment service connection
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.whoami.PowerPlatformWhoAmi@2
displayName: 'Power Platform WhoAmI'
inputs:
# Username/password (no MFA support)
PowerPlatformEnvironment: 'My service connection'
المعلمات (WhoAmI)
المعلمات | الوصف |
---|---|
authenticationType نوع المصادقة |
(اختياري) حدد إما PowerPlatformEnvironment لاتصال اسم مستخدم/كلمة مرور أو PowerPlatformSPN لاتصال سري لمسؤول الخدمة/العميل. لمزيد من المعلومات، راجع BuildTools.EnvironmentUrl ضمن Power Platform إنشاء بيئة |
PowerPlatformEnvironment عنوان URL لبيئة Power Platform |
نقطة نهاية خدمة البيئة المطلوب الاتصال بها. تم تحديده ضمن اتصالات الخدمة في إعدادات المشروع. لمزيد من المعلومات، راجع BuildTools.EnvironmentUrl ضمن Power Platform إنشاء بيئة |
PowerPlatformSPN مسؤول الخدمة Power Platform |
نقطة نهاية خدمة البيئة المطلوب الاتصال بها. تم تحديده ضمن اتصالات الخدمة في إعدادات المشروع. |
فحص الجودة
في القسم التالي توجد المهام المتاحة للتحقق من جودة الحل.
مدقق Power Platform
تُجري هذه المهمة فحص تحليل ثابت على الحلول مقابل مجموعة من قواعد أفضل الممارسات لتحديد الأنماط التي تنطوي على مشاكل التي ربما لم تكن مقصودة عند بناء الحل.
قصاصة برمجية YAML (المدقق)
# Static analysis check of your solution
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.checker.PowerPlatformChecker@2
displayName: 'Power Platform Checker '
inputs:
PowerPlatformSPN: 'Dataverse service connection'
RuleSet: '0ad12346-e108-40b8-a956-9a8f95ea18c9'
# Static analysis check of your solution
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.checker.PowerPlatformChecker@2
displayName: 'Power Platform Checker '
inputs:
PowerPlatformSPN: 'Dataverse service connection'
UseDefaultPACheckerEndpoint: false
CustomPACheckerEndpoint: 'https://japan.api.advisor.powerapps.com/'
FileLocation: sasUriFile
FilesToAnalyzeSasUri: 'SAS URI'
FilesToAnalyze: '**\*.zip'
FilesToExclude: '**\*.tzip'
RulesToOverride: 'JSON array'
RuleSet: '0ad12346-e108-40b8-a956-9a8f95ea18c9'
المعلمات (المدقق)
المعلمات | الوصف |
---|---|
PowerPlatformSPN اتصال الخدمة |
(مطلوب) يلزم وجود اتصال ببيئة Microsoft Power Platform مرخصة لاستخدام مدقق Power Platform. يتم تعريف اتصالات الخدمة في اتصالات الخدمة ضمن إعدادات المشروع باستخدام نوع الاتصال Power Platform. مزيد من المعلومات: راجع BuildTools.EnvironmentUrl ضمن Power Platform إنشاء بيئةملاحظة: تتوفر طرق مصادقة كيان الخدمة واسم المستخدم/كلمة المرور لمهمة المدقق. للحصول على مزيد من المعلومات حول كيفية تكوين كيانات الخدمة التي سيتم استخدامها مع هذه المهمة، راجع تكوين اتصالات كيان الخدمة لبيئات Power Platform. |
UseDefaultPACheckerEndpoint استخدام نقطة نهاية مدقق Power Platform الافتراضية |
بشكل افتراضي (صواب)، يستخدم الموقع الجغرافي لخدمة المدقق المنطقة الجغرافية نفسها للبيئة التي تتصل بها. |
CustomPACheckerEndpoint نقطة نهاية مدقق PAC مخصص |
مطلوب عندما يكون UseDefaultPACheckerEndpoint معين إلى خطأ. يمكنك تحديد منطقة جغرافية أخرى لاستخدامها، على سبيل المثال https://japan.api.advisor.powerapps.com. للحصول على قائمة بالمناطق الجغرافية المتاحة، راجع استخدام واجهة API لمدقق Power Platform. |
FileLocation موقع الملفات للتحليل |
مطلوب عند الإشارة إلى ملف من عنوان URL لتوقيع الوصول المشترك (SAS).sasUriFile .ملاحظة: من المهم الإشارة إلى ملف الحل الذي تم تصديره وليس الملفات المصدر التي تم فك حزمتها في المستودع الخاص بك. يمكن تحليل ملفات الحلول المُدارة وغير المُدارة. |
FilesToAnalyzeSasUri ملفات SAS لتحليلها |
مطلوب عند تعيين FileLocation إلى sasUriFile . أدخل عنوان URI لتوقيع SAS. يمكنك إضافة أكثر من SAS URI واحد من خلال قائمة مفصولة بفاصلة (،) أو فاصلة منقوطة (;). |
FilesToAnalyze ملفات محلية لتحليلها |
مطلوب عندما لا يتم تحليل ملفات SAS. حدد المسار واسم الملف لملفات zip التي سيتم تحليلها. يمكن استخدام أحرف البدل. على سبيل المثال، يمكنك إدخال **\*.zip لجميع ملفات zip في جميع المجلدات الفرعية. |
FilesToExclude ملفات محلية لاستبعادها |
حدد أسماء الملفات التي سيتم استبعادها من التحليل. إذا كانت أكثر من ملف واحد، فاذكرها من خلال قائمة مفصولة باستخدام فاصلة (،) أو فاصلة منقوطة (؛). يمكن أن تتضمن هذه القائمة اسم ملف كامل أو اسمًا يحتوي على أحرف بدل بادئة أو لاحقة، مثل *jquery أو form.js |
RulesToOverride قواعد التجاوز |
تحتوي مصفوفة JSON على قواعد التجاوز ومستوياته. القيم المقبولة لمستوى التجاوز هي: هامة، شديدة الأهمية، متوسطة الأهمية، منخفضة الأهمية، معلوماتية. مثال: [{"Id":"meta-remove-dup-reg","OverrideLevel":"Medium"},{"Id":"il-avoid-specialized-update-ops","OverrideLevel":"Medium"}] |
RuleSet مجموعة القواعد |
(مطلوب) حدد مجموعة القواعد التي سيتم تطبيقها. تتوفر مجموعتا القواعد التاليتان:
|
ErrorLevel مستوى الخطأ |
يتحد مع معلمة حد الخطأ لتحديد خطورة الأخطاء والتحذيرات المسموح بها. قيم الحد المدعومة هي <level>IssueCount حيث المستوى= هامة وشديدة الأهمية ومتوسطة الأهمية منخفضة ومعلوماتية. |
ErrorThreshold حد الخطأ |
تحدد عدد الأخطاء (>=0) لمستوى محدد يسمح للمدقق بتمرير الحلول التي يتم التحقق منها. |
FailOnPowerAppsCheckerAnalysisError فشل في الخطأ |
عند تعيين صواب، يكون الخطأ عندما يتم إرجاع تحليل مدقق Power Apps على أنه فشل أو FinishedWithErrors. |
ArtifactDestinationName اسم البيانات المصطنعة DevOps |
حدد اسم Azure Artifacts لملف المدقق .sarif. |
مهام الحل
بإمكان مجموعة المهام هذه تنفيذ إجراءات الحل بشكل تلقائي. تقوم مهام البيئة الموضحة لاحقًا في هذا القسم والتي تقوم بإنشاء بيئة أو نسخها أو استعادتها بالكتابة فوق اتصالات الخدمة مع البيئات التي تم إنشاؤها حديثًا. تتيح هذه المهام تنفيذ مهام الحل في مقابل البيئات التي يتم إنشاؤها حسب الطلب.
استيراد حل في Power Platform
استيراد حل إلى بيئة هدف.
قصاصة برمجية YAML (استيراد)
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.import-solution.PowerPlatformImportSolution@2
displayName: 'Power Platform Import Solution '
inputs:
PowerPlatformEnvironment: 'My service connection'
SolutionInputFile: 'C:\Public\Contoso_sample_1_0_0_1_managed.zip'
HoldingSolution: true
OverwriteUnmanagedCustomizations: true
SkipProductUpdateDependencies: true
ConvertToManaged: true
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.import-solution.PowerPlatformImportSolution@2
displayName: 'Power Platform Import Solution '
inputs:
authenticationType: PowerPlatformSPN
PowerPlatformSPN: 'Dataverse service connection '
SolutionInputFile: 'C:\Public\Contoso_sample_1_0_0_1_managed.zip'
AsyncOperation: true
MaxAsyncWaitTime: 60
PublishWorkflows: false
المعلمات (استيراد)
المعلمات | الوصف |
---|---|
authenticationType نوع المصادقة |
(مطلوب لـ SPN) حدد إما PowerPlatformEnvironment لاتصال اسم مستخدم/كلمة مرور أو PowerPlatformSPN لاتصال سري لمسؤول الخدمة/العميل. |
PowerPlatformEnvironment عنوان URL لبيئة Power Platform |
نقطة نهاية الخدمة التي تريد استيراد الحل إليها (على سبيل المثال، https://powerappsbuildtools.crm.dynamics.com ). نحدد ضمن اتصالات الخدمة في إعدادات المشروع باستخدام نوع الاتصال Power Platform. لمزيد من المعلومات، راجع BuildTools.EnvironmentUrl ضمن Power Platform إنشاء بيئة |
PowerPlatformSPN مسؤول الخدمة Power Platform |
نقطة نهاية الخدمة التي تريد استيراد الحل إليها (على سبيل المثال، https://powerappsbuildtools.crm.dynamics.com ). نحدد ضمن اتصالات الخدمة في إعدادات المشروع باستخدام نوع الاتصال Power Platform. لمزيد من المعلومات، راجع BuildTools.EnvironmentUrl ضمن Power Platform إنشاء بيئة |
SolutionInputFile ملف إدخال الحل |
(مطلوب) المسار واسم ملف solution.zip لاستيراده إلى البيئة الهدف (على سبيل المثال، $(Build.ArtifactStagingDirectory)$(SolutionName).zip). ملاحظة: تمنحك المتغيرات طريقة ملائمة للحصول على أجزاء رئيسية من البيانات في أجزاء مختلفة من خط الأنابيب الخاص بك. راجع استخدام متغيرات معرّفة مسبقًا للحصول على قائمة شاملة. |
HoldingSolution استيراد كحل انتظار |
معلمة متقدمة (صواب|خطأ) تُستخدم عند الحاجة إلى ترقية أحد الحلول. وتستضيف هذه المعلمة الحل في Dataverse ولكنها لا تقوم بترقية الحل حتى يتم تشغيل مهمة "تطبيق ترقية الحل". |
OverwriteUnmanagedCustomizations الكتابة فوق التخصيصات غير المُدارة |
حدد ما إذا كنت تريد الكتابة فوق التخصيصات غير المدارة (صواب|خطأ). |
SkipProductUpdateDependencies تخطي تبعيات تحديث المنتج |
حدد ما إذا كان يجب تخطي فرض التبعيات المرتبطة بتحديثات المنتجات (صواب|خطأ). |
ConvertToManaged تحويل إلى مُدار |
حدد ما إذا كنت تريد استيراد حل مُدار (صواب|خطأ). |
AsyncOperation استيراد غير متزامن |
إذا تم تحديد (صواب)، فإنه سيتم تنفيذ عملية الاستيراد بشكل غير متزامن. ينصح بهذا الخيار للحلول الكبيرة الحجم لأن مهلة هذه المهمة ستنقضي بشكل تلقائي بعد 4 دقائق. سيعمل تحديد عملية غير متزامنة على القيام بالاستطلاع والانتظار حتى يتم الوصول إلى MaxAsyncWaitTime (صواب|خطأ). |
MaxAsyncWaitTime الحد الأقصى لوقت الانتظار |
الحد الأقصى لوقت الانتظار بالدقائق للعملية غير المتزامنة؛ الإعداد الافتراضي هو 60 دقيقة (ساعة واحدة)، وكذلك الإعداد الافتراضي في Azure DevOps للمهام. |
PublishWorkflows تنشيط العمليات بعد الاستيراد |
حدد ما إذا كان يجب تنشيط أية عمليات (مهام سير عمل) في الحل بعد الاستيراد (صواب|خطأ). |
UseDeploymentSettingsFile استخدام ملف إعدادات التوزيع |
يمكن تعيين مراجع الاتصال وقيم متغيرات البيئة باستخدام ملف إعدادات النشر (صواب|خطأ). |
DeploymentSettingsFile ملف إعدادات النشر |
(مطلوب عندما يكون UseDeploymentSettingsFile =صواب) المسار واسم الملف الخاص بملف إعدادات التوزيع. |
Power Platform إضافة مكون الحل
إضافة مكون حل إلى حل غير مُدار.
جزء تعليمة برمجية متكررة YAML (إضافة)
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.add-solution-component.PowerPlatformAddSolutionComponent@2
displayName: 'Power Platform Add Solution Component '
inputs:
authenticationType: PowerPlatformSPN
PowerPlatformSPN: Build
SolutionName: 'SampleSolution '
Component: contact
ComponentType: 1
AddRequiredComponents: false
معلمات (إضافة)
المعلمات | الوصف |
---|---|
ComponentId معرف مكون الحل |
اسم المخطط أو معرف المكون لإضافته إلى الحل الهدف. |
ComponentType عنوان URL لبيئة Power Platform |
القيمة التي تمثل مكون الحل الذي تعمل على إضافته. راجع استخدام أنواع مكونات محددة معرفة مسبقًا للحصول على قائمة شاملة بقيم المكونات. |
SolutionUniqueName اسم الحل |
الاسم الفريد للحل. |
AddRequiredComponents تعتمد أية مكونات مطلوبة من حل آخر على مكون الحل |
(اختياري) الإشارة إلى ما إذا كان يجب أن تُضاف أيضًا مكونات الحل الأخرى المطلوبة من قِبل مكون الحل الذي تعمل على إضافته إلى الحل غير المُدار. |
Environment معرف أو عنوان URL خاص بالبيئة |
(اختياري) عنوان URL للبيئة أو معرف البيئة الهدف. |
تطبيق ترقية الحل لـ Power Platform
يقوم بترقية حل تم استيراده كحل انتظار.
قصاصة برمجية YAML (ترقية)
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.apply-solution-upgrade.PowerPlatformApplySolutionUpgrade@2
displayName: 'Power Platform Apply Solution Upgrade '
inputs:
PowerPlatformEnvironment: 'My service connection'
SolutionName: 'Contoso_sample'
AsyncOperation: false
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.apply-solution-upgrade.PowerPlatformApplySolutionUpgrade@2
displayName: 'Power Platform Apply Solution Upgrade '
inputs:
authenticationType: PowerPlatformSPN
PowerPlatformSPN: 'Dataverse service connection '
SolutionName: 'Contoso_sample'
MaxAsyncWaitTime: 45
المعلمات (ترقية)
المعلمات | الوصف |
---|---|
authenticationType نوع المصادقة |
(مطلوب لـ SPN) حدد إما PowerPlatformEnvironment لاتصال اسم مستخدم/كلمة مرور أو PowerPlatformSPN لاتصال سري لمسؤول الخدمة/العميل. |
PowerPlatformEnvironment عنوان URL لبيئة Power Platform |
نقطة نهاية الخدمة التي تريد ترقية الحل فيها (على سبيل المثال، https://powerappsbuildtools.crm.dynamics.com ). نحدد ضمن اتصالات الخدمة في إعدادات المشروع باستخدام نوع الاتصال Power Platform. لمزيد من المعلومات، راجع BuildTools.EnvironmentUrl ضمن Power Platform إنشاء بيئة |
PowerPlatformSPN مسؤول الخدمة Power Platform |
نقطة نهاية الخدمة التي تريد ترقية الحل فيها (على سبيل المثال، https://powerappsbuildtools.crm.dynamics.com ). نحدد ضمن اتصالات الخدمة في إعدادات المشروع باستخدام نوع الاتصال Power Platform. لمزيد من المعلومات، راجع BuildTools.EnvironmentUrl ضمن Power Platform إنشاء بيئة |
SolutionName اسم الحل |
(مطلوب) اسم الحل لتطبيق الترقية. استخدم دائمًا اسم الحل، وليس اسمه المعروض. |
AsyncOperation ترقية غير متزامنة |
إذا تم تحديد (صواب)، فإنه سيتم تنفيذ عملية الترقية كمهمة دفعة غير متزامنة. سيعمل تحديد عملية غير متزامنة على القيام بالاستطلاع والانتظار حتى يتم الوصول إلى MaxAsyncWaitTime. |
MaxAsyncWaitTime الحد الأقصى لوقت الانتظار |
الحد الأقصى لوقت الانتظار بالدقائق للعملية غير المتزامنة؛ الإعداد الافتراضي هو 60 دقيقة (ساعة واحدة)، وكذلك الإعداد الافتراضي في Azure DevOps للمهام. |
ملاحظة
تمنحك المتغيرات طريقة ملائمة لإدخال عناصر بيانات رئيسية في أجزاء مختلفة من مسارك. راجع استخدام متغيرات معرّفة مسبقًا للحصول على قائمة شاملة. يمكنك تعبئة مرجع الاتصال ومعلومات متغيرات البيئة بشكل مسبق للبيئة الهدف أثناء استيراد حل باستخدام ملف إعدادات النشر.
مزيد من المعلومات: ملء مراجع الاتصال ومتغيرات البيئة مسبقًا لعمليات النشر التي يتم تنفيذها تلقائيًا
تصدير حل في Power Platform
تصدير حل من البيئة المصدر.
قصاصة برمجية YAML (تصدير)
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.export-solution.PowerPlatformExportSolution@2
displayName: 'Power Platform Export Solution '
inputs:
PowerPlatformEnvironment: 'My service connection'
SolutionName: 'Contoso_sample'
SolutionOutputFile: 'C:\Public\Contoso_sample_1_0_0_1_managed.zip'
Managed: true
MaxAsyncWaitTime: 120
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.export-solution.PowerPlatformExportSolution@2
displayName: 'Power Platform Export Solution '
inputs:
authenticationType: PowerPlatformSPN
PowerPlatformSPN: 'Dataverse service connection '
SolutionName: 'Contoso_sample'
SolutionOutputFile: 'C:\Public\Contoso_sample_1_0_0_1_managed.zip'
Managed: true
MaxAsyncWaitTime: 120
ExportAutoNumberingSettings: true
ExportCalendarSettings: true
ExportCustomizationSettings: true
ExportEmailTrackingSettings: true
ExportGeneralSettings: true
ExportIsvConfig: true
ExportMarketingSettings: true
ExportOutlookSynchronizationSettings: true
ExportRelationshipRoles: true
ExportSales: true
المعلمات (تصدير)
المعلمات | الوصف |
---|---|
authenticationType نوع المصادقة |
(مطلوب لـ SPN) حدد إما PowerPlatformEnvironment لاتصال اسم مستخدم/كلمة مرور أو PowerPlatformSPN لاتصال سري لمسؤول الخدمة/العميل. |
PowerPlatformEnvironment عنوان URL لبيئة Power Platform |
نقطة نهاية الخدمة التي تريد ترقية الحل فيها (على سبيل المثال، https://powerappsbuildtools.crm.dynamics.com ). نحدد ضمن اتصالات الخدمة في إعدادات المشروع باستخدام نوع الاتصال Power Platform. لمزيد من المعلومات، راجع BuildTools.EnvironmentUrl ضمن Power Platform إنشاء بيئة |
PowerPlatformSPN مسؤول الخدمة Power Platform |
نقطة نهاية الخدمة التي تريد ترقية الحل فيها (على سبيل المثال، https://powerappsbuildtools.crm.dynamics.com ). نحدد ضمن اتصالات الخدمة في إعدادات المشروع باستخدام نوع الاتصال Power Platform. لمزيد من المعلومات، راجع BuildTools.EnvironmentUrl ضمن Power Platform إنشاء بيئة |
SolutionName اسم الحل |
(مطلوب) اسم الحل الذي سيتم تصديره. استخدم دائمًا اسم الحل، وليس اسمه المعروض. |
SolutionOutputFile ملف إخراج الحل |
(مطلوب) المسار واسم ملف solution.zip لتصدير البيئة المصدر إليه (على سبيل المثال، $(Build.ArtifactStagingDirectory)$(SolutionName).zip ). ملاحظة: تمنحك المتغيرات طريقة ملائمة للحصول على أجزاء رئيسية من البيانات في أجزاء مختلفة من خط الأنابيب الخاص بك. راجع استخدام متغيرات معرّفة مسبقًا للحصول على قائمة شاملة. |
AsyncOperation تصدير غير متزامن |
إذا تم تحديد (صواب)، فإنه سيتم تنفيذ عملية التصدير كمهمة دفعة غير متزامنة. سيعمل تحديد عملية غير متزامنة على القيام بالاستطلاع والانتظار حتى يتم الوصول إلى MaxAsyncWaitTime. |
MaxAsyncWaitTime الحد الأقصى لوقت الانتظار |
الحد الأقصى لوقت الانتظار بالدقائق للعملية غير المتزامنة؛ الإعداد الافتراضي هو 60 دقيقة (ساعة واحدة)، وكذلك الإعداد الافتراضي في Azure DevOps للمهام. |
Managed تصدير كمُدار |
إذا تم تحديد (صواب)، قم بتصدير الحل كحل مُدار؛ وإلا قم فإنك ستقوم بتصديره كحل غير مُدار. |
ExportAutoNumberingSettings تصدير إعدادات الترقيم التلقائي |
قم بتصدير إعدادات الترقيم التلقائي (صواب|خطأ). |
ExportCalendarSettings تصدير إعدادات التقويم |
قم بتصدير إعدادات التقويم (صواب|خطأ). |
ExportCustomizationSettings تصدير إعدادات التخصيص |
قم بتصدير إعدادات التخصيص (صواب|خطأ). |
ExportEmailTrackingSettings تصدير إعدادات تعقب البريد الإلكتروني |
قم بتصدير إعدادات تعقب البريد الإلكتروني (صواب|خطأ). |
ExportGeneralSettings تصدير الإعدادات العامة |
قم تصدير الإعدادات العامة (صواب|خطأ). |
ExportIsvConfig تصدير تكوين ISV |
قم بتصدير تكوين ISV (صواب|خطأ). |
ExportMarketingSettings تصدير إعدادات التسويق |
قم بتصدير إعدادات التسويق (صواب|خطأ). |
ExportOutlookSynchronizationSettings تصدير إعدادات مزامنة Outlook |
قم بتصدير إعدادات مزامنة Outlook (صواب|خطأ). |
ExportRelationshipRoles تصدير تفاصيل العلاقات |
قم بتصدير تفاصيل العلاقات (صواب|خطأ). |
ExportSales مبيعات التصديرات |
القيام بمبيعات التصديرات (صواب|خطأ). |
فك حزمة حل في Power Platform
تأخذ مهمة فك حزمة الحل ملفًا مضغوطًا وتفككه إلى ملفات XML متعددة وملفات أخرى بحيث تصبح قراءة هذه الملفات وإدارتها أكثر سهوله بواسطة نظام التحكم في المصدر.
قصاصة برمجية YAML (فك الحزمة)
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.unpack-solution.PowerPlatformUnpackSolution@2
displayName: 'Power Platform Unpack Solution '
inputs:
SolutionInputFile: 'C:\Public\Contoso_sample_1_0_0_1_managed.zip'
SolutionTargetFolder: 'C:\Public'
SolutionType: Both
المعلمات (فك الحزمة)
المعلمات | الوصف |
---|---|
SolutionInputFile ملف إدخال الحل |
(مطلوب) المسار واسم الملف لملف solution.zip الذي سيتم فك حزمته. |
SolutionTargetFolder المجلد الهدف لفك حزمة الحل |
(مطلوب) المسار والمجلد الهدف الذي تريد فك حزمة الحل فيه. |
SolutionType نوع الحل |
(مطلوب) نوع الحل الذي تريد فك حزمته. تتضمن الخيارات: غير مُدار (مستحسن)، ومُدار وكلاهما. |
حزم حل في Power Platform
تقوم هذه المهمة بحزم حل ممثل في التحكم في المصدر في ملف solution.zip يمكن استيراده إلى بيئة أخرى.
قصاصة برمجية YAML (الحزمة)
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.pack-solution.PowerPlatformPackSolution@2
displayName: 'Power Platform Pack Solution '
inputs:
SolutionSourceFolder: 'C:\Public'
SolutionOutputFile: 'Contoso_sample_1_0_0_1_managed.zip'
SolutionType: Managed
المعلمات (الحزمة)
المعلمات | الوصف |
---|---|
SolutionOutputFile ملف إخراج الحل |
(مطلوب) المسار واسم ملف solution.zip لحزم الحل فيه. |
SolutionSourceFolder المجلد المصدر للحل الذي سيتم حزمه |
(مطلوب) المسار والمجلد المصدر للحل الذي سيتم حزمه. |
SolutionType نوع الحل |
(مطلوب) نوع الحل الذي تريد حزمه. تتضمن الخيارات: مُدار (موصى به)، وغير مُدار، وكلاهما. |
Power Platform حذف الحل
يؤدي إلى حذف الحل في بيئة الهدف.
قصاصة برمجية YAML (حذف)
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.delete-solution.PowerPlatformDeleteSolution@2
displayName: 'Power Platform Delete Solution '
inputs:
authenticationType: PowerPlatformSPN
PowerPlatformSPN: 'Dataverse service connection '
SolutionName: 'Contoso_sample'
المعلمات (حذف)
المعلمات | الوصف |
---|---|
authenticationType نوع المصادقة |
(مطلوب لـ SPN) حدد إما PowerPlatformEnvironment لاتصال اسم مستخدم/كلمة مرور أو PowerPlatformSPN لاتصال سري لمسؤول الخدمة/العميل. |
PowerPlatformEnvironment عنوان URL لبيئة Power Platform |
نقطة نهاية الخدمة التي تريد حذف الحل فيها (على سبيل المثال، https://powerappsbuildtools.crm.dynamics.com ). نحدد ضمن اتصالات الخدمة في إعدادات المشروع باستخدام نوع الاتصال Power Platform. لمزيد من المعلومات، راجع BuildTools.EnvironmentUrl ضمن Power Platform إنشاء بيئة |
PowerPlatformSPN مسؤول الخدمة Power Platform |
نقطة نهاية الخدمة التي تريد حذف الحل فيها (على سبيل المثال، https://powerappsbuildtools.crm.dynamics.com ). نحدد ضمن اتصالات الخدمة في إعدادات المشروع باستخدام نوع الاتصال Power Platform. لمزيد من المعلومات، راجع BuildTools.EnvironmentUrl ضمن Power Platform إنشاء بيئة |
SolutionName اسم الحل |
(مطلوب) اسم الحل المراد حذفه. استخدم دائمًا اسم الحل، وليس اسمه المعروض. |
نشر تخصيصات في Power Platform
نشر كافة التخصيصات في بيئة.
قصاصة برمجية YAML (توزيع)
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.publish-customizations.PowerPlatformPublishCustomizations@2
displayName: 'Power Platform Publish Customizations '
inputs:
authenticationType: PowerPlatformSPN
PowerPlatformSPN: 'Dataverse service connection '
المعلمات (نشر)
المعلمات | الوصف |
---|---|
authenticationType نوع المصادقة |
(مطلوب لـ SPN) حدد إما PowerPlatformEnvironment لاتصال اسم مستخدم/كلمة مرور أو PowerPlatformSPN لاتصال سري لمسؤول الخدمة/العميل. |
PowerPlatformEnvironment عنوان URL لبيئة Power Platform |
نقطة نهاية الخدمة التي تريد نشر التخصيصات فيها (على سبيل المثال، https://powerappsbuildtools.crm.dynamics.com ). نحدد ضمن اتصالات الخدمة في إعدادات المشروع باستخدام نوع الاتصال Power Platform. لمزيد من المعلومات، راجع BuildTools.EnvironmentUrl ضمن Power Platform إنشاء بيئة |
PowerPlatformSPN مسؤول الخدمة Power Platform |
نقطة نهاية الخدمة التي تريد نشر التخصيصات فيها (على سبيل المثال، https://powerappsbuildtools.crm.dynamics.com ). نحدد ضمن اتصالات الخدمة في إعدادات المشروع باستخدام نوع الاتصال Power Platform. لمزيد من المعلومات، راجع BuildTools.EnvironmentUrl ضمن Power Platform إنشاء بيئة |
تعيين إصدار حل في Power Platform
تحديث إصدار الحل.
قصاصة برمجية YAML (الإصدار)
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.set-solution-version.PowerPlatformSetSolutionVersion@2
displayName: 'Power Platform Set Solution Version '
inputs:
authenticationType: PowerPlatformSPN
PowerPlatformSPN: 'Dataverse service connection '
SolutionName: 'Contoso_sample'
SolutionVersionNumber: 1.0.0.0
المعلمات (الإصدار)
المعلمات | الوصف |
---|---|
authenticationType نوع المصادقة |
(مطلوب لـ SPN) حدد إما PowerPlatformEnvironment لاتصال اسم مستخدم/كلمة مرور أو PowerPlatformSPN لاتصال سري لمسؤول الخدمة/العميل. |
PowerPlatformEnvironment عنوان URL لبيئة Power Platform |
نقطة نهاية الخدمة التي تريد تعيين إصدار الحل فيها (على سبيل المثال، https://powerappsbuildtools.crm.dynamics.com ). نحدد ضمن اتصالات الخدمة في إعدادات المشروع باستخدام نوع الاتصال Power Platform. لمزيد من المعلومات، راجع BuildTools.EnvironmentUrl ضمن Power Platform إنشاء بيئة |
PowerPlatformSPN مسؤول الخدمة Power Platform |
نقطة نهاية الخدمة التي تريد تعيين إصدار الحل فيها (على سبيل المثال، https://powerappsbuildtools.crm.dynamics.com ). نحدد ضمن اتصالات الخدمة في إعدادات المشروع باستخدام نوع الاتصال Power Platform. لمزيد من المعلومات، راجع BuildTools.EnvironmentUrl ضمن Power Platform إنشاء بيئة |
SolutionName اسم الحل |
(مطلوب) اسم الحل لتعيين الإصدار له. استخدم دائمًا اسم الحل، وليس اسمه المعروض. |
SolutionVersionNumber رقم إصدار الحل |
(مطلوب) رقم الإصدار الذي تريد تعيينه. |
على الرغم من أنه يمكن ترميز رقم الإصدار في المسار، من المستحسن استخدام Azure DevOps متغير مسار مثل BuildId. يوفر هذا الخيار خيارات لتحديد الشكل الصحيح لعدد الإصدارات ضمن علامة التبويب "خيارات"، على سبيل المثال: $(Year:yyyy)-$(Month:MM)-$(Day:dd)-$(rev:rr)-3
يمكن استخدام هذا التعريف بعد ذلك في مهمة تعيين إصدار الحل عن طريق تعيين خاصية رقم الإصدار بواسطة: $(Build.BuildId) بدلًا من التعليمات البرمجية المضمنة 20200824.0.0.2.
أو بدلًا من ذلك، قم بتعيين إخراج البرنامج النصي لمهمة مضمنة في powershell$(Get-Date -Format yyyy.MM.dd.HHmm) إلى متغير فارغ باسم SolutionVersion كـ Write-Host ("##vso[task.setvariable variable=SolutionVersion;]$version")، قم بتعيين الإصدار كـ $(SolutionVersion).
تعيين متغيرات الاتصال في Power Platform
تعيين متغيرات BuildTools.* لتوفير الوصول إلى مهام البرنامج النصي المخصصة لاستخدام اتصال الخدمة كمصدر واحد للحقيقة.
جزء تعليمة YAML البرمجية المتكررة (SetConnectionVariables)
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.set-connection-variables.PowerPlatformSetConnectionVariables@2
displayName: 'Power Platform Set Connection Variables '
inputs:
authenticationType: PowerPlatformSPN
PowerPlatformSPN: 'Dataverse service connection '
timeoutInMinutes: 2
retryCountOnTaskFailure: 5
المعلمات (SetConnectionVariables)
المعلمات | الوصف |
---|---|
authenticationType نوع المصادقة |
(مطلوب لـ SPN) حدد إما PowerPlatformEnvironment لاتصال اسم مستخدم/كلمة مرور أو PowerPlatformSPN لاتصال سري لمسؤول الخدمة/العميل. |
PowerPlatformSPN مسؤول الخدمة Power Platform |
نقطة نهاية الخدمة التي تريد تعيين متغيرات الاتصال لها. نحدد ضمن اتصالات الخدمة في إعدادات المشروع باستخدام نوع الاتصال Power Platform. لمزيد من المعلومات، راجع BuildTools.EnvironmentUrl ضمن Power Platform إنشاء بيئة |
timeoutInMinutes المهلة |
تحديد الحد الأقصى للوقت، بالدقائق، الذي يُسمح للمهمة بتنفيذه قبل أن يتم إلغاؤه بواسطة الخادم. تشير القيمة صفر إلى مهلة لا نهائية. |
retryCountOnTaskFailure عدد مرات إعادة المحاولة في حالة فشل المهمة |
تحديد عدد مرات إعادة المحاولة لهذه المهمة التي ستحدث في حالة فشل المهمة. غير مدعوم للمهام الأقل مندوبين. |
ApplicationId معرف التطبيق لتسجيل الدخول |
(مطلوب لاسم المستخدم/كلمة المرور) معرف التطبيق المراد استخدامه لتسجيل الدخول (انظر الملاحظة الإضافية أدناه). |
RedirectUri عنوان URI لإعادة التوجيه للتطبيق المحدد |
(مطلوب لاسم المستخدم/كلمة المرور) عنوان URI لإعادة التوجيه للتطبيق المحدد. مطلوب عند تحديد معرف التطبيق. (انظر الملاحظة الإضافية أدناه). |
ملاحظة
عند استخدام نوع مصادقة اسم المستخدم/كلمة المرور، سيكون معرف التطبيق وUri لإعادة التوجيه مطلوبًا. يحتوي مستند المصادقة oauth هذا على شرح لسبب حاجتك إلى إنشاء تسجيل تطبيق للمصادقة باستخدام Dataverse. عند الاتصال باستخدام مصادقة اسم المستخدم/كلمة المرور، يتصرف الاتصال كتطبيق يتصل بالنيابة عن المستخدم بخدمة Dataverse.
نشر حزمة في Power Platform
نشر حزمة في بيئة. تمنحك عملية نشر الحزمة في مقابل ملف حل فردي خيار نشر حلول متعددة وبيانات وتعليمات برمجية في بيئة.
قصاصة برمجية YAML (توزيع)
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.deploy-package.PowerPlatformDeployPackage@2
displayName: 'Power Platform Deploy Package '
inputs:
authenticationType: PowerPlatformSPN
PowerPlatformSPN: 'Dataverse service connection '
PackageFile: 'C:\Users\Public\package.dll'
MaxAsyncWaitTime: 120
المعلمات (توزيع)
المعلمات | الوصف |
---|---|
authenticationType نوع المصادقة |
(مطلوب لـ SPN) حدد إما PowerPlatformEnvironment لاتصال اسم مستخدم/كلمة مرور أو PowerPlatformSPN لاتصال سري لمسؤول الخدمة/العميل. |
PowerPlatformEnvironment عنوان URL لبيئة Power Platform |
نقطة نهاية الخدمة التي تريد توزيع الحزمة فيها (على سبيل المثال، https://powerappsbuildtools.crm.dynamics.com ). نحدد ضمن اتصالات الخدمة في إعدادات المشروع باستخدام نوع الاتصال Power Platform. لمزيد من المعلومات، راجع BuildTools.EnvironmentUrl ضمن Power Platform إنشاء بيئة |
PowerPlatformSPN مسؤول الخدمة Power Platform |
نقطة نهاية الخدمة التي تريد توزيع الحزمة فيها (على سبيل المثال، https://powerappsbuildtools.crm.dynamics.com ). نحدد ضمن اتصالات الخدمة في إعدادات المشروع باستخدام نوع الاتصال Power Platform. لمزيد من المعلومات، راجع BuildTools.EnvironmentUrl ضمن Power Platform إنشاء بيئة |
PackageFile ملف الحزمة |
(مطلوب) المسار واسم الملف الخاصين بمجموعة ملف الحزمة (.dll). |
MaxAsyncWaitTime الحد الأقصى لوقت الانتظار |
الحد الأقصى لوقت الانتظار بالدقائق للعملية غير المتزامنة؛ الإعداد الافتراضي هو 60 دقيقة (ساعة واحدة)، وكذلك الإعداد الافتراضي في Azure DevOps للمهام. |
مهام إدارة البيئة
أتمتة مهام إدارة دورة حياة البيئة (ELM) الشائعة.
إنشاء بيئة في Power Platform
إنشاء بيئة جديدة. إنشاء بيئة جديدة أيضًا تقوم بإنشاء BuildTools.EnvironmentUrl
تلقائيًا.
هام
عند التعيين، سيتم استخدام BuildTools.EnvironmentUrl
كـ اتصال خدمة افتراضي للمهام اللاحقة في البنية الأساسية لبرنامج ربط العمليات التجارية. تستخدم كل مهمة موضحة في هذا المقال نقطة النهاية من اتصال الخدمة فقط عندما لا يتم تعيين BuildTools.EnvironmentUrl
.
لا يمكن توفير بيئة جديدة إلا إذا كان ترخيصك أو سعتك تسمح بإنشاء بيئات إضافية. لمزيد من المعلومات حول كيفية عرض السعة، راجع تفاصيل صفحة السعة.
قصاصة برمجية YAML (إنشاء بيئة)
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.create-environment.PowerPlatformCreateEnvironment@2
displayName: 'Power Platform Create Environment '
inputs:
PowerPlatformEnvironment: 'My service connection'
DisplayName: 'First Coffee test'
DomainName: firstcoffee
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.create-environment.PowerPlatformCreateEnvironment@2
displayName: 'Power Platform Create Environment '
inputs:
authenticationType: PowerPlatformSPN
PowerPlatformSPN: 'Dataverse service connection '
DisplayName: 'First Coffee prod'
EnvironmentSku: Production
AppsTemplate: 'D365_CustomerService,D365_FieldService'
LocationName: canada
LanguageName: 1036
CurrencyName: ALL
DomainName: firstcoffee
المعلمات (إنشاء بيئة)
المعلمات | الوصف |
---|---|
authenticationType نوع المصادقة |
(مطلوب لـ SPN) حدد إما PowerPlatformEnvironment لاتصال اسم مستخدم/كلمة مرور أو PowerPlatformSPN لاتصال سري لمسؤول الخدمة/العميل. |
PowerPlatformEnvironment عنوان URL لبيئة Power Platform |
نقطة نهاية الخدمة التي تريد إنشاء البيئة فيها (على سبيل المثال، https://powerappsbuildtools.crm.dynamics.com ). نحدد ضمن اتصالات الخدمة في إعدادات المشروع باستخدام نوع الاتصال Power Platform. |
PowerPlatformSPN مسؤول الخدمة Power Platform |
نقطة نهاية الخدمة التي تريد إنشاء البيئة فيها (على سبيل المثال، https://powerappsbuildtools.crm.dynamics.com ). نحدد ضمن اتصالات الخدمة في إعدادات المشروع باستخدام نوع الاتصال Power Platform. |
DisplayName اسم العرض |
(مطلوب) الاسم المعروض للبيئة التي تم إنشاؤها. |
LocationName منطقة التوزيع |
(مطلوب) المنطقة التي يجب أن يتم إنشاء البيئة فيها. |
EnvironmentSku نوع البيئة |
(مطلوب) نوع المثيل المراد نشره. الخيارات هي وضع الحماية و الإنتاج و الإصدار التجريبي و SubscriptionBasedTrial. |
AppsTemplate التطبيقات |
بالنسبة لنوع البيئة غير التجريبية، التطبيقات المدعومة هي D365_CustomerService وD365_FieldService وD365_ProjectServiceAutomation وD365_Sales. |
CurrencyName عملة |
(مطلوب) العملة الأساسية للبيئة التي تم إنشاؤها. لا يمكن تحديث العملة بعد إنشاء البيئة. |
LanguageName Language |
(مطلوب) اللغة الأساسية في البيئة. |
DomainName اسم المجال |
(مطلوب) هذه هي السلسلة الخاصة بالبيئة التي تشكل جزءًا من عنوان URL. على سبيل المثال، بالنسبة إلى بيئة تتضمن عنوان URL التالي: https://powerappsbuildtasks.crm.dynamics.com/ ، قد يكون اسم المجال "powerappsbuildtasks". ملاحظة: إذا أدخلت اسم نطاق قيد الاستخدام بالفعل، تلحق المهمة قيمة رقمية باسم النطاق، بدءا من 0. بالنسبة إلى المثال أعلاه، قد يصبح URL |
حذف بيئة في Power Platform
حذف بيئة.
قصاصة برمجية YAML (حذف بيئة)
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.delete-environment.PowerPlatformDeleteEnvironment@2
displayName: 'Power Platform Delete Environment '
inputs:
PowerPlatformEnvironment: 'My service connection'
المعلمات (حذف بيئة)
المعلمات | الوصف |
---|---|
authenticationType نوع المصادقة |
(مطلوب لـ SPN) حدد إما PowerPlatformEnvironment لاتصال اسم مستخدم/كلمة مرور أو PowerPlatformSPN لاتصال سري لمسؤول الخدمة/العميل. |
PowerPlatformEnvironment عنوان URL لبيئة Power Platform |
نقطة نهاية الخدمة التي تريد حذف البيئة فيها (على سبيل المثال، https://powerappsbuildtools.crm.dynamics.com ). نحدد ضمن اتصالات الخدمة في إعدادات المشروع باستخدام نوع الاتصال Power Platform. |
PowerPlatformSPN مسؤول الخدمة Power Platform |
نقطة نهاية الخدمة التي تريد حذف البيئة فيها (على سبيل المثال، https://powerappsbuildtools.crm.dynamics.com ). نحدد ضمن اتصالات الخدمة في إعدادات المشروع باستخدام نوع الاتصال Power Platform. |
تعيين مستخدم Power Platform
قم بتعيين مستخدم إلى بيئة هدف مع دور أمان محدد.
قصاصة برمجية YAML (AssignUser-env)
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.assign-user.PowerPlatformAssignUser@2
displayName: 'Power Platform Assign User '
inputs:
authenticationType: PowerPlatformSPN
PowerPlatformSPN: Build
User: EnvironmentUsername
Role: 'Environment Maker'
ApplicationUser: true
المعلمات (AssignUser-env)
المعلمات | الوصف |
---|---|
authenticationType نوع المصادقة |
(مطلوب لـ SPN) حدد إما PowerPlatformEnvironment لاتصال اسم مستخدم/كلمة مرور أو PowerPlatformSPN لاتصال سري لمسؤول الخدمة/العميل. |
PowerPlatformSPN مسؤول الخدمة Power Platform |
نقطة نهاية الخدمة للبيئة التي تريد تعيين المستخدم لها (على سبيل المثال، https://powerappsbuildtools.crm.dynamics.com ). نحدد ضمن اتصالات الخدمة في إعدادات المشروع باستخدام نوع الاتصال Power Platform. |
User اسم مستخدم في Power Platform |
معرف كائن Microsoft Entra أو اسم كيان الخدمة لتعيينه إلى البيئة الهدف. |
Role اسم أو معرف دور الأمان |
اسم أو معرف دور الأمان لتعيينه إلى المستخدم. |
ApplicationUser اسم مستخدم تطبيق Power Platform |
تحديد ما إذا كان مستخدم الإدخال مستخدم تطبيق (صواب|خطأ). |
إعادة تعيين بيئة Power Platform
إعادة تعيين بيئة.
قصاصة برمجية YAML (Reset-env)
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.reset-environment.PowerPlatformResetEnvironment@2
displayName: 'Power Platform Reset Environment '
inputs:
authenticationType: PowerPlatformSPN
PowerPlatformSPN: Build
CurrencyName: ALL
Purpose: 'Reset to PointInTime'
AppsTemplate: 'D365_CustomerService,D365_FieldService'
المعلمات (Reset-env)
المعلمات | الوصف |
---|---|
authenticationType نوع المصادقة |
(مطلوب لـ SPN) حدد إما PowerPlatformEnvironment لاتصال اسم مستخدم/كلمة مرور أو PowerPlatformSPN لاتصال سري لمسؤول الخدمة/العميل. |
PowerPlatformEnvironment عنوان URL لبيئة Power Platform |
نقطة نهاية الخدمة التي تريد إعادة تعيين البيئة فيها (على سبيل المثال، https://powerappsbuildtools.crm.dynamics.com ). نحدد ضمن اتصالات الخدمة في إعدادات المشروع باستخدام نوع الاتصال Power Platform. |
PowerPlatformSPN مسؤول الخدمة Power Platform |
نقطة نهاية الخدمة التي تريد إعادة تعيين البيئة فيها (على سبيل المثال، https://powerappsbuildtools.crm.dynamics.com ). نحدد ضمن اتصالات الخدمة في إعدادات المشروع باستخدام نوع الاتصال Power Platform. |
نسخ احتياطي لبيئة في Power Platform
إجراء نسخة احتياطية للبيئة
قصاصة برمجية YAML (نسخ احتياطي للبيئة)
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.backup-environment.PowerPlatformBackupEnvironment@2
displayName: 'Power Platform Backup Environment '
inputs:
PowerPlatformEnvironment: 'My service connection'
BackupLabel: 'Full backup - $(Build.BuildNumber)'
المعلمات (نسخ احتياطي للبيئة)
المعلمات | الوصف |
---|---|
authenticationType نوع المصادقة |
(مطلوب لـ SPN) حدد إما PowerPlatformEnvironment لاتصال اسم مستخدم/كلمة مرور أو PowerPlatformSPN لاتصال سري لمسؤول الخدمة/العميل. |
PowerPlatformEnvironment عنوان URL لبيئة Power Platform |
نقطة نهاية الخدمة التي تريد نسخ البيئة الاحتياطي فيها (على سبيل المثال، https://powerappsbuildtools.crm.dynamics.com ). نحدد ضمن اتصالات الخدمة في إعدادات المشروع باستخدام نوع الاتصال Power Platform. |
PowerPlatformSPN مسؤول الخدمة Power Platform |
نقطة نهاية الخدمة التي تريد نسخ البيئة الاحتياطي فيها (على سبيل المثال، https://powerappsbuildtools.crm.dynamics.com ). نحدد ضمن اتصالات الخدمة في إعدادات المشروع باستخدام نوع الاتصال Power Platform. |
BackupLabel تسمية النسخة الاحتياطية |
(مطلوب) التسمية التي يجب تعيينها للنسخة الاحتياطية. |
نسخ بيئة في Power Platform
نسخ بيئة إلى بيئة هدف. هناك خياران للنُسخ: نسخة كاملة ونسخة الحد الأدنى. تتضمن النسخة الكاملة بيانات وبيانات تعريف الحل (تخصيصات)، بينما تتضمن نسخة الحد الأدنى بيانات تعريف الحل فقط وليس البيانات الفعلية.
قصاصة برمجية YAML (نسخ البيئة)
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.copy-environment.PowerPlatformCopyEnvironment@2
displayName: 'Power Platform Copy Environment '
inputs:
PowerPlatformEnvironment: 'My service connection'
TargetEnvironmentUrl: 'https://contoso-test.crm.dynamics.com'
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.copy-environment.PowerPlatformCopyEnvironment@2
displayName: 'Power Platform Copy Environment '
inputs:
authenticationType: PowerPlatformSPN
PowerPlatformSPN: 'Dataverse service connection '
TargetEnvironmentUrl: 'https://contoso-test.crm.dynamics.com'
CopyType: MinimalCopy
OverrideFriendlyName: true
FriendlyName: 'Contoso Test'
DisableAdminMode: false
المعلمات (نسخ البيئة)
المعلمات | الوصف |
---|---|
authenticationType نوع المصادقة |
(مطلوب لـ SPN) حدد إما PowerPlatformEnvironment لاتصال اسم مستخدم/كلمة مرور أو PowerPlatformSPN لاتصال سري لمسؤول الخدمة/العميل. |
PowerPlatformEnvironment عنوان URL لبيئة Power Platform |
نقطة نهاية الخدمة للبيئة المصدر التي ترغب في النسخ منها (على سبيل المثال، https://powerappsbuildtools.crm.dynamics.com ). نحدد ضمن اتصالات الخدمة في إعدادات المشروع باستخدام نوع الاتصال Power Platform. |
PowerPlatformSPN مسؤول الخدمة Power Platform |
نقطة نهاية الخدمة للبيئة المصدر التي ترغب في النسخ منها (على سبيل المثال، https://powerappsbuildtools.crm.dynamics.com ). نحدد ضمن اتصالات الخدمة في إعدادات المشروع باستخدام نوع الاتصال Power Platform. |
TargetEnvironmentUrl عنوان URL للبيئة الهدف |
(مطلوب) عنوان URL للبيئة الهدف التي تريد النسخ اليها. |
CopyType نوع النسخ |
نوع النسخ المراد تنفيذه: نسخة كاملة أو نسخة مصغرة |
OverrideFriendlyName تجاوز اسم مألوف |
قم بتغيير الاسم المألوف للبيئة الهدف إلى اسم آخر (صواب|خطأ). |
FriendlyName اسم مألوف |
الاسم المألوف للبيئة الهدف. |
DisableAdminMode تعطيل وضع الإدارة |
إذا ما كنت تريد تعطيل وضع الإدارة (صواب|خطأ). |
استعادة بيئة Power Platform
استعادة بيئة إلى نسخة احتياطية محددة.
قصاصة برمجية YAML (Restore-env)
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.restore-environment.PowerPlatformRestoreEnvironment@2
displayName: 'Power Platform Restore Environment '
inputs:
PowerPlatformEnvironment: 'My service connection'
authenticationType: PowerPlatformSPN
PowerPlatformSPN: Build
TargetEnvironmentUrl: 'https://contoso-test.crm.dynamics.com'
RestoreLatestBackup: false
RestoreTimeStamp: '12/01/2022 09:00'
FriendlyName: 'Contoso Test'
المعلمات (Restore-env)
المعلمات | الوصف |
---|---|
authenticationType نوع المصادقة |
(مطلوب لـ SPN) حدد إما PowerPlatformEnvironment لاتصال اسم مستخدم/كلمة مرور أو PowerPlatformSPN لاتصال سري لمسؤول الخدمة/العميل. |
PowerPlatformEnvironment عنوان URL لبيئة Power Platform |
نقطة نهاية الخدمة للبيئة المصدر التي ترغب في الاستعادة منها (على سبيل المثال، https://powerappsbuildtools.crm.dynamics.com ). نحدد ضمن اتصالات الخدمة في إعدادات المشروع باستخدام نوع الاتصال Power Platform. |
PowerPlatformSPN مسؤول الخدمة Power Platform |
نقطة نهاية الخدمة للبيئة المصدر التي ترغب في الاستعادة منها (على سبيل المثال، https://powerappsbuildtools.crm.dynamics.com ). نحدد ضمن اتصالات الخدمة في إعدادات المشروع باستخدام نوع الاتصال Power Platform. |
RestoreLatestBackup آخر نسخة احتياطية لاستعادتها |
ما إذا كان يجب استعادة أحدث نسخة احتياطية أو توفير RestoreTimeStamp (صواب|خطأ). |
RestoreTimeStamp تاريخ/وقت النسخ الاحتياطي |
تاريخ ووقت النسخة الاحتياطية بالتنسيق "mm/dd/yyyy hh:mm" "أو" السلسلة "الأحدث". |
TargetEnvironmentUrl عنوان URL للبيئة الهدف |
(مطلوب) عنوان URL للبيئة الهدف التي تريد استعادتها. |
FriendlyName اسم البيئة المستعادة. |
(اختياري) اسم البيئة المستعادة. |
DisableAdminMode تعطيل وضع الإدارة |
إذا ما كنت تريد تعطيل وضع الإدارة (صواب|خطأ). |
تصدير بيانات Dataverse
تصدير بيانات من بيئة باستخدام المخطط الموفر.
قصاصة برمجية YAML (exportdata-env)
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.export-data.PowerPlatformExportData@2
displayName: 'Power Platform Export Data '
inputs:
authenticationType: PowerPlatformSPN
PowerPlatformSPN: Build
SchemaFile: 'C:\tempschema.xml'
DataFile: exportdata.zip
Overwrite: true
المعلمات (exportdata-env)
المعلمات | الوصف |
---|---|
authenticationType نوع المصادقة |
(مطلوب لـ SPN) حدد إما PowerPlatformEnvironment لاتصال اسم مستخدم/كلمة مرور أو PowerPlatformSPN لاتصال سري لمسؤول الخدمة/العميل. |
PowerPlatformSPN مسؤول الخدمة Power Platform |
نقطة نهاية الخدمة للبيئة التي تريد تصدير البيانات منها (على سبيل المثال، https://powerappsbuildtools.crm.dynamics.com ). نحدد ضمن اتصالات الخدمة في إعدادات المشروع باستخدام نوع الاتصال Power Platform. |
SchemaFile اسم ملف XML المخطط |
اسم ملف XML المخطط. يمكن إنشاؤه باستخدام أداة ترحيل التكوين. |
DataFile اسم ملف البيانات |
اسم الملف الخاص بملف البيانات لتصديرها (ملف zip). |
Overwrite الكتابة فوق المحتوى |
محتوى موقع ويب Power Pages للكتابة فوقه (صواب|خطأ). |
استيراد بيانات Dataverse
استيراد بيانات إلى بيئة.
قصاصة برمجية YAML (importdata-env)
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.import-data.PowerPlatformImportData@2
displayName: 'Power Platform Import Data '
inputs:
authenticationType: PowerPlatformSPN
PowerPlatformSPN: Build
DataFile: 'C:\Data\Import.zip'
المعلمات (importdata-env)
المعلمات | الوصف |
---|---|
authenticationType نوع المصادقة |
(مطلوب لـ SPN) حدد إما PowerPlatformEnvironment لاتصال اسم مستخدم/كلمة مرور أو PowerPlatformSPN لاتصال سري لمسؤول الخدمة/العميل. |
PowerPlatformSPN مسؤول الخدمة Power Platform |
نقطة نهاية الخدمة للبيئة التي تريد استيراد البيانات منها (على سبيل المثال، https://powerappsbuildtools.crm.dynamics.com ). نحدد ضمن اتصالات الخدمة في إعدادات المشروع باستخدام نوع الاتصال Power Platform. |
DataFile اسم ملف البيانات |
اسم الملف الخاص بالملف المضغوط) الذي سيتم استيراده، أو المجلد الذي يحتوي على data-schema.xml وdata.xml الذي سيتم استيراده. |
مهام إدارة Power Pages
مهام للتعامل مع موقع الويب Power Pages.
PAPortal لتنزيل Power Platform
تنزيل محتوى موقع ويب Power Pages من بيئة Dataverse الحالية.
قصاصة برمجية YAML (download-paportal)
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.download-paportal.PowerPlatformDownloadPaportal@2
displayName: 'Power Platform Download PAPortal '
inputs:
authenticationType: PowerPlatformSPN
PowerPlatformSPN: Build
DownloadPath: 'C:\portals'
WebsiteId: 'f88b70cc-580b-4f1a-87c3-41debefeb902'
Overwrite: true
المعلمات (download-paportal)
المعلمات | الوصف |
---|---|
authenticationType نوع المصادقة |
(مطلوب لـ SPN) حدد إما PowerPlatformEnvironment لاتصال اسم مستخدم/كلمة مرور أو PowerPlatformSPN لاتصال سري لمسؤول الخدمة/العميل. |
PowerPlatformSPN مسؤول الخدمة Power Platform |
نقطة نهاية الخدمة للبيئة التي تريد تنزيل المحتوى منها (على سبيل المثال، https://powerappsbuildtools.crm.dynamics.com ). نحدد ضمن اتصالات الخدمة في إعدادات المشروع باستخدام نوع الاتصال Power Platform. |
WebsiteId معرف موقع ويب المدخل |
معرف موقع ويب Power Pages المطلوب تنزيله. |
Overwrite الكتابة فوق المحتوى |
محتوى موقع ويب Power Pages للكتابة فوقه (صواب|خطأ). |
ModelVersion نموذج بيانات الموقع |
الإشارة إلى ما إذا كانت بيانات الموقع التي سيتم تحميلها ستستخدم نموذج البيانات القياسي (1 ) أو المحسّن (2 ). القيمة الافتراضية هي "1". |
PAPortal لتحميل Power Platform
تحميل محتوى موقع ويب Power Pages إلى بيئة Dataverse الحالية.
قصاصة برمجية YAML (upload-paportal)
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.upload-paportal.PowerPlatformUploadPaportal@2
displayName: 'Power Platform Upload PAPortal '
inputs:
authenticationType: PowerPlatformSPN
PowerPlatformSPN: Build
UploadPath: 'C:\portals\starter-portal'
المعلمات (upload-paportal)
المعلمات | الوصف |
---|---|
authenticationType نوع المصادقة |
(مطلوب لـ SPN) حدد إما PowerPlatformEnvironment لاتصال اسم مستخدم/كلمة مرور أو PowerPlatformSPN لاتصال سري لمسؤول الخدمة/العميل. |
PowerPlatformSPN مسؤول الخدمة Power Platform |
نقطة نهاية الخدمة للبيئة التي تريد تحميل المحتوى إليها (على سبيل المثال، https://powerappsbuildtools.crm.dynamics.com ). نحدد ضمن اتصالات الخدمة في إعدادات المشروع باستخدام نوع الاتصال Power Platform. |
UploadPath مسار محتوى التحميل |
المسار الذي سيتم منه تحميل محتوى موقع الويب Power Pages. |
ModelVersion نموذج بيانات الموقع |
الإشارة إلى ما إذا كانت بيانات الموقع التي سيتم تحميلها ستستخدم نموذج البيانات القياسي (1 ) أو المحسّن (2 ). القيمة الافتراضية هي "1". |
كتالوج لمهام Power Platform (إصدار أولي)
تنفذ هذه المهام إجراءات مقابل الكتالوج في Power Platform وتتضمن ما يلي.
ملاحظة
في الوقت الحالي، مهام الكتالوج في Power Platform هي في وضع الإصدار الأولي.
تثبيت عنصر كتالوج
قم بتثبيت عنصر Catalog في البيئة الهدف.
المعلمات | الوصف |
---|---|
authenticationType نوع المصادقة |
(مطلوب لـ SPN) حدد إما PowerPlatformEnvironment لاتصال اسم مستخدم/كلمة مرور أو PowerPlatformSPN لاتصال سري لمسؤول الخدمة/العميل. |
PowerPlatformSPN مسؤول الخدمة Power Platform |
نقطة نهاية الخدمة للبيئة التي تريد تحميل المحتوى إليها (على سبيل المثال، https://powerappsbuildtools.crm.dynamics.com ). نحدد ضمن اتصالات الخدمة في إعدادات المشروع باستخدام نوع الاتصال Power Platform. |
Environment عنوان URL للبيئة الهدف |
(مطلوب) عنوان URL الذي تستهدفه هذه المهمة. |
CatalogItemId معرف عنصر الكتالوج الذي سيتم تثبيته |
(مطلوب) عنصر الكتالوج الذي سيتم تثبيته في البيئة الهدف. |
TargetEnvironmentUrl عنوان URL للبيئة الهدف |
(مطلوب) عنوان URL للبيئة المستهدفة لتثبيت عنصر الكتالوج في (على سبيل المثال، "https://YourOrg.crm.dynamics.com"). |
PollStatus التحقق من حالة الاستقصاء |
(اختياري) استقصاء للتحقق من حالة طلبك (صواب|خطأ). |
المعلمات (catalog-install)
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools-DEV.install-catalog.PowerPlatformInstallCatalog@2
displayName: 'Power Platform Install Catalog '
inputs:
authenticationType: PowerPlatformSPN
PowerPlatformSPN: Build
Environment: '$(BuildTools.EnvironmentUrl)'
CatalogItemId: '00000000-0000-0000-0000-000000000001'
TargetEnvironmentUrl: 'https://test.crm.dynamics.com/'
PollStatus: true
إرسال الموافقة على الكتالوج
إرسال طلب موافقة Catalog.
المعلمات | الوصف |
---|---|
authenticationType نوع المصادقة |
(مطلوب لـ SPN) حدد إما PowerPlatformEnvironment لاتصال اسم مستخدم/كلمة مرور أو PowerPlatformSPN لاتصال سري لمسؤول الخدمة/العميل. |
PowerPlatformSPN مسؤول الخدمة Power Platform |
نقطة نهاية الخدمة للبيئة التي تريد تحميل المحتوى إليها (على سبيل المثال، "https://powerappsbuildtools.crm.dynamics.com"). نحدد ضمن اتصالات الخدمة في إعدادات المشروع باستخدام نوع الاتصال Power Platform. |
Environment عنوان URL للبيئة الهدف |
(مطلوب) عنوان URL الذي تستهدفه هذه المهمة. |
CatalogSubmissionFile ملف إرسال الكتالوج |
(مطلوب) حدد المسار واسم الملف لملف إرسال الكتالوج. |
UsePackageSolutionZipFile نوع الملف |
نوع الملف: حزمة أو ملف مضغوط للحل. |
SolutionZipFile اسم الملف المضغوط للحل. |
حدد المسار واسم الملف للملف المضغوط للحل. |
PollStatus التحقق من حالة الاستقصاء |
(اختياري) استقصاء للتحقق من حالة طلبك (صواب|خطأ). |
المعلمات (catalog-submit)
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools-DEV.submit-catalog.PowerPlatformSubmitCatalog@2
displayName: 'Power Platform Submit Catalog '
inputs:
authenticationType: PowerPlatformSPN
PowerPlatformSPN: Build
Environment: '$(BuildTools.EnvironmentUrl)'
CatalogSubmissionFile: submission.json
UsePackageSolutionZipFile: true
FileType: SolutionZipFile
SolutionZipFile: solution.zip
PollStatus: true
حالة طلب الكتالوج
احصل على حالة طلب تثبيت/إرسال الكتالوج.
المعلمات | الوصف |
---|---|
authenticationType نوع المصادقة |
(مطلوب لـ SPN) حدد إما PowerPlatformEnvironment لاتصال اسم مستخدم/كلمة مرور أو PowerPlatformSPN لاتصال سري لمسؤول الخدمة/العميل. |
PowerPlatformSPN مسؤول الخدمة Power Platform |
نقطة نهاية الخدمة للبيئة التي تريد تحميل المحتوى إليها (على سبيل المثال، "https://powerappsbuildtools.crm.dynamics.com"). نحدد ضمن اتصالات الخدمة في إعدادات المشروع باستخدام نوع الاتصال Power Platform. |
Environment عنوان URL للبيئة الهدف |
(مطلوب) عنوان URL الذي تستهدفه هذه المهمة. |
TrackingId معرف تعقب الطلب |
(مطلوب) معرف تعقب الطلب. |
RequestType نوع الطلب |
(مطلوب) نوع الطلب. (القيم: تثبيت | إرسال). |
المعلمات (catalog-status)
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools-DEV.catalog-status.PowerPlatforCatalogStatus@2
displayName: 'Power Platform Catalog Status '
inputs:
authenticationType: PowerPlatformSPN
PowerPlatformSPN: Build
Environment: '$(BuildTools.EnvironmentUrl)'
TrackingId: '00000000-0000-0000-0000-000000000002'
RequestType: Submit
مسارات البناء والإصدار
والآن وقد تعرفنا على ما يمكن القيام به باستخدام أدوات البناء، سنرى كيف يمكنك تطبيق هذه الأدوات على مسارات البناء والإصدار. فيما يلي نظرة عامة تصورية. لنستعرض الآن بعض التفاصيل الخاصة بتنفيذ المسار باستخدام مهام أدوات البناء في الأقسام الفرعية التالية.
لمعرفة المزيد حول إنشاء هذه والمسارات وإجراء عمليات تأليف مسارات فعلية باستخدام Microsoft Power Platform Build Tools، أكمل مختبرات build tools، التي يمكنك تنزيلها من GitHub.
مزيد من المعلومات حول Azure Pipelines: استخدام Azure Pipelines
مسار البناء: تصدير حل من بيئة تطوير (DEV)
يُظهر الشكل التالي مهام أدوات البناء التي قد تضيفها إلى مسار يقوم بتصدير حل من بيئة تطوير.
مسار البناء: بناء حل مُدار
يُظهر الشكل التالي مهام أدوات البناء التي قد تضيفها إلى مسار يقوم ببناء حل مُدار.
مسار الإصدار: النشر إلى بيئة إنتاج (PROD)
يُظهر الشكل التالي مهام أدوات البناء التي قد تضيفها إلى مسار يقوم بنشر بيئة إنتاج.