مهام 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@0
  displayName: 'Power Platform Tool Installer'
# Installs specific versions of the Power Platform Build Tools
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.tool-installer.PowerPlatformToolInstaller@0
  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@0
  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@0
  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@0
  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@0
  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
مجموعة القواعد
(مطلوب) حدد مجموعة القواعد التي سيتم تطبيقها. تتوفر مجموعتا القواعد التاليتان:
  • مدقق الحلول: مجموعة القواعد هذه هي نفسها التي يتم تشغيلها من Power Apps Maker Portal.
  • AppSource: مجموعة القواعد الموسعة المستخدمة للتصديق على الطلب قبل أن يتم نشره على AppSource.
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@0
  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@0
  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@0
  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@0
  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@0
  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@0
  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@0
  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@0
  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@0
  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@0
  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@0
  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@0
  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@0
  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@0
  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 https://powerappsbuildtasks0.crm.dynamics.com/.

حذف بيئة في Power Platform

حذف بيئة.

قصاصة برمجية YAML (حذف بيئة)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.delete-environment.PowerPlatformDeleteEnvironment@0
  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@0
  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@0
  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@0
  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)

يُظهر الشكل التالي مهام أدوات البناء التي قد تضيفها إلى مسار يقوم بتصدير حل من بيئة تطوير.

تصدير حل من بيئة تطوير (DEV).

مسار البناء: بناء حل مُدار

يُظهر الشكل التالي مهام أدوات البناء التي قد تضيفها إلى مسار يقوم ببناء حل مُدار.

بناء حل مُدار.

مسار الإصدار: النشر إلى بيئة إنتاج (PROD)

يُظهر الشكل التالي مهام أدوات البناء التي قد تضيفها إلى مسار يقوم بنشر بيئة إنتاج.

النشر إلى بيئة إنتاج (PROD).

راجع أيضًا:

Microsoft Power Platform Build Tools لـ Azure DevOps