Podrška za portale za Microsoft Power Platform CLI
Napomena
Od 12. oktobra 2022. Power Apps portali postaju Power Pages. Više informacija: Usluga Microsoft Power Pages je sada opštedostupna (blog)
Uskoro ćemo migrirati i objediniti dokumentaciju o Power Apps portalima sa dokumentacijom o usluzi Power Pages.
Microsoft Power Platform CLI (Interfejs sa komandnom linijom) je jednostavan interfejs za komandnu liniju programera na jednom mestu koji omogućava programerima i kreatorima aplikacija da prave 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, pogledajte: Šta je to Microsoft Power Platform CLI?
Pomoću ove funkcije portali Microsoft Power Apps podržavaju CLI da Microsoft Power Platform bi omogućili CI/CD (Kontinuirana integracija/neprekidno raspoređivanje) konfiguracije portala. Sada možete da prijavite konfiguraciju portala da biste kontrolisali izvor i premestili konfiguraciju portala u bilo koje okruženje pomoću Microsoft Power Platform CLI-ja.
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, pogledajte članak Instaliranje Microsoft Power Platform CLI.
Zašto koristite Microsoft Power Platform CLI za razvoj portala?
Sa podrškom za portale za Microsoft Power Platform CLI, sada možete da koristite mogućnosti slične radu van mreže za prilagođavanje portala unošenjem promena u sadržaj portala. Nakon što se sva prilagođavanja ili promene sačuvaju, otpremite ih na portal. Kada sadržaj portala 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 portala u/iz lokalnog sistema datoteka
Kreirajte se na postojećem Microsoft Power Platform CLI alatu.
Upravljanje životnim ciklusom aplikacije (ALM)
Pratite promene u konfiguraciji portala 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 dolenavedene 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 |
|---|---|---|
| lista | Navodi sve veb-lokacije portala iz trenutnog Dataverse okruženja. | pac paportal list |
| preuzimanje | Preuzmite sadržaj veb-lokacije portala od aktuelnog Dataverse okruženja. Ima sledeće parametre: - path: Putanja na koju će biti preuzet sadržaj veb-lokacije (pseudonim: -p) - webSiteId: ID veb-stranice 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) |
pac paportal download --path "C:\portals" --webSiteId f88b70cc-580b-4f1a-87c3-41debefeb902 |
| otpremanje | Otpremite sadržaj veb-lokacije portala u aktuelno Dataverse okruženje. Ima sledeći parametar: - putanja: Putanja na kojoj je uskldiš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 |
pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile "profile-name" |
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 sa 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
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 CLI komandu pac paportal download, zajedno sa preuzimanjem sadržaja lokacije on će takođe generisati dve datoteke manifesta;
- 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 će biti samo za čitanje kada se poveže sa istim okruženjem (URL adresa okruženja se podudara sa imenom datoteke), da bi se izbegle slučajne promene.
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 će dodati izbrisane zapise iz datoteke manifesta okruženja (org-url-manifest.yml) u datoteku manifest.yml. Dakle, kada otpremite sadržaj veb-lokacije pomoću komande pac paportal upload, on će izbrisati 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.
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 extension Power Platform VS Code Extension da biste koristili ugrađeni tečni jezik od IntelliSense-a, pomoć pri dovršavanja koda, hinting i interakciju Microsoft Power Platform sa CLI pomoću VS code integrisanog terminala. Još informacija: Korišćenje proširenja Visual Studio Code (verzija za pregled)
Dodatna 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 drugi 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