Portalstøtte for Microsoft Power Platform CLI
Obs!
Fra og med 12. oktober 2022 er Power Apps-portaler Power Pages. Mer informasjon: Microsoft Power Pages er nå tilgjengelig (blogg)
Vi overfører og slår snart sammen Power Apps-portaldokumentasjonen med Power Pages-dokumentasjonen.
Microsoft Power Platform CLI (Command Line Interface) er et enkelt kommandolinjegrensesnitt for utviklere som gir utviklere og apputviklere muligheten til å opprette kodekomponenter.
Microsoft Power Platform CLI-verktøy er det første steget på veien mot en omfattende ALM-artikkel (Application Life Cycle Management), der bedriftsutviklere og ISV-er kan opprette, bygge, feilsøke og publisere utvidelsene og tilpassingene sine raskt og effektivt. Hvis du vil ha mer informasjon, kan du se Hva er Microsoft Power Platform CLI?.
Med denne funksjonen støtter Microsoft Power Apps-portaler Microsoft Power Platform CLI-en for å aktivere CI/CD (Continuous Integration/Continuous Deployment) for portalkonfigurasjon. Du kan nå sjekke inn portalkonfigurasjonen til kildekontrollen og flytte portalkonfigurasjonen til ethvert miljø ved hjelp av Microsoft Power Platform CLI.
Obs!
Denne funksjonen er vanligvis tilgjengelig fra Power Platform CLI versjon 1.9.8. Hvis du vil vite mer om hvordan du installerer den nyeste versjonen, kan du se Installere Microsoft Power Platform CLI.
Hvorfor bruke Microsoft Power Platform CLI til portalutvikling?
Med portalstøtte for Microsoft Power Platform CLI kan du nå bruke frakoblet funksjonalitet for portaltilpasning ved å gjøre endringer i portalinnholdet. Og når alle tilpasninger eller endringer er lagret, laster du dem opp til portalen. Når du laster ned portalinnhold ved hjelp av Microsoft Power Platform CLI, er innholdet strukturert i YAML- og HTML-formater, noe som gjør det enkelt å tilpasse det, noe som gir en profesjonell utviklingsopplevelse.
Her er en liste over funksjoner og funksjoner som portaler drar nytte av med støtte for Microsoft Power Platform CLI:
Brukervennlighet
Støtte for nedlasting/opplasting av portaldata til/fra det lokale filsystemet
Bygge på eksisterende Microsoft Power Platform CLI-verktøy.
Administrasjon av programlivssyklus (ALM)
Spore endringer i portalkonfigurasjon i en organisasjon
Flytte konfigurasjonsfiler på tvers av organisasjoner eller leiere
Støtte for profesjonell utvikling og bedrift
Bidrar til å integrere effektivt med alle kildekontrollverktøy, for eksempel "git"
Enkel konfigurasjon av CI/CD-forløp
Installer Microsoft Power Platform CLI
Hvis du vil ha trinnvise instruksjoner, kan du se Installere Microsoft Power Platform CLI.
Tabeller som støttes
Portalstøtten for Microsoft Power Platform CLI er begrenset til tabellene som er oppført nedenfor.
adx_ad
adx_adplacement
adx_blog
adx_blogpost
adx_botconsumer
adx_communityforum
adx_communityforumaccesspermission
adx_contentsnippet
adx_entityform
adx_entityformmetadata
adx_entitylist
adx_entitypermission
adx_forumthreadtype
adx_pagetemplate
adx_poll
adx_polloption
adx_pollplacement
adx_portallanguage
adx_publishingstate
adx_redirect
adx_shortcut
adx_sitemarker
adx_sitesetting
adx_tag
adx_urlhistory
adx_webfile
adx_webform
adx_webformmetadata
adx_webformstep
adx_weblink
adx_weblinkset
adx_webpage
adx_webpageaccesscontrolrule
adx_webrole
adx_website
adx_websiteaccess
adx_websitebinding (bare nedlasting)
adx_websitelanguage
adx_webtemplate
annotation
Viktig
- Egendefinerte tabeller og portalmalspesifikke tabeller (for eksempel blogg, gruppe eller idéportal) støttes ikke for tilpassing ved hjelp av Microsoft Power Platform CLI.
- Bildefilvedlegg til annonseoppføringer (adx_ad) lastes ikke ned med Power Platform-CLI. En løsning er å bruke feltet Nettadresse for bildet eller ved å legge til en HTML-referanse i Kopier-feltet i en webfil-oppføring som inneholder en bildefil.
Installer og kontroller Microsoft Power Platform CLI for portaler
Hvis du vil vite mer om installasjon av Microsoft Power Platform CLI, kan du gå til Installer Microsoft Power Platform CLI.
Når du har installert Microsoft Power Platform CLI, åpner du ledeteksten og kjører pac for å kontrollere at utdataene inneholder “paportal” – kommandoen for Power Apps-portaler.
Microsoft Power Platform CLI-kommandoer for portaler
Microsoft Power Platform CLI-kommandoen for portaler er ”paportal”.
Delene nedenfor inneholder flere detaljer om forskjellige egenskaper for "paportal"-kommandoen.
Parametere
| Egenskapsnavn | Bekrivelse | Eksempel |
|---|---|---|
| liste | Viser alle portalnettsteder fra gjeldende Dataverse-miljø. | pac paportal list |
| last ned | Last ned innhold på portalnettstedet fra gjeldende Dataverse-miljø. Den har følgende parametere: - path: Banen der nettstedsinnholdet blir lastet ned (alias: -p) - webSiteId: Portalens nettsteds-ID som skal lastes ned (alias: -id) - overwrite: (Valgfritt) true – for å overskrive eksisterende innhold, false – for å mislykkes hvis mappen allerede har nettstedsinnhold (alias: -o) |
pac paportal download --path "C:\portals" --webSiteId f88b70cc-580b-4f1a-87c3-41debefeb902 |
| last opp | Last opp innhold på portalnettstedet til gjeldende Dataverse-miljø. Den har følgende parameter: - path: Banen der nettstedsinnholdet lagres (alias: -p) -deploymentProfile: Last opp portaldata med miljødetaljer definert gjennom profilvariabler i filen deployment-profiles/[profile-name].deployment.yaml |
pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile "profile-name" |
Bruke distribusjonsprofil
Med bryteren deploymentProfile kan du definere et sett med variabler for miljøet i YAML-format. Du kan for eksempel ha ulike distribusjonsprofiler (for eksempel utvikling, test, produksjon) med ulike skjemadetaljer definert i profilen.
Hvis du oppretter en testprofil, kan du opprette filen under deployment-profiles med navnet «test.deployment.yml» (det vil si <profileTag>.deployment.yml). Du kan også kjøre kommandoen med koden (<profileTag>) for å bruke denne profilen:
pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile test
I denne filen kan du ha navnet på tabellen (enheten) med tabell-ID, liste over attributter og verdiene du vil overstyre, under opplasting av portalkonfigurasjonen ved hjelp av parameteren deploymentProfile.
Du kan i tillegg bruke OS-variabelen til å få tilgang til operativsystemets miljøvariabler.
Her er et eksempel på denne YAML-filen med profilen «test.deployment.yml» som har unike skjemadetaljer:
adx_sitesetting:
- adx_sitesettingid: 4ad86900-b5d7-43ac-1234-482529724970
adx_value: ${OS.FacebookAppId}
adx_name: Authentication/OpenAuth/Facebook/AppId
- adx_sitesettingid: 5ad86900-b5d7-43ac-8359-482529724979
adx_value: contoso_sample
adx_name: Authentication/OpenAuth/Facebook/Secret
adx_contentsnippet:
- adx_contentsnippetid: b0a1bc03-0df1-4688-86e8-c67b34476510
adx_name: PowerBI/contoso/sales
adx_value: https://powerbi.com/group/contoso/sales
Obs!
Hvis du vil finne ut mer om alle kommandoene som brukes i CLI i tillegg til portaler, går du til Vanlige kommandoer i Microsoft Power Platform CLI.
Manifestfiler
Når du laster ned nettstedets innhold ved hjelp av en paportal laste ned CLI-kommando, sammen med nedlasting av områdeinnholdet, genererer det også to manifestfiler.
- Miljømanifestfil (org-url-manifest.yml)
- Slette sporingsmanifestfil (manifest.yml)
Miljømanifestfil (org-url-manifest.yml)
Miljømanifestfilen genereres hver gang du kjører kommandoen pac paportal download for nedlastning.
Etter hver nedlasting leser CLI-verktøyet den eksisterende miljømanifestfilen og oppdaterer oppføringene som slettes i miljøet, eller oppretter miljømanifestfilen hvis den ikke finnes.
Når du kjører kommandoen for pac paportal upload for å laste opp portalens webområdeinnhold. Den leser miljømanifestfilen og identifiserer endringene som er gjort siden sist nedlasting, og laster bare opp det oppdaterte innholdet. Dette bidrar til å optimalisere opplastingsprosessen når bare oppdatert webområdeinnhold lastes opp, i stedet for å laste opp alt innholdet ved hver opplastingskommando.
Miljømanifestfilen blir skrivebeskyttet når den kobler til det samme miljøet (URL-adresse for miljø samsvarer med filnavn) for å unngå utilsiktet endringer.
Slette sporingsmanifestfil (manifest.yml)
Denne filen brukes til å spore de slettede oppføringene fra miljøet.
Når nettstedsinnhold lastes ned med kommandoen pac paportal download legger dette til de slettede oppføringene fra miljømanifestfilen (org-url-manifest.yml) til filen manifest.yml. Når du laster opp nettstedets innhold ved hjelp av kommandoen for pac paportal upload, slettes filene fra miljøet (til og med i et annet miljø). Denne filen slettes ikke, og den brukes uansett hvilket miljø du er tilkoblet.
Obs!
Hvis du vil slette oppføringene for områdeinnhold i ett miljø og også slette de samme innholdsoppføringene i et annet miljø ved hjelp av PAC CLI, må du kjøre kommandoen for pac paportal download før og etter slettingen av nettstedets oppføringsinnhold. Manifest.yml sporer disse endringene og fjerner de tilsvarende oppføringene i målmiljøet når kommandoen pac paportal upload kjøres.
Bruk Visual Studio Code-utvidelsen
Du kan også bruke VS-kodeutvidelse Power Platform VS Code Extension til å dra nytte av det innebygde Liquid-språket fra IntelliSense, assistanse for kodefullføring, hinting og samhandling med Microsoft Power Platform CLI-en ved hjelp av VS Code Integrated Terminal. Mer informasjon: Bruk Visual Studio Code-utvidelsen (forhåndsversjon)
Andre hensyn
- Det rapporteres en feil hvis filbanen overskrider den maksimale lengdebegrensningen for banen. Mer informasjon: Maksimal lengdebegrensning for bane i Windows
- For duplikatoppføringer, for eksempel navnet på en duplisert nettside, oppretter Microsoft Power Platform CLI to forskjellige mapper – én med navnet på nettsiden, og den andre med samme navn som prefikset med en hashkode. For eksempel Min-side og Min-side-hash-kode.
Neste trinn
Opplæring: Bruk Microsoft Power Platform CLI med portaler