Deli putem


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 u pac powerpages. paportal nastavlja da radi, ali preporučujemo korišćenje unapred powerpages . Ovaj članak će uskoro biti ažuriran da bi se koristio powerpages umesto paportal.

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.

Potvrdite komandu „paportal“ u Microsoft Power Platform CLI interfejsu.

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

Pogledajte i ovo