Uputstvo: Korišćenje usluge Microsoft Power Platform CLI sa uslugom Power Pages
U ovom vodiču ćete naučiti kako da počnete da koristite Microsoft Power Platform CLI za ažuriranje konfiguracije uzorka veb sajta.
Belešku
- Ovaj vodič se fokusira na potrebne Microsoft Power Platform CLI komande za upotrebu sa uslugom Power Pages. Za više informacija o komandama koje se koriste u usluzi Power Platform CLI, pročitajte Uobičajene komande.
- Počevši od CLI verzije Power Platform 1.27, komanda
pac paportal
se menja upac powerpages
.paportal
nastavlja da radi, ali preporučujemo da koristitepowerpages
ide napred.
Preuzmite i instalirajte Visual Studio Code
Da biste se povezali sa Power Apps portalima, i koristili Microsoft Power Platform CLI naredbe, koristite Visual Studio Code i integrisani terminal. Integrisani terminal olakšava povezivanje sa Dataverse okruženjem i za preuzimanje, promenu i otpremanje konfiguracije portala. Takođe možete da koristite i Windows PowerShell.
Korak 1. Potvrdite identitet
Pre nego što se povežete, izlistate, preuzmete ili otpremite bilo kakve promene za Power Apps portal, morate prvo da potvrdite identitet za Dataverse okruženje. Za više informacija o potvrđivanju identiteta pomoću Microsoft Power Platform CLI interfejsa, idite na pac auth.
Da biste potvrdili identitet, otvorite Windows PowerShell i pokrenite komandu pac auth create koristeći URL adresu svog Dataverse okruženja:
pac auth create -u [Dataverse URL]
Primer
pac auth create -u https://contoso-org.crm.dynamics.com
Sledite uputstva za potvrdu identiteta da biste se prijavili u okruženje.
2. korak Navedite dostupne veb-lokacije
Koristite komandu pac poverpages list da biste naveli dostupne Power Pages veb stranice u okruženju na koje Dataverse ste se povezali u prethodnom korak.
pac powerpages list
3. korak Preuzmite sadržaj veb-lokacije
Preuzmite sadržaj sajta iz povezanog Dataverse okruženja pomoću komande za preuzimanje pac poverpages.
pac powerpages download --path [PATH] -id [WebSiteId-GUID] --modelVersion [DataModel]
Primer
pac powerpages download --path c:\pac-portals\downloads -id d44574f9-acc3-4ccc-8d8d-85cf5b7ad141 --modelVersion 2
Za parametar ID koristite WebSiteId dobijen iz rezultata prethodnog koraka.
Belešku
- Koristite modelVersion
1
ili2
da naznačite da li će podaci o lokaciji koji se otpremaju koristiti standardni (KSNUMKS) ili poboljšani model podataka (KSNUMKS). - Pokreni
pac powerpages list -v
komandu da biste videli koji model podataka se koristi za vašu veb lokaciju. Za više detalja, idite na poboljšani model podataka.
4. korak Promena sadržaja veb-lokacije
Promenite konfiguraciju pomoću usluge Visual Studio Code i sačuvajte promene.
Napomena
Obavezno ažurirajte samo podržane tabele za upotrebu sa Power Platform CLI interfejsom. Za više informacija, pogledajte odeljak Podržane tabele.
Na primer, podrazumevana stranica portala prikazuje tekst poput ovog:
Ovaj tekst je vidljiv iz HTML koda veb-stranice:
Možete da izmenite ovaj tekst i sačuvate promene:
Napojnica
Možete da promenite lokaciju putanje fascikle u PowerShell/integrisanom terminalu na lokaciju preuzimanja i unesete „code .“ da biste otvorili fasciklu direktno u usluzi Visual Studio Code.
Korak 5. Otpremite promene
Napomena
- Ako otpremate u više okruženja, pogledajte otpremanje promena pomoću profila za primenu da biste saznali kako da otpremite promene pomoću profila za primenu.
- Uverite se da je maksimalna veličina priloga ciljnog okruženja postavljena na istu ili veću veličinu kao izvorno okruženje.
- Maksimalna veličina datoteka određena je postavkom Maksimalna veličina datoteke na kartici e-pošte na stranici sa sistemskim postavkama u dijalogu sistemskih postavki okruženja.
Nakon što potrebne izmene, otpremite ih pomoću komande pac poverpages upload :
pac powerpages upload --path [Folder-location] --modelVersion [ModelVersion]
Primer
pac powerpages upload --path C:\pac-portals\downloads\custom-portal\ --modelVersion 2
Belešku
Uverite se da je putanja za sadržaj portala koji ste uneli tačna. Podrazumevano se kreira fascikla koju je imenovao portal (prepoznatljivo ime) sa preuzetim sadržajem portala. Na primer, ako je prepoznatljivo ime portala custom-portal, putanja za gorenavedenu naredbu (--path) treba da bude C:\pac-portals\downloads\custom-portal.
Učitavanje se dešava samo za sadržaj koji se menja. U ovom primeru, s obzirom da je napravljena promena na veb-stranici, sadržaj se otprema samo za tabelu adx_webpage.
Otpremanje promena pomoću profila primene
Kada radite sa više različitih okruženja, možete razmisliti o korišćenju profila za raspoređivanje kako biste osigurali da se promene učitaju u ispravno okruženje koristeći profil primene.
Kreirajte fasciklu pod imenom deployment-profiles unutar fascikle koja sadrži sadržaj portala. Na primer, ako se preuzeti sadržaj portala nalazi unutar "starter-portal", fascikla profila za primenu bi trebalo da se nalazi u ovoj fascikli.
Unutar fascikle profila za primenu, kreirajte YAML datoteku za primenu koja sadrži promene specifične za okruženje. Na primer, razvojno okruženje se može nazvati "dev.deployment.yml".
Uredite YAML datoteku primene koristeći Visual Studio Code sa sledećim formatom:
<table-name>: - <record-id>: <GUID> <column-name>: <Name> <column-value>: <Value>
Na primer, sledeći uzorak YAML koda ažurira vrednost za "sufiks naslova pregledača" sa podrazumevanog "prilagođeni portal" na "prilagođeni portal (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
Da biste otpremili promene u drugo okruženje pomoću YAML datoteke profila za primenu, prvo potvrdite verodostojnost ciljne organizacije.
Nakon autentifikacije i povezan sa ispravnim okruženjem, koristite komandu za otpremanje pac poverpages da biste otpremili sadržaj:
pac powerpages upload --path "C:\portals\starter-portal" --deploymentProfile dev --modelVersion 2
Belešku
U gorenavedenom primeru, ime profila primene koje se koristi je "dev" nakon prethodnih koraka za kreiranje dev profila za primenu. Promenite ime iz "dev" u bilo koje drugo (kao što je QA za "qa.deployment.yml" ili Test za "test.deployment.yml") ako ste koristili drugo ime datoteke za primenu YAML datoteke.
Korak 6. Potvrdite promene
Da biste potvrdili promene izvršene na veb-stranici:
Izaberite stavku Sinhronizuj u Power Pages studiju za dizajniranje.
Da biste videli promenu, pređite na veb stranicu.
Ako ste koristili prethodno objašnjeni primerprofila razmene, IAML isečak ažurira vrednost kao što je prikazano na sledećem ekranu.
Sufiks naslova pregledača ažuriran gorenavedenom promenom prikazuje promenu kada otvorite portal u pregledaču:
Ovim se uputstvo završava. Možete da ponovite gorenavedene korake i promenite sadržaj portala drugim podržanim tabelama.
Sledeći koraci
Koristite ekstenziju Visual Studio koda