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.
Poznámka
- Tento výukový program sa zameriava na požadované príkazy Microsoft Power Platform CLI pre použitie Power Pages. Pre viac informácií o príkazoch použitých v Power Platform CLI si prečítajte časť Bežné príkazy.
- Počnúc Power Platform CLI verzie 1.27 sa príkaz
pac paportal
zmení napac powerpages
.paportal
naďalej funguje, ale odporúčame použiťpowerpages
vpred. Tento článok bude čoskoro aktualizovaný tak, aby namiesto toho používalpowerpages
paportal
.
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
Použite príkaz pac paportal list na vypísanie dostupných webových lokalít Power Pages v prostredí Dataverse, ku ktorému ste sa pripojili v predchádzajúcom kroku.
pac paportal list
Krok č. 3. Stiahnite si obsah webovej stránky
Stiahnite si obsah webovej lokality z pripojeného prostredia Dataverse pomocou príkazu pac papportal download.
pac paportal download --path [PATH] -id [WebSiteId-GUID] --modelVersion [DataModel]
Príklad
pac paportal 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.
Poznámka
- Použite modelVersion
1
alebo2
na označenie, či údaje stránok, ktoré sa majú nahrať, budú používať štandard (1) alebo vylepšené dátový model (2). - Spustite
pac powerpages list -v
príkaz, aby ste videli, ktorý dátový model sa používa pre vaše stránky. Ďalšie podrobnosti nájdete v časti vylepšený dátový model.
Krok č. 4. Zmena obsahu webovej lokality
Zmeňte konfiguráciu pomocou Visual Studio Code a uložte zmeny.
Poznámka
Uistite sa, že aktualizujete iba podporované tabuľky na použitie s Power Platform CLI. Ďalšie informácie nájdete v téme Podporované tabuľky.
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ť:
Tip
Môžete zmeniť umiestnenie cesty k priečinku v PowerShell/integrovanom termináli na stiahnuté umiestnenie a zadať „code“, aby sa otvoril priečinok priamo v riešení Visual Studio Code.
Krok č. 5: Nahranie zmien
Poznámka
- Ak nahrávate do viacerých prostredí, prečítajte si nahranie zmien pomocou profilu nasadenia, kde sa dozviete, ako nahrať zmeny pomocou profilu nasadenia.
- Uistite sa, že maximálna veľkosť prílohy cieľového prostredia je nastavená na rovnakú alebo väčšiu veľkosť ako vaše zdrojové prostredie.
- Maximálna veľkosť súborov je určená nastavením Maximálna veľkosť súboru na karte E-mail nastavení systému v dialógovom okne nastavenia systému prostredia.
Po vykonaní požadovaných zmien ich nahrajte pomocou príkazu pac paportal upload:
pac paportal upload --path [Folder-location] --modelVersion [ModelVersion]
Príklad
pac paportal upload --path C:\pac-portals\downloads\custom-portal\ --modelVersion 2
Poznámka
Uistite sa, že cesta k zadanému obsahu portálov je správna. V predvolenom nastavení sa priečinok pomenovaný portálom (priateľský názov) vytvorí so stiahnutým obsahom portálov. Napríklad, ak je priateľský názov portálu custom-portal cesta pre vyššie uvedený príkaz (--path) by mala byť C:\pac-portals\downloads\custom-portal.
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.
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.
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“.
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
Ak chcete nahrať zmeny do iného prostredia pomocou súboru YAML profilu nasadenia, overte sa v cieľovej organizácii.
Po overení a pripojení k správnemu prostrediu použite príkaz pac paportal upload na nahratie obsahu:
pac paportal 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:
V dizajnovom štúdiu Power Pages vyberte položku Synchronizovať.
Ak chcete vidieť zmenu, prejdite na webovú stránku.
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 rozšírenie Visual Studio Code
Pozrite si tiež
Pripomienky
https://aka.ms/ContentUserFeedback.
Pripravujeme: V priebehu roka 2024 postupne zrušíme službu Problémy v službe GitHub ako mechanizmus pripomienok týkajúcich sa obsahu a nahradíme ju novým systémom pripomienok. Ďalšie informácie nájdete na stránke:Odoslať a zobraziť pripomienky pre