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

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

Opomba

• Uporabite lahko tudi Power Platform CLI z 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, odprite Vmesnik ukazne vrstice Microsoft Power Platform – preverjanje pristnosti.

Če želite preveriti pristnost, odprite Windows PowerShell in z vašim računalnikom zaženite naslednji ukaz 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 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.

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. Spremenite vsebino portala

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 na lokacijo prenosa in vnesete "code ." da odprete mapo neposredno v storitvi Visual Studio Code.

5. korak: Naložite spremembe

Opomba

Če nalagate v več okolij, glejte naložite spremembe s profilom uvajanja če želite izvedeti, kako naložiti spremembe s profilom uvajanja.

Ko izvedete potrebne spremembe, jih naložite z naslednjim ukazom:

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 s profilom uvajanja

Ko delate z več različnimi okolji, lahko razmislite o uporabi profilov uvajanja, da zagotovite, da so spremembe naložene v pravilno okolje s profilom uvajanja.

1. Ustvarite mapo z imenom razmestitveni profili znotraj mape z vsebino portala. Če je na primer prenesena vsebina portala znotraj »starter-portal«, bi morala biti mapa profilov razmestitve znotraj te mape.

   

2. V mapi s profili uvajanja ustvarite datoteko YAML za razmestitev, ki vsebuje spremembe, specifične za okolje. Na primer, razvojno okolje lahko imenujemo "dev.deployment.yml".

   

3. Uredite datoteko YAML za razmestitev z uporabo Visual Studio Koda v naslednji obliki:

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

   Na primer, naslednja vzorčna koda YAML posodobi vrednost za "Pripona naslova brskalnika" s privzetega "Portal po meri" v "Portal po meri (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. Če želite naložiti spremembe v drugo okolje z datoteko YAML profila za uvajanje, overiti najprej na ciljno organizacijo.

5. Ko ste overjeni in povezani s pravilnim okoljem, uporabite naslednji ukaz za nalaganje vsebine:

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

   Opomba

   V zgornjem primeru je uporabljeno ime profila za razmestitev "dev", potem ko sledite prejšnjim korakom za ustvarjanje profila za uvajanje razvijalca. Spremenite ime iz "dev" v katero koli drugo (na primer QA za "qa.deployment.yml" ali Test za "test.deployment.yml"), če ste za svojo datoteko YAML za razmestitev 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 za uvajanje razloženo prej, bo YAML izrezek 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

Uporabi Visual Studio Razširitev kode

Glejte tudi

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