Dijeli putem

Podrška portala za Microsoft Power Platform CLI

Napomena

Od 12. listopada 2022. portali Power Apps postaju Power Pages. Više informacija: Usluga Microsoft Power Pages je sada javno dostupna (blog)
Uskoro ćemo migrirati i spojiti dokumentaciju za portale Power Apps s dokumentacijom za Power Pages.

Microsoft Power Platform CLI (sučelje naredbenog retka) jednostavno je sučelje naredbenog retka za programere na jednom mjestu koje programerima 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. Više informacija potražite u odjeljku Što je Microsoft Power Platform CLI?

Uz ovu značajku, Microsoft Power Apps portali podržavaju Microsoft Power Platform CLI kako bi omogućili CI /CD (Kontinuirana integracija / Kontinuirana implementacija) konfiguracije portala. Sada možete provjeriti konfiguraciju portala za kontrolu izvora i premjestiti konfiguraciju portala u bilo koje okruženje pomoću Microsoft Power Platform CLI-ja.

Napomena

Ova je značajka općenito dostupna počevši od Power Platform CLI verzije 1.9.8. Da biste saznali više o instalaciji najnovije verzije, pogledajte Instaliranje Microsoft Power Platform CLI-ja.

Zašto koristiti Microsoft Power Platform CLI za razvoj portala?

Uz podršku portala za Microsoft Power Platform CLI, sada možete koristiti izvanmrežne mogućnosti za prilagodbu portala unošenjem promjena u sadržaj portala. A nakon što su sve prilagodbe ili promjene spremljene, prenesite ih na portal. Kada preuzimate sadržaj portala 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 portala 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 portala 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 tablice u nastavku.

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.

Potvrdite naredbu paportala u Microsoft Power Platform CLI.

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. pac paportal list
preuzmi Preuzmite sadržaj web-mjesta portala iz trenutačnog okruženja Dataverse. Ima sljedeće parametre:
- putanja: putanja s koje će se preuzeti sadržaj web-mjesta (pseudonim: -p)
- webSiteId : ID web-stranice portala za preuzimanje (pseudonim: -id)
- prepisati: (neobavezno) true – za prepisivanje postojećeg sadržaja, false – za neuspjeh ako mapa već ima sadržaj web mjesta (pseudonim: -o)		 pac paportal download --path "C:\portals" --webSiteId f88b70cc-580b-4f1a-87c3-41debefeb902
prenesi Prenesite sadržaj web-mjesta portala u trenutačno okruženje Dataverse. Ima sljedeće parametre:
- putanja: putanja mjesta gdje će se spremiti sadržaj web-mjesta (pseudonim: -p)
-deploymentProfile: Prenesite podatke portala s pojedinostima okruženja definiranim putem varijable profila u datoteci deployment-profiles/[profile-name].deployment.yaml		 pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile "profile-name"
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 implementacijski profili s nazivom „test.deployment.yml” (tj. <profileTag>.deployment.yml). I možete pokrenuti naredbu s oznakom (<profileTag>) da biste koristili ovaj profil:

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

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

Kad preuzmete sadržaj web stranice s pomoću naredbe pac paportal download za CLI, sadržaj stranice će se preuzeti i generirat će se dvije 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 generira se svaki put kad se pokrene naredba pac paportal download.

Nakon svakog preuzimanja, PAC CLI alat č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 moći će se samo čitati kad se poveže s istim okruženjem (kad URL okruženja odgovara nazivu datoteke) kako bi se izbjegle slučajne promjene.

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 preuzima naredbom pac paportal download, zapisi izbrisani iz datoteka manifesta okruženja (org-url-manifest.yml) dodat će se u datoteku manifest.yml. Dakle, kad prenesete sadržaj web-mjesta s pomoću naredbe pac paportal upload, ona će izbrisati datoteke iz okruženja (čak i u drugom okruženju). Ova se datoteka ne briše i koristi se bez obzira na to u kojem ste okruženju povezani.

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 download prije 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 proširenje Power Platform VS koda VS proširenje koda u korist ugrađenog tekućeg jezika tvrtke IntelliSense, pomoći pri dovršavanju koda, nagovještavanja i interakcije s Microsoft Power Platform CLI-jem pomoću integriranog terminala 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č: Korištenje Microsoft Power Platform CLI-ja s portalima

Pogledajte također

  • Last updated on