Deli z drugimi prek

Podpora portalov za vmesnik ukazne vrstice za Microsoft Power Platform

Opomba

Od 12. oktobra 2022 najprej je portal Power Apps Power Pages. Več informacij: Microsoft Power Pages je zdaj splošno dostopen (spletni dnevnik)
Dokumentacijo portalov Power Apps bomo kmalu preselili in združili z dokumentacijo za Power Pages.

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. Za več informacij glejte Kaj je Microsoft Power Platform CLI?.

S to funkcijo Microsoft Power Apps portali podpirajo Microsoft Power Platform CLI, da omogočijo CI/CD (neprekinjeno integracijo/neprekinjeno uvajanje) konfiguracije portala. Zdaj lahko preverite konfiguracijo portala za nadzor vira in premaknete konfiguracijo portala v poljubno okolje z uporabo 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, glejte Namesti vmesnik orodne vrstice Microsoft Power Platform.

Zakaj uporabljati vmesnik ukazne vrstice za Microsoft Power Platform za razvoj portalov?

S podporo portalov za vmesnik ukazne vrstice za Microsoft Power Platform lahko zdaj za prilagajanje portalov uporabljate zmogljivosti, kot bi bili v načinu brez povezave, tako da spreminjate vsebino portalov. Ko so vse prilagoditve ali spremembe shranjene, jih naložite na portal. Ko prenašate vsebino portalov z vmesnikom ukazne vrstice za Microsoft Power Platform, 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 portala 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 portala 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 za portale za vmesnik ukazne vrstice za Microsoft Power Platform je omejen na spodnje 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.

Potrdite ukaz paportal v vmesniku ukazne vrstice za Microsoft Power Platform.

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 Description Primer
seznam Navaja vsa spletna mesta portala iz trenutnega okolja Dataverse. pac paportal list
prenos Prenesite vsebino spletnega mesta portala iz trenutnega okolja Dataverse. Ima naslednje parametre:
- path: pot, kamor bo prenesena vsebina spletnega mesta (alias: -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)		 pac paportal download --path "C:\portals" --webSiteId f88b70cc-580b-4f1a-87c3-41debefeb902
naloži 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 mapi razporeditev-profili/[ime-profila].deployment.yaml		 pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile "profile-name"
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 razporeditev-profili z imenom "test.deployment.yml" (tj. <profileTag>.deployment.yml). Za uporabo tega profila lahko izvedete ukaz z oznako (<profileTag>):

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

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 uporabo ukaza vmesnika ukazne vrstice prenos pac paportal, bo skupaj s prenosom vsebine spletnega mesta ustvaril 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 PAC CLI 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 okoljskega manifesta bo samo za branje, ko se poveže z istim okoljem (URL okolja se ujema z imenom datoteke), da se izognete nenamernim spremembam.

Datoteko manifesta o brisanju sledenja (manifest.yml)

Ta datoteka se uporablja za sledenje izbrisanim zapisom iz okolja.

Ko se vsebina spletnega mesta prenese z ukazom prenos pac paportal, se s tem doda izbrisane zapise iz datoteke okoljskega manifesta (org-url-manifest.yml) v datoteko manifest.yml. Torej, ko naložite vsebino spletnega mesta z uporabo ukaza prenos pac paportal, boste s tem izbrisali datoteke iz okolja (tudi v drugem okolju). Ta datoteka se ne izbriše in se uporablja ne glede na to, s katerim okoljem ste povezani.

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 paportal pred 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 kode VS Power Platform Razširitev kode VS, da izkoristite vgrajeni jezik Liquid iz IntelliSense, pomoč pri dokončanju kode, namige in interakcijo z Microsoft Power Platform CLI z uporabo integriranega terminala kode VS. Več informacij: Uporaba razširitve za Visual Studio Code (predogledna različica)

Dodatni 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 ukazne vrstice za Microsoft Power Platform 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 ukazne vrstice za Microsoft Power Platform s portali

Glejte tudi

  • Last updated on