Deli putem


Uputstvo: Korišćenje usluge Microsoft Power Platform CLI sa uslugom Power Pages

U ovom vodiču ćete naučiti kako da počnete da koristite Microsoft Power Platform CLI za ažuriranje konfiguracije uzorka veb sajta.

Belešku

  • Ovaj vodič se fokusira na potrebne Microsoft Power Platform CLI komande za upotrebu sa uslugom Power Pages. Za više informacija o komandama koje se koriste u usluzi Power Platform CLI, pročitajte Uobičajene komande.
  • Počevši od CLI verzije Power Platform 1.27, komanda pac paportal se menja u pac powerpages. paportal nastavlja da radi, ali preporučujemo da koristite powerpages ide napred.

Preuzmite i instalirajte Visual Studio Code

Da biste se povezali sa Power Apps portalima, i koristili Microsoft Power Platform CLI naredbe, koristite Visual Studio Code i integrisani terminal. Integrisani terminal olakšava povezivanje sa Dataverse okruženjem i za preuzimanje, promenu i otpremanje konfiguracije portala. Takođe možete da koristite i Windows PowerShell.

Korak 1. Potvrdite identitet

Pre nego što se povežete, izlistate, preuzmete ili otpremite bilo kakve promene za Power Apps portal, morate prvo da potvrdite identitet za Dataverse okruženje. Za više informacija o potvrđivanju identiteta pomoću Microsoft Power Platform CLI interfejsa, idite na pac auth.

Da biste potvrdili identitet, otvorite Windows PowerShell i pokrenite komandu pac auth create koristeći URL adresu svog Dataverse okruženja:

pac auth create -u [Dataverse URL]

Primer

pac auth create -u https://contoso-org.crm.dynamics.com

Sledite uputstva za potvrdu identiteta da biste se prijavili u okruženje.

Primer kako se potvrđuje identitet na Dataverse okruženju korišćenjem Microsoft Power Platform CLI interfejsa

2. korak Navedite dostupne veb-lokacije

Koristite komandu pac poverpages list da biste naveli dostupne Power Pages veb stranice u okruženju na koje Dataverse ste se povezali u prethodnom korak.

pac powerpages list

Primer liste veb-lokacija.

3. korak Preuzmite sadržaj veb-lokacije

Preuzmite sadržaj sajta iz povezanog Dataverse okruženja pomoću komande za preuzimanje pac poverpages.

pac powerpages download --path [PATH] -id [WebSiteId-GUID] --modelVersion [DataModel]

Primer

pac powerpages download --path c:\pac-portals\downloads -id d44574f9-acc3-4ccc-8d8d-85cf5b7ad141 --modelVersion 2

Za parametar ID koristite WebSiteId dobijen iz rezultata prethodnog koraka.

Tekst koji koriste čitači ekrana.

Belešku

  • Koristite modelVersion1 ili 2 da naznačite da li će podaci o lokaciji koji se otpremaju koristiti standardni (KSNUMKS) ili poboljšani model podataka (KSNUMKS).
  • Pokreni pac powerpages list -v komandu da biste videli koji model podataka se koristi za vašu veb lokaciju. Za više detalja, idite na poboljšani model podataka.

4. korak Promena sadržaja veb-lokacije

Promenite konfiguraciju pomoću usluge Visual Studio Code i sačuvajte promene.

Napomena

Obavezno ažurirajte samo podržane tabele za upotrebu sa Power Platform CLI interfejsom. Za više informacija, pogledajte odeljak Podržane tabele.

Na primer, podrazumevana stranica portala prikazuje tekst poput ovog:

Uzorak teksta stranice portala

Ovaj tekst je vidljiv iz HTML koda veb-stranice:

Visual Studio Code sa istaknutim tekstom koji treba promeniti.

Možete da izmenite ovaj tekst i sačuvate promene:

Tekst ažuriran pomoću usluge Visual Studio Code.

Napojnica

Možete da promenite lokaciju putanje fascikle u PowerShell/integrisanom terminalu na lokaciju preuzimanja i unesete „code .“ da biste otvorili fasciklu direktno u usluzi Visual Studio Code.

Korak 5. Otpremite promene

Napomena

Nakon što potrebne izmene, otpremite ih pomoću komande pac poverpages upload :

pac powerpages upload --path [Folder-location] --modelVersion [ModelVersion]

Primer

pac powerpages upload --path C:\pac-portals\downloads\custom-portal\ --modelVersion 2

Pokretanje otpremanja.

Belešku

Uverite se da je putanja za sadržaj portala koji ste uneli tačna. Podrazumevano se kreira fascikla koju je imenovao portal (prepoznatljivo ime) sa preuzetim sadržajem portala. Na primer, ako je prepoznatljivo ime portala custom-portal, putanja za gorenavedenu naredbu (--path) treba da bude C:\pac-portals\downloads\custom-portal.

Učitavanje se dešava samo za sadržaj koji se menja. U ovom primeru, s obzirom da je napravljena promena na veb-stranici, sadržaj se otprema samo za tabelu adx_webpage.

Otpremanje je završeno samo za promenjeni sadržaj.

Otpremanje promena pomoću profila primene

Kada radite sa više različitih okruženja, možete razmisliti o korišćenju profila za raspoređivanje kako biste osigurali da se promene učitaju u ispravno okruženje koristeći profil primene.

  1. Kreirajte fasciklu pod imenom deployment-profiles unutar fascikle koja sadrži sadržaj portala. Na primer, ako se preuzeti sadržaj portala nalazi unutar "starter-portal", fascikla profila za primenu bi trebalo da se nalazi u ovoj fascikli.

    Fascikla za profile za primenu

  2. Unutar fascikle profila za primenu, kreirajte YAML datoteku za primenu koja sadrži promene specifične za okruženje. Na primer, razvojno okruženje se može nazvati "dev.deployment.yml".

    YAML datoteka za razvojni profil za primenu

  3. Uredite YAML datoteku primene koristeći Visual Studio Code sa sledećim formatom:

    <table-name>:
    - <record-id>: <GUID>
      <column-name>: <Name>
      <column-value>: <Value>
    

    Na primer, sledeći uzorak YAML koda ažurira vrednost za "sufiks naslova pregledača" sa podrazumevanog "prilagođeni portal" na "prilagođeni portal (Razvoj)".

    adx_contentsnippet:
        - adx_contentsnippetid: 76227a41-a33c-4d63-b0f6-cd4ecd116bf8 # Replace with your content snippet ID
          adx_name: Browser Title Suffix # Setting name
          adx_value:  &nbsp;· Custom Portal (Dev) # Setting value
    
  4. Da biste otpremili promene u drugo okruženje pomoću YAML datoteke profila za primenu, prvo potvrdite verodostojnost ciljne organizacije.

  5. Nakon autentifikacije i povezan sa ispravnim okruženjem, koristite komandu za otpremanje pac poverpages da biste otpremili sadržaj:

    pac powerpages upload --path "C:\portals\starter-portal" --deploymentProfile dev --modelVersion 2

    Belešku

    U gorenavedenom primeru, ime profila primene koje se koristi je "dev" nakon prethodnih koraka za kreiranje dev profila za primenu. Promenite ime iz "dev" u bilo koje drugo (kao što je QA za "qa.deployment.yml" ili Test za "test.deployment.yml") ako ste koristili drugo ime datoteke za primenu YAML datoteke.

Korak 6. Potvrdite promene

Da biste potvrdili promene izvršene na veb-stranici:

  1. Izaberite stavku Sinhronizuj u Power Pages studiju za dizajniranje.

  2. Da biste videli promenu, pređite na veb stranicu.

    Prikažite ažurirani sadržaj stranice.

  3. Ako ste koristili prethodno objašnjeni primerprofila razmene, IAML isečak ažurira vrednost kao što je prikazano na sledećem ekranu.

    Sufiks naslova pregledača iz aplikacije „Upravljanje portalom“

    Sufiks naslova pregledača ažuriran gorenavedenom promenom prikazuje promenu kada otvorite portal u pregledaču:

    Promena pregledača

Ovim se uputstvo završava. Možete da ponovite gorenavedene korake i promenite sadržaj portala drugim podržanim tabelama.

Sledeći koraci

Koristite ekstenziju Visual Studio koda

Pogledajte i ovo