Podpora vmesnika Microsoft Power Platform CLI za storitev Power Pages

Vmesnik Microsoft Power Platform CLI (vmesnik ukazne vrstice) je preprost, celovit vmesnik ukazne vrstice za razvijalce, ki razvijalcem in izdelovalcem aplikacij omogoča ustvarjanje komponent kode.

Orodje Microsoft Power Platform CLI je prvi korak k celoviti zgodbi upravljanja življenjskega cikla aplikacij (ALM), v kateri lahko razvijalci podjetja in neodvisni proizvajalci hitro in učinkovito ustvarjajo, gradijo, odpravljajo napake in objavljajo svoje razširitve in prilagoditve. Če želite več informacij, glejte Kaj je Microsoft Power Platform CLI?

S to funkcijo vmesnik Microsoft Power Platform CLI omogoča CI/CD (neprekinjena integracija/neprekinjena razmestitev) konfiguracije spletnega mesta Power Pages. Zdaj lahko prijavite konfiguracijo spletnega mesta v kontrolnik vira in jo premaknete v katero koli okolje, ki uporablja vmesnik Microsoft Power Platform CLI.

opomba,

• Ta funkcija je običajno na voljo od različice vmesnika ukazne vrstice Power Platform 1.9.8. Če želite izvedeti več o namestitvi najnovejše različice, pojdite na Namestitev Microsoft Power Platform CLI.
• Začenši z Power Platform različico CLI 1.27, pac paportal se ukaz spremeni v pac powerpages. paportal Še naprej deluje, vendar priporočamo, da uporabite powerpages nadaljevanje. Ta članek bo kmalu posodobljen za uporabo powerpages namesto tega paportal.

Zakaj uporabljati vmesnik Microsoft Power Platform CLI za razvoj spletnih mest?

Z vmesnikom Microsoft Power Platform CLI lahko zdaj za prilagajanje spletnih mest uporabljate zmogljivosti, kot bi bili v načinu brez povezave, tako da spreminjate vsebino spletnih mest. Ko so vse prilagoditve ali spremembe shranjene, lahko spletno konfiguracijo naložite nazaj v Microsoft Dataverse. Ko prenašate vsebino spletnega mesta z vmesnikom Microsoft Power Platform CLI, je vsebina strukturirana v oblikah zapisa YAML in HTML, kar olajša prilagajanje in omogoča profesionalno razvojno izkušnjo.

Spodaj je seznam funkcij in zmogljivosti, ki jih portali pridobijo s podporo vmesnika ukazne vrstice za Microsoft Power Platform:

Enostavnost uporabe

• Podpora za prenos/nalaganje podatkov spletne konfiguracije v/iz lokalnega datotečnega sistema

• Nadgradite obstoječe orodje vmesnika ukazne vrstice za Microsoft Power Platform.

Upravljanje življenjskega cikla programov (ALM)

• Sledite spremembam v konfiguraciji spletnega mesta znotraj organizacije

• Premikajte konfiguracijske datoteke med organizacijami ali najemniki

Podpora za profesionalne razvijalce in podjetja

• Pomaga pri nemoteni integraciji z vsemi orodji kontrolnikov za vire, kot je »git«

• Preprosta nastavitev lijakov CI/CD

Namestitev vmesnika ukazne vrstice za Microsoft Power Platform

Navodila po korakih najdete tukaj: Namestitev vmesnika ukazne vrstice storitve Microsoft Power Platform.

Podprte tabele

Podpora portalov za Microsoft Power Platform CLI je omejena na naslednje 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 prenos)

adx_websitelanguage

adx_webtemplate

opomba

Pomembno

• Tabele po meri in tabele, ki temeljijo na predlogi portala (na primer portal za spletni dnevnik, skupnost ali ideje), niso podprte za prilagajanje z vmesnikom ukazne vrstice za Microsoft Power Platform.
• Priloge slikovnih datotek k oglasnim zapisom (adx_ad) se ne prenašajo z uporabo CLI Power Platform. Kot rešitev uporabite polje URL slike ali v polje Kopiraj dodate sklic HTML v zapis spletne datoteke, ki vsebuje slikovno datoteko.

Namestitev in preverjanje vmesnika ukazne vrstice za Microsoft Power Platform za portale

Če želite izvedeti več o namestitvi vmesnika ukazne vrstice za Microsoft Power Platform, odprite Namestitev vmesnika ukazne vrstice za Microsoft Power Platform.

Po namestitvi vmesnika ukazne vrstice (CLI) za Microsoft Power Platform, odprite ukazni poziv in zaženite pac, da preverite, ali izhod vsebuje »paportal« – ukaz za portale Power Apps.

Ukazi vmesnika ukazne vrstice za Microsoft Power Platform za portale

Ukaz vmesnika ukazne vrstice za Microsoft Power Platform za portale je »paportal«.

Naslednji razdelki vsebujejo dodatne podrobnosti o različnih lastnostih ukaza »paportal«.

Parametri

Ime lastnosti	Opis	Primer
seznam	Navaja vsa spletna mesta portala iz trenutnega okolja Dataverse. Dodate lahko parameter -v, ki označuje, ali spletno mesto uporablja standardni ali izboljšani podatkovni model	pac paportal list
prenos	Prenesite vsebino spletnega mesta portala iz trenutnega okolja Dataverse. Ima naslednje parametre: - pot: Pot, kamor se prenese vsebina spletnega mesta (vzdevek: -p) - webSiteId: ID spletnega mesta portala za prenos (alias: -id) - overwrite: (izbirno) true – za prepis obstoječe vsebine; false – za neuspešno izvajanje, če mapa že vsebuje vsebino spletnega mesta (alias: -o) - modelVersion: 1 ali 2 za označevanje, ali podatki spletnega mesta, ki jih želite prenesti, uporabljajo standardni (1) ali izboljšani podatkovni model [2].	pac paportal download --path "C:\portals" --webSiteId f88b70cc-580b-4f1a-87c3-41debefeb902 --modelVersion 2
nalaganje	Naložite vsebino spletnega mesta portala v trenutno okolje Dataverse. Ima naslednji parameter: - path: pot, kjer je shranjena vsebina spletnega mesta (alias: -p) -deploymentProfile: naložite podatke portala s podrobnostmi o okolju, ki jih določajo spremenljivke profila v datoteki deployment-profiles/[profile-name].deployment.yaml - modelVersion:ali 1 za označevanje, ali podatki spletnega mesta, ki jih želite naložiti, 2 uporabljajo standardni (1) ali izboljšani podatkovni model [2].	pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile "profile-name" --modelVersion 2

Uporabite profil uvajanja

Stikalo deploymentProfile omogoča, da določite niz spremenljivk za okolje v formatu YAML. Na primer, lahko imate različne profile uvajanja (kot so dev, test, prod), ki imajo v profilu določene različne podrobnosti sheme.

Če ustvarjate preskusni profil, lahko datoteko ustvarite v razdelku deployment-profiles z imenom "test.deployment.yml" (oz., <profileTag>.deployment.yml). Za uporabo tega profila lahko izvedete ukaz z oznako (<profileTag>):

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

V tej datoteki lahko imate ime tabele (entitete) z ID-jem tabele, seznamom atributov in vrednostmi, ki jih želite preglasiti med nalaganjem konfiguracije portala z uporabo parametra deploymentProfile.

Poleg tega lahko uporabite spremenljivko OS za dostop do spremenljivk okolja operacijskega sistema.

Tu je primer datoteke YAML profila "test.deployment.yml", ki vsebuje enolične podrobnosti 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

opomba,

Za več informacij o vseh ukazih, ki se poleg portalov uporabljajo v vmesniku ukazne vrstice, odprite Pogosti ukazi v vmesniku ukazne vrsticeMicrosoft Power Platform.

Manifestne datoteke

Ko prenesete vsebino spletnega mesta z ukazom pac paportal, prenesite CLI in skupaj s prenosom vsebine spletnega mesta ustvari tudi dve manifestni datoteki;

• Datoteka okoljskega manifesta (org-url-manifest.yml)
• Datoteko manifesta o brisanju sledenja (manifest.yml)

Datoteka okoljskega manifesta (org-url-manifest.yml)

Datoteka okoljskega manifesta se ustvari vsakič, ko se izvaja ukaz prenos pac paportal.

Po vsakem prenosu orodje vmesnika ukazne vrstice PAC prebere obstoječo datoteko manifesta okolja in posodobi vnose, izbrisane v okolju, ali ustvari datoteko manifesta okolja, če ta ne obstaja.

Ko zaženete ukaz prenos pac paportal za nalaganje vsebine spletnega mesta portala. Prebere datoteko okoljskega manifesta in prepozna spremembe, narejene od zadnjega prenosa, ter naloži samo posodobljeno vsebino. To pomaga pri optimizaciji postopka prenosa, saj se naloži samo posodobljena vsebina spletnega mesta, namesto da bi se naložila vsa vsebina ob vsakem ukazu za prenos.

Datoteka manifesta okolja je samo za branje, ko se poveže z istim okoljem (URL okolja se ujema z imenom datoteke), da se preprečijo nenamerne spremembe.

opomba,

• Datoteka manifesta okolja ni zasnovana za sledenje spremembam pri uvajanju spletnega mesta v različna okolja.
• Datoteka manifesta okolja je zasnovana tako, da jo razvijalci uporabljajo za lokalno uvajanje v svojem razvijalskem okolju in jo je treba dodati na seznam prezrtih git.

Datoteko manifesta o brisanju sledenja (manifest.yml)

Ta datoteka se uporablja za sledenje izbrisanim zapisom iz okolja.

Ko prenesete vsebino spletnega mesta z ukazom za prenos pac paportala, s tem dodate izbrisane zapise iz datoteke manifesta okolja (org-url-manifest.yml) v manifest.yml datoteko. Torej, ko naložite vsebino spletnega mesta z ukazom za nalaganje pac paportala, izbriše datoteke iz okolja (tudi v drugo okolje). Ta datoteka se ne izbriše in se uporablja ne glede na to, s katerim okoljem ste povezani. To datoteko je treba upoštevati, ko vnašate spremembe v nadzor izvorne kode, da lahko razmislite o brisanju elementov v ciljnem okolju.

opomba,

Če želite izbrisati zapise vsebine mesta v enem okolju in poleg tega izbrisati iste zapise vsebine v drugem okolju z uporabo PAC CLI, boste morali izvajati ukaz prenos pac paportalpred brisanjem vsebine zapisa spletnega mesta in po njem. Manifest.yml bo sledil tem spremembam in odstranil ustrezne zapise v ciljnem okolju, ko bo izvajan ukaz prenos pac paportal.

Uporaba razširitve za kodo za Visual Studio Code

Uporabite lahko tudi razširitev VS Code Razširitev Power Platform VS Code, da izkoristite vgrajeni jezik Liquid storitve IntelliSense, pomoč pri dokončanju kode, zagotavljanje namigov in interakcijo z vmesnikom Microsoft Power Platform CLI z uporabo integriranega terminala z VS Code. Več informacij: Uporaba razširitve za Visual Studio Code (predogledna različica)

Nadaljnji premisleki

• Pojavila se bo napaka, če pot do datoteke presega največjo omejitev dolžine poti. Več informacij: Omejitev največje dolžine poti v sistemu Windows
• Za podvojene zapise, kot je podvojeno ime spletne strani, vmesnik Microsoft Power Platform CLI ustvari dve različni mapi – eno z imenom spletne strani ter drugo z istim imenom in predpono hash code (zgoščena vrednost). Na primer "My-page" in "My-page-hash-code".

Naslednji koraki

Vadnica: uporaba vmesnika Microsoft Power Platform CLI s portali

Glejte tudi

• Microsoft Power Platform CLI
• Uporaba razširitve za Visual Studio Code (predogledna različica)