Microsoft Power Platform CLI podrška za Power Pages
Microsoft Power Platform CLI (interfejs sa komandnom linijom) je jednostavan interfejs sa komandnom linijom za programere gde je sve na jednom mestu i koji omogućava programerima i autorima aplikacija da kreiraju komponente koda.
Microsoft Power Platform CLI alat je prvi korak ka sveobuhvatnoj priči o upravljanju životnim ciklusom aplikacija (ALM), gde programeri preduzeća i ISV mogu brzo i efikasno da kreiraju, grade, otklanjaju greške i objavljuju svoja proširenja i prilagođavanja. Za više informacija posetite šta je Microsoft Power Platform CLI?
Sa ovom funkcijom, Microsoft Power Platform CLI omogućava CI/CD (kontinuirana integracija/kontinuirana primena) konfiguracije Power Pages lokacije. Sada možete da prijavite konfiguraciju veb-lokacije za kontrolu izvora i premestite konfiguraciju veb-lokacije u bilo koje okruženje koje koristi Microsoft Power Platform CLI.
Napomena
- Ova funkcija je obično dostupna počevši od Power Platform CLI verzije 1.9.8. Da biste saznali više o instaliranju najnovije verzije, idite na dugme "Instaliraj Microsoft Power Platform CLI".
- Počevši od Power Platform CLI verzije 1.27, komanda
pac paportal
se menja upac powerpages
.paportal
nastavlja da radi, ali preporučujemo korišćenje unapredpowerpages
. Ovaj članak će uskoro biti ažuriran da bi se koristiopowerpages
umestopaportal
.
Zašto koristite Microsoft Power Platform CLI za razvoj veb-lokacije?
Uz Microsoft Power Platform CLI, sada možete da koristite mogućnosti slične radu van mreže za prilagođavanje veb-lokacije unošenjem promena u sadržaj veb-lokacije. Kada se sva prilagođavanja ili promene sačuvaju, možete otpremiti konfiguraciju veb-lokacije nazad u Microsoft Dataverse. Kada sadržaj veb-lokacije preuzimate pomoću Microsoft Power Platform CLI interfejsa, sadržaj je strukturiran u YAML i HTML formatima što olakšava prilagođavanje, omogućavajući iskustvo profesionalnog razvoja aplikacije.
Evo liste funkcija i mogućnosti od kojih portali imaju koristi uz podršku Microsoft Power Platform CLI:
Lakoća korišćenja
Podrška za preuzimanje/otpremanje podataka konfiguracije veb-lokacije u lokalni sistem datoteka i iz njega
Kreirajte se na postojećem Microsoft Power Platform CLI alatu.
Upravljanje životnim ciklusom aplikacije (ALM)
Praćenje promena u konfiguraciji veb-lokacije unutar organizacije
Premeštajte konfiguracione datoteke u organizacijama ili zakupcima
Profesionalna podrška za programere i preduzeća
Pomaže u neprimetnoj integraciji sa bilo kojim alatkama za kontrolu izvora, kao što je „git“
Jednostavno podešavanje CI/CD kanala
Instaliraj Microsoft Power Platform CLI
Za detaljna uputstva pogledajte Instaliranje Microsoft Power Platform CLI.
Podržane tabele
Podrška portala za Microsoft Power Platform CLI je ograničena na sledeće tabele.
adx_ad
adx_adplacement
adx_blog
adx_blogpost
adx_botconsumer
adx_communityforum
adx_communityforumaccesspermission
adx_contentsnippet
adx_entityform
adx_entityformmetadata
adx_entitylist
adx_entitypermission
adx_forumthreadtype
adx_pagetemplate
adx_poll
adx_polloption
adx_pollplacement
adx_portallanguage
adx_publishingstate
adx_redirect
adx_shortcut
adx_sitemarker
adx_sitesetting
adx_tag
adx_urlhistory
adx_webfile
adx_webform
adx_webformmetadata
adx_webformstep
adx_weblink
adx_weblinkset
adx_webpage
adx_webpageaccesscontrolrule
adx_webrole
adx_website
adx_websiteaccess
adx_websitebinding (samo preuzimanje)
adx_websitelanguage
adx_webtemplate
beleška
Važno
- Prilagođene tabele i tabele specifične za predložak portala (poput bloga, zajednice ili portala ideja) nisu podržane za prilagođavanje pomoću Microsoft Power Platform CLI interfejsa.
- Prilozi datoteka slike u zapisima oglasa (adx_ad) ne preuzimaju se pomoću usluge Power Platform CLI. Kao zaobilazno rešenje, koristite polje URL adresa slike ili dodavanjem HTML reference u polju Kopiraj u zapis veb-datoteke koji sadrži datoteku slike.
Instalirajte i verifikujte Microsoft Power Platform CLI interfejs za portale
Da biste saznali više o instaliranju Microsoft Power Platform CLI interfejsa, idite na instaliraj Microsoft Power Platform CLI.
Nakon instaliranja Microsoft Power Platform CLI, otvorite komandnu liniju i pokrenite CLI da biste proverili da li izlaz sadrži „paportal“ – komandu za Power Apps portale.
Microsoft Power Platform CLI komande za portale
Microsoft Power Platform CLI komanda za portale je „paportal“.
Sledeći odeljci pružaju više detalja o različitim svojstvima komande „paportal“.
Parametri
Ime svojstva | Opis | Primer |
---|---|---|
list | Navodi sve veb-lokacije portala iz trenutnog Dataverse okruženja. Možete da dodate parametar -v da biste naznačili da li lokacija koristi standardni ili poboljšani model podataka |
pac paportal list |
download | Preuzmite sadržaj veb-lokacije portala od aktuelnog Dataverse okruženja. Ima sledeće parametre: - putanja: Putanja na kojoj se preuzima sadržaj web sajta (pseudonim: -p) - webSiteId: ID veb-lokacije portala za preuzimanje (pseudonim: -id) - overwrite: (Opcionalno) true – da zameni postojeći sadržaj, false – da ne uspe ako fascikla već ima sadržaj veb-lokacije (pseudonim: -o) - modelVersion: 1 ili da 2 biste naznačili da li podaci lokacije za preuzimanje koriste standard (1) ili poboljšani model podataka (2). |
pac paportal download --path "C:\portals" --webSiteId f88b70cc-580b-4f1a-87c3-41debefeb902 --modelVersion 2 |
upload | Otpremite sadržaj veb-lokacije portala u aktuelno Dataverse okruženje. Ima sledeći parametar: - path: Putanja na kojoj je uskladišten sadržaj veb-lokacije (pseudonim: -p) - deploymentProfile: Otpremajte podatke o portalu sa detaljima o okruženju definisanim putem promenljivih profila u datoteci deployment-profiles/[profile-name].depoyment.yaml - modelVersion: 1 ili da 2 označi da li podaci lokacije za otpremanje koriste standardni (1) ili poboljšani model podataka (2). |
pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile "profile-name" --modelVersion 2 |
Korišćenje profila za primenu
Prekidač deploymentProfile vam omogućava da definišete skup promenljivih za okruženje u YAML formatu. Na primer, možete imati različite profile primene (kao što su razvojni, testni, proizvodni) koji imaju različite detalje šeme definisane u profilu.
Ako kreirate testni profil, možete da kreirate datoteku u okviru deployment-profiles pod nazivom „test.deployment.yml“ (tj. <profileTag>.deployment.yml). I možete pokrenuti komandu sa oznakom (<profileTag>) da biste koristili ovaj profil:
pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile test --modelVersion 2
U ovoj datoteci možete imati naziv tabele (entiteta) sa ID-om tabele, spiskom atributa i vrednostima koje želite da izmenite prilikom otpremanja konfiguracije portala pomoću deploymentProfile
parametra.
Osim toga, možete koristiti OS
promenljivu za pristup promenljivima okruženja operativnog sistema.
Evo primera ove „test.deployment.yml“ datoteke YAML profila koji ima jedinstvene detalje šeme:
adx_sitesetting:
- adx_sitesettingid: 4ad86900-b5d7-43ac-1234-482529724970
adx_value: ${OS.FacebookAppId}
adx_name: Authentication/OpenAuth/Facebook/AppId
- adx_sitesettingid: 5ad86900-b5d7-43ac-8359-482529724979
adx_value: contoso_sample
adx_name: Authentication/OpenAuth/Facebook/Secret
adx_contentsnippet:
- adx_contentsnippetid: b0a1bc03-0df1-4688-86e8-c67b34476510
adx_name: PowerBI/contoso/sales
adx_value: https://powerbi.com/group/contoso/sales
Napomena
Da biste saznali više o svim naredbama koje se koriste u CLI pored portala, idite na članak Uobičajene komande u Microsoft Power Platform CLI.
Datoteke manifesta
Kada preuzmete sadržaj Veb lokacije koristeći pac paportal download CLI komandu, zajedno sa preuzimanjem sadržaja lokacije on takođe generiše dve manifestne datoteke;
- Datoteka manifesta okruženja (org-url-manifest.yml)
- Brisanje datoteke manifesta praćenja (manifest.yml)
Datoteka manifesta okruženja (org-url-manifest.yml)
Datoteka manifesta okruženja se generiše svaki put kada se pokrene komanda pac paportal download.
Nakon svakog preuzimanja, alatka PAC CLI čita postojeću datoteku manifesta okruženja i ažurira stavke izbrisane u okruženju ili kreira datoteku manifesta okruženja ako ne postoji.
Kada pokrenete komandu pac paportal upload da biste otpremili sadržaj veb-lokacije portala. Ona čita datoteku manifesta okruženja i identifikuje promene napravljene od poslednjeg preuzimanja i otprema samo ažurirani sadržaj. Ovo pomaže u optimizaciji procesa otpremanja jer se otprema samo ažurirani sadržaj veb-lokacije, umesto da se otprema sav sadržaj na svakoj komandi za otpremanje.
Datoteka manifesta okruženja se čita kada se poveže sa istim okruženjem (URL adresa okruženja se podudara sa imenom datoteke), da bi se izbegle slučajne promene.
Napomena
- Datoteka manifesta okruženja nije dizajnirana da prati promene prilikom primene veb-lokacije u različita okruženja.
- Datoteka manifesta okruženja je dizajnirana da je koriste programeri za lokalno raspoređivanje u razvojnom okruženju i treba je dodati na git listu za ignorisanje.
Brisanje datoteke manifesta praćenja (manifest.yml)
Ova datoteka se koristi za praćenje izbrisanih zapisa iz okruženja.
Kada se sadržaj Veb lokacije preuzme pomoću komande pac paportal download , ovo dodaje izbrisane zapise iz datoteke manifesta okruženja (org-url-manifest.yml) u manifest.yml datoteku. Dakle, kada otpremite sadržaj Veb lokacije pomoću komande pac paportal upload , on briše datoteke iz okruženja (čak i u drugo okruženje). Ova datoteka se ne briše i koristi se bez obzira na okruženje u koje ste povezani. Ovu datoteku je potrebno uzeti u obzir prilikom prosleđivanja promena u izvornu kontrolu da bi se razmotrilo brisanje stavki u ciljnom okruženju.
Napomena
Da biste izbrisali zapise sadržaja lokacije u jednom okruženju, kao i izbrisali iste zapise sadržaja u drugom okruženju pomoću PAC CLI, moraćete da pokrenete komandu pac paportal download pre i posle brisanja sadržaja zapisa veb-lokacije. Datoteka manifest.yml će pratiti ove promene i ukloniti odgovarajuće zapise u ciljnom okruženju kada se pokrene komanda pac paportal upload.
Korišćenje proširenja za Visual Studio Code
Takođe možete da koristite VS Code proširenje Power Platform VS Code proširenje da biste imali koristi od ugrađenog jezika Liquid, usluge IntelliSense, pomoći u dovršavanju koda, nagoveštavanja i interakcije sa Microsoft Power Platform CLI interfejsom koji koristi VS Code integrisani terminal. Još informacija: Korišćenje proširenja Visual Studio Code (verzija za pregled)
Još razmatranja
- Ako putanja datoteke premašuje ograničenje maksimalne dužine putanje, pojavljuje se poruka o grešci. Još informacija: Ograničenje maksimalne dužine putanje u operativnom sistemu Windows
- Za duplirane zapise, na primer duplirani naziv veb-stranice, Microsoft Power Platform CLI kreira dve različite fascikle: jednu sa nazivom veb-stranice, a drugu sa istim nazivom sa prefiksom heš koda. Na primer, „Moja stranica“ i „Moja stranica-heš kod".
Sledeći koraci
Vodič: Korišćenje Microsoft Power Platform CLI interfejsa sa portalima