Microsoft Power Platform Build Tools тапсырмалары
Қолжетімді құрастыру тапсырмалары келесі бөлімдерде сипатталған. Содан кейін біз осы тапсырмаларды пайдаланатын Azure құбырларының кейбір мысалын көрсетеміз. Құрастыру құралдары және оларды жүктеп алу жолы туралы ақпаратты Microsoft Power Platform Azure Pipelines үшін құрастыру құралдары бөлімінен қараңыз.
Көмекші тапсырма
Қол жетімді көмекші тапсырмалар келесіде сипатталады.
Power Platform құрал орнатушысы
Бұл тапсырманы құрастырылым мен шығарылым арналарындағы басқа кез келген Power Platform құрастыру құралдарының тапсырмаларының алдында қосу қажет. Бұл тапсырма агент Microsoft Power Platform құрастыру тапсырмаларын іске қосу үшін қажет 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
WhoAmI сұранысын қосу және жасау арқылы Power Platform орта қызметінің қосылымын растайды. Бұл тапсырма үдерістер тізбегін ертерек қосып, өңдеу басталғанға дейін қосылымды тексеру үшін тиімді болуы мүмкін.
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 Power Platform ортасының URL мекенжайы |
Ортаға қосылатын қызметтің соңғы нүктесі. Жоба параметрлері ішіндегі Қызмет қосылымдары тармағында анықталған. Қосымша ақпарат: BuildTools.EnvironmentUrl тақырыбын Power Platform ортасын жасау бөлімінен қараңыз |
PowerPlatformSPN Power Platform қызмет‑субъектісі |
Ортаға қосылатын қызметтің соңғы нүктесі. Жоба параметрлері ішіндегі Қызмет қосылымдары тармағында анықталған. |
Сапаны тексеру
Келесі бөлімде шешімнің сапасын тексеруге арналған қолжетімді тапсырмалар берілген.
Power Platform Checker
Бұл тапсырма шешімді құру кезінде байқаусызда енгізуі мүмкін кез келген проблемалық үлгілерді анықтау үшін ең жақсы тәжірибе ережелерінің жиынтығына қарсы шешімдеріңізде статикалық талдауды тексереді.
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 Қызмет қосылымы |
(Міндетті) Power Platform тексергіш құралын пайдалану үшін лицензияланған Microsoft Power Platform ортасына қосылым қажет. Қызметтік қосылымдар Power Platform қосылым түрін пайдаланатын Проект параметрлері тармағындағы Қызмет қосылымдары бөлімінде анықталады. Қосымша ақпарат: BuildTools.EnvironmentUrl астындағы Power Platform Ортаны жасаубөлімінен қараңыз.Ескертпе: Қызметтің негізгі және пайдаланушы аты/құпия сөздің аутентификация әдістері тексеруші тапсырмасы үшін қолжетімді. Осы тапсырмада пайдаланылатын субъект-қызметін конфигурациялау жолы туралы қосымша ақпаратты Power Platform орталары үшін субъект-қызмет қосылымдарын конфигурациялау бөлімінен қараңыз. |
UseDefaultPACheckerEndpoint Әдепкі Power Platform тексеру құралының соңғы нүктесін пайдалану |
Әдепкі бойынша (шын), тексеру қызметінің географиялық орны сіз қосылатын орта сияқты географияны пайдаланады. |
CustomPACheckerEndpoint Реттелетін PAC тексеру құралының соңғы нүктесі |
UseDefaultPACheckerEndpoint параметрі жалған болған кезде қажет. Қолдану үшін басқа географияны көрсетуге болады, мысалы https://japan.api.advisor.powerapps.com. Қол жетімді географиялар тізімін Power Platform Checker API пайдалану бөлімін қараңыз. . |
FileLocation Талдау үшін файлдардың орны |
Ортақ қатынас қолтаңбасының (SAS) URL мекенжайынан файлға сілтеме жасау кезінде талап етіледі sasUriFile .Ескертпе: репозиторийдегі қаптамадан шығарылған бастапқы файлдарға емес, экспортталған шешім файлына сілтеме жасау маңызды. Басқарылатын және басқарылмайтын шешім файлдарын талдауға болады. |
FilesToAnalyzeSasUri Талдау керек SAS файлдары |
FileLocation параметрі sasUriFile орнатылған кезде қажет. SAS URI мекенжайын енгізіңіз. Үтір (,) немесе нүктелі үтір (;) арқылы тізімге бірнеше SAS URI қосуға болады. |
FilesToAnalyze Талдау керек жергілікті файлдар |
SAS файлдары талданбаған кезде қажет. Талдау үшін zip файлдарының жолын және атауын көрсетіңіз. Жұлдызшаларды пайдалануға болады. Мысалы, барлық ішкі қалталардағы барлық zip файлдары үшін **\*.zip енгізіңіз. |
FilesToExclude Шығару керек жергілікті файлдар |
Талдаудан шығарылатын файлдардың атауларын көрсетіңіз. Егер бірнешеу болса, үтір (,) немесе нүктелі үтір (;) арқылы бөлінген тізім ретінде көрсетіңіз. Бұл тізім толық файл атауын немесе *jquery немесе form.js сияқты алдыңғы немесе кейінгі қойылмалы таңбалары бар атауды қамтуы мүмкін |
RulesToOverride Алдын ала анықтау ережелері |
Алдын ала анықталатын ережелер мен деңгейлерді қамтитын JSON жиымы. OverrideLevel үшін қабылданған мәндер: критикалық, жоғары, орташа, төмен, ақпараттық. Мысалы: [{"Id":"meta-remove-dup-reg","OverrideLevel":"Medium"},{"Id":"il-avoid-specialized-update-ops","OverrideLevel":"Medium"}] |
RuleSet Ережелер жинағы |
(Міндетті) Қандай ережелер жиынтығын қолданатындығын көрсетіңіз. Мына екі ережелер жиынтығы қолжетімді:
|
ErrorLevel Қате деңгейі |
Қатемен біріктірілген шекті параметр рұқсат етілген қателер мен ескертулердің ауырлығын анықтайды. Қолдау көрсетілетін шекті мәндер <level>IssueCount, мұнда level=критикалық, жоғары, орташа, төмен және ақпараттық. |
ErrorThreshold Қатенің шекті мәні |
Тексеру құралына тексерілетін шешімдерден өтуге рұқсат етілген көрсетілген деңгейдегі қателер санын (>=0) анықтайды. |
FailOnPowerAppsCheckerAnalysisError Қатемен сәтсіздік |
Шын болған кезде, Power Apps тексеру талдауы Failed немесе FinishedWithErrors ретінде қайтарылады. |
ArtifactDestinationName DevOps артефакт атауы |
Checker .sarif файлы үшін Azure Artifacts атауын көрсетіңіз. |
Шешім тапсырмалары
Бұл тапсырмалар жиынтығы шешім әрекеттерін автоматтандыруы мүмкін. Осы бөлімде кейінірек сипатталған ортаны жасайтын, көшіретін немесе қалпына келтіретін орта тапсырмалары жаңадан жасалған орталармен қызмет қосылымдарын қайта жазады. Бұл тапсырмалар сұраныс бойынша жасалған орталарға қарсы шешім тапсырмаларын орындауға мүмкіндік береді.
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 Power Platform ортасының URL мекенжайы |
Шешімді импорттағыңыз келетін қызметтің соңғы нүктесі (мысалы, 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 Шешімнің енгізу файлы |
(Міндетті) Мақсатты ортаға импортталатын шешім .zip файлының жолы мен файл атауы (мысалы, $(Build.ArtifactStagingDirectory)$(SolutionName).zip). Ескерту: айнымалылар үрдістер тізбегіңіздің әртүрлі бөліктеріне деректердің негізгі биттерін апарудың ыңғайлы әдісін ұсынады. Жиынтық тізім туралы Алдын ала анықталған айнымалыларды пайдалану бөлімін қараңыз. |
HoldingSolution Холдингтік шешім ретінде импорттау |
Шешімді жаңарту қажет болған кезде пайдаланылатын жетілдіру параметрі (шын|жалған). Бұл параметр шешімді Dataverse бағдарламасында орналастырады, бірақ шешімді жаңартуды қолдану тапсырмасы орындалмайынша оны жаңартпайды. |
OverwriteUnmanagedCustomizations Басқарылмайтын теңшеулерді қайта жазу |
Басқарылмайтын теңшеулерді қайта жазу керектігін көрсетіңіз (шын|жалған). |
SkipProductUpdateDependencies Өнімді жаңарту тәуелділіктерін өткізіп жіберу |
Өнім жаңартуларына қатысты тәуелділіктерді орындауды өткізіп жіберу керектігін көрсетіңіз (шын|жалған). |
ConvertToManaged Басқарылатынға түрлендіру |
Басқарылатын шешім ретінде импорттау керектігін не керек еместігін көрсетіңіз (шын|жалған). |
AsyncOperation Үндестірілмеген импорттау |
Егер таңдалған болса (шын), импорттау операциясы үндестірілмеген түрде орындалады. Бұл үлкен шешім үшін ұсынылады, себебі бұл тапсырма басқаша түрде 4 минуттан кейін автоматты түрде тоқтайды. Үндестірілмеген таңдау сауалнама жүргізеді және MaxAsyncWaitTime уақыты жеткенше күтеді (шын|жалған). |
MaxAsyncWaitTime Максималды күту уақыты |
Үндестірілмеген операция үшін минут бірлігіндегі максималды күту уақыты; әдепкі — 60 мин (1 сағ), сол сияқты 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 Power Platform ортасының URL мекенжайы |
Қосып жатқан шешім құрамдасын көрсететін мән. Құрамдас мәндердің толық тізімі үшін Алдын ала анықталған құрамдас түрлерін пайдалану бөлімін қараңыз. |
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 Power Platform ортасының URL мекенжайы |
Шешімді жаңартқыңыз келетін қызметтің соңғы нүктесі (мысалы, 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 мин (1 сағ), сол сияқты 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 Power Platform ортасының URL мекенжайы |
Шешімді жаңартқыңыз келетін қызметтің соңғы нүктесі (мысалы, 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 мин (1 сағ), сол сияқты 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 Power Platform ортасының URL мекенжайы |
Шешімді жойғыңыз келетін қызметтің соңғы нүктесі (мысалы, 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 Power Platform ортасының URL мекенжайы |
Теңшеулерді жариялағыңыз келетін қызметтің соңғы нүктесі (мысалы, 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 Power Platform ортасының URL мекенжайы |
Шешім нұсқасын орнатқыңыз келетін қызметтің соңғы нүктесі (мысалы, 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 Шешім нұсқасының нөмірі |
(Міндетті) Орнатқыңыз келетін нұсқа нөмірі. |
Үдерістер тізбегінде нұсқа нөмірін қатаң кодтау мүмкін болса да, алайда BuildId сияқты Azure DevOps үдерістер тізбегі айнымалысын пайдалану ұсынылады. Бұл "Параметрлер" қойындысының астында нұсқа нөмірінің нақты пішінін анықтауға мүмкіндік береді, мысалы: $ (жыл: жжжж)-$ (ай: АА)-$ (күн: кк)-$ (айналым: аа)-3
Осы анықтама шешім нұсқасын орнату тапсырмасында 20200824.0.0.2 кіріктірудің орнына нұсқа нөмірінің сипатын келесідей етіп орнату арқылы пайдаланылады: $(Build.BuildId).
Немесе Powershell кірістірілген тапсырма сценарийі $(Get-Date -Format yyyy.MM.dd.HHmm) шығысы Write-Host ретінде SolutionVersion деп аталатын бос айнымалыға орнатылады ("##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 Power Platform ортасының URL мекенжайы |
Буманы орналастырғыңыз келетін қызметтің соңғы нүктесі (мысалы, 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 мин (1 сағ), сол сияқты 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 Power Platform ортасының URL мекенжайы |
Ортаны жасағыңыз келетін қызметтің соңғы нүктесі (мысалы, 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 Тіл |
(Қажет) Ортадағы негізгі тіл. |
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 Power Platform ортасының URL мекенжайы |
Ортаны жойғыңыз келетін қызметтің соңғы нүктесі (мысалы, https://powerappsbuildtools.crm.dynamics.com ). Power Platform қосылым түрін пайдалану арқылы Жоба параметрлері бөліміндегі Қызмет қосылымдары арқылы анықталады. |
PowerPlatformSPN Power Platform қызмет‑субъектісі |
Ортаны жойғыңыз келетін қызметтің соңғы нүктесі (мысалы, https://powerappsbuildtools.crm.dynamics.com ). Power Platform қосылым түрін пайдалану арқылы Жоба параметрлері бөліміндегі Қызмет қосылымдары арқылы анықталады. |
Power Platform Пайдаланушыны тағайындау
Пайдаланушыны қауіпсіздік рөлі көрсетілген мақсатты ортаға тағайындаңыз.
YAML үзінді (User-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 үзінді (Қалпына келтіру-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 Power Platform ортасының URL мекенжайы |
Ортаны қалпына келтіргіңіз келетін қызметтің соңғы нүктесі (мысалы, 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 Power Platform ортасының URL мекенжайы |
Ортаның сақтық көшірмесін жасағыңыз келетін қызметтің соңғы нүктесі (мысалы, 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 Power Platform ортасының URL мекенжайы |
Көшіретін бастапқы ортаға арналған қызметтің соңғы нүктесі (мысалы, 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 Түсінікті атау |
Мақсатты ортаның түсінікті атауы. |
DisableAdminMode Басқару режимін өшіру |
Басқару режимін өшіру керек не керек емес (шын|жалған). |
Power Platform Қоршаған ортаны қалпына келтіру
Ортаны берілген сақтық көшірмеге қалпына келтіреді.
YAML үзінді (қалпына келтіру)
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'
Параметрлер (қалпына келтіру-env)
Параметрлер | Сипаттама |
---|---|
authenticationType Аутентификация түрі |
(SPN үшін міндетті) Пайдаланушы аты/құпиясөз қосылымы үшін PowerPlatformEnvironment немесе қызмет‑субъектісі/клиент құпиясы қосылым үшін PowerPlatformSPN параметрін көрсетіңіз. |
PowerPlatformEnvironment Power Platform ортасының URL мекенжайы |
Қалпына келтіргіңіз келетін бастапқы ортаға арналған қызметтің соңғы нүктесі (мысалы, https://powerappsbuildtools.crm.dynamics.com ). Power Platform қосылым түрін пайдалану арқылы Жоба параметрлері бөліміндегі Қызмет қосылымдары арқылы анықталады. |
PowerPlatformSPN Power Platform қызмет‑субъектісі |
Қалпына келтіргіңіз келетін бастапқы ортаға арналған қызметтің соңғы нүктесі (мысалы, https://powerappsbuildtools.crm.dynamics.com ). Power Platform қосылым түрін пайдалану арқылы Жоба параметрлері бөліміндегі Қызмет қосылымдары арқылы анықталады. |
RestoreLatestBackup Қалпына келтіру үшін соңғы сақтық көшірме |
Соңғы сақтық көшірмені қалпына келтіру немесе RestoreTimeStamp (шын|жалған) беру керек пе. |
RestoreTimeStamp Сақтық көшірменің DateTime |
"аа.кк.жжжж сс:мм" пішіміндегі сақтық көшірменің жасалған уақыты НЕМЕСЕ "ең соңғы" жолы. |
TargetEnvironmentUrl Мақсатты орта URL |
(Міндетті) Қалпына келтіргіңіз келетін мақсатты ортаның URL мекенжайы. |
FriendlyName Қалпына келтірілген ортаның атауы |
(Қосымша) Қалпына келтірілген ортаның атауы. |
DisableAdminMode Басқару режимін өшіру |
Басқару режимін өшіру керек не керек емес (шын|жалған). |
Dataverse Деректерді экспорттау
Берілген схемасы бар ортадан деректерді экспорттау.
YAML үзінді (экспорттау деректері)
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 үзінді (импорттау деректері)
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 Деректер файлының аты |
Сығылған zip үшін файл атауы) импортталатын деректер файлы немесе импортталатын data-schema.xml және data.xml бар қалта. |
Power Pages басқару міндеттері
Power Pages веб-сайтпен жұмыс істеуге арналған тапсырмалар.
Power Platform — PAPortal жүктеп алу
Power Pages веб-сайтының мазмұнын ағымдағы Dataverse ортасынан жүктеп алыңыз.
YAML үзінді (жүктеу-папортал)
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
Параметрлер (жүктеу-папортал)
Параметрлер | Сипаттама |
---|---|
authenticationType Аутентификация түрі |
(SPN үшін міндетті) Пайдаланушы аты/құпиясөз қосылымы үшін PowerPlatformEnvironment немесе қызмет‑субъектісі/клиент құпиясы қосылым үшін PowerPlatformSPN параметрін көрсетіңіз. |
PowerPlatformSPN Power Platform қызмет‑субъектісі |
Мазмұнды жүктеп алғыңыз келетін ортаға арналған қызметтің соңғы нүктесі (мысалы, https://powerappsbuildtools.crm.dynamics.com ). Power Platform қосылым түрін пайдалану арқылы Жоба параметрлері бөліміндегі Қызмет қосылымдары арқылы анықталады. |
WebsiteId Портал веб-сайтының идентификаторы |
Power Pages жүктеп алу үшін веб-сайт идентификаторы. |
Overwrite Мазмұнды қайта жазу |
Power Pages қайта жазу үшін веб-сайт мазмұны (шын|жалған). |
ModelVersion Сайт деректерінің үлгісі |
Жүктеп салынатын сайт деректері стандартты (1 ) немесе жақсартылған деректер үлгісін (2 ) пайдаланатынын көрсетеді. Әдепкі мән - "1". |
Power Platform — PAPortal жүктеп салу
Ағымдағы Power Pages ортаға Dataverse веб-сайт мазмұнын жүктеп салыңыз.
YAML үзінді (жүктеп салу-папортал)
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'
Параметрлер (жүктеп салу-папорталдық)
Параметрлер | Сипаттама |
---|---|
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 каталог тапсырмалары алдын ала қарау шығарылымы болып табылады.
Каталог элементін орнату
Каталог элементін мақсатты ортаға орнатыңыз.
Параметрлер | Сипаттама |
---|---|
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 Сауалнама күйін тексеріңіз |
(Қосымша) Сұрауыңыздың күйін тексеру үшін сауалнама (шын|жалған). |
Параметрлер (каталогты орнату)
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
Каталогты бекітуді жіберу
Каталог бекіту сұрауын жіберіңіз.
Параметрлер | Сипаттама |
---|---|
authenticationType Аутентификация түрі |
(SPN үшін міндетті) Пайдаланушы аты/құпиясөз қосылымы үшін PowerPlatformEnvironment немесе қызмет‑субъектісі/клиент құпиясы қосылым үшін PowerPlatformSPN параметрін көрсетіңіз. |
PowerPlatformSPN Power Platform қызмет‑субъектісі |
Мазмұнды жүктеп салғыңыз келетін ортаға арналған қызметтің соңғы нүктесі (мысалы, "https://powerappsbuildtools.crm.dynamics.com"). Power Platform қосылым түрін пайдалану арқылы Жоба параметрлері бөліміндегі Қызмет қосылымдары арқылы анықталады. |
Environment Мақсатты орта URL |
(Міндетті) Бұл тапсырманы мақсат ететін ортаның URL мекенжайы. |
CatalogSubmissionFile Каталог жіберу файлы |
(Міндетті) Каталог жіберу файлының жолын және файл атауын көрсетіңіз. |
UsePackageSolutionZipFile Файл түрі |
Файл түрі: бума немесе шешім zip файлы. |
SolutionZipFile Шешім zip файл атауы |
Шешім zip файлының жолын және файл атауын көрсетіңіз. |
PollStatus Сауалнама күйін тексеріңіз |
(Қосымша) Сұрауыңыздың күйін тексеру үшін сауалнама (шын|жалған). |
Параметрлер (каталогты жіберу)
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 Сұрау түрі |
(Міндетті) Сұраныс түрі. (Мәндер: Орнату | Жіберу). |
Параметрлер (каталог-күй)
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 арқылы үрдістер тізбегін жасау үшін, құрастыру құралдарының зертханаларын құру керек, оны GitHub хабынан жүктеуге болады.
Azure құбыр желілері туралы қосымша ақпарат: Azure құбыр желілерін пайдаланыңыз
Үрдістер тізбегін құру: шешімді әзірлеу ортасынан (DEV) экспорттаңыз
Төмендегі суретте әзірлеу ортасынан шешімді экспорттайтын үрдістер тізбегін қосуға болатын құрастыру құралдарының тапсырмалары көрсетілген.
Үдерістер тізбегін құру: басқарылатын шешімді құрыңыз
Төмендегі суретте басқарылатын шешімді құрастыратын үрдістер тізбегін қосуға болатын құрастыру құралдарының тапсырмалары көрсетілген.
Үдерістер тізбегін шығару: өндірістік ортаға (PROD) орналастырыңыз
Өндіріс ортасына орналастыратын үрдістер тізбегін қосуға болатын құрастыру құралдарының тапсырмалары көрсетілген.
Сонымен қатар қараңыз
Azure DevOps жүйесіне арналған Microsoft Power Platform құрастыру құралдары
Кері байланыс
https://aka.ms/ContentUserFeedback.
Жақында қолжетімді болады: 2024 жыл бойы біз GitHub Issues жүйесін мазмұнға арналған кері байланыс механизмі ретінде біртіндеп қолданыстан шығарамыз және оны жаңа кері байланыс жүйесімен ауыстырамыз. Қосымша ақпаратты мұнда қараңыз:Жіберу және пікірді көру