Opplæring: Bruk Microsoft Power Platform CLI med portaler

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.

I dette opplæringseksempelet ser du hvordan du kommer i gang med Microsoft Power Platform CLI for å oppdatere eksempelportalkonfigurasjonen.

Obs!

• Du kan også bruke Power Platform CLI med Power Pages. Mer informasjon: Hva er Power Pages
• Denne opplæringen fokuserer på de nødvendige Microsoft Power Platform CLI-kommandoene for bruk av Power Apps-portaler. Hvis du vil ha mer informasjon om kommandoer som brukes i Power Platform CLI, kan lese Vanlige kommandoer.

Last ned og installer Visual Studio Code

Hvis du vil koble til Power Apps-portaler og bruke Microsoft Power Platform CLI-kommandoer, bruker du Visual Studio Code og den integrerte terminalen. Den integrerte terminalen gjør det enkelt å koble til Dataverse-miljøet og laste ned, endre og laste opp portalkonfigurasjonen. Du kan også bruke Windows PowerShell i stedet.

Trinn 1. Godkjenn

Før du kobler til, viser, laster ned eller laster opp eventuelle endringer for en Power Apps-portal, må du først godkjenne Dataverse-miljøet. Hvis du vil ha mer informasjon om godkjenning ved hjelp av Microsoft Power Platform CLI, kan du gå til pac auth.

Hvis du vil godkjenne, åpner du Windows PowerShell og kjører kommandoen pac auth create ved hjelp av nettadressen for Dataverse-miljøet:

pac auth create -u [Dataverse URL]

Eksempel

pac auth create -u https://contoso-org.crm.dynamics.com

Følg instruksjonene for godkjenning for å logge på miljøet.

Trinn 2. Viser tilgjengelige portaler

Bruk pac paportal list-kommandoen til å vise de tilgjengelige Power Apps-portalene i Dataverse-miljøet du koblet til i forrige trinn.

pac paportal list

Trinn 3. Last ned portalinnhold

Last ned portalens webområdeinnhold fra det tilkoblede Dataverse-miljøet ved hjelp av kommandoen pac paportal download.

pac paportal download --path [PATH] -id [WebSiteId-GUID]

Eksempel

pac paportal download --path c:\pac-portals\downloads -id d44574f9-acc3-4ccc-8d8d-85cf5b7ad141

For id-parameteren bruker du WebSiteId som returneres fra utdataene fra forrige trinn.

Trinn 4. Endre portalinnhold

Endre konfigurasjonen ved hjelp Visual Studio Code, og lagre endringene.

Obs!

Sørg for at du bare oppdaterer tabellene som støttes, slik at de kan brukes med Power Platform CLI. Hvis du vil ha mer informasjon, kan du se Støttede tabeller.

Det vises for eksempel tekst som dette på standard portalside:

Denne teksten vises i HTML-koden for nettsiden:

Du kan endre teksten og lagre endringene:

Tips

Du kan endre plasseringen til mappebanen i PowerShell / integrert terminal til den nedlastede plasseringen og skrive inn "kode ." for å åpne mappen direkte i Visual Studio Code.

Trinn 5. Laste opp endringene

Obs!

• Hvis du laster opp til flere miljøer, kan du se laste opp endringene ved hjelp av distribusjonsprofilen for å lære hvordan du laster opp endringer ved hjelp av distribusjonsprofilen.
• Kontroller at maksimal vedleggsstørrelse for målmiljøet er angitt til samme eller som kildemiljøet eller en større størrelse.
• Maksimumsstørrelsen på filer avgjøres av innstillingen Maksimal filstørrelse i fanen E-post for systeminnstillinger i dialogboksen for systeminnstillinger for miljø.

Når du har gjort de nødvendige endringene, laster du dem opp med kommandoen pac paportal upload:

pac paportal upload --path [Folder-location]

Eksempel

pac paportal upload --path C:\pac-portals\downloads\custom-portal\

Obs!

Kontroller at banen til portalinnholdet du angav, er riktig. En mappe med navnet på portalen (egendefinert navn) opprettes som standard med nedlastet portalinnhold. Hvis for eksempel portalens egendefinerte navn er tilpasset-portal, skal banen for kommandoen ovenfor være C:\pac-portals\nedlastinger\tilpasset-portal.

Opplastingen skjer bare for innhold som er endret. Siden endringen gjøres på en nettside i dette eksemplet, lastes innholdet bare opp for tabellen adx_webpage.

Laste opp endringene ved hjelp av distribusjonsprofilen

Når du arbeider med flere forskjellige miljøer, kan du vurdere å bruke distribusjonsprofiler for å sikre at endringene lastes opp til riktig miljø ved hjelp av distribusjonsprofilen.

1. Opprett en mappe med navnet distribusjonsprofiler i mappen som inneholder portalinnholdet. Hvis for eksempel det nedlastede portalinnholdet er i "startportalen", bør distribusjonsprofilmappen være i denne mappen.

   

2. I mappen for distribusjonsprofiler oppretter du en YAML-distribusjonsfil som inneholder de miljøspesifikke endringene. Utviklingsmiljøet kan for eksempel kalles "dev.deployment.yml".

   

3. Rediger YAML-filen for distribusjon ved hjelp av Visual Studio Code med følgende format:

   <table-name>:
   - <record-id>: <GUID>
     <column-name>: <Name>
     <column-value>: <Value>
   

   Eksemplet nedenfor oppdaterer YAML-eksempelkodeverdien for "Suffiks for nettlesertittel" fra standard "Kundeportal" til "Egendefinert portal (Dev)".

   adx_contentsnippet:
       - adx_contentsnippetid: 76227a41-a33c-4d63-b0f6-cd4ecd116bf8 # Replace with your content snippet ID
         adx_name: Browser Title Suffix # Setting name
         adx_value:   · Custom Portal (Dev) # Setting value
   

4. Hvis du vil laste opp endringene til et annet miljø ved hjelp av en YAML-fil for distribusjonsprofil, må du godkjenne til målorganisasjonen først.

5. Når du har godkjent og koblet til riktig miljø, bruker du kommandoen pac paportal upload til å laste opp innholdet:

   pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile dev

   Obs!

   I eksemplet ovenfor er distribusjonsprofilnavnet som brukes, "dev" etter å ha fulgt de forrige trinnene for å opprette en utviklingsdistribusjonsprofil. Endre navnet fra "dev" til et hvilken som helst annet (for eksempel QA for "qa.deployment.yml", eller Test for "test.deployment.yml") hvis du har brukt et annet filnavn for YAML-filen for distribusjon.

Trinn 6. Bekrefte endringene

Slik bekrefter du endringene gjort på portalens nettside:

1. Fjern hurtigbufferen på serversiden, eller bruk Synkroniseringskonfigurasjon ved hjelp av Power Apps-portalstudio.

2. Gå til portalnettsiden for å se endringen.

   

3. Hvis du har brukt distribusjonsprofileksemplet forklart tidligere, vil YAML-snuttet oppdatere verdien nedenfor.

   

   Lesertittelsuffikset som oppdateres gjennom endringen ovenfor, viser endringen når du åpner portalen i en nettleser:

   

Dette avslutter opplæringen. Du kan gjenta trinnene ovenfor og endre portalinnholdet for andre tabeller som støttes.

Neste trinn

Bruk Visual Studio Code-utvidelsen

Se også

• Microsoft Power Platform CLI
• Bruk Visual Studio Code-utvidelsen (forhåndsversjon)