Vadnica: Uporaba vmesnika ukazne vrstice za Microsoft Power Platform s portali

Opomba

Od 12. oktobra 2022 najprej je portal Power Apps Power Pages. Več informacij: Microsoft Power Pages je zdaj splošno dostopen (spletni dnevnik)
Dokumentacijo portalov Power Apps bomo kmalu preselili in združili z dokumentacijo za Power Pages.

V tem primeru vadnice boste videli, kako začeti uporabljati vmesnik ukazne vrstice Microsoft Power Platform za posodobitev vzorčne konfiguracije portalov.

Opomba

• Uporabite lahko tudi vmesnik ukazne vrstice Power Platform s Power Pages. Več informacij: Kaj je Power Pages
• Ta vadnica se osredotoča na zahtevane ukaze vmesnika ukazne vrstice Microsoft Power Platform za uporabo portalov Power Apps. Za več informacij o ukazih, uporabljenih v vmesniku ukazne vrstice Power Platform, si preberite splošne ukaze.

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 portalov

Uporabi ukaz seznam pac paportal za seznam razpoložljivih portalov Power Apps v okolju Dataverse, s katerim ste se povezali v prejšnjem koraku.

pac paportal list

3. korak. Prenos vsebine portalov

Prenesite vsebino spletnega mesta portala iz povezanega okolja Dataverse z uporabo ukaza prenos pac paportal.

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

Primer

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

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

4. korak. Sprememba vsebine portalov

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:

Nasvet

Lokacijo poti do mape v PowerShell/integriranem terminalu lahko spremenite v lokacijo prenosa in vnesete »code«. da odprete mapo neposredno v storitvi 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 izvedete zahtevane spremembe, jih naložite z ukazom prenos pac paportal:

pac paportal upload --path [Folder-location]

Primer

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

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 portal po meri, bi morala biti pot za zgornji ukaz (--pot) C:\pac-portali\prenosi\portal po meri.

Nalaganje se zgodi 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

Ko delate z več različnimi okolji, razmislite o uporabi profilov uvajanja, da zagotovite, da so spremembe naložene v pravo 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. Po preverjanju pristnosti in vzpostavitvi povezave s pravilnim okoljem uporabite ukaz prenos pac paportal za nalaganje vsebine:

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

   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 portala:

1. počistite strežniški predpomnilnik ali uporabite konfiguracijo sinhronizacije s portali Power Apps Studio.

2. Za prikaz spremembe obiščite spletno stran portala.

   

3. Če ste uporabili primer profila uvajanja, ki je bil razložen prej, bo izrezek YAML posodobil vrednost, kot je prikazano spodaj.

   

   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

Uporaba razširitve za kodo za Visual Studio Code

Glejte tudi

• Microsoft Power Platform Vmesnik ukazne vrstice
• Uporaba razširitve za Visual Studio Code (predogledna različica)