Vadnica: Uporaba vmesnika Microsoft Power Platform CLI s storitvijo Power Pages

V tej vadnici se boste naučili, kako začeti uporabljati CLI za posodobitev konfiguracije vzorčnega spletnega mesta. Microsoft Power Platform

opomba,

• Ta vadnica se osredotoča na zahtevane ukaze vmesnika Microsoft Power Platform CLI za uporabo storitve Power Pages. Za več informacij o ukazih, uporabljenih v vmesniku ukazne vrstice Power Platform, si preberite splošne ukaze.
• Od različice 1.27 vmesnika CLI se ukaz spremeni v Power Platform . pac paportalpac pages paportal še vedno deluje, vendar priporočamo uporabo powerpages v prihodnje.

Prenos in namestitev programa Visual Studio Code

Za povezavo s portali Power Apps in za uporabo ukazov vmesnika ukazne vrstice Microsoft Power Platform uporabite Visual Studio Code in integrirani terminal. Integrirani terminal omogoča enostavno povezavo z okoljem Dataverse ter prenos, spreminjanje in nalaganje konfiguracije portalov. Namesto tega lahko uporabite tudi Windows PowerShell.

1. korak: Preverjanje pristnosti

Preden se povežete, navedete, prenesete ali naložite kakršne koli spremembe za portal Power Apps, morate izvesti preverjanje pristnosti v okolju Dataverse. Za več informacij o preverjanju pristnosti z uporabo vmesnika ukazne vrstice Microsoft Power Platform, se pomaknite na pac auth.

Če želite preveriti pristnost, odprite Windows PowerShell in izvedite ukaz pac auth create z URL-jem okolja Dataverse.

pac auth create -u [Dataverse URL]

Primer

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

Sledite navodilom za preverjanje pristnosti, da se prijavite v okolje.

2. korak. Seznam razpoložljivih spletnih mest

Z ukazom seznam strani pac navedite razpoložljiva spletna Power Pages v okolju Dataverse, s katero ste se povezali v prejšnjem koraku.

pac pages list

3. korak. Prenos vsebine spletnih mest

Prenesite vsebino spletnega mesta iz povezanega okolja Dataverse z ukazom za prenos strani pac .

pac pages download --path [PATH] -id [WebSiteId-GUID] --modelVersion [DataModel]

Primer

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

Za parameter ID uporabite vrednost WebSiteId, ki vam jo vrne rezultat v prejšnjem koraku.

opomba,

• Z uporabo modelVersion1 ali 2 navedite, ali bodo podatki spletnega mesta, ki jih želite naložiti, uporabljali standardni (1) ali izboljšan podatkovni model (2).
• Ukaz » pac pages list -v Zaženi«, če si želite ogledati, kateri podatkovni model se uporablja za vaše mesto. Če želite več podrobnosti, glejte izboljšan podatkovni model.

4. korak. Sprememba vsebine spletnega mesta

Spremenite konfiguracijo z Visual Studio Code in shranite spremembe.

opomba,

Poskrbite, da boste posodobili samo podprte tabele za uporabo z vmesnikom ukazne vrstice Power Platform. Če želite več informacij, glejte podprte tabele.

Privzeta stran portala na primer prikazuje besedilo, kot je to:

To besedilo je vidno v kodi html na spletni strani:

To besedilo lahko spremenite in shranite spremembe:

Napitnina

Lokacijo poti do mape v PowerShell/integriranem terminalu lahko spremenite na lokacijo prenosa in vnesete »code. «, da odprete mapo neposredno v orodju Visual Studio Code.

5. korak: Nalaganje sprememb

opomba,

• Če nalagate v več okolij, glejte Prenos sprememb z uporabo profila uvajanja, če želite izvedeti, kako naložite spremembe s profilom uvajanja.
• Poskrbite, da je največja velikost prilog v ciljnem okolju nastavljena na enako ali večjo velikost kot v vašem izvornem okolju.
• Največjo dovoljeno velikost datotek določa nastavitev Največja dovoljena velikost datoteke v zavihku »E-pošta« v sistemskih nastavitvah v pogovornem oknu za sistemske nastavitve okolja.

Ko naredite zahtevane spremembe, jih naložite z ukazom za nalaganje strani pac :

pac pages upload --path [Folder-location] --modelVersion [ModelVersion]

Primer

pac pages upload --path C:\pac-portals\downloads\custom-portal\ --modelVersion 2

opomba,

Prepričajte se, da je pot do vsebine portalov, ki ste jo vnesli, pravilna. Privzeto se ustvari mapa z imenom portala (uporabniku prijazno ime) s preneseno vsebino portalov. Če je na primer uporabniku prijazno ime portala custom-portal, bi morala biti pot za zgornji ukaz (--pot) C:\pac-portals\downloads\custom-portal.

Nalaganje se izvede samo za vsebino, ki je bila spremenjena. V tem primeru se vsebina naloži samo za tabelo adx_webpage, ker je spremenjena spletna stran.

Naložite spremembe z uporabo profila uvajanja

Pri delu z več različnimi okolji lahko razmislite o uporabi profilov uvajanja, da zagotovite, da se spremembe naložijo v pravilno okolje z uporabo profila uvajanja.

1. Ustvarite mapo z imenom profili uvajanja znotraj mape z vsebino portala. Na primer, če je prenesena vsebina portala znotraj mape profilov uvajanja »začetni portal«, mora biti mapa profilov uvajanja v tej mapi.

   

2. Znotraj mape s profili uvajanja ustvarite datoteko YAML za uvajanje, ki vsebuje spremembe, specifične za okolje. Na primer, razvojno okolje se lahko imenuje »dev.deployment.yml«.

   

3. Uredite datoteko YAML za uvajanje z uporabo kose za Visual Studio Code v naslednji obliki zapisa:

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

   Naslednja vzorčna koda YAML na primer posodobi vrednost »Pripona naslova brskalnika« s privzetega »Portal po meri« na »Portal po meri (razvoj)«.

   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. Če želite naložiti spremembe v drugo okolje z uporabo datoteke YAML profila uvajanja, najprej preverite pristnost v ciljni organizaciji.

5. Ko je pristnost preverjena in povezana s pravilnim okoljem, za prenos vsebine uporabite ukaz upload strani pac :

   pac pages upload --path "C:\portals\starter-portal" --deploymentProfile dev --modelVersion 2

   opomba,

   V zgornjem primeru je uporabljeno ime profila uvajanja »razvoj« po izvedbi prejšnjih korakov za ustvarjanje profila uvajanja razvoja. Spremenite ime iz »razvoj« v kar koli drugega (na primer »QA« za »qa.deployment.yml« ali »Test« za »test.deployment.yml«), če ste za datoteko YAML uvajanja uporabili drugo ime datoteke.

6. korak: Potrdite spremembe

Če želite potrditi spremembe na spletni strani:

1. V oblikovalskem studiu storitve Power Pages izberite Sinhronizacija.

2. Če si želite ogledati spremembo, pojdite na spletno stran.

   

3. Če ste uporabili primer profila uvajanja , ki je bil pojasnjen prej, delček kode YAML posodobi vrednost, kot je prikazano na naslednjem posnetku zaslona.

   

   Pripona naslova brskalnika, posodobljena z zgornjo spremembo, prikazuje spremembo, ko odprete portal v brskalniku:

   

S tem tudi zaključujemo vadnico. Zgornje korake lahko ponovite in vsebino portalov spremenite z drugimi podprtimi tabelami.

Naslednji koraki

Uporabite razširitev Visual Studio Code

Glejte tudi

• Microsoft Power Platform CLI
• Uporabite razširitev Visual Studio Code