Microsoft Power Platform CLI podpora pre Power Pages

Microsoft Power Platform CLI (Command Line Interface) je jednoduché vývojové rozhranie príkazového riadku pre vývojárov, ktoré vývojárom a výrobcom aplikácií umožňuje vytvárať komponenty kódu.

Nástroje Microsoft Power Platform CLI sú prvým krokom k dosiahnutiu komplexného príbehu správy životného cyklu aplikácií (ALM), v ktorom môžu podnikoví vývojári a nezávislí dodávatelia softvéru rýchlo a efektívne vytvárať, zostavovať, ladiť a zverejňovať svoje rozšírenia a prispôsobenia. Ďalšie informácie nájdete v téme Čo je Microsoft Power Platform CLI?

Vďaka tejto funkcii Microsoft Power Platform CLI podporuje CI/CD (Continuous Integration/Continuous Deployment) konfigurácie lokality Power Pages. Teraz môžete prihlásiť konfiguráciu webovej lokality k zdrojovému ovládaciemu prvku a presunúť konfiguráciu webovej lokality do ľubovoľného prostredia pomocou Microsoft Power Platform CLI.

Prečo používať Microsoft Power Platform CLI na vývoj webovej lokality?

S riešením Microsoft Power Platform CLI teraz môžete na prispôsobenie webovej lokality využívať schopnosť podobnú režimu offline vykonaním zmien v obsahu webovej lokality. Keď sú všetky prispôsobenia alebo zmeny uložené, môžete nahrať konfiguráciu webovej lokality späť do riešenia Microsoft Dataverse. Pri sťahovaní obsahu webovej lokality pomocou Microsoft Power Platform CLI, je obsah štruktúrovaný do formátov YAML a HTML, čo umožňuje ľahké prispôsobenie a zameranie na vývoj.

Tu je zoznam funkcií a schopností, z ktorých portály profitujú vďaka podpore pre Microsoft Power Platform CLI:

Jednoduché používanie

• Podpora sťahovania/nahrávania údajov konfigurácie webovej lokality do/z lokálneho súborového systému

• Vytvorené na existujúcom nástroji Microsoft Power Platform CLI.

Správa životného cyklu aplikácie (ALM)

• Sledujte zmeny v konfigurácii webovej lokality rámci organizácie

• Presuňte konfiguračné súbory medzi organizáciami alebo nájomníkmi

Pro-dev a podniková podpora

• Pomáha bezproblémovo integrovať s akýmikoľvek nástrojmi na riadenie zdrojov, ako je napríklad „git“

• Ľahko nastavte kanály CI/CD

Inštalácia Microsoft Power Platform CLI

Podrobné pokyny nájdete v časti Inštalácia Microsoft Power Platform CLI.

Podporované tabuľky

Podpora portálov pre Microsoft Power Platform CLI je obmedzená na nasledujúce tabuľky.

Nainštalujte a overte Microsoft Power Platform CLI pre portály

Ak sa chcete dozvedieť viac o inštalácii Microsoft Power Platform CLI, choďte na Inštalácia Microsoft Power Platform CLI.

Po inštalácii Microsoft Power Platform CLI otvorte príkazový riadok a spustite príkaz pac na overenie, či výstup obsahuje „paportal“ – príkaz pre portály Power Apps.

Príkazy Microsoft Power Platform CLI pre portály

Príkaz Microsoft Power Platform CLI pre portály je „paportal“.

Nasledujúca časť poskytuje viac podrobností o rôznych vlastnostiach príkazu „paportal“.

Parametre

Použite profil nasadenia

Prepínač deploymentProfile vám umožňuje definovať množinu premenných pre prostredie vo formáte YAML. Môžete mať napríklad rôzne profily nasadenia (napríklad dev, test, prod), ktoré majú v profile definované rôzne detaily schémy.

Ak vytvárate testovací profil, môžete vytvoriť súbor pod profilmi nasadenia s názvom „test.deployment.yml“ (t. j. <profileTag>.deployment.yml). A môžete spustiť príkaz so značkou (<profileTag>) na použitie tohto profilu:

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

V tomto súbore môžete mať názov tabuľky (entity) s ID tabuľky, zoznam atribútov a hodnoty, ktoré chcete prepísať pri odosielaní konfigurácie portálu pomocou parametra deploymentProfile.

Okrem toho môžete použiť premennú OS na prístup k premenným prostredia operačného systému.

Tu je príklad tohto profilového súboru YAML „test.deployment.yml“, ktorý má jedinečné podrobnosti o schéme:

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

Súbory manifestov

Keď stiahnete obsah webovej stránky pomocou príkazu pac paportal download CLI, spolu so stiahnutím obsahu stránky sa vygenerujú aj dva súbory manifestu;

• Súbor manifestu prostredia (org-url-manifest.yml)
• Súbor manifestu odstránenia sledovania (manifest.yml)

Súbor manifestu prostredia (org-url-manifest.yml)

Súbor manifestu prostredia sa vygeneruje po každom spustení príkazu pac paportal download.

Po každom stiahnutí nástroj PAC CLI načíta existujúci súbor manifestu prostredia a aktualizuje položky odstránené v prostredí, alebo vytvorí súbor manifestu prostredia, ak tento súbor neexistuje.

Keď spustíte príkaz pac paportal upload na nahratie obsahu webovej stránky portálu. Prečíta súbor manifestu prostredia a identifikuje zmeny vykonané od posledného stiahnutia a odovzdá iba aktualizovaný obsah. Pomáha to pri optimalizácii procesu nahrávania, pretože sa nahráva iba aktualizovaný obsah webovej lokality namiesto nahrávania celého obsahu pri každom príkaze na nahrávanie.

Súbor manifestu prostredia je readonly pri pripojení k rovnakému prostrediu (adresa URL prostredia sa zhoduje s názvom súboru), aby sa zabránilo náhodným zmenám.

Súbor manifestu odstránenia sledovania (manifest.yml)

Tento súbor sa používa na sledovanie odstránených záznamov z prostredia.

Keď sa obsah webovej stránky stiahne príkazom pac paportal download , pridá sa tým odstránené záznamy zo súboru manifestu prostredia (org-url-manifest.yml) do súboru manifest.yml. Takže, keď nahráte obsah webových stránok pomocou príkazu pac paportal upload , odstráni súbory z prostredia (dokonca aj do iného prostredia). Tento súbor sa neodstráni a bude sa používať bez ohľadu na to, v akom prostredí ste pripojení. Tento súbor je potrebné zohľadniť pri presadzovaní zmien do ovládacieho prvku zdroja, aby bolo možné zvážiť odstránenie položiek v cieľovom prostredí.

Použitie rozšírenia Visual Studio Code

Môžete tiež použiť Rozšírenie Power Platform VS Code využívať výhody integrovaného jazyka Liquid z technológie IntelliSense, pomoci pri vypĺňaní kódu, rady a interakcie s Microsoft Power Platform CLI pomocou integrovaného terminálu VS Code. Ďalšie informácie: Použitie rozšírenia aplikácie Visual Studio Code (verzia Preview)

Ďalšie úvahy

• Ak cesta k súboru presahuje obmedzenie maximálnej dĺžky cesty, nahlási sa chyba. Viac informácií: Maximálne obmedzenie dĺžky cesty v systéme Windows
• Pre duplicitné záznamy, ako napríklad duplicitný názov webovej lokality, Microsoft Power Platform CLI vytvára dva rôzne priečinky – jeden s názvom webovej stránky a druhý s rovnakým názvom s predponou s kódom hash. Napríklad "My-page" a "My-page-hash-code".

Ďalšie kroky

Kurz: Používanie rozhrania Microsoft Power Platform CLI s portálmi

Pozrite si tiež

• Microsoft Power Platform CLI
• Použite rozšírenie Visual Studio Code (verzia Preview)