Podrška za Microsoft Power Platform CLI za Power Pages

Microsoft Power Platform CLI (sučelje naredbenog retka) jednostavno je sučelje naredbenog retka za razvojne inženjere na jednom mjestu koje razvojnim inženjerima i proizvođačima aplikacija omogućuje stvaranje komponenti koda.

Alati Microsoft Power Platform CLI prvi su korak prema sveobuhvatnoj priči o upravljanju životnim ciklusom aplikacija (ALM) u kojoj brzo i učinkovito razvojni inženjeri i ISV-ovi mogu stvarati, graditi, ispravljati pogreške i objavljivati svoja proširenja i prilagodbe. Dodatne informacije potražite u odjeljku Što je Microsoft Power Platform CLI?

Uz ovu značajku Microsoft Power Platform CLI podržava CI/CD (kontinuirana integracija/kontinuirano postavljanje) konfiguracije web-mjesta Power Pages. Sada možete prijaviti konfiguraciju web-mjesta za kontrolu izvora i premjestiti konfiguraciju web-mjesta u bilo koje okruženje koje upotrebljava Microsoft Power Platform CLI.

Napomena

• Ova je značajka općenito dostupna počevši od Power Platform CLI verzije 1.9.8. Dodatne informacije o instalaciji najnovije verzije potražite u članku Instaliranje Microsoft Power Platform CLI-ja.
• Počevši od Power Platform CLI verzije 1.27, pac paportal naredba se mijenja u pac powerpages. paportal nastavlja raditi, ali preporučujemo da ubuduće koristite powerpages . Ovaj će se članak uskoro ažurirati za upotrebu powerpages umjesto paportal.

Zašto upotrebljavati Microsoft Power Platform CLI za razvoj web-mjesta?

Uz podršku usluge Microsoft Power Platform CLI, sada možete upotrebljavati izvanmrežne mogućnosti za prilagodbu web-mjesta unošenjem promjena u sadržaj web-mjesta. A nakon što su sve prilagodbe ili promjene spremljene, konfiguraciju web-mjesta možete prenijeti natrag na uslugu Microsoft Dataverse. Kada preuzimate sadržaj web-mjesta s pomoću Microsoft Power Platform CLI-ja, sadržaj je strukturiran u formatima YAML i HTML što olakšava prilagodbu, omogućujući razvojno iskustvo.

Evo popisa značajki i mogućnosti koje portali koriste uz podršku za Microsoft Power Platform CLI:

Jednostavnost korištenja

• Podrška za preuzimanje/prijenos podataka o konfiguraciji web-mjesta u lokalni datotečni sustav / iz lokalnog datotečnog sustava

• Nadovezujte se na postojeći alat Microsoft Power Platform CLI.

Upravljanje životnim ciklusom aplikacije (ALM)

• Praćenje promjena u konfiguraciji web-mjesta unutar tvrtke ili ustanove

• Premještanje konfiguracijskih datoteka u tvrtke ili ustanove ili klijente

Pro-razvojna i poslovna podrška

• Pomaže u neprimjetnoj integraciji s bilo kojim alatima za kontrolu izvora, kao što je "git"

• Jednostavno postavljanje kanala CI/CD

Instalacija Microsoft Power Platform CLI

Za detaljne upute pogledajte Instalacija Microsoft Power Platform CLI.

Podržane tablice

Podrška portala za Microsoft Power Platform CLI ograničena je na sljedeće tablice.

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

primjedba

Važno

• Prilagođene tablice i tablice specifične za predložak portala (poput bloga, zajednice ili portala ideja) nisu podržane za prilagodbu s pomoću Microsoft Power Platform CLI.
• Privitci zapisima oglasa (adx_ad) u obliku slikovnih datoteka ne preuzimaju se s pomoću sučelja Power Platform CLI. Umjesto toga, upotrijebite polje URL slike ili u polje Kopiraj dodajte HTML referencu za zapis web datoteke koji sadržava slikovnu datoteku.

Instalirajte i provjerite Microsoft Power Platform CLI za portale

Da biste saznali više o instalaciji Microsoft Power Platform CLI, idite na Instalacija Microsoft Power Platform CLI.

Nakon instalacije sučelja Microsoft Power Platform CLI, otvorite naredbeni redak i pokrenite pac kako biste provjerili sadržava li izlaz „paportal” naredbu za portale Power Apps.

Naredbe za portale Microsoft Power Platform CLI

Naredba za portale Microsoft Power Platform CLI je „paportal”.

Sljedeći odjeljci sadržavaju dodatne pojedinosti o različitim svojstvima naredbe „paportal”.

Parametri

Naziv svojstva	Opis	Primjer
popis	Popis svih web-mjesta portala iz trenutačnog okruženja Dataverse. Možete dodati parametar -v za označavanje upotrebljava li stranica standardni ili poboljšani podatkovni model	pac paportal list
preuzimanje	Preuzmite sadržaj web-mjesta portala iz trenutačnog okruženja Dataverse. Ima sljedeće parametre: - put: Put na kojem se preuzima sadržaj web-mjesta (pseudonim: -p) - webSiteId: ID web-mjesta portala za preuzimanje (pseudonim: -id) - overwrite: (izborno) true – za prepisivanje postojećeg sadržaja; false – za neuspjeh ako mapa već ima sadržaj web-mjesta (pseudonim: -o) - modelVersion: 1 ili 2 da biste naznačili koriste li podaci web-mjesta za preuzimanje standardni (1) ili poboljšani podatkovni model (2).	pac paportal download --path "C:\portals" --webSiteId f88b70cc-580b-4f1a-87c3-41debefeb902 --modelVersion 2
prijenos	Prenesite sadržaj web-mjesta portala u trenutačno okruženje Dataverse. Ima sljedeće parametre: - path: putanja mjesta gdje će se spremiti sadržaj web-mjesta (pseudonim: -p) -deploymentProfile: prijenos podatak portala s pojedinostima okruženja definiranim putemvarijablama profila u datoteci deployment-profiles/[profile-name].deployment.yaml - modelVersion: 1 ili 2 da biste naznačili koriste li podaci web-mjesta za prijenos standardni (1) ili poboljšani podatkovni model (2).	pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile "profile-name" --modelVersion 2

Upotreba profila implementacije

Promjena deploymentProfile omogućuje definiranje skupa varijabli za okruženje u formatu YAML. Na primjer, možete imati različite profile implementacije (kao što su dev, test, prod) koji imaju različite pojedinosti sheme definirane u profilu.

Ako stvarate testni profil, datoteku možete stvoriti pod stavkom deployment-profiles s nazivom "test.deployment.yml" (to je, <profileTag>.deployment.yml). I možete pokrenuti naredbu s oznakom (<profileTag>) da biste upotrebljavali ovaj profil:

pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile test --modelVersion 2

U ovoj datoteci možete imati naziv tablice (entiteta) s ID -om tablice, popisom atributa i vrijednostima koje želite nadjačati tijekom prijenosa konfiguracije portala s pomoću parametra deploymentProfile.

Osim toga, možete koristiti i varijablu OS za pristup varijablama okruženja operacijskog sustava.

Evo primjera ovog profila datoteke YAML „test.deployment.yml" koja ima jedinstvene pojedinosti sheme:

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 osim u portalima koriste u CLI-u, idite na Uobičajene naredbe u Microsoft Power Platform CLI.

Datoteke manifesta

Kada preuzmete sadržaj web stranice pomoću pac paportal preuzmite CLI naredbu, zajedno s preuzimanjem sadržaja web stranice, ona također generira dvije 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 generira se svaki put kad se pokrene naredba pac paportal download.

Nakon svakog preuzimanja alat PAC CLI čita postojeću datoteku manifesta okruženja i ažurira unose izbrisane u okruženju ili stvara datoteku manifesta okruženja ako ne postoji.

Kad izvršite naredbu pac paportal upload za prijenos sadržaja web-mjesta portala. Čita datoteku manifesta okruženja i identificira promjene koje su napravljene od zadnjeg preuzimanja i prenosi samo ažurirani sadržaj. Na taj se način optimizira proces prijenosa jer se prenosi samo ažurirani sadržaj web-mjesta, a ne cijeli sadržaj pri svakoj naredbi za prijenosom.

Datoteka manifesta okruženja je samo za čitanje kada se poveže s istim okruženjem (URL okruženja podudara se s nazivom datoteke) kako bi se izbjegle slučajne promjene.

Napomena

• Datoteka manifesta okruženja nije dizajnirana za praćenje promjena prilikom postavljanja web-mjesta u različita okruženja.
• Datoteka manifesta okruženja dizajnirana je za razvojne inženjere radi lokalnu implementaciju u njihovom okruženju razvojnog inženjera i treba je dodati na popis zanemarivanja git.

Brisanje datoteke manifesta praćenja (manifest.yml)

Ova datoteka upotrebljava se za praćenje izbrisanih zapisa iz okruženja.

Kada se sadržaj web-mjesta preuzme naredbom pac paportal download , time se izbrisani zapisi iz datoteke manifesta okruženja (org-url-manifest.yml) dodaju u manifest.yml datoteku. Dakle, kada prenesete sadržaj web stranice pomoću naredbe pac paportal upload , ona briše datoteke iz okruženja (čak iu drugo okruženje). Ova se datoteka ne briše i upotrebljava se neovisno o okruženju s kojim ste povezani. Ovu datoteku treba uzeti u obzir prilikom unosa promjena u kontrolu izvora kako bi se razmotrilo brisanje stavki u ciljnom okruženju.

Napomena

Kako biste izbrisali zapise o sadržaju web-mjesta u jednom okruženju i također izbrisali iste zapise o sadržaju u drugom okruženju s pomoću alata PAC CLI, izvršite naredbu pac paportal downloadprije i nakon brisanja sadržaja zapisa web-mjesta. Manifest.yml pratit će ove promjene i ukloniti odgovarajuće zapise u ciljnom okruženju kad izvršite naredbu pac paportal upload.

Upotreba proširenja Visual Studio Code

Također možete koristiti VS Code proširenje Power Platform VS Code proširenje da biste iskoristili ugrađeni jezik Liquid od IntelliSensea, pomoć u dovršenju koda, nagovještavanje i interakciju s Microsoft Power Platform CLI s pomoću integriranog terminala za VS Code. Dodatne informacije: Upotreba proširenja Visual Studio Code (pretpregled)

Dodatne napomene

• Pogreška se prijavljuje ako putanja datoteke premašuje ograničenje maksimalne duljine putanje. Više informacija: Ograničenje maksimalne duljine putanje u sustavu Windows
• Za dvostruke zapise, poput dvostrukog naziva web-stranice, Microsoft Power Platform CLI stvara dvije različite mape jednu s nazivom web-stranice, a drugu s istim nazivom s prefiksom koda za raspršivanje. Na primjer, „Moja stranica" i „Moja stranica–kod za raspršivanje”.

Sljedeći koraci

Vodič: upotreba Microsoft Power Platform CLI-ja s portalima

Pogledajte

• Microsoft Power Platform CLI
• Korištenje proširenja Visual Studio Code (pretpregled)