Kurz: Používanie rozhrania Microsoft Power Platform CLI so službou Power Pages

V tomto návode sa dozviete, ako začať používať Microsoft Power Platform CLI na aktualizáciu konfigurácie vzorovej webovej lokality.

Stiahnutie a inštalácia Visual Studio Code

Ak sa chcete pripojiť k portálom Power Apps a používať príkazy Microsoft Power Platform CLI, použite Visual Studio Code a integrovaný terminál. Integrovaný terminál umožňuje ľahké pripojenie k prostrediu Dataverse a stiahnutie, zmenu a nahranie konfigurácie portálov. Namiesto toho môžete tiež použiť Windows PowerShell.

Krok č. 1: Overiť

Pred pripojením, výpisom, stiahnutím alebo nahraním zmien pre portál Power Apps sa musíte najprv overiť v prostredí Dataverse. Ďalšie informácie o overovanie pomocou Microsoft Power Platform CLI nájdete v časti pac auth.

Ak chcete vykonať overenie, otvorte Windows PowerShell a spustite príkaz pac auth create pomocou adresy URL prostredia Dataverse:

pac auth create -u [Dataverse URL]

Príklad

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

Podľa pokynov na overenie sa prihláste do prostredia.

Krok č. 2. Výpis dostupných webových lokalít

Pomocou príkazu pac powerpages list vypíšte dostupné Power Pages webové stránky v Dataverse prostredí, ku ktorému ste sa pripojili v predchádzajúcom krok.

pac powerpages list

Krok č. 3. Stiahnite si obsah webovej stránky

Stiahnite si obsah webových stránok z pripojeného Dataverse prostredia pomocou príkazu pac powerpages download .

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

Príklad

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

Pre parameter id použite WebSiteId na vrátenie z výstupu z predchádzajúceho kroku.

Krok č. 4. Zmena obsahu webovej lokality

Zmeňte konfiguráciu pomocou Visual Studio Code a uložte zmeny.

Napríklad predvolená portálová stránka zobrazuje text, ako je tento:

Tento text je viditeľný z webovej stránky html:

Tento text môžete zmeniť a zmeny uložiť:

Krok č. 5: Nahranie zmien

Po vykonaní požadovaných zmien ich nahrajte pomocou príkazu pac powerpages upload :

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

Príklad

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

Odovzdanie sa uskutoční iba pre obsah, ktorý sa zmení. Pretože v tomto príklade sa vykoná zmena na webovej stránke, obsah sa nahrá iba pre tabuľku adx_webpage.

Nahranie zmien pomocou profilu nasadenia

Pri práci s viacerými rôznymi prostrediami môžete zvážiť použitie profilov nasadenia, aby ste sa uistili, že zmeny sa nahrajú do správneho prostredia pomocou profilu nasadenia.

1. Vytvorte priečinok s názvom deployment-profiles v priečinku s obsahom portálu. Napríklad, ak je stiahnutý obsah portálu v priečinku „starter-portal“, priečinok deployment-profiles by mal byť v tomto priečinku.

   

2. V priečinku profilov nasadenia vytvorte súbor nasadenia YAML, ktorý obsahuje zmeny špecifické pre dané prostredie. Napríklad vývojové prostredie sa môže nazývať „dev.deployment.yml“.

   

3. Upravte súbor YAML nasadenia pomocou Visual Studio Code v nasledujúcom formáte:

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

   Napríklad nasledujúci vzorový kód YAML aktualizuje hodnotu pre „Prípona názvu prehliadača“ z predvolenej „Vlastný portál“ na „Vlastný portál (Dev)“.

   adx_contentsnippet:
       - adx_contentsnippetid: 76227a41-a33c-4d63-b0f6-cd4ecd116bf8 # Replace with your content snippet ID
         adx_name: Browser Title Suffix # Setting name
         adx_value:   · Custom Portal (Dev) # Setting value
   

4. Ak chcete nahrať zmeny do iného prostredia pomocou súboru YAML profilu nasadenia, overte sa v cieľovej organizácii.

5. Po overení a pripojení k správnemu prostrediu použite na odovzdanie obsahu príkaz pac powerpages upload :

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

   Poznámka

   Vo vyššie uvedenom príklade je použitý názov profilu nasadenia „dev“ po vykonaní predchádzajúcich krokov na vytvorenie profilu nasadenia pre vývojárov. Zmeňte názov z „dev“ na akýkoľvek iný (napríklad QA pre „qa.deployment.yml“ alebo Test pre „test.deployment.yml“), ak ste použili iný názov súboru pre súbor nasadenia YAML.

Krok č. 6: Potvrďte zmeny

Potvrdenie zmien vykonaných na webovej stránke:

1. V dizajnovom štúdiu Power Pages vyberte položku Synchronizovať.

2. Ak chcete vidieť zmenu, prejdite na webovú stránku.

   

3. Ak ste použili príklad profilu nasadenia vysvetlený vyššie, YAML úryvok aktualizuje hodnotu, ako je znázornené na nasledujúcej snímke obrazovky.

   

   Prípona názvu prehliadača aktualizovaná prostredníctvom vyššie uvedenej zmeny zobrazuje zmenu, keď otvoríte portál v prehliadači:

   

Týmto sa končí kurz. Vyššie uvedené kroky môžete zopakovať a zmeniť obsah portálov za iné podporované tabuľky.

Ďalšie kroky

Použite Visual Studio rozšírenie kódu

Pozrite si tiež

• Microsoft Power Platform CLI
• Použite Visual Studio rozšírenie kódu