إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
تصف الأقسام التالية مهام البناء المتوفرة. بعد ذلك، نعرض بعض الأمثلة على استخدام 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 default Power Platform Build Tools and adds the pac cli to the `PATH` environment variable
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.tool-installer.PowerPlatformToolInstaller@2
displayName: 'Power Platform Tool Installer'
inputs:
AddToolsToPath: true
# 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استخدام إصدارات الأدوات الافتراضية |
قم بالتعيين إلى صواب لاستخدام الإصدار الافتراضي لجميع الأدوات، وإلا خطأ. مطلوب (و خطأ) عندما يتم تحديد أية إصدارات أدوات. |
AddToolsToPathإضافة أدوات إلى المسار |
يضيف pac cli إلى متغير البيئة PATH. يمكنك من استخدام pac cli من مهام البرنامج النصي دون الحاجة إلى إعداد المسار يدويا. |
PowerAppsAdminVersionXrmToolingPackageDeploymentVersionMicrosoftPowerAppsCheckerVersionCrmSdkCoreToolsVersionإصدار الأداة |
الإصدار المحدد من الأداة التي يجب استخدامها. |
منصة Power: 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 في جميع المجلدات الفرعية. |
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 Checker على أنه فشل أو 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
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
تعيين PowerPlatformSetConnectionVariables.BuildTools.* المتغيرات لتوفير الوصول إلى مهام البرنامج النصي المخصصة لاستخدام اتصال الخدمة كمصدر واحد للحقيقة.
يتم تعيين المتغيرات التالية:
PowerPlatformSetConnectionVariables.BuildTools.TenantIdPowerPlatformSetConnectionVariables.BuildTools.ApplicationIdPowerPlatformSetConnectionVariables.BuildTools.ClientSecretPowerPlatformSetConnectionVariables.BuildTools.DataverseConnectionString
جزء تعليمة 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عملة |
(مطلوب) العملة الأساسية للبيئة التي تم إنشاؤها. لا يمكن تحديث العملة بعد إنشاء البيئة. |
LanguageNameLanguage |
(مطلوب) اللغة الأساسية في البيئة. |
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'
SkipAuditData: true
MaxAsyncWaitTime: 60
المعلمات (نسخ البيئة)
| المعلمات | الوصف |
|---|---|
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نوع النسخ |
نوع النسخ المراد تنفيذه: FullCopy أو MinimalCopy |
OverrideFriendlyNameتجاوز اسم مألوف |
قم بتغيير الاسم المألوف للبيئة الهدف إلى اسم آخر (صواب|خطأ). |
FriendlyNameاسم مألوف |
الاسم المألوف للبيئة الهدف. |
SkipAuditDataSkipAuditData |
ما إذا كنت تريد تخطي بيانات التدقيق أثناء عملية النسخ. (true|false). |
MaxAsyncWaitTimeالحد الأقصى لوقت الانتظار |
الحد الأقصى لوقت الانتظار بالدقائق للعملية غير المتزامنة؛ الإعداد الافتراضي هو 60 دقيقة (ساعة واحدة)، وكذلك الإعداد الافتراضي في Azure DevOps للمهام. |
استرداد بيئة 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 المخطط. يمكن إنشاؤه باستخدام Configuration Migration tool. |
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 management
مهام للتعامل مع موقع الويب 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)
يُظهر الشكل التالي مهام أدوات البناء التي قد تضيفها إلى مسار يقوم بنشر بيئة إنتاج.