Õpetus: Microsoft Power Platform CLI kasutamine portaalidega

Märkus

Alates 12. oktoobrist 2022 on Power Appsi portaalid Power Pages. Lisateave: Microsoft Power Pages on nüüd üldiselt saadaval (ajaveebipostitus)
Peagi migreerime ja ühendame Power Appsi portaalide dokumentatsiooni Power Pagesi dokumentatsiooniga.

Selles õpetuse näites näete, kuidas Microsoft Power Platform CLI-ga alustada, et värskendada näidisportaalide konfiguratsiooni.

Märkus

• Saate Power Platform CLI-d kasutada ka Power Pages-ga. Lisateave: Mis on Power Pages
• See õpetus keskendub Microsoft Power Platform portaalide kasutamiseks vajalikele Power Apps CLI käskudele. Lisateavet Power Platform CLI-s kasutatavate käskude kohta lugege Tavalised käsud.

Laadige alla ja installige Visual Studio Code

Power Apps portaalidega ühenduse loomiseks ning Microsoft Power Platform CLI käskude kasutamiseks kasutage Visual Studio Code ja integreeritud terminali. Integreeritud terminal muudab keskkonnaga ühenduse loomise ning Dataverse keskkonda allalaadimise, muutmise ja üleslaadimise hõlpsaks. Võite selle asemel kasutada ka Windows PowerShelli.

1. etapp. Autentimine

Enne Power Apps portaali ühendamist, allalaadimist või üleslaadimist ning muudatuste tegemist peate esmalt Dataverse keskkonna autendima. Lisateavet Microsoft Power Platform CLI abil autentimise kohta leiate jaotisest pac auth.

Autentimiseks avage Windows PowerShell ja käivitage käsk pac auth create, kasutades oma Dataverse'i keskkonna URLi:

pac auth create -u [Dataverse URL]

Näide

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

Keskkonda sisselogimiseks järgige autentimisviiteid.

2. etapp Saadaolevate portaalide loend

Kasutage käsku pac paportal list, et loetleda saadaolevad Power Appsi portaalid selles Dataverse'i keskkonnas, mille eelmises etapis ühendasite.

pac paportal list

3. etapp Portaalide sisu allalaadimine

Laadige portaali veebisaidi sisu ühendatud Dataverse'i keskkonnast alla, kasutades käsku pac paportal download.

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

Näide

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

Kasutage ID parameetri jaoks parameetrit WebSiteId, mis on eelmise etapi väljundilt tagastatud.

4. etapp Portaalide sisu muutmine

Muutke konfiguratsiooni Visual Studio Code abil ja salvestage muudatused.

Märkus

Veenduge, et värskendate ainult Power Platform CLI-ga kasutamiseks toetatud tabeleid. Lisateavet leiate Toetatud tabelid.

Näiteks kuvatakse portaali vaikelehel järgmine tekst:

See tekst on nähtav veebilehe HTML-is:

Saate seda teksti muuta ja muudatused salvestada:

Jootraha

Saate muuta PowerShellis/integreeritud terminalis kausta tee asukoha allalaaditud asukohaks ja sisestada "koodi." kasuta avamine otse Visual Studio Code-s.

5. etapp. Muudatuste üleslaadimine

Märkus

• Kui laadite üles mitmesse keskkonda, lugege juurutusprofiili abil muudatuste üleslaadimise kohta jaotisest muudatuste üleslaadimine juurutusprofiili abil.
• Veenduge, et sihtkeskkonna manuse maksimaalseks suuruseks seatakse teie lähtekeskkonnaga sama või sellest suurem suurus.
• Failide maksimaalse suuruse määrab ära säte Faili maksimaalne suurus süsteemi sätete meili vahekaardil, mis asub keskkonnasüsteemi sätete dialoogiboksis.

Pärast vajalike muudatuste tegemist laadige need üles käsuga pac paportal upload:

pac paportal upload --path [Folder-location]

Näide

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

Märkus

Veenduge, et sisestatud portaalide sisu tee oleks õige. Vaikimisi luuakse allalaaditud portaalide sisuga kaust, mille nimi on portaali nimi (sõbralik). Näiteks kui portaali sõbralik nimi on kohandatud portaal, peaks ülaltoodud käsu (--tee) tee olema C:\pac-portals\downloads\custom-portal.

Üleslaadimine toimub ainult muudetud sisu puhul. Selles näites, kuna muudatus on tehtud veebilehel, laaditakse sisu üles ainult adx_webpage jaoks.

Laadige muudatused juurutusprofiili abil üles

Mitme erineva keskkonnaga töötamisel võite kaaluda juurutusprofiilide kasutamist, et tagada juurutamisprofiili abil muudatuste üleslaadimine õigesse keskkonda.

1. Looge portaali sisu sisaldavasse kausta kaust nimega juurutusprofiilid. Näiteks kui allalaaditud portaali sisu on "alustusportaali" sees, peaks juurutusprofiilide kaust olema selles kaustas.

   

2. Looge juurutusprofiilide kausta juurutuse YAML-fail, mis sisaldab keskkonnapõhiseid muudatusi. Näiteks arenduskeskkonda võib nimetada "dev.deployment.yml".

   

3. Redigeerige juurutuse YAML-faili Visual Studio Code'i järgmises vormingus:

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

   Näiteks järgmine YAML-koodi näide uuendab "Brauseri pealkirja järelliite" väärtuse vaikeolekust "Kohandatud portaal" väärtusele "Kohandatud portaal (Arendus)".

   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. Muudatuste teise keskkonda arendusprofiili YAML-faili abil üles laadimiseks autentige kõigepealt sihtorganisatsioon.

5. Pärast autentimist ja õigesse keskkonda ühendamist kasutage sisu üleslaadimiseks käsku pac paportal upload:

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

   Märkus

   Ülaltoodud näites on kasutatud juurutusprofiili nimeks "dev", olles järginud eelnevaid juhiseid arenduse juurutusprofiili loomiseks. Muutke nimi "dev" mistahes muuks (nt K ja V "qa.deployment.yml" korral või Test "test.deployment.yml") korral, kui olete kasutanud oma juurutuse YAML-faili jaoks erinevad failinime.

6. etapp. Kinnitage muudatused

Portaali veebilehel tehtud muudatuste kinnitamiseks.

1. Tühjendage serveripoolne vahemälu või kasutage sünkroonimiskonfiguratsioone Power Apps portaalide stuudio abil.

2. Sirvige portaali veebilehte, et muudatust näha.

   

3. Kui olete kasutanud juurutamisprofiili näidet eelnevalt selgitatud, värskendab YAML-lõigend väärtuse, nii nagu allpool näidatud.

   

   Ülaltoodud muudatuse kaudu värskendatud brauseri pealkirja järelliide näitab muudatust portaali avamisel brauseris:

   

Sellega on õpetus lõppenud. Saate ülaltoodud samme korrata ja muuta muude toetatud tabelite portaalide sisu.

Järgmised toimingud

Visual Studio Code laiendi kasutamine

Vt ka

• Microsoft Power Platform CLI
• Visual Studio Code'i laiendi kasutamine (eelversioon)