Dijeli putem

Zadaci sustava Microsoft Power Platform Build Tools

  • Članak

Dostupni zadaci alata za izradu opisani su u sljedećim odjeljcima. Nakon toga prikazujemo neke primjere servisa Azure Pipelines koji koriste te zadatke. Informacije o alatima za izradu i njihovom preuzimanju potražite u članku Microsoft Power Platform Sastavljanje alata za cjevovode servisa Azure.

Zadatak pomoćnika

Sljedeći su opisani dostupni zadaci pomagača.

Instalacijski program za Power Platform Tool

Ovaj zadatak treba dodati jedanput prije bilo kojeg drugog zadatka Power Platform Build Tools za izgradnju u kanalima za izgradnju i izdavanje. Ovaj zadatak instalira skup posebnih alata Power Platformkoji su potrebni agentu da bi mogao pokrenuti zadatke izgradnje Microsoft Power Platform. Ovaj zadatak ne zahtijeva više konfiguracije prilikom dodavanja. Ovaj zadatak sadrži parametre za određene verzije svakog alata koji se instalira.

Kako biste uvijek bili u tijeku s verzijama alata, provjerite odgovaraju li ovi parametri verzijama alata koje su potrebni da bi kanal pravilno radio.

YAML isječak (instalater)

# 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

Parametri (instalater)

Parametri Opis
DefaultVersion
Koristite zadane verzije alata		 Postavite na Istinito za korištenje zadane verzije svih alata, inače na Neistinito. Obavezno (i neistinito) kada su određene verzije alata.
PowerAppsAdminVersion
XrmToolingPackageDeploymentVersion
MicrosoftPowerAppsCheckerVersion
CrmSdkCoreToolsVersion
Verzija alata		 Konkretna verzija alata za korištenje.

Power Platform WhoAmI

Potvrđuje vezu s uslugom Power Platform okruženja povezivanjem i podnošenjem WhoAmI zahtjeva. Ovaj zadatak može biti korisno uključiti rano u kanal kako bi se provjerila povezivost prije nego što započne obrada.

YAML isječak (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'

Parametri (WhoAmI)

Parametri Opis
authenticationType
Vrsta provjere autentičnosti		 (Neobavezno) Navedite bilo PowerPlatformEnvironment za vezu s korisničkim imenom / lozinkom ili PowerPlatformSPN za upravitelja servisa / tajnu klijenta. Više informacija: vidi BuildTools.EnvironmentUrl pod stavkom Stvaranje okruženja Power Platform
PowerPlatformEnvironment
URL okruženja Power Platform		 Krajnja točka usluge za okruženje s kojim se želite povezati. Definirana je pod Veze usluge u Postavke projekta. Više informacija: vidi BuildTools.EnvironmentUrl pod stavkom Stvaranje okruženja Power Platform
PowerPlatformSPN
Upravitelj usluge platforme Power Platform		 Krajnja točka usluge za okruženje s kojim se želite povezati. Definirana je pod Veze usluge u Postavke projekta.

Provjera kvalitete

U sljedećem odjeljku nalaze se dostupni zadaci za provjeru kvalitete rješenja.

Power Platform Checker

Ovaj zadatak pokreće statičku analizu vaših rješenja u odnosu na skup pravila najbolje prakse kako bi se identificirali problematični obrasci koje biste mogli nehotice uvesti prilikom izrade rješenja.

YAML isječak (provjeritelj)

# 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'

Parametri (provjeritelj)

Parametri Opis
PowerPlatformSPN
Servisna veza		 (Obavezno) Veza s licenciranim Microsoft Power Platform okruženjem je potrebna za upotrebu Power Platform provjere. Servisne veze definirane su u Servisne veze pod Postavke projekta korištenjem vrste veze Power Platform. Dodatne informacije: pogledajte BuildTools.EnvironmentUrl u odjeljku Power Platform Stvaranje okruženja

Napomena: Za zadatak provjere dostupni su glavni servis i metode provjere autentičnosti korisničkog imena/lozinke. Dodatne informacije o konfiguriranju upravitelja usluga koji se koriste s ovim zadatkom potražite u odjeljku Konfiguracija veza upravitelja usluga za okruženja servisa Power Platform.
UseDefaultPACheckerEndpoint
Koristite zadanu krajnju točku Power Platform provjeritelja		 Prema zadanim postavkama (true), zemljopisni položaj usluge provjere koristi istu geografiju kao i okruženje s kojim se povezujete.
CustomPACheckerEndpoint
Prilagođena krajnja točka PAC provjeritelja		 Obavezno kada je UseDefaultPACheckerEndpointneistinito. Možete navesti drugi geo koji će se koristiti, na primjer https://japan.api.advisor.powerapps.com. Popis dostupnih geografskih područja potražite u odjeljku Power Platform Korištenje API-ja za provjeru.
FileLocation
Mjesto datoteka za analizu		 Potrebno prilikom upućivanja na datoteku s URL-a sasUriFile

potpisa zajedničkog pristupa (SAS).Napomena: važno je referencirati izvezenu datoteku rješenja, a ne raspakirane izvorne datoteke u spremištu. Mogu se analizirati datoteke i upravljanog i neupravljanog rješenja.
FilesToAnalyzeSasUri
SAS datoteke za analizu		 Obavezno kada je FileLocation postavljeno na sasUriFile. Unesite URI SAS-a. Možete dodati više od jednog SAS URI-ja kroz popis razdvojen zarezom(,) ili točkom-zarezom (;).
FilesToAnalyze
Lokalne datoteke za analizu		 Obavezno kada se SAS datoteke ne analiziraju. Navedite putanju i ime datoteke komprimiranih datoteka koje treba analizirati. Mogu se koristiti zamjenski znakovi. Na primjer, unesite **\*.zip za sve zip datoteke u svim podmapama.
FilesToExclude
Lokalne datoteke za isključenje		 Navedite nazive datoteka koje će se isključiti iz analize. Ako ih ima više, navedite popis odvojen zarezom (,) ili točkom-zarezom (;). Ovaj popis može uključivati puni naziv datoteke ili naziv s vodećim ili završnim zamjenskim znakovima, kao što su *jquery ili form.js
RulesToOverride
Pravila za nadjačavanje		 JSON niz koji sadrži pravila i razine za nadjačavanje. Prihvaćene vrijednosti za OverrideLevel su: Critical, High, Medium, Low, Informational. Primjer: [{"Id":"meta-remove-dup-reg","OverrideLevel":"Medium"},{"Id":"il-avoid-specialized-update-ops","OverrideLevel":"Medium"}]
RuleSet
Skup pravila		 (Obvezno) Navedite skup pravila koji će primijeniti. Dostupna su da sljedeća skupa pravila:
  • Alat za provjeru rješenja: Ovaj skup pravila isti je onaj koji se pokreće s portala Power Apps proizvođača.
  • AppSource: prošireni skup pravila koji se koristi za certificiranje aplikacije prije objavljivanja u AppSource.
ErrorLevel
Razina pogreške		 U kombinaciji s pogreškom, parametar praga definira ozbiljnost dopuštenih pogrešaka i upozorenja. Podržane vrijednosti praga su <level>IssueCount gdje je level=Critical, High, Medium, Low i Informational.
ErrorThreshold
Granična vrijednost pogreške		 Definira broj pogrešaka (>=0) određene razine koje su dopuštene da provjeritelj da prolaz rješenjima koja se provjeravaju.
FailOnPowerAppsCheckerAnalysisError
Neuspjelo prilikom pogreške		 Kada je istinito, ne uspijeva ako se analiza Power Apps provjeritelja vraća kao Failed ili FinishedWithErrors.
ArtifactDestinationName
Naziv DevOps artefakta		 Navedite naziv artefakata servisa Azure za datoteku checker .sarif.

Zadaci rješenja

Ovaj skup zadataka može automatizirati radnje rješenja. Zadaci okruženja navedeni kasnije u ovom odjeljku koji stvaraju, kopiraju ili vraćaju okruženje prebrisuju veze usluge s novostvorenim okruženjima. Ovi zadaci omogućuju izvođenje zadataka rješenja u okruženjima koja se stvaraju na zahtjev.

Uvoz rješenja Power Platform

Uvozi rješenje u ciljno okruženje.

YAML isječak (uvoz)

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

Parametri (uvoz)

Parametri Opis
authenticationType
Vrsta provjere autentičnosti		 (Obvezno za SPN) Navedite bilo PowerPlatformEnvironment za vezu s korisničkim imenom / lozinkom ili PowerPlatformSPN za upravitelja servisa / tajnu klijenta.
PowerPlatformEnvironment
URL okruženja Power Platform		 Servisna krajnja točka u koju želite uvesti rješenje (na primjer, https://powerappsbuildtools.crm.dynamics.com). Definirano pod stavkom Veze usluge u odjeljku Postavke projekta korištenjem vrste veze Power Platform. Više informacija: vidi BuildTools.EnvironmentUrl pod stavkom Stvaranje okruženja Power Platform
PowerPlatformSPN
Upravitelj usluge platforme Power Platform		 Servisna krajnja točka u koju želite uvesti rješenje (na primjer, https://powerappsbuildtools.crm.dynamics.com). Definirano pod stavkom Veze usluge u odjeljku Postavke projekta korištenjem vrste veze Power Platform. Više informacija: vidi BuildTools.EnvironmentUrl pod stavkom Stvaranje okruženja Power Platform
SolutionInputFile
Datoteke ulaza rješenja		 (obavezno) Put i naziv datoteke rješenja .zip za uvoz u ciljno okruženje (na primjer, $(Build.ArtifactStagingDirectory)$(SolutionName) .zip).

Napomena: varijable vam daju jednostavan način za dobivanje ključnih bitova podataka u različitim dijelovima kanala. Pogledajte Korištenje unaprijed definiranih varijabli za opsežni popis.
HoldingSolution
Uvoz kao spremljeno rješenje		 Napredni parametar (istinito|neistinito) koji se koristi kada je rješenje potrebno nadograditi. Ovaj parametar sadrži rješenje u Dataverse, ali ne nadograđuje rješenje sve dok se ne pokrene zadatak Primijeni nadogradnju rješenja.
OverwriteUnmanagedCustomizations
Prebrišite neupravljane prilagodbe		 Navedite želite li prebrisati neupravljane prilagodbe (istinito|neistinito).
SkipProductUpdateDependencies
Preskočite ovisnosti ažuriranja proizvoda		 Navedite treba li preskočiti provedbu ovisnosti povezanih s ažuriranjima proizvoda (istinito|neistinito).
ConvertToManaged
Pretvaranje u upravljano		 Navedite želite li uvesti kao upravljano rješenje (istinito|neistinito).
AsyncOperation
Asinkroni uvoz		 Ako je odabrano (istinito), operacija uvoza izvest će se asinkrono. Ovo se preporučuje za veća rješenja jer će se ovaj zadatak automatski zaustaviti nakon 4 minute. Odabirom asinkronog slat će se upiti i čekati dok se ne dosegne MaxAsyncWaitTime (istinito|neistinito).
MaxAsyncWaitTime
Maksimalno vrijeme čekanja		 Maksimalno vrijeme čekanja u minutama za asinkronu operaciju; zadana vrijednost je 60 min (1 h), isto kao zadana postavka Azure DevOps za zadatke.
PublishWorkflows
Aktivirajte procese nakon uvoza		 Navedite trebaju li se neki procesi (tokovi rada) u rješenju aktivirati nakon uvoza (istinito|neistinito).
UseDeploymentSettingsFile
Korištenje datoteke postavki uvođenja		 Reference veze i vrijednosti varijabli okruženja mogu se postaviti korištenjem datoteke postavki implementacije (istinito|neistinito).
DeploymentSettingsFile
Datoteka postavki uvođenja		 (Obavezno kada je UseDeploymentSettingsFile=istinito) Putanja i naziv datoteke datoteke postavki uvođenja.

Power Platform Dodaj komponentu rješenja

Dodaje komponentu rješenja neupravljanom rješenju.

YAML isječak (dodaj)

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

Parametri (dodaj)

Parametri Opis
ComponentId
ID komponente rješenja		 Naziv sheme ili ID komponente za dodavanje ciljnom rješenju.
ComponentType
URL okruženja Power Platform		 Vrijednost koja predstavlja komponentu rješenja koju dodajete. Pogledajte Korištenje unaprijed definiranih vrsta komponenti za sveobuhvatan popis vrijednosti komponenti.
SolutionUniqueName
Naziv rješenja		 Jedinstveni naziv rješenja.
AddRequiredComponents
Sve komponente potrebne iz drugog rješenja koje ovise o komponenti rješenja		 (Neobavezno) Označava treba li u neupravljano rješenje dodati i druge komponente rješenja koje zahtijeva komponenta rješenja koju dodajete.
Environment
URL ili ID okruženja		 (Neobavezno) URL okruženja ili ID ciljnog okruženja.

Power Platform Primijeni nadogradnju rješenja

Nadograđuje rješenje koje je uvezeno kao spremljeno rješenje.

YAML isječak (nadogradnja)

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

Parametri (nadogradnja)

Parametri Opis
authenticationType
Vrsta provjere autentičnosti		 (Obvezno za SPN) Navedite bilo PowerPlatformEnvironment za vezu s korisničkim imenom / lozinkom ili PowerPlatformSPN za upravitelja servisa / tajnu klijenta.
PowerPlatformEnvironment
URL okruženja Power Platform		 Servis krajnja točka u koji želite nadograditi rješenje (na primjer, https://powerappsbuildtools.crm.dynamics.com). Definirano pod stavkom Veze usluge u odjeljku Postavke projekta korištenjem vrste veze Power Platform. Više informacija: vidi BuildTools.EnvironmentUrl pod stavkom Stvaranje okruženja Power Platform
PowerPlatformSPN
Upravitelj usluge platforme Power Platform		 Servis krajnja točka u koji želite nadograditi rješenje (na primjer, https://powerappsbuildtools.crm.dynamics.com). Definirano pod stavkom Veze usluge u odjeljku Postavke projekta korištenjem vrste veze Power Platform. Više informacija: vidi BuildTools.EnvironmentUrl pod stavkom Stvaranje okruženja Power Platform
SolutionName
Naziv rješenja		 (Obavezno) Naziv rješenja za primjenu nadogradnje. Uvijek koristite Naziv rješenje, a ne njegov Zaslonski naziv.
AsyncOperation
Asinkrona nadogradnja		 Ako je odabrano (istinito), operacija nadogradnje izvest će se kao asinkroni skupni posao. Odabirom asinkronog slat će se upiti i čekati dok se ne dosegne MaxAsyncWaitTime.
MaxAsyncWaitTime
Maksimalno vrijeme čekanja		 Maksimalno vrijeme čekanja u minutama za asinkronu operaciju; zadana vrijednost je 60 min (1 h), isto kao zadana postavka Azure DevOps za zadatke.

Napomena

Varijable vam daju prikladan način za dobivanje ključnih bita podataka u različitim dijelovima kanala. Pogledajte Korištenje unaprijed definiranih varijabli za opsežni popis. Možete unaprijed popuniti podatke o referenci veze i varijablama okruženja za ciljno okruženje dok uvozite rješenje s pomoću datoteke postavki implementacije.

Više informacija: Popunjavanje referenci veze i varijabli okruženja unaprijed za automatizirane implementacije

Izvoz rješenja Power Platform

Izvozi rješenje iz izvornog okruženja.

YAML isječak (izvoz)

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

Parametri (izvoz)

Parametri Opis
authenticationType
Vrsta provjere autentičnosti		 (Obvezno za SPN) Navedite bilo PowerPlatformEnvironment za vezu s korisničkim imenom / lozinkom ili PowerPlatformSPN za upravitelja servisa / tajnu klijenta.
PowerPlatformEnvironment
URL okruženja Power Platform		 Servis krajnja točka u koji želite nadograditi rješenje (na primjer, https://powerappsbuildtools.crm.dynamics.com). Definirano pod stavkom Veze usluge u odjeljku Postavke projekta korištenjem vrste veze Power Platform. Više informacija: vidi BuildTools.EnvironmentUrl pod stavkom Stvaranje okruženja Power Platform
PowerPlatformSPN
Upravitelj usluge platforme Power Platform		 Servis krajnja točka u koji želite nadograditi rješenje (na primjer, https://powerappsbuildtools.crm.dynamics.com). Definirano pod stavkom Veze usluge u odjeljku Postavke projekta korištenjem vrste veze Power Platform. Više informacija: vidi BuildTools.EnvironmentUrl pod stavkom Stvaranje okruženja Power Platform
SolutionName
Naziv rješenja		 (Obvezno) Naziv rješenja koje treba izvesti. Uvijek koristite Naziv rješenje, a ne njegov Zaslonski naziv.
SolutionOutputFile
Datoteke izlaza rješenja		 (obavezno) Put i naziv solution.zip datoteke za izvoz izvorišnog okruženja u (na primjer,.zip $(Build.ArtifactStagingDirectory)$(SolutionName)).

Napomena: varijable vam daju jednostavan način za dobivanje ključnih bitova podataka u različitim dijelovima kanala. Pogledajte Korištenje unaprijed definiranih varijabli za opsežni popis.
AsyncOperation
Asinkroni izvoz		 Ako je odabrano (istinito), operacija izvoza izvest će se kao asinkroni skupni posao. Odabirom asinkronog slat će se upiti i čekati dok se ne dosegne MaxAsyncWaitTime.
MaxAsyncWaitTime
Maksimalno vrijeme čekanja		 Maksimalno vrijeme čekanja u minutama za asinkronu operaciju; zadana vrijednost je 60 min (1 h), isto kao zadana postavka Azure DevOps za zadatke.
Managed
Izvezi kao upravljano		 Ako je odabrano (istinito), izvezite rješenje kao upravljano rješenje; inače izvezite kao neupravljano rješenje.
ExportAutoNumberingSettings
Izvezite postavke automatskog numeriranja		 Izvezite postavke automatskog numeriranja (istinito|neistinito).
ExportCalendarSettings
Izvezi postavke kalendara		 Izvezite postavke kalendara (istinito|neistinito).
ExportCustomizationSettings
Izvezi postavke prilagođavanja		 Izvezite postavke prilagođavanja (istinito|neistinito).
ExportEmailTrackingSettings
Izvezi postavke praćenja e-pošte		 Izvezite postavke praćenja e-pošte (istinito|neistinito).
ExportGeneralSettings
Izvezi općenite postavke		 Izvezite opće postavke (istinito|neistinito).
ExportIsvConfig
Izvezi ISV konfiguraciju		 Izvezite ISV konfiguraciju (istinito|neistinito).
ExportMarketingSettings
Izvezi marketinške postavke		 Izvezite marketinške postavke (istinito|neistinito).
ExportOutlookSynchronizationSettings
Izvezi postavke sinkronizacije za Outlook		 Izvezite postavke sinkronizacije za Outlook (istinito|neistinito).
ExportRelationshipRoles
Izvezi uloge odnosa		 Izvezite uloge odnosa (istinito|neistinito).
ExportSales
Izvozi prodaju		 Izvezite prodaju (istinito|neistinito).

Raspakiranje rješenja Power Platform

Uzima komprimiranu datoteku rješenja i rastavlja je u više datoteka XML tako da sustav kontrole izvora može jednostavnije čitati i upravljati tim datotekama.

YAML isječak (raspakiranje)

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

Parametri (raspakiranje)

Parametri Opis
SolutionInputFile
Datoteke ulaza rješenja		 (Obvezno) Navedite putanju i ime datoteke rješenje.zip koje treba raspakirati.
SolutionTargetFolder
Ciljana mapa za raspakiranje rješenja		 (Obvezno) Putanja i ciljana mapa u koju želite raspakirati rješenje.
SolutionType
Vrsta rješenja		 (Obvezno) Vrsta rješenja koje želite raspakirati. Opcije uključuju: Neupravljano (preporučeno), Upravljano i Oboje.

Pakiranje rješenja Power Platform

Pakira rješenje predstavljeno u kontroli izvora u datoteku rješenje.zip koja se može uvesti u drugo okruženje.

YAML isječak (pakiranje)

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

Parametri (pakiranje)

Parametri Opis
SolutionOutputFile
Datoteke izlaza rješenja		 (Obvezno) Putanja i naziv datoteke rješenje.zip u koju treba zapakirati rješenje.
SolutionSourceFolder
Izvorna mapa rješenja koje treba zapakirati		 (Obvezno) Putanja i izvorna mapa rješenja koje treba zapakirati.
SolutionType
Vrsta rješenja		 (Obvezno) Vrsta rješenja koje želite zapakirati. Opcije uključuju: Upravljano (preporučeno), Neupravljano i Oboje.

Power Platform Izbriši rješenje

Briše rješenje u ciljnom okruženju.

YAML isječak (brisanje)

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'

Parametri (brisanje)

Parametri Opis
authenticationType
Vrsta provjere autentičnosti		 (Obvezno za SPN) Navedite bilo PowerPlatformEnvironment za vezu s korisničkim imenom / lozinkom ili PowerPlatformSPN za upravitelja servisa / tajnu klijenta.
PowerPlatformEnvironment
URL okruženja Power Platform		 Servis krajnja točka da želite izbrisati rješenje (na primjer, https://powerappsbuildtools.crm.dynamics.com). Definirano pod stavkom Veze usluge u odjeljku Postavke projekta korištenjem vrste veze Power Platform. Više informacija: vidi BuildTools.EnvironmentUrl pod stavkom Stvaranje okruženja Power Platform
PowerPlatformSPN
Upravitelj usluge platforme Power Platform		 Servis krajnja točka da želite izbrisati rješenje (na primjer, https://powerappsbuildtools.crm.dynamics.com). Definirano pod stavkom Veze usluge u odjeljku Postavke projekta korištenjem vrste veze Power Platform. Više informacija: vidi BuildTools.EnvironmentUrl pod stavkom Stvaranje okruženja Power Platform
SolutionName
Naziv rješenja		 (Obvezno) Naziv rješenja za brisanje. Uvijek koristite Naziv rješenje, a ne njegov Zaslonski naziv.

Objava prilagodbi Power Platform

Objavljuje sva prilagođavanja u okruženju.

YAML isječak (objavljivanje)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.publish-customizations.PowerPlatformPublishCustomizations@0
  displayName: 'Power Platform Publish Customizations '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '

Parametri (objavljivanje)

Parametri Opis
authenticationType
Vrsta provjere autentičnosti		 (Obvezno za SPN) Navedite bilo PowerPlatformEnvironment za vezu s korisničkim imenom / lozinkom ili PowerPlatformSPN za upravitelja servisa / tajnu klijenta.
PowerPlatformEnvironment
URL okruženja Power Platform		 Servis krajnja točka da želite objaviti prilagodbe (na primjer, https://powerappsbuildtools.crm.dynamics.com). Definirano pod stavkom Veze usluge u odjeljku Postavke projekta korištenjem vrste veze Power Platform. Više informacija: vidi BuildTools.EnvironmentUrl pod stavkom Stvaranje okruženja Power Platform
PowerPlatformSPN
Upravitelj usluge platforme Power Platform		 Servis krajnja točka da želite objaviti prilagodbe (na primjer, https://powerappsbuildtools.crm.dynamics.com). Definirano pod stavkom Veze usluge u odjeljku Postavke projekta korištenjem vrste veze Power Platform. Više informacija: vidi BuildTools.EnvironmentUrl pod stavkom Stvaranje okruženja Power Platform

Verzija postavljenog rješenja Power Platform

Ažurira verziju rješenja.

YAML isječak (verzija)

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

Parametri (verzija)

Parametri Opis
authenticationType
Vrsta provjere autentičnosti		 (Obvezno za SPN) Navedite bilo PowerPlatformEnvironment za vezu s korisničkim imenom / lozinkom ili PowerPlatformSPN za upravitelja servisa / tajnu klijenta.
PowerPlatformEnvironment
URL okruženja Power Platform		 Servis krajnja točka da želite postaviti verziju rješenja (na primjer, https://powerappsbuildtools.crm.dynamics.com). Definirano pod stavkom Veze usluge u odjeljku Postavke projekta korištenjem vrste veze Power Platform. Više informacija: vidi BuildTools.EnvironmentUrl pod stavkom Stvaranje okruženja Power Platform
PowerPlatformSPN
Upravitelj usluge platforme Power Platform		 Servis krajnja točka da želite postaviti verziju rješenja (na primjer, https://powerappsbuildtools.crm.dynamics.com). Definirano pod stavkom Veze usluge u odjeljku Postavke projekta korištenjem vrste veze Power Platform. Više informacija: vidi BuildTools.EnvironmentUrl pod stavkom Stvaranje okruženja Power Platform
SolutionName
Naziv rješenja		 (Obavezno) Naziv rješenja za koje se postavlja verzija. Uvijek koristite Naziv rješenje, a ne njegov Zaslonski naziv.
SolutionVersionNumber
Broj verzije rješenja		 (Obvezno) Broj verzije koji želite postaviti.

Iako se broj verzije može tvrdo kodirati u kanalu, preporučuje se korištenje varijable kanala Azure DevOps kao što je BuildId. Ovo pruža mogućnosti za definiranje točnog oblika broja verzije na kartici "Mogućnosti", na primjer: $(Year:yyyy)-$(Month:MM)-$(Day:dd)-$(rev:rr)-3

Ovu se definiciju zatim može koristiti u zadatku Postavi verziju rješenja postavljanjem svojstva Broj verzije sa: $(Build.BuildId) umjesto čvrstog kodiranja 20200824.0.0.2.

Alternativno, izlaz Powershell skripte zadatka u retku $(Get-Date -Format yyyy.MM.dd.HHmm) postavljen na praznu varijablu pod nazivom SolutionVersion kao Write-Host ("##vso[task.setvariable variable=SolutionVersion;]$version"), Postavite Verziju rješenja kao $(SolutionVersion).

Power Platform Postavi varijable veze

Postavlja BuildTools.* varijable kako bi omogućio pristup prilagođenim zadacima skripte za korištenje servisne veze kao jednog izvora istine.

YAML isječak (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

Parametri (SetConnectionVariables)

Parametri Opis
authenticationType
Vrsta provjere autentičnosti		 (Obvezno za SPN) Navedite bilo PowerPlatformEnvironment za vezu s korisničkim imenom / lozinkom ili PowerPlatformSPN za upravitelja servisa / tajnu klijenta.
PowerPlatformSPN
Upravitelj usluge platforme Power Platform		 Servis krajnja točka za koji želite postaviti varijable veze. Definirano pod stavkom Veze usluge u odjeljku Postavke projekta korištenjem vrste veze Power Platform. Više informacija: vidi BuildTools.EnvironmentUrl pod stavkom Stvaranje okruženja Power Platform
timeoutInMinutes
Vremensko ograničenje		 Određuje maksimalno vrijeme, u minutama, koje je zadatak dopušten za izvršavanje prije nego što ga poslužitelj otkaže. Vrijednost nula označava beskonačno vremensko ograničenje.
retryCountOnTaskFailure
Broj ponovnih pokušaja ako zadatak nije uspio		 Određuje broj ponovnih pokušaja za ovaj zadatak koji će se dogoditi u slučaju neuspjeha zadatka. Nije podržano za zadatke bez agenta.
ApplicationId
ID aplikacije za prijavu		 (Potrebno za korisničko ime/lozinku) ID aplikacije koji će se koristiti za prijavu (Pogledajte dodatnu bilješku u nastavku).
RedirectUri
URI preusmjeravanja određene aplikacije		 (Potrebno za korisničko ime/lozinku) URI preusmjeravanja navedene aplikacije. Potrebno prilikom navođenja ID-a aplikacije (Pogledajte dodatnu bilješku u nastavku).

Napomena

Kada koristite vrstu provjere autentičnosti korisničkog imena/lozinke, bit će potrebni ID aplikacije i URI preusmjeravanja. Ovaj oauth dokument za provjeru autentičnosti sadrži objašnjenje zašto trebate izraditi registraciju aplikacije za provjeru autentičnosti Dataverse. Kada se povežete pomoću provjere autentičnosti korisničkog imena/lozinke, veza se ponaša kao aplikacija koja se povezuje u ime korisnika s Dataverse.

Paket za uvođenje Power Platform

Uvodi paket u okruženje. Uvođenje paketa, za razliku od jedne datoteke rješenja, pruža mogućnost uvođenja više rješenja, podataka i koda u okruženje.

YAML isječak (uvođenje)

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

Parametri (uvođenje)

Parametri Opis
authenticationType
Vrsta provjere autentičnosti		 (Obvezno za SPN) Navedite bilo PowerPlatformEnvironment za vezu s korisničkim imenom / lozinkom ili PowerPlatformSPN za upravitelja servisa / tajnu klijenta.
PowerPlatformEnvironment
URL okruženja Power Platform		 Servis krajnja točka u koji želite uvesti paket (na primjer, https://powerappsbuildtools.crm.dynamics.com). Definirano pod stavkom Veze usluge u odjeljku Postavke projekta korištenjem vrste veze Power Platform. Više informacija: vidi BuildTools.EnvironmentUrl pod stavkom Stvaranje okruženja Power Platform
PowerPlatformSPN
Upravitelj usluge platforme Power Platform		 Servis krajnja točka u koji želite uvesti paket (na primjer, https://powerappsbuildtools.crm.dynamics.com). Definirano pod stavkom Veze usluge u odjeljku Postavke projekta korištenjem vrste veze Power Platform. Više informacija: vidi BuildTools.EnvironmentUrl pod stavkom Stvaranje okruženja Power Platform
PackageFile
Datoteka paketa		 (Obavezno) Putanja i naziv datoteke sklopa datoteke paketa (.dll).
MaxAsyncWaitTime
Maksimalno vrijeme čekanja		 Maksimalno vrijeme čekanja u minutama za asinkronu operaciju; zadana vrijednost je 60 min (1 h), isto kao zadana postavka Azure DevOps za zadatke.

Zadaci upravljanja okruženjem

Automatizirajte zajedničke zadatke upravljanja životnim ciklusom okruženja (ELM).

Izrada okruženja Power Platform

Stvara novo okruženje. Stvaranje novog okruženja također automatski stvara BuildTools.EnvironmentUrl.

Važno

Kada je postavljeno, BuildTools.EnvironmentUrl će se koristiti kao zadana veza usluge za sljedeće zadatke u kanalu. Svaki zadatak opisan u ovom članku koristi krajnju točku iz veze usluge samo kada BuildTools.EnvironmentUrl nije postavljeno.

Novo okruženje može se dodijeliti samo ako vaša licenca ili kapacitet dopuštaju stvaranje dodatnih okruženja. Za više informacija o tome kako vidjeti kapacitet pogledajte Pojedinosti o stranici kapaciteta.

YAML isječak (Create-env)

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

Parameteri (Create-env)

Parametri Opis
authenticationType
Vrsta provjere autentičnosti		 (Obvezno za SPN) Navedite bilo PowerPlatformEnvironment za vezu s korisničkim imenom / lozinkom ili PowerPlatformSPN za upravitelja servisa / tajnu klijenta.
PowerPlatformEnvironment
URL okruženja Power Platform		 Servis krajnja točka da želite stvoriti okruženje (na primjer, https://powerappsbuildtools.crm.dynamics.com). Definirano pod stavkom Veze usluge u odjeljku Postavke projekta korištenjem vrste veze Power Platform.
PowerPlatformSPN
Upravitelj usluge platforme Power Platform		 Servis krajnja točka da želite stvoriti okruženje (na primjer, https://powerappsbuildtools.crm.dynamics.com). Definirano pod stavkom Veze usluge u odjeljku Postavke projekta korištenjem vrste veze Power Platform.
DisplayName
Zaslonski naziv		 (Obavezno) Zaslonski naziv okruženja je stvoren.
LocationName
Regija uvođenja		 (Obavezno) Regija u kojoj se okruženje treba stvoriti.
EnvironmentSku
Vrsta okruženja		 (Obavezno) Vrsta instance za uvođenje. Opcije su Sandbox, Production, Trial i SubscriptionBasedTrial.
AppsTemplate
Aplikacije		 Za neprobni tip okruženja, podržane aplikacije su D365_CustomerService, D365_FieldService, D365_ProjectServiceAutomation i D365_Sales.
CurrencyName
Valuta		 (Obavezno) Osnovna valuta za okruženje je stvorena. Valuta se ne može ažurirati nakon stvaranja okruženja.
LanguageName
Jezik		 (Obavezno) Osnovni jezik u okruženju.
DomainName
Naziv domene		 (Obavezno) Ovo je niz specifičan za okruženje koji čini dio URL-a. Na primjer, za okruženje sa sljedećim URL-om: https://powerappsbuildtasks.crm.dynamics.com/, naziv domene bio bi „powerappsbuildtasks”.

Napomena: ako upišete naziv domene koji se već koristi, zadatak dodaje numeričku vrijednost nazivu domene, počevši od 0. U gornjem primjeru URL može postatihttps://powerappsbuildtasks0.crm.dynamics.com/.

Izbriši okruženje Power Platform

Briše okruženje.

YAML isječak (Delete-env)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.delete-environment.PowerPlatformDeleteEnvironment@0
  displayName: 'Power Platform Delete Environment '
  inputs:
    PowerPlatformEnvironment: 'My service connection'

Parametri (Delete-env)

Parametri Opis
authenticationType
Vrsta provjere autentičnosti		 (Obvezno za SPN) Navedite bilo PowerPlatformEnvironment za vezu s korisničkim imenom / lozinkom ili PowerPlatformSPN za upravitelja servisa / tajnu klijenta.
PowerPlatformEnvironment
URL okruženja Power Platform		 Servis krajnja točka da želite izbrisati okruženje (na primjer, https://powerappsbuildtools.crm.dynamics.com). Definirano pod stavkom Veze usluge u odjeljku Postavke projekta korištenjem vrste veze Power Platform.
PowerPlatformSPN
Upravitelj usluge platforme Power Platform		 Servis krajnja točka da želite izbrisati okruženje (na primjer, https://powerappsbuildtools.crm.dynamics.com). Definirano pod stavkom Veze usluge u odjeljku Postavke projekta korištenjem vrste veze Power Platform.

Power Platform Dodijeli korisnika

Dodijelite korisnika ciljnom okruženju s navedenim sigurnosna uloga.

YAML isječak (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

Parametri (AssignUser-env)

Parametri Opis
authenticationType
Vrsta provjere autentičnosti		 (Obvezno za SPN) Navedite bilo PowerPlatformEnvironment za vezu s korisničkim imenom / lozinkom ili PowerPlatformSPN za upravitelja servisa / tajnu klijenta.
PowerPlatformSPN
Upravitelj usluge platforme Power Platform		 Usluga krajnja točka za okruženje kojem želite dodijeliti korisnika (na primjer, https://powerappsbuildtools.crm.dynamics.com). Definirano pod stavkom Veze usluge u odjeljku Postavke projekta korištenjem vrste veze Power Platform.
User
Power Platform korisničko ime		 Microsoft Entra ID objekta ili glavno ime korisnika za dodjelu ciljnom okruženju.
Role
Sigurnosna uloga ime ili ID		 Sigurnosna uloga ime ili ID koji će se dodijeliti korisniku.
ApplicationUser
Power Platform korisničko ime aplikacije		 Određuje je li ulazni korisnik korisnik aplikacije (true|false).

Power Platform Vrati izvorno okruženje

Vraća okruženje na izvorno.

YAML isječak (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'

Parametri (Reset-env)

Parametri Opis
authenticationType
Vrsta provjere autentičnosti		 (Obvezno za SPN) Navedite bilo PowerPlatformEnvironment za vezu s korisničkim imenom / lozinkom ili PowerPlatformSPN za upravitelja servisa / tajnu klijenta.
PowerPlatformEnvironment
URL okruženja Power Platform		 Servis krajnja točka da želite vratiti okruženje na izvorno (na primjer, https://powerappsbuildtools.crm.dynamics.com). Definirano pod stavkom Veze usluge u odjeljku Postavke projekta korištenjem vrste veze Power Platform.
PowerPlatformSPN
Upravitelj usluge platforme Power Platform		 Servis krajnja točka da želite vratiti okruženje na izvorno (na primjer, https://powerappsbuildtools.crm.dynamics.com). Definirano pod stavkom Veze usluge u odjeljku Postavke projekta korištenjem vrste veze Power Platform.

Sigurnosna kopija okruženja Power Platform

Sigurnosno kopira okruženje.

YAML isječak (Backup-env)

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)'

Parametri (Backup-env)

Parametri Opis
authenticationType
Vrsta provjere autentičnosti		 (Obvezno za SPN) Navedite bilo PowerPlatformEnvironment za vezu s korisničkim imenom / lozinkom ili PowerPlatformSPN za upravitelja servisa / tajnu klijenta.
PowerPlatformEnvironment
URL okruženja Power Platform		 Servis krajnja točka da želite stvoriti sigurnosnu kopiju okruženja (na primjer, https://powerappsbuildtools.crm.dynamics.com). Definirano pod stavkom Veze usluge u odjeljku Postavke projekta korištenjem vrste veze Power Platform.
PowerPlatformSPN
Upravitelj usluge platforme Power Platform		 Servis krajnja točka da želite stvoriti sigurnosnu kopiju okruženja (na primjer, https://powerappsbuildtools.crm.dynamics.com). Definirano pod stavkom Veze usluge u odjeljku Postavke projekta korištenjem vrste veze Power Platform.
BackupLabel
Oznaka sigurnosnog kopiranja		 (Obavezno) Oznaka koja će se dodijeliti sigurnosnoj kopiji.

Kopiranje okruženja Power Platform

Kopira okruženje u ciljno okruženje. Dostupne su dvije vrste kopija: potpuna i minimalna. Potpuna kopija uključuje podatke i metapodatke rješenja (prilagodbe), a minimalna kopija uključuje samo metapodatke rješenja, a ne stvarne podatke.

YAML isječak (Copy-env)

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

Parametri (Copy-env)

Parametri Opis
authenticationType
Vrsta provjere autentičnosti		 (Obvezno za SPN) Navedite bilo PowerPlatformEnvironment za vezu s korisničkim imenom / lozinkom ili PowerPlatformSPN za upravitelja servisa / tajnu klijenta.
PowerPlatformEnvironment
URL okruženja Power Platform		 Servis krajnja točka za izvorišno okruženje iz kojeg želite kopirati (na primjer, https://powerappsbuildtools.crm.dynamics.com). Definirano pod stavkom Veze usluge u odjeljku Postavke projekta korištenjem vrste veze Power Platform.
PowerPlatformSPN
Upravitelj usluge platforme Power Platform		 Servis krajnja točka za izvorišno okruženje iz kojeg želite kopirati (na primjer, https://powerappsbuildtools.crm.dynamics.com). Definirano pod stavkom Veze usluge u odjeljku Postavke projekta korištenjem vrste veze Power Platform.
TargetEnvironmentUrl
URL ciljnog okruženja		 (Obavezno) URL ciljnog okruženja u koji želite kopirati.
CopyType
Vrsta kopiranja		 Vrsta kopiranja koje će se obaviti: FullCopy ili MinimalCopy
OverrideFriendlyName
Nadjačaj neslužbeni naziv		 Promijenite prijateljski naziv ciljnog okruženja u drugi naziv (istinito|neistinito).
FriendlyName
Neslužbeni naziv		 Neslužbeni naziv ciljnog okruženja.
DisableAdminMode
Onemogućivanje administratorskog načina rada		 Treba li onemogućiti administratorski način rada (istinito|neistinito).

Power Platform Vrati okruženje

Vraća okruženje na zadanu sigurnosnu kopiju.

YAML isječak (Vraćanje-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'

Parametri (Restore-env)

Parametri Opis
authenticationType
Vrsta provjere autentičnosti		 (Obvezno za SPN) Navedite bilo PowerPlatformEnvironment za vezu s korisničkim imenom / lozinkom ili PowerPlatformSPN za upravitelja servisa / tajnu klijenta.
PowerPlatformEnvironment
URL okruženja Power Platform		 Usluga krajnja točka za izvorišno okruženje iz kojeg želite vratiti (na primjer, https://powerappsbuildtools.crm.dynamics.com). Definirano pod stavkom Veze usluge u odjeljku Postavke projekta korištenjem vrste veze Power Platform.
PowerPlatformSPN
Upravitelj usluge platforme Power Platform		 Usluga krajnja točka za izvorišno okruženje iz kojeg želite vratiti (na primjer, https://powerappsbuildtools.crm.dynamics.com). Definirano pod stavkom Veze usluge u odjeljku Postavke projekta korištenjem vrste veze Power Platform.
RestoreLatestBackup
Najnovija sigurnosna kopija za vraćanje		 Hoće li se vratiti najnovija sigurnosna kopija ili pružiti RestoreTimeStamp (true|false).
RestoreTimeStamp
DateTime sigurnosne kopije		 Datum i vrijeme sigurnosnog kopiranja u formatu „mm/dd/gggg hh:mm” ILI niz „najnovije”.
TargetEnvironmentUrl
URL ciljnog okruženja		 (obavezno) URL ciljnog okruženja koje želite vratiti.
FriendlyName
Naziv vraćenog okruženja		 (Neobavezno) Naziv obnovljenog okruženja.
DisableAdminMode
Onemogućivanje administratorskog načina rada		 Treba li onemogućiti administratorski način rada (istinito|neistinito).

Izvoz Dataverse podataka

Izvezite podatke iz okruženja s navedenom shemom.

YAML isječak (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

Parametri (exportdata-env)

Parametri Opis
authenticationType
Vrsta provjere autentičnosti		 (Obvezno za SPN) Navedite bilo PowerPlatformEnvironment za vezu s korisničkim imenom / lozinkom ili PowerPlatformSPN za upravitelja servisa / tajnu klijenta.
PowerPlatformSPN
Upravitelj usluge platforme Power Platform		 Usluga krajnja točka za okruženje iz kojeg želite izvesti podatke (na primjer, https://powerappsbuildtools.crm.dynamics.com). Definirano pod stavkom Veze usluge u odjeljku Postavke projekta korištenjem vrste veze Power Platform.
SchemaFile
Naziv XML datoteke sheme		 Naziv XML datoteke sheme. Može se stvoriti pomoću alata za migraciju konfiguracije.
DataFile
Naziv podatkovne datoteke		 Naziv datoteke za podatke za izvoz (zip datoteka).
Overwrite
Prebrisivanje sadržaja		 Power Pages sadržaj web-mjesta za prebrisivanje (true|false).

Uvoz Dataverse podataka

Uvoz podataka u okruženje.

YAML isječak (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'

Parametri (importdata-env)

Parametri Opis
authenticationType
Vrsta provjere autentičnosti		 (Obvezno za SPN) Navedite bilo PowerPlatformEnvironment za vezu s korisničkim imenom / lozinkom ili PowerPlatformSPN za upravitelja servisa / tajnu klijenta.
PowerPlatformSPN
Upravitelj usluge platforme Power Platform		 Usluga krajnja točka za okruženje u koje želite uvesti podatke (na primjer, https://powerappsbuildtools.crm.dynamics.com). Definirano pod stavkom Veze usluge u odjeljku Postavke projekta korištenjem vrste veze Power Platform.
DataFile
Naziv podatkovne datoteke		 Naziv datoteke za komprimirani zip) podatkovnu datoteku za uvoz ili mapu s data-schema.xml i data.xml za uvoz.

Power Pages zadaci upravljanja

Zadaci za rad s web-mjestom Power Pages .

PAPportal Power Platform preuzimanje

Preuzmite sadržaj web-mjesta Power Pages iz trenutnog okruženja programa Dataverse.

YAML isječak (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

Parametri (download-paportal)

Parametri Opis
authenticationType
Vrsta provjere autentičnosti		 (Obvezno za SPN) Navedite bilo PowerPlatformEnvironment za vezu s korisničkim imenom / lozinkom ili PowerPlatformSPN za upravitelja servisa / tajnu klijenta.
PowerPlatformSPN
Upravitelj usluge platforme Power Platform		 Usluga krajnja točka za okruženje iz kojeg želite preuzeti sadržaj (na primjer, https://powerappsbuildtools.crm.dynamics.com). Definirano pod stavkom Veze usluge u odjeljku Postavke projekta korištenjem vrste veze Power Platform.
WebsiteId
ID web-mjesta portala		 Power Pages ID web-mjesta za preuzimanje.
Overwrite
Prebrisivanje sadržaja		 Power Pages sadržaj web-mjesta za prebrisivanje (true|false).
ModelVersion
Podatkovni model web-mjesta		 Označava hoće li podaci web-mjesta za prijenos koristiti standardni (1) ili poboljšani podatkovni model (2). Zadana vrijednost je '1'.

PAPortal Power Platform prijenos

Prenesite Power Pages sadržaj web-mjesta u trenutno Dataverse okruženje.

YAML isječak (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'

Parametri (upload-paportal)

Parametri Opis
authenticationType
Vrsta provjere autentičnosti		 (Obvezno za SPN) Navedite bilo PowerPlatformEnvironment za vezu s korisničkim imenom / lozinkom ili PowerPlatformSPN za upravitelja servisa / tajnu klijenta.
PowerPlatformSPN
Upravitelj usluge platforme Power Platform		 Usluga krajnja točka za okruženje u koje želite prenijeti sadržaj (na primjer, https://powerappsbuildtools.crm.dynamics.com). Definirano pod stavkom Veze usluge u odjeljku Postavke projekta korištenjem vrste veze Power Platform.
UploadPath
Prijenos puta sadržaja		 Put od mjesta na Power Pages koje će se sadržaj web-mjesta prenijeti.
ModelVersion
Podatkovni model web-mjesta		 Označava hoće li podaci web-mjesta za prijenos koristiti standardni (1) ili poboljšani podatkovni model (2). Zadana vrijednost je '1'.

Katalog zadataka Power Platform (pretpregled)

Ovi zadaci izvode akcije protiv kataloga u Power Platform i uključuju sljedeće.

Napomena

Trenutno su kataloški zadaci za Power Platform izdanje pretpregleda .

Instaliranje stavke kataloga

Instalirajte stavku za katalog u ciljno okruženje.

Parametri Opis
authenticationType
Vrsta provjere autentičnosti		 (Obvezno za SPN) Navedite bilo PowerPlatformEnvironment za vezu s korisničkim imenom / lozinkom ili PowerPlatformSPN za upravitelja servisa / tajnu klijenta.
PowerPlatformSPN
Upravitelj usluge platforme Power Platform		 Usluga krajnja točka za okruženje u koje želite prenijeti sadržaj (na primjer, https://powerappsbuildtools.crm.dynamics.com). Definirano pod stavkom Veze usluge u odjeljku Postavke projekta korištenjem vrste veze Power Platform.
Environment
URL ciljnog okruženja		 (obavezno) URL okruženja koji ovaj zadatak cilja.
CatalogItemId
ID stavke kataloga za instalaciju		 (obavezno) Stavka kataloga koja će se instalirati u ciljno okruženje.
TargetEnvironmentUrl
URL ciljnog okruženja		 (obavezno) URL ciljnog okruženja za instalaciju stavke kataloga u (na primjer, "https://YourOrg.crm.dynamics.com").
PollStatus
Provjera stanja ankete		 (Neobavezno) Anketa za provjeru stanja zahtjeva (true|false).

Parametri (katalog-instalacija)

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

Pošalji odobrenje kataloga

Pošalji zahtjev za odobrenje za katalog.

Parametri Opis
authenticationType
Vrsta provjere autentičnosti		 (Obvezno za SPN) Navedite bilo PowerPlatformEnvironment za vezu s korisničkim imenom / lozinkom ili PowerPlatformSPN za upravitelja servisa / tajnu klijenta.
PowerPlatformSPN
Upravitelj usluge platforme Power Platform		 Usluga krajnja točka za okruženje u koje želite prenijeti sadržaj (na primjer, "https://powerappsbuildtools.crm.dynamics.com"). Definirano pod stavkom Veze usluge u odjeljku Postavke projekta korištenjem vrste veze Power Platform.
Environment
URL ciljnog okruženja		 (obavezno) URL okruženja koji ovaj zadatak cilja.
CatalogSubmissionFile
Datoteka slanja kataloga		 (obavezno) Navedite put i naziv datoteke slanja kataloga.
UsePackageSolutionZipFile
Vrsta datoteke		 Vrsta datoteke: zip datoteka paketa ili rješenja.
SolutionZipFile
Naziv zip datoteke rješenja		 Navedite put i naziv datoteke zip datoteke rješenja.
PollStatus
Provjera stanja ankete		 (Neobavezno) Anketa za provjeru stanja zahtjeva (true|false).

Parametri (katalog-slanje)

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

Stanje zahtjeva za katalogom

Dohvaćanje statusa zahtjeva za instalaciju/slanje kataloga.

Parametri Opis
authenticationType
Vrsta provjere autentičnosti		 (Obvezno za SPN) Navedite bilo PowerPlatformEnvironment za vezu s korisničkim imenom / lozinkom ili PowerPlatformSPN za upravitelja servisa / tajnu klijenta.
PowerPlatformSPN
Upravitelj usluge platforme Power Platform		 Usluga krajnja točka za okruženje u koje želite prenijeti sadržaj (na primjer, "https://powerappsbuildtools.crm.dynamics.com"). Definirano pod stavkom Veze usluge u odjeljku Postavke projekta korištenjem vrste veze Power Platform.
Environment
URL ciljnog okruženja		 (obavezno) URL okruženja koji ovaj zadatak cilja.
TrackingId
ID praćenja zahtjeva		 (obavezno) ID praćenja zahtjeva.
RequestType
Vrsta zahtjeva		 (obavezno) Reqeust tip. (Vrijednosti: Instaliraj | Pošalji).

Parametri (kataloški 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

Kanali za izgradnju i izdavanje

Sada kada smo utvrdili što se može učiniti pomoću alata za izgradnju, pogledajmo kako te alate možete primijeniti na kanale za izgradnju i izdavanje. Konceptualni pregled prikazan je u nastavku. Pogledajmo neke detalje implementacije kanala koristeći zadatke alata za izgradnju u sljedećim pododjeljcima.

Da biste saznali više o stvaranju ovih kanala i praktično naučiti rukovati kanalom koristeći Microsoft Power Platform Build Tools, završite laboratorij za Build Tools, koji možete preuzeti s GitHuba.

Dodatne informacije o Azure pipelines: Use Azure Pipelines

Izgradnja kanala: Izvezite rješenje iz razvojnog okruženja (DEV)

Sljedeća slika prikazuje zadatke alata za izradu koje možete dodati kanalu koji izvozi rješenje iz razvojnog okruženja.

Izvezite rješenje iz razvojnog okruženja (DEV).

Izradite kanal: Izradite upravljano rješenje

Sljedeća slika prikazuje zadatke alata za izradu koje možete dodati kanalu koji izrađuje upravljano rješenje.

Izgradite upravljano rješenje.

Izdavanje kanala: Uvedite u proizvodno okruženje (PROD)

Sljedeća slika prikazuje zadatke alata za izradu koje možete dodati kanalu koji se primjenjuje na proizvodno okruženje.

Implementacija u proizvodno okruženje (PROD).

Također pogledajte

Microsoft Power Platform Build Tools za Azure DevOps