Dijeli putem

Vodič: Upotreba Microsoft Power Platform CLI-ja s uslugom Power Pages

  • Članak

U ovom primjeru vodiča vidjet ćete kako započeti upotrebljavati Microsoft Power Platform CLI za ažuriranje uzorka konfiguracije web-mjesta.

Napomena

  • Ovaj se vodič usredotočuje na potrebne naredbe za Microsoft Power Platform CLI za upotrebu usluge Power Pages. Više informacija o naredbama koje se koriste u CLI-ju platforme Power Platform možete pornaći u odjeljku Uobičajene naredbe.
  • 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.

Preuzimanje i instalacija značajke Visual Studio Code

Za povezivanje na portale Power Apps i za upotrebu komandi Microsoft Power Platform CLI, koristite Visual Studio Code i integrirani terminal. Integrirani terminal olakšava povezivanje s Dataverse okruženjem te za preuzimanje, promjenu i prijenos konfiguracije portala. Umjesto toga možete koristiti i Windows PowerShell.

1. korak Provjera autentičnosti

Prije povezivanja navedite, preuzmite ili prenesite sve promjene za portal Power Apps, prvo se morate prijaviti u okruženje Dataverse. Više informacija o provjeri autentičnosti s pomoću sučelja Microsoft Power Platform CLI pronađite na pac auth.

Kako biste provjerili autentičnost, otvorite Windows PowerShell i pokrenite naredbu pac auth create upotrebljavajući svoj URL okruženja Dataverse:

pac auth create -u [Dataverse URL]

Primjer

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

Slijedite upute za provjeru autentičnosti da biste se prijavili u okruženje.

Primjer načina provjere autentičnosti za okruženje Dataverse s pomoću Microsoft Power Platform CLI

2. korak Popis dostupnih web-mjesta

Upotrijebite naredbu Popi pac paportal za popis dostupnih web-mjesta Power Pages u okruženju Dataverse s kojim ste se povezali u prethodnom koraku.

pac paportal list

Primjer popisa web-mjesta.

3. korak Preuzimanje sadržaja web-stranice

Preuzmite sadržaj web-mjesta iz povezanog okruženja Dataverse koristeći naredbu Preuzmi pac paportal.

pac paportal download --path [PATH] -id [WebSiteId-GUID]

Primjer

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

Za parametar id koristite WebSiteId vraćen iz rezultata prethodnog koraka.

Tekst koji upotrebljavaju čitači zaslona.

4. korak Promjena sadržaja web-mjesta

Promijenite konfiguraciju s pomoću značajke Visual Studio Code i spremite promjene.

Napomena

Obavezno ažurirajte samo podržane tablice za upotrebu s Power Platform CLI. Više informacija potražite u odjeljku Podržane tablice.

Na primjer, zadana stranica portala prikazuje tekst poput ovog:

Uzorak teksta stranice portala

Ovaj je tekst vidljiv na html u web-stranice:

Visual Studio Code s istaknutim tekstom za promjenu.

Možete izmijeniti ovaj tekst i spremiti promjene:

Ažuriran tekst s pomoću značajke Visual Studio Code.

Savjet

Možete promijeniti lokaciju putanje mape u PowerShell/integriranom terminalu na preuzeto mjesto i unijeti "kod ." da otvorite mapu izravno u značajci Visual Studio Code.

5. korak Prenošenje promjena

Napomena

  • Ako prenosite u više okruženja, pogledajte prijenos promjena s pomoću profila za uvođenje kako biste naučili kako možete prenijeti promjene s pomoću profila za uvođenje.
  • Osigurajte da je najveća veličina privitka ciljnog okruženja postavljena na istu ili veću veličinu kao vaše izvorno okruženje.
  • Maksimalna veličina datoteka određena je postavkom Maksimalna veličina datoteke u kartici e-pošte postavki sustava u dijaloškom okviru postavki sustava okruženja.

Nakon što napravite potrebne promjene, prenesite ih naredbom pac paportal upload:

pac paportal upload --path [Folder-location]

Primjer

pac paportal upload --path C:\pac-portals\downloads\custom-portal\

Početak prijenosa.

Napomena

Provjerite je li točna putanja za sadržaj portala koji ste unijeli. Prema zadanim postavkama, kreira se mapa koju je portal imenovao (neslužbeni naziv) s preuzetim sadržajem portala. Na primjer, ako je neslužbeni naziv portala custom-portal,, putanja za gornju naredbu (--putanja) trebala bi biti C:\pac-portals\downloads\custom-portal.

Prijenos se događa samo za sadržaj koji je izmijenjen. U ovom primjeru, budući da je promjena izvršena na web-stranici, sadržaj se prenosi samo za tablicu adx_webpage.

Prijenos dovršen samo za promijenjeni sadržaj.

Prenesite promjene s pomoću profila za uvođenje

Kad radite s više različitih okruženja, razmislite o upotrebi profila za uvođenje kako biste osigurali da će se promjene prenijeti točnom okruženju putem profila za uvođenje.

  1. Izradite mapu s nazivom profili-za-uvođenje unutar mape koja sadržava sadržaj portala. Na primjer, ako je preuzeti sadržaj portala unutar "portala-za-početnike", mapa profila za uvođenje trebala bi biti unutar ove mape.

    Mapa za profile za uvođenje

  2. Unutar mape profila za uvođenje izradite datoteku uvođenja YAML koja sadržava promjene specifične za okruženje. Na primjer, razvojno okruženje može se nazvati "dev.deployment.yml".

    Profil za uvođenje YAML za razvoj

  3. Uredite datoteku za uvođenje YAML s pomoću programa Visual Studio Code u sljedećem formatu:

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

    Na primjer, sljedeći primjer koda YAML ažurira vrijednost za "Sufiks naslova preglednika" od zadanog "Prilagođenog portala" na "Prilagođeni portal (Razvojni)".

    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. Za prijenos promjena u drugo okruženje s pomoću datoteke YAML profila za uvođenje, prvo provjerite autentičnost ciljne organizacije.

  5. Nakon provjere autentičnosti i povezivanja s ispravnim okruženjem, upotrijebite naredbu pac paportal upload za prijenos sadržaja:

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

    Napomena

    U gornjem primjeru upotrijebljen je naziv "razvojni" profila za uvođenje nakon prethodnih koraka za izradu razvojnog profila za uvođenje. Zamijenite naziv "razvojni" s odgovarajućim nazivom (npr. QA za "qa.deployment.yml" ili Test za "test.deployment.yml") ako ste upotrijebili drugi naziv datoteke YAML za uvođenje.

6. korak Potvrđivanje promjena

Da biste potvrdili promjene izvršene na web-stranici:

  1. Odaberite Sinkroniziraj u dizajnerskom studiju Power Pages.

  2. Pregledajte web-stranicu da biste vidjeli promjenu.

    Pogledajte ažurirani sadržaj stranice.

  3. Ako ste upotrijebili prethodno objašnjeni primjer profila za uvođenje, isječak YAML ažurirat će vrijednost kao što je prikazano u nastavku.

    Sufiks naslova preglednika iz aplikacije za upravljanje portalom

    Sufiks naslova preglednika ažuriran putem gore navedene promjene prikazat će se kad otvorite portal u pregledniku:

    Promjena preglednika

Ovim završava vodič. Možete ponoviti gornje korake i sadržaj portala promijeniti za ostale podržane tablice.

Sljedeći koraci

Upotreba proširenja Visual Studio Code

Pogledajte