Vodič: Upotreba Microsoft Power Platform CLI-ja s portalima
U ovom primjeru vodiča vidjet ćete kako započeti s radom Microsoft Power Platform CLI-ja za ažuriranje uzorka konfiguracije portala.
Napomena
Ovaj se vodič usredotočuje na potrebne komande Microsoft Power Platform CLI za upotrebu portala Power Apps. Više informacija o naredbama koje se koriste u CLI-ju platforme Power Platform možete pornaći u odjeljku Uobičajene naredbe.
Preuzimanje i instalacija značajke Visual Studio Code
Za povezivanje na portale Power Apps i za upotrebu komandi Microsoft Power Platform CLI, koristite Visual Studio Code i integrirani terminal. Integrirani terminal olakšava povezivanje s Dataverse okruženjem te za preuzimanje, promjenu i prijenos konfiguracije portala. Umjesto toga možete koristiti i Windows PowerShell.
1. korak Provjera autentičnosti
Prije povezivanja navedite, preuzmite ili prenesite sve promjene za portal Power Apps, prvo se morate prijaviti u okruženje Dataverse. Više informacija o provjeri autentičnosti s pomoću Microsoft Power Platform CLI-a, pronađite na Microsoft Power Platform CLI – Auth.
Da biste provjerili autentičnost, otvorite Windows PowerShell i pokrenite sljedeću naredbu koristeći svoj URL Dataverse okruženja:
pac auth create -u [Dataverse URL]
Primjer
pac auth create -u https://contoso-org.crm.dynamics.com
Slijedite upute za provjeru autentičnosti da biste se prijavili u okruženje.

2. korak Popis dostupnih portala
Koristite naredbu popis za popis dostupnih portala platforme Power Apps u Dataverse okruženju s kojim ste se povezali u prethodnom koraku.
pac paportal list

3. korak Preuzimanje sadržaja portala
Preuzmite sadržaj web-mjesta portala iz povezanog okruženja Dataverse.
pac paportal download --path [PATH] -id [WebSiteId-GUID]
Primjer
pac paportal download --path c:\pac-portals\downloads -id d44574f9-acc3-4ccc-8d8d-85cf5b7ad141
Za parametar id koristite WebSiteId vraćen iz rezultata prethodnog koraka.

4. korak Promjena sadržaja portala
Promijenite konfiguraciju s pomoću značajke Visual Studio Code i spremite promjene.
Napomena
Obavezno ažurirajte samo podržane tablice za upotrebu s Power Platform CLI. Više informacija potražite u odjeljku Podržane tablice.
Na primjer, zadana stranica portala prikazuje tekst poput ovog:
Ovaj je tekst vidljiv na html u web-stranice:

Možete izmijeniti ovaj tekst i spremiti promjene:

Savjet
Možete promijeniti lokaciju putanje mape u PowerShell/integriranom terminalu na preuzeto mjesto i unijeti „kod.” da biste mapu otvorili izravno u značajci Visual Studio Code.
5. korak Prijenos promjena
Napomena
Ako prenosite u više okruženja, pročitajte članak Prijenos promjena pomoću profila za implementaciju da biste saznali kako prenijeti promjene pomoću profila za implementaciju.
Nakon što izvršite potrebne promjene, prenesite ih s pomoću sljedeće naredbe:
pac paportal upload --path [Folder-location]
Primjer
pac paportal upload --path C:\pac-portals\downloads\custom-portal\

Napomena
Provjerite je li točna putanja za sadržaj portala koji ste unijeli. Prema zadanim postavkama, kreira se mapa koju je portal imenovao (neslužbeni naziv) s preuzetim sadržajem portala. Na primjer, ako je neslužbeni naziv portala prilagođeni portal, putanja za gornju naredbu (--path) trebala bi biti C:\pac-portali\preuzimanja\custom-portal.
Prijenos se događa samo za sadržaj koji je izmijenjen. U ovom primjeru, budući da je promjena izvršena na web-stranici, sadržaj se prenosi samo za tablicu adx_webpage.

Prijenos promjena pomoću profila za implementaciju
Kada radite s više različitih okruženja, razmislite o korištenju profila za implementaciju kako biste osigurali da se promjene prenesu u ispravno okruženje pomoću profila implementacije.
Stvorite mapu pod nazivom deployment-profiles unutar mape koja sadrži sadržaj portala. Na primjer, ako se preuzeti sadržaj portala nalazi unutar "starter-portala", mapa profila implementacije trebala bi biti unutar ove mape.
Unutar mape profila implementacije stvorite YAML datoteku implementacije koja sadrži promjene specifične za okoliš. Na primjer, razvojno okruženje može se nazvati "dev.deployment.yml".
Uredite YAML datoteku implementacije pomoću Visual Studio koda u sljedećem obliku:
<table-name>: - <record-id>: <GUID> <column-name>: <Name> <column-value>: <Value>Na primjer, sljedeći ogledni YAML kod ažurira vrijednost za "Sufiks naslova preglednika" iz zadanog "Prilagođeni portal" u "Prilagođeni 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 valueDa biste prenijeli promjene u drugo okruženje pomoću YAML datoteke profila za implementaciju, najprije provjerite autentičnost na ciljnoj organizaciji.
Nakon provjere autentičnosti i povezivanja s ispravnim okruženjem, za prijenos sadržaja koristite sljedeću naredbu:
pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile devNapomena
U gornjem primjeru korišteni naziv profila implementacije je "dev" nakon što slijedi prethodne korake za stvaranje profila implementacije dev. Promijenite naziv iz "dev" u bilo koji drugi (kao što je QA za "qa.deployment.yml" ili Test za "test.deployment.yml") ako ste za YAML datoteku implementacije koristili drugi naziv datoteke.
6. korak Potvrda promjena
Da biste potvrdili promjene izvršene na web-stranici portala:
Očistite predmemoriju na poslužitelju, ili koristite Konfiguracija sinkronizacije s pomoću portala Power Apps Studio.
Pregledajte web-stranicu portala da biste vidjeli promjenu.
Ako ste prethodno objasnili primjer profila implementacije, YAML isječak ažurirat će vrijednost kao što je prikazano u nastavku.
Sufiks naslova preglednika ažuriran gore navedenom promjenom prikazuje promjenu kada otvorite portal u pregledniku:
Ovim završava vodič. Možete ponoviti gornje korake i sadržaj portala promijeniti za ostale podržane tablice.
Sljedeći koraci
Pregled podrške portala za Microsoft Power Platform CLI