Microsoft Power Platform "Izrada alatki"

Članak
12/02/2021
20 min. za čitanje

Dostupni razvojni zadaci opisani su u narednim odeljcima. Nakon toga ćemo prikazati neki primer Azure DevOps gasovoda koji koriste ove zadatke. Više informacija o alatkama za izradu i načinu njihovog preuzimanja potražite u članku Microsoft Power Platform alatke za Azure DevOps.

Zadatak pomagača

Dostupni zadaci pomagači su opisani u nastavku.

Instalator alatki Power Platform za instalaciju

Ovaj zadatak je potrebno dodati jednom pre bilo kog drugog zadatka Power Platform alatkama u izradi i izdavanju cevovoda. Ovaj zadatak instalira skup alatki Power Platform alatka koje – agent zahteva za pokretanje programa za Microsoft Power Platform izradu zadataka. Ovaj zadatak ne zahteva još konfiguracije kada se doda, ali sadrži parametre za određene verzije svake alatke koja se instalira.

Da biste tokom vremena bili u toku sa verzijama alatki, postarajte se da ovi parametri odgovaraju verzijama alatki koje su potrebne da bi kanal pravilno radio.

YAML isečak (Program za instalaciju)

# 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 (Program za instalaciju)

Parametri	Opis
`DefaultVersion` Korišćenje podrazumevanih verzija alatki	Podesite na vrednost tačno da biste koristili podrazumevanu verziju svih alatki, u suprotnom netačno. Obavezno (i netačno) kada su navedene bilo koje verzije alatki.
`PowerAppsAdminVersion` `XrmToolingPackageDeploymentVersion` `MicrosoftPowerAppsCheckerVersion` `CrmSdkCoreToolsVersion` Verzija alatke	Određena verzija alatke za korišćenje.

Power Platform WhoAmI

Proverava vezu Power Platform okruženja povezivanjem i zahtevom whoAmI. Može biti korisno da se ovaj zadatak rano uključi u kanal da biste proverili povezanost pre nego što započne obrada.

YAML iseč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` Tip potvrde identiteta	(Opcionalno) Navedite PowerPlatformEnvironment za vezu sa korisničkim imenom/lozinkom ili PowerPlatformSPN za tajnu vezu principala usluge/klijenta. Više informacija: pogledajte `BuildTools.EnvironmentUrl` u okviru Power Platform Kreiranje okruženja
`PowerPlatformEnvironment` URL Power Platform okruženja	Krajnja tačka usluge za okruženje sa kojim se povezujete. Definisano je u delu Veze sa uslugom u odeljku Podešavanja projekta. Više informacija: pogledajte `BuildTools.EnvironmentUrl` u okviru Power Platform Kreiranje okruženja
`PowerPlatformSPN` Power Platform usluge	Krajnja tačka usluge za okruženje sa kojim se povezujete. Definisano je u delu Veze sa uslugom u odeljku Podešavanja projekta.

Provera kvaliteta

Ispod su dostupni zadaci za proveru kvaliteta rešenja.

Power Platform checker

Ovaj zadatak pokreće statičku analizu vaših rešenja naspram skupa pravila najbolje prakse kako bi se identifikovali svi problematični obrasci koje biste mogli nenamerno da uvedete prilikom pravljenja vašeg rešenja.

YAML isečak (Kontrolor)

# 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 (Kontrolor)

Parametri	Opis
`PowerPlatformSPN` Veza sa uslugom	(Obavezno) Za korišćenje alatke za Microsoft Power Platform potrebna je veza sa licenciranim Power Platform datoteke. Servisne veze su definisane u okviru stavke "Veze servisa" u okviru stavke "Postavke projekta" Power Platform tipa veze. Više informacija: pogledajte `BuildTools.EnvironmentUrl` u okviru Power Platform Kreiranje okruženja Napomena: Princip usluge je jedini način potvrde identiteta dostupan za zadatak provere, tako da ako koristite korisničko ime / lozinku za sve ostale zadatke, moraćete da kreirate zasebnu vezu koja će se koristiti za zadatak provere. Više informacija o konfigurisanju direktora usluga za korišćenje sa ovim zadatkom potražite u članku Konfigurisanje glavnih veza usluge za Power Platform okruženja.
`UseDefaultPACheckerEndpoint` Korišćenje podrazumevanih Power Platform checker krajnja tačka	Podrazumevano (tačno), geografska lokacija usluge kontrolora koristiće istu geografiju kao i okruženje sa kojim se povezujete.
`CustomPACheckerEndpoint` Krajnja tačka prilagođenog PAC kontrolora	Obavezno kada `UseDefaultPACheckerEndpoint` ima vrednost netačno. Imate opciju da navedete drugu geografiju za korišćenje, na primer https://japan.api.advisor.powerapps.com. Listu dostupnih geografija potražite u članku Korišćenje API-ja Power Platform Checker.
`FileLocation` Lokacija datoteka za analizu	Obavezno prilikom upućivanja na datoteku sa URL adrese potpisa za deljeni pristup (SAS) `sasUriFile`. Napomena: Važno je da referencirate izvoznu datoteku rešenja, a ne raspakovane izvorne datoteke u vašem spremištu. Možete analizirati datoteke i kompletnih i nekompletnih rešenja.
`FilesToAnalyzeSasUri` SAS datoteke za analizu	Obavezno kada je `FileLocation` podešeno na `sasUriFile`. Unesite URI adresu za SAS. Možete dodati više od SAS URI-ja kroz listu razdvojenu zarezom (,) ili tačkom i zarezom (;).
`FilesToAnalyze` Lokalne datoteke za analizu	Obavezno kada se SAS datoteke ne analiziraju. Navedite putanju i naziv datoteke zip datoteka za analizu. Možete da koristite džokere. Na primer, unesite *\.zip za sve zip datoteke u svim podfasciklama.
`FilesToExclude` Lokalne datoteke za izuzimanje	Navedite imena datoteka koje treba isključiti iz analize. Ako ima više njih, navedite ih u listi razdvojenoj zarezom (,) ili tačkom i zarezom (;). Ova lista može da sadrži puno ime datoteke ili ime sa džoker znakovima na početku ili na kraju, kao što su *jquery ili form.js
`RulesToOverride` Pravila za izmenu	JSON niz koji sadrži pravila i nivoe za izmenu. Prihvaćene vrednosti za OverrideLevel su: kritično, visoko, srednje, nisko, informativno. Primer: [{"Id":"meta-remove-dup-reg","OverrideLevel":"Medium"},{"Id":"il-avoid-specialized-update-ops","OverrideLevel":"Medium"}]
`RuleSet` Skup pravila	(Obavezno) Navedite koji skup pravila treba da se primenjuje. Dostupna su sledeća dva skupa pravila: Provera rešenja: Ovo je isti skup pravila koji se pokreću sa Power Apps portala proizvođača. AppSource: Ovo je prošireni skup pravila koji se koristi za overu aplikacije pre nego što može da se objavi AppSource.
`ErrorLevel` Nivo greške	U kombinaciji sa graničnom vrednošću greške, parametar definiše ozbiljnost grešaka i upozorenja koja su dozvoljena. Podržane vrednosti graničnih vrednosti su <level>IssueCount gde je nivo = Kritičan, Visok, Srednji, Nizak i Informativni.
`ErrorThreshold` Granična vrednost greške	Definiše broj grešaka (>=0) navedenog nivoa kojima je dozvoljeno da kontrolor prosledi rešenja koja se proveravaju.
`FailOnPowerAppsCheckerAnalysisError` Neuspeh u slučaju greške	Kada je to tačno, nije uspelo ako Power Apps checker-a vraćena kao "Failed" ili "FinishedWithErrors".
`ArtifactDestinationName` Naziv DevOps artefakta	Navedite ime Azure DevOps artefakata za .porif datoteku proveravača.

Zadaci rešenja

Ovaj skup zadataka može automatizovati radnje rešenja. Zadaci okruženja opisani kasnije u ovom odeljku, koji kreiraju, kopiraju ili obnavljaju okruženje, zameniće servisne veze novokreiranim okruženjima. To omogućava izvršavanje zadataka rešenja u okruženjima koja se kreiraju na zahtev.

Power Platform za uvoz

Uvozi rešenje u ciljno okruženje.

YAML iseč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` Tip potvrde identiteta	(Obavezno za SPN) Navedite PowerPlatformEnvironment za vezu sa korisničkim imenom/lozinkom ili PowerPlatformSPN za tajnu vezu principala usluge/klijenta.
`PowerPlatformEnvironment` URL Power Platform okruženja	Krajnja tačka usluge u koju želite da uvezete rešenje (npr. https://powerappsbuildtools.crm.dynamics.com). Definisano u okviru stavke Servisne veze u postavkama projekta koristeći Power Platform tip veze. Više informacija: pogledajte `BuildTools.EnvironmentUrl` u okviru Power Platform Kreiranje okruženja
`PowerPlatformSPN` Power Platform usluge	Krajnja tačka usluge u koju želite da uvezete rešenje (npr. https://powerappsbuildtools.crm.dynamics.com). Definisano u okviru stavke Servisne veze u postavkama projekta koristeći Power Platform tip veze. Više informacija: pogledajte `BuildTools.EnvironmentUrl` u okviru Power Platform Kreiranje okruženja
`SolutionInputFile` Ulazna datoteka rešenja	(Obavezno) Putanja i ime datoteke rešenja .zip datoteke za uvoz u ciljno okruženje (npr. $(Build.ArtifactStagingDirectory) $ (Ime rešenja).zip). Napomena: Promenljive vam daju pogodan način za unos ključnih podataka u različite delove kanala. Pogledajte članak Korišćenje unapred definisanih promenljivih da biste videli sveobuhvatnu listu.
`HoldingSolution` Uvoz kao slobodno rešenje	Napredni parametar (tačno\|netačno) koji se koristi kada rešenje treba da se nadogradi. Ovaj parametar hostuje rešenje u programu Dataverse ali ne nadograđuje rešenje dok se ne pokrene zadatak "Primeni nadogradnju rešenja".
`OverwriteUnmanagedCustomizations` Izmena nekompletnih prilagođavanja	Navedite da li treba izmeniti nekompletna prilagođavanja (tačno\|netačno).
`SkipProductUpdateDependencies` Preskakanje zavisnosti od ažuriranja proizvoda	Navedite da li treba preskočiti primenu zavisnosti u vezi sa ažuriranjem proizvoda (tačno\|netačno).
`ConvertToManaged` Konvertovanje u kompletno	Navedite da li treba uvesti kompletno rešenje (tačno\|netačno).
`AsyncOperation` Asinhroni uvoz	Ako je izabrano (tačno), operacija uvoza će biti izvršena asinhrono. Ovo se preporučuje za veća rešenja, jer će se ovaj zadatak inače automatski zaustaviti nakon 4 minuta. Izbor asinhronog će anketirati i čekati dok se ne dostigne MaxAsyncWaitTime (istina \| netačno).
`MaxAsyncWaitTime` Maksimalno vreme čekanja	Maksimalno vreme čekanja u minutima za asinhronu operaciju; podrazumevana vrednost je 60 min (1 hr), isto kao Azure DevOps podrazumevana za zadatke.
`PublishWorkflows` Aktiviranje procesa nakon uvoza	Navedite da li neki procesi (tokovi posla) u rešenju treba da se aktiviraju nakon uvoza (tačno\|netačno).
`UseDeploymentSettingsFile` Korišćenje datoteke podešavanja primene	Reference za vezu i vrednosti promenljivih okruženja mogu da se podese korišćenjem datoteke za podešavanje primene (tačno\|netačno).
`DeploymentSettingsFile` Datoteka podešavanja primene	(obavezno kada je `UseDeploymentSettingsFile`=tačno) Putanja i naziv datoteke za podešavanje primene.

Power Platform primeni nadogradnju rešenja

Nadograđuje rešenje koje je uvezeno kao rešenje za zadržavanje.

YAML iseč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` Tip potvrde identiteta	(Obavezno za SPN) Navedite PowerPlatformEnvironment za vezu sa korisničkim imenom/lozinkom ili PowerPlatformSPN za tajnu vezu principala usluge/klijenta.
`PowerPlatformEnvironment` URL Power Platform okruženja	Krajnja tačka usluge u koju želite da nadogradite rešenje (npr. https://powerappsbuildtools.crm.dynamics.com). Definisano u okviru stavke Servisne veze u postavkama projekta koristeći Power Platform tip veze. Više informacija: pogledajte `BuildTools.EnvironmentUrl` u okviru Power Platform Kreiranje okruženja
`PowerPlatformSPN` Power Platform usluge	Krajnja tačka usluge u koju želite da nadogradite rešenje (npr. https://powerappsbuildtools.crm.dynamics.com). Definisano u okviru stavke Servisne veze u postavkama projekta koristeći Power Platform tip veze. Više informacija: pogledajte `BuildTools.EnvironmentUrl` u okviru Power Platform Kreiranje okruženja
`SolutionName` Ime rešenja	(Obavezno) Naziv rešenja za primenu nadogradnje. Uvek koristite Naziv rešenja, a ne njegovo Ime za prikaz.
`AsyncOperation` Asinhrona nadogradnja	Ako je izabrano (tačno), operacija nadogradnje će biti izvršena kao asinhroni grupni posao. Izbor asinhronog će anketirati i čekati dok se ne dostigne MaxAsyncWaitTime.
`MaxAsyncWaitTime` Maksimalno vreme čekanja	Maksimalno vreme čekanja u minutima za asinhronu operaciju; podrazumevana vrednost je 60 min (1 hr), isto kao Azure DevOps podrazumevana za zadatke.

Napomena

Promenljive vam daju pogodan način za unos ključnih podataka u različite delove kanala. Pogledajte članak Korišćenje unapred definisanih promenljivih da biste videli sveobuhvatnu listu. Možete unapred da popunite informacije o referenci veze i promenljivim okruženja za ciljno okruženje dok uvozite rešenje pomoću datoteke za podešavanje primene.

Još informacija: Unapred popunite reference veza i promenljive okruženja za automatizovane primene

Power Platform izvoza

Izvozi rešenje iz izvornog okruženja.

YAML iseč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` Tip potvrde identiteta	(Obavezno za SPN) Navedite PowerPlatformEnvironment za vezu sa korisničkim imenom/lozinkom ili PowerPlatformSPN za tajnu vezu principala usluge/klijenta.
`PowerPlatformEnvironment` URL Power Platform okruženja	Krajnja tačka usluge u koju želite da nadogradite rešenje (npr. https://powerappsbuildtools.crm.dynamics.com). Definisano u okviru stavke Servisne veze u postavkama projekta koristeći Power Platform tip veze. Više informacija: pogledajte `BuildTools.EnvironmentUrl` u okviru Power Platform Kreiranje okruženja
`PowerPlatformSPN` Power Platform usluge	Krajnja tačka usluge u koju želite da nadogradite rešenje (npr. https://powerappsbuildtools.crm.dynamics.com). Definisano u okviru stavke Servisne veze u postavkama projekta koristeći Power Platform tip veze. Više informacija: pogledajte `BuildTools.EnvironmentUrl` u okviru Power Platform Kreiranje okruženja
`SolutionName` Ime rešenja	(Obavezno) Naziv rešenja koje se izvozi. Uvek koristite Naziv rešenja, a ne njegovo Ime za prikaz.
`SolutionOutputFile` Izlazna datoteka rešenja	(Obavezno) Putanja i ime datoteke rešenja.zip datoteka za izvoz izvornog okruženja u (npr. $(Build.ArtifactStagingDirectory) $ (Ime rešenja).zip). Napomena: Promenljive vam daju pogodan način za unos ključnih podataka u različite delove kanala. Pogledajte članak Korišćenje unapred definisanih promenljivih da biste videli sveobuhvatnu listu.
`AsyncOperation` Asinhroni izvoz	Ako je izabrano (tačno), operacija izvoza će biti izvršena kao asinhroni grupni posao. Izbor asinhronog će anketirati i čekati dok se ne dostigne MaxAsyncWaitTime.
`MaxAsyncWaitTime` Maksimalno vreme čekanja	Maksimalno vreme čekanja u minutima za asinhronu operaciju; podrazumevana vrednost je 60 min (1 hr), isto kao Azure DevOps podrazumevana za zadatke.
`Managed` Izvezi kao kompletno	Ako je izabrano (tačno), izvezite rešenje kao kompletno rešenje; u suprotnom izvezite kao nekompletno rešenje.
`ExportAutoNumberingSettings` Izvoz podešavanja automatskog numerisanja	Izvoz podešavanja automatskog numerisanja (tačno\|netačno).
`ExportCalendarSettings` Izvoz podešavanja kalendara	Izvoz podešavanja kalendara (tačno\|netačno).
`ExportCustomizationSettings` Izvoz podešavanja prilagođavanja	Izvoz podešavanja prilagođavanja (tačno\|netačno).
`ExportEmailTrackingSettings` Izvoz podešavanja praćenja e-pošte	Izvezite podešavanja praćenja e-pošte (tačno\|netačno).
`ExportGeneralSettings` Izvoz opštih podešavanja	Izvoz opštih podešavanja (tačno\|netačno).
`ExportIsvConfig` Izvoz konfiguracije ISV	Izvoz konfiguracije ISV (tačno\|netačno).
`ExportMarketingSettings` Izvoz marketinških podešavanja	Izvoz marketinških podešavanja (tačno\|netačno).
`ExportOutlookSynchronizationSettings` Izvoz podešavanja Outlook sinhronizacije	Izvoz podešavanja Outlook sinhronizacije (tačno\|netačno).
`ExportRelationshipRoles` Izvoz uloga relacija	Izvoz uloga relacija (tačno\|netačno).
`ExportSales` Izvoz prodaje	Izvoz prodaje (tačno\|netačno).

Power Platform raspakuj rešenje

Uzima komprimovanu datoteku rešenja i dekomponuje je u više XML datoteka kako bi ih sistem kontrole izvora lakše čitao i upravljao njima.

YAML isečak (Raspakivanje)

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 (Raspakivanje)

Parametri	Opis
`SolutionInputFile` Ulazna datoteka rešenja	(Obavezno) Putanja i naziv .zip datoteke rešenja za raspakivanje.
`SolutionTargetFolder` Ciljna fasciklu za raspakivanje rešenja	(Obavezno) Putanja i ciljna fascikla u koju želite da raspakujete rešenje.
`SolutionType` Tip rešenja	(Obavezno) Tip rešenja koje želite da raspakujete. Opcije uključuju: Nekompletno (preporučuje se), Kompletno i Oba.

Power Platform paketa

Pakuje rešenje predstavljeno u kontroli izvora u .zip datoteku rešenja koja se može uvesti u drugo okruženje.

YAML isečak (Paket)

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 (Paket)

Parametri	Opis
`SolutionOutputFile` Izlazna datoteka rešenja	(Obavezno) Naziv putanje i .zip datoteke rešenja za pakovanje rešenja.
`SolutionSourceFolder` Izvorna fascikla rešenja za paket	(Obavezno) Putanja i izvorna fascikla rešenja za pakovanje.
`SolutionType` Tip rešenja	(Obavezno) Tip rešenja koje želite da spakujete. Opcije uključuju: Nekompletno (preporučuje se), Kompletno i Oba.

Power Platform izbriši rešenje

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

YAML iseč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` Tip potvrde identiteta	(Obavezno za SPN) Navedite PowerPlatformEnvironment za vezu sa korisničkim imenom/lozinkom ili PowerPlatformSPN za tajnu vezu principala usluge/klijenta.
`PowerPlatformEnvironment` URL Power Platform okruženja	Krajnja tačka usluge u kojoj želite da izbrišete rešenje (npr. https://powerappsbuildtools.crm.dynamics.com). Definisano u okviru stavke Servisne veze u postavkama projekta koristeći Power Platform tip veze. Više informacija: pogledajte `BuildTools.EnvironmentUrl` u okviru Power Platform Kreiranje okruženja
`PowerPlatformSPN` Power Platform usluge	Krajnja tačka usluge u kojoj želite da izbrišete rešenje (npr. https://powerappsbuildtools.crm.dynamics.com). Definisano u okviru stavke Servisne veze u postavkama projekta koristeći Power Platform tip veze. Više informacija: pogledajte `BuildTools.EnvironmentUrl` u okviru Power Platform Kreiranje okruženja
`SolutionName` Ime rešenja	(Obavezno) Naziv rešenja koje se briše. Uvek koristite Naziv rešenja, a ne njegovo Ime za prikaz.

Power Platform objavi prilagođavanja

Objavljuje sva prilagođavanja u okruženju.

YAML iseč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` Tip potvrde identiteta	(Obavezno za SPN) Navedite PowerPlatformEnvironment za vezu sa korisničkim imenom/lozinkom ili PowerPlatformSPN za tajnu vezu principala usluge/klijenta.
`PowerPlatformEnvironment` URL Power Platform okruženja	Krajnja tačka usluge u kojoj želite da objavite prilagođavanja (npr. https://powerappsbuildtools.crm.dynamics.com). Definisano u okviru stavke Servisne veze u postavkama projekta koristeći Power Platform tip veze. Više informacija: pogledajte `BuildTools.EnvironmentUrl` u okviru Power Platform Kreiranje okruženja
`PowerPlatformSPN` Power Platform usluge	Krajnja tačka usluge u kojoj želite da objavite prilagođavanja (npr. https://powerappsbuildtools.crm.dynamics.com). Definisano u okviru stavke Servisne veze u postavkama projekta koristeći Power Platform tip veze. Više informacija: pogledajte `BuildTools.EnvironmentUrl` u okviru Power Platform Kreiranje okruženja

Power Platform postavi verziju rešenja

Ažurira verziju rešenja.

YAML iseč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` Tip potvrde identiteta	(Obavezno za SPN) Navedite PowerPlatformEnvironment za vezu sa korisničkim imenom/lozinkom ili PowerPlatformSPN za tajnu vezu principala usluge/klijenta.
`PowerPlatformEnvironment` URL Power Platform okruženja	Krajnja tačka usluge u kojoj želite da podesite verziju rešenja (npr. https://powerappsbuildtools.crm.dynamics.com). Definisano u okviru stavke Servisne veze u postavkama projekta koristeći Power Platform tip veze. Više informacija: pogledajte `BuildTools.EnvironmentUrl` u okviru Power Platform Kreiranje okruženja
`PowerPlatformSPN` Power Platform usluge	Krajnja tačka usluge u kojoj želite da podesite verziju rešenja (npr. https://powerappsbuildtools.crm.dynamics.com). Definisano u okviru stavke Servisne veze u postavkama projekta koristeći Power Platform tip veze. Više informacija: pogledajte `BuildTools.EnvironmentUrl` u okviru Power Platform Kreiranje okruženja
`SolutionName` Ime rešenja	(Obavezno) Naziv rešenja za podešavanje verzije. Uvek koristite Naziv rešenja, a ne njegovo Ime za prikaz.
`SolutionVersionNumber` Broj verzije rešenja	(Obavezno) Broj verzije koji želite da podesite.

Iako se broj verzije može kodirati u cevovodu, preporučuje se korišćenje promenljive Azure DevOps kao što je BuildId. Ovo pruža opcije za definisanje tačnog oblika broja verzije na kartici „Opcije“, na primer: $(Year:yyyy)-$(Month:MM)-$(Day:dd)-$(rev:rr)-3

Ova definicija se zatim može koristiti u zadatku "Postavi verziju rešenja" postavljanjem svojstva "Broj verzije" sa: $(Build.BuildId) umesto čvrstih 20200824.0.0.2.

Druga mogućnost umetnute skripte zadatka $(Get-Date -Format yyyy.MM.dd. HHmm) izlaz postavljen na praznu promenljivu pod imenom "SolutionVersion as Write-Host" ("##vso[task.setvariable variable=SolutionVersion;] $version"), Postavite verziju rešenja kao $(SolutionVersion).

Power Platform za primenu

Primenjuje paket u okruženje. Primena paketa za razliku od jedne datoteke rešenja daje vam mogućnost primene više rešenja, podataka i koda u okruženje.

YAML isečak (Primena)

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 (Primena)

Parametri	Opis
`authenticationType` Tip potvrde identiteta	(Obavezno za SPN) Navedite PowerPlatformEnvironment za vezu sa korisničkim imenom/lozinkom ili PowerPlatformSPN za tajnu vezu principala usluge/klijenta.
`PowerPlatformEnvironment` URL Power Platform okruženja	Krajnja tačka usluge u koju želite da primenite paket (npr. https://powerappsbuildtools.crm.dynamics.com). Definisano u okviru stavke Servisne veze u postavkama projekta koristeći Power Platform tip veze. Više informacija: pogledajte `BuildTools.EnvironmentUrl` u okviru Power Platform Kreiranje okruženja
`PowerPlatformSPN` Power Platform usluge	Krajnja tačka usluge u koju želite da primenite paket (npr. https://powerappsbuildtools.crm.dynamics.com). Definisano u okviru stavke Servisne veze u postavkama projekta koristeći Power Platform tip veze. Više informacija: pogledajte `BuildTools.EnvironmentUrl` u okviru Power Platform Kreiranje okruženja
`PackageFile` Datoteka paketa	(Obavezno) Putanja i naziv sklopa datoteke paketa (.dll).
`MaxAsyncWaitTime` Maksimalno vreme čekanja	Maksimalno vreme čekanja u minutima za asinhronu operaciju; podrazumevana vrednost je 60 min (1 hr), isto kao Azure DevOps podrazumevana za zadatke.

Zadaci upravljanja okruženjima

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

Power Platform kreiranje okruženja

Kreira novo okruženje. Kreiranje novog okruženja takođe automatski kreira BuildTools.EnvironmentUrl.

Važno

Kada je podešeno, BuildTools.EnvironmentUrl će se koristiti kao podrazumevana servisna veza za naredne zadatke u kanalu. Svaki zadatak opisan u ovom članku koristi samo krajnju tačku iz veze usluge kada BuildTools.EnvironmentUrl nije podešen.

Novo okruženje se može obezbediti samo ako vam licenca ili kapacitet omogućavaju kreiranje dodatnih okruženja. Za više informacija o tome kako da vidite kapacitet, pogledajte stranicu Detalji stranice kapaciteta.

YAML iseč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

Parametri (Create-env)

Parametri	Opis
`authenticationType` Tip potvrde identiteta	(Obavezno za SPN) Navedite PowerPlatformEnvironment za vezu sa korisničkim imenom/lozinkom ili PowerPlatformSPN za tajnu vezu principala usluge/klijenta.
`PowerPlatformEnvironment` URL Power Platform okruženja	Krajnja tačka usluge u kojoj želite da kreirate okruženje (npr. https://powerappsbuildtools.crm.dynamics.com). Definisano u okviru stavke Servisne veze u postavkama projekta koristeći Power Platform tip veze.
`PowerPlatformSPN` Power Platform usluge	Krajnja tačka usluge u kojoj želite da kreirate okruženje (npr. https://powerappsbuildtools.crm.dynamics.com). Definisano u okviru stavke Servisne veze u postavkama projekta koristeći Power Platform tip veze.
`DisplayName` Ime za prikaz	(Obavezno) Kreirano je ime za prikaz okruženja.
`LocationName` Region primene	(Obavezno) Region u koji treba da se primeni okruženje.
`EnvironmentSku` Tip okruženja	(Obavezno) Tip instance za primenu. Opcije su Sandbox, Proizvodno, Probno i SubscriptionBasedTrial.
`AppsTemplate` Aplikacije	Za tip okruženja koje nije probno, podržane aplikacije su D365_CustomerService, D365_FieldService, D365_ProjectServiceAutomation i D365_Sales.
`CurrencyName` Valuta	(Obavezno) Osnovna valuta za kreirano okruženje. Valuta se ne može izmeniti nakon kreiranja okruženja.
`LanguageName` Jezik	(Obavezno) Osnovni jezik u okruženju.
`DomainName` Ime domena	(Obavezno) Ovo je niska specifična za okruženje koja čini deo URL adrese. Na primer, za okruženje sa sledećom URL adresom: https://powerappsbuildtasks.crm.dynamics.com, ime domena bi bilo „powerappsbuildtasks“. Napomena: Ako unesete ime domena koje se već koristi, zadatak dodaje brojčanu vrednost imenu domena, počevši od 0. U gorenavedenom primeru, URL adresa može da postane https://powerappsbuildtasks0.crm.dynamics.com.

Power Platform izbriši okruženje

Briše okruženje.

YAML iseč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` Tip potvrde identiteta	(Obavezno za SPN) Navedite PowerPlatformEnvironment za vezu sa korisničkim imenom/lozinkom ili PowerPlatformSPN za tajnu vezu principala usluge/klijenta.
`PowerPlatformEnvironment` URL Power Platform okruženja	Krajnja tačka usluge u kojoj želite da izbrišete okruženje (npr. https://powerappsbuildtools.crm.dynamics.com). Definisano u okviru stavke Servisne veze u postavkama projekta koristeći Power Platform tip veze.
`PowerPlatformSPN` Power Platform usluge	Krajnja tačka usluge u kojoj želite da izbrišete okruženje (npr. https://powerappsbuildtools.crm.dynamics.com). Definisano u okviru stavke Servisne veze u postavkama projekta koristeći Power Platform tip veze.

Power Platform rezervno okruženje

Pravi rezervnu kopiju okruženja.

YAML iseč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` Tip potvrde identiteta	(Obavezno za SPN) Navedite PowerPlatformEnvironment za vezu sa korisničkim imenom/lozinkom ili PowerPlatformSPN za tajnu vezu principala usluge/klijenta.
`PowerPlatformEnvironment` URL Power Platform okruženja	Krajnja tačka usluge u kojoj želite da napravite rezervnu kopiju okruženja (npr. https://powerappsbuildtools.crm.dynamics.com). Definisano u okviru stavke Servisne veze u postavkama projekta koristeći Power Platform tip veze.
`PowerPlatformSPN` Power Platform usluge	Krajnja tačka usluge u kojoj želite da napravite rezervnu kopiju okruženja (npr. https://powerappsbuildtools.crm.dynamics.com). Definisano u okviru stavke Servisne veze u postavkama projekta koristeći Power Platform tip veze.
`BackupLabel` Oznaka rezervne kopije	(Obavezno) Oznaka koja će se dodeliti rezervnoj kopiji.

Power Platform kopiraj okruženje

Kopira okruženje u ciljno okruženje. Dostupne su dve vrste kopija: kompletna i minimalna. Kompletna kopija uključuje i podatke i metapodatke rešenja (prilagođavanja), dok minimalna kopija uključuje samo metapodatke rešenja, a ne stvarne podatke.

YAML iseč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` Tip potvrde identiteta	(Obavezno za SPN) Navedite PowerPlatformEnvironment za vezu sa korisničkim imenom/lozinkom ili PowerPlatformSPN za tajnu vezu principala usluge/klijenta.
`PowerPlatformEnvironment` URL Power Platform okruženja	Krajnja tačka usluge za izvorno okruženje iz kojeg želite da kopirate rešenje (npr. https://powerappsbuildtools.crm.dynamics.com). Definisano u okviru stavke Servisne veze u postavkama projekta koristeći Power Platform tip veze.
`PowerPlatformSPN` Power Platform usluge	Krajnja tačka usluge za izvorno okruženje iz kojeg želite da kopirate rešenje (npr. https://powerappsbuildtools.crm.dynamics.com). Definisano u okviru stavke Servisne veze u postavkama projekta koristeći Power Platform tip veze.
`TargetEnvironmentUrl` URL adresa ciljnog okruženja	(Obavezno) URL adresa za ciljno okruženje u koje želite da kopirate.
`CopyType` Tip kopiranja	Tip kopiranja koji treba obaviti: FullCopy ili MinimalCopy
`OverrideFriendlyName` Izmena prepoznatljivog imena	Promenite prepoznatljivo ime ciljnog okruženja u drugo ime (tačno\|netačno).
`FriendlyName` Prepoznatljivi naziv	Prepoznatljivo ime ciljnog okruženja.
`DisableAdminMode` Onemogućavanje režima administracije	Da li onemogućiti režim administracije (tačno\|netačno).

Pravljenje i objavljivanje kanala

Sada kada smo identifikovali šta možete da radite pomoću razvojnih alatki, da vidimo kako možete da primenite ove alatke na kanale za razvoj i objavljivanje. Konceptualni pregled je prikazan u nastavku. Hajde da vidimo neke detalje primene kanala pomoću Build Tools zadataka u pododeljcima koji slede.

Da biste saznali više o kreiranju ovih cevovoda i zapravo uradili "hands-on pipeline" autorizaciju pomoću Microsoft Power Platform Build Tools, dovršite laboratorije za izradu alata koje možete preuzeti sa GitHub-a.

Više informacija o Azure DevOps gasovodima: Korišćenje Azure cevovoda

Pravljenje kanala: Izvoz rešenja iz razvojnog okruženja

Sledeća slika prikazuje zadatke razvojne alatke koje možete dodati u kanal koji izvozi rešenje iz razvojnog okruženja.

Izvoz rešenja iz razvojnog okruženja.

Pravljenje kanala: Izrada kompletnog rešenja

Sledeća slika prikazuje zadatke razvojne alatke koje možete dodati u kanal koji izrađuje kompletno rešenje.

Kreiranje kompletnog rešenja.

Objavite kanal: Primena u proizvodnom okruženju

Sledeća slika prikazuje zadatke razvojne alatke koje možete dodati u kanal koji primenjuje u proizvodnom okruženju.

Primena u proizvodnom okruženju.

Takođe pogledajte

Microsoft Power Platform alatke za izradu Azure DevOps