Understøttelse af portaler til Microsoft Power Platform CLI
Bemærk
Fra 12. oktober 2022 bliver Power Apps-portaler til Power Pages. Flere oplysninger: Microsoft Power Pages er nu generelt tilgængelig (blog)
Vi overfører og fletter snart dokumentationen til Power Apps-portalerne med Power Pages-dokumentationen.
Microsoft Power Platform CLI (Kommandolinjegrænseflade) er en enkel kommandolinjegrænseflade for udviklere med ét stop, der giver udviklere og appudviklere mulighed for at oprette kodekomponenter.
Microsoft Power Platform CLI-værktøjer er det første skridt i retning af en omfattende ALM-oversigt (application life-cycle management), hvor virksomhedsudviklere og -softwareleverandører kan oprette, oprette, foretage fejlfinding og publicere deres udvidelser og tilpasninger hurtigt og effektivt. Der er flere oplysninger i Hvad er Microsoft Power Platform CLI?
Med denne funktion understøtter Microsoft Power Apps-portaler Microsoft Power Platform CLI, så CI/CD (Continuous Integration/Continuous Deployment) kan aktiveres i portalkonfigurationen. Du kan nu kontrollere portalkonfigurationen for at styre kilden og flytte portalkonfigurationen til et hvilket som helst miljø ved hjælp af Microsoft Power Platform CLI.
Bemærk
Denne funktion er generelt tilgængelig med udgangspunkt i Power Platform CLI version 1.9.8. Du kan få mere at vide om, hvordan du installerer den nyeste version, under Installation af Microsoft Power Platform CLI.
Hvorfor bruge Microsoft Power Platform CLI til udvikling af portaler?
Med understøttelse af portaler til Microsoft Power Platform CLI kan du nu bruge offline-lignende funktioner til tilpasning af portaler ved at foretage ændringer af portalindholdet. Og når alle tilpasninger eller ændringer er gemt, skal du overføre dem til portalen. Når du henter portalindhold ved hjælp af Microsoft Power Platform CLI, er indholdet struktureret i YAML- og HTML-formater, så det er nemt at tilpasse det, så det giver en god oplevelse for udviklingen.
Her er en liste over funktioner og funktioner, som portaler drager fordel af, når de understøtter Microsoft Power Platform CLI:
Nem at bruge
Understøttelse af download/upload af portaldata til/fra det lokale filsystem
Bygger på det eksisterende Microsoft Power Platform CLI-værktøj.
Administration af programlivscyklus (ALM)
Registrere ændringer af portalkonfiguration i en organisation
Flytte konfigurationsfiler på tværs af organisationer eller lejere
Udvikler og virksomhedssupport
Hjælper med at blive integreret problemfrit med alle værktøjer til kildestyring som f.eks. "git"
Nem konfiguration af CI/CD-pipelines
Installér Microsoft Power Platform CLI
Du kan finde trinvise instruktioner i Installere Microsoft Power Platform CLI.
Understøttede tabeller
Understøttelse af Microsoft Power Platform CLI-portaler er begrænset til de tabeller, der er angivet 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 (kun overførsel)
adx_websitelanguage
adx_webtemplate
anmærkning
Vigtigt
- Brugerdefinerede tabeller og portalskabelonspecifikke tabeller (f.eks. blog, community eller idéportal) understøttes ikke til tilpasning ved hjælp af Microsoft Power Platform CLI.
- Vedhæftede billedfiler til reklameposter (adx_ad) hentes ikke ved hjælp af Power Platform CLI. Du kan løse dette problem ved at bruge feltet URL-adresse til billede eller ved at føje en HTML-reference i feltet Kopiér til en webfilpost, der indeholder en billedfil.
Installere og kontrollere Microsoft Power Platform CLI for portaler
Du kan få mere at vide om, hvordan du installerer Microsoft Power Platform CLI ved at gå til Installere Microsoft Power Platform CLI.
Når du har installeret Microsoft Power Platform CLI, skal du åbne en kommandoprompt og køre pac for at kontrollere, at outputtet indeholder "paportal"-kommandoen til Power Apps-portaler.
Microsoft Power Platform CLI kommandoer til portaler
Microsoft Power Platform CLI-kommando til portaler er "paportal".
Følgende afsnit indeholder flere oplysninger om forskellige egenskaber for kommandoen "paportal".
Parametre
| Egenskabsnavn | Beskrivelse | Eksempel |
|---|---|---|
| list | Vis alle portalwebsteder fra det aktuelle Dataverse-miljø. | pac paportal list |
| download | Download portalwebstedets indhold fra det aktuelle Dataverse-miljø. Der er følgende parametre: - path: Sti, hvor webstedsindholdet skal downloades (alias: -p) - webSiteId: Id for portalwebsted, der skal downloades (alias: -id) - overwrite: (Valgfri) true – hvis du vil overskrive eksisterende indhold, eller false, hvis det ikke lykkes, når mappen allerede har webstedsindhold (alias: -o) |
pac paportal download --path "C:\portals" --webSiteId f88b70cc-580b-4f1a-87c3-41debefeb902 |
| upload | Upload portalwebstedets indhold til det aktuelle Dataverse-miljø. Der er følgende parameter: - sti: Sti, hvor webstedsindholdet skal gemmes (alias: -p) -deploymentProfile: Overfør portaldata med miljødetaljer defineret via profilvariabler i installationsprofiler/[profilnavn].deployment.yaml-fil |
pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile "profile-name" |
Bruge installationsprofil
Du kan bruge parameteren deploymentProfile til at definere et sæt variabler for miljøet i YAML-format. Du kan for eksempel have forskellige installationsprofiler (for eksempel udvikling, test, produktion), hvor der er defineret forskellige skemadetaljer i profilen.
Hvis du opretter en testprofil, kan du oprette en fil under deployment-profiles med navnet "test.deployment.yml" (dvs. <profileTag>.deployment.yml). Du kan også køre kommandoen med kode (<profileTag>) for at bruge denne profil:
pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile test
I denne fil kan tabelnavnet være (objektnavnet) med tabel-id, liste over attributter og de værdier, du vil tilsidesætte, når du uploader portalkonfigurationen ved hjælp af parameteren deploymentProfile.
Du kan også bruge variablen OS til at få adgang til operativsystemets miljøvariabler.
Her er et eksempel på denne YAML-fil med "test.deployment.yml"-profilen, der har entydige skemadetaljer:
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
Bemærk
Hvis du vil vide mere om alle de kommandoer, der bruges i CLI ud over portaler, skal du gå til Almindelige kommandoer i Microsoft Power Platform CLI.
Manifestfiler
Når du downloader webstedets indhold ved hjælp CLI-kommandoen pac paportal download, og du downloader indholdet af webstedet, samtidig med at du opretter to manifestfiler.
- Miljømanifestfil (org-url-manifest.yml)
- Slet sporingsmanifestfil (manifest.yml)
Miljømanifestfil (org-url-manifest.yml)
Filen med miljømanifestet oprettes, hver gang kommandoen pac paportal download køres.
Efter hver download læser PAC CLI-værktøjet den eksisterende miljømanifestfil og opdaterer de poster, der slettes i miljøet, eller opretter miljømanifestfilen, hvis den ikke findes.
Når du kører kommandoen pac paportal upload for at uploade portalens webstedsindhold. Filen læser miljømanifestfilen og identificerer de ændringer, der er foretaget siden sidste overførsel, og den overfører kun det opdaterede indhold. Det hjælper med at optimere overførselsprocessen, da det kun er opdateret webstedsindhold, der overføres, i stedet for at overføre alt indhold ved alle overførselskommandoer.
Miljømanifestfilen læses kun, når den opretter forbindelse til det samme miljø (URL-adressen for miljøet stemmer overens med filnavnet) for at undgå utilsigtede ændringer.
Slet sporingsmanifestfil (manifest.yml)
Denne fil bruges til sporing af slettede poster fra miljøet.
Når indholdet af webstedet downloades med kommandoen pac paportal download, føjes slettede poster fra miljømanifestfilen (org-url-manifest.yml) til filen manifest.yml. Så når du uploader webstedsindholdet ved hjælp af kommandoen pac paportal upload, slettes filerne fra miljøet (også til et andet miljø). Filen slettes ikke, og den bruges, uanset hvilket miljø du har forbindelse til.
Bemærk
Hvis du vil slette webstedets indholdsposter i ét miljø og også slette de samme indholdsposter i et andet miljø ved hjælp af PAC CLI, skal du køre kommandoen pac paportal download før og efter sletning af webstedets postindhold. I manifest.yml spores disse ændringer, og de tilsvarende poster fjernes i destinationsmiljøet, når kommandoen pac paportal upload køres.
Bruge Visual Studio Code-udvidelsen
Du kan også bruge VS Code-udvidelsen Power Platform VS Code-udvidelsen til at få fordel af det indbyggede sprog, der bruger sproget, fra IntelliSupport, hjælp til fuldførelse af kode, tip og interaktion med Microsoft Power Platform CLI ved hjælp af VS Code Integrated Terminal. Flere oplysninger: Bruge Visual Studio Code-udvidelsen (forhåndsversion)
Yderligere overvejelser
- Der rapporteres en fejl, hvis filstien overskrider maksimumlængdebegrænsningen for stien. Flere oplysninger: Begrænsning af maksimumlængden for stien i Windows
- I forbindelse med duplikerede poster, f.eks. et duplikeret websidenavn, opretter Microsoft Power Platform CLI to forskellige mapper med navnet på websiden og den anden med det samme navn præfiks med en hashkode. Det kan f.eks. være "Min-side" og "Min-side-hash-kode".
Næste trin
Selvstudium: Bruge Microsoft Power Platform CLI sammen med portaler