Podpora portálov pre Microsoft Power Platform CLI
Poznámka
S účinnosťou od 12. októbra 2022 sa portály Power Apps nazývajú Power Pages. Ďalšie informácie: Služba Microsoft Power Pages je teraz všeobecne dostupná (blog)
Čoskoro vykonáme migráciu a zlúčenie dokumentácie k portálom Power Apps s dokumentáciou k službe 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 Apps portály podporujú Microsoft Power Platform CLI na povolenie konfigurácie portálu CI/CD (Continuous Integration/Continuous Deployment). Teraz môžete skontrolovať konfiguráciu portálu na riadenie zdroja a presunúť konfiguráciu portálu do akéhokoľvek prostredia pomocou Microsoft Power Platform CLI.
Poznámka
Táto funkcia je všeobecne dostupná od Power Platform CLI verzia 1.9.8. Informácie o inštalácii najnovšej verzie nájdete v časti Inštalácia Microsoft Power Platform CLI.
Prečo používať Microsoft Power Platform CLI na vývoj portálov?
S podporou portálov pre Microsoft Power Platform CLI, teraz môžete pre prispôsobenie portálov využívať schopnosť podobnú režimu offline vykonaním zmien v obsahu portálov. Akonáhle sú všetky prispôsobenia alebo zmeny uložené, nahrajte ich na portál. Pri sťahovaní obsahu portálov pomocou Microsoft Power Platform CLI, obsah je štruktúrovaný do formátov YAML a HTML, čo umožňuje ľahké prispôsobenie a umožňuje pro-vývojový zážitok.
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 portálu 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 portálu v 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 tabuľky uvedené nižšie.
adx_ad
adx_adplacement
adx_blog
adx_blogpost
adx_botconsumer
adx_communityforum
adx_communityforumaccesspermission
adx_contentsnippet
adx_entityform
adx_entityformmetadata
adx_entitylist
adx_entitypermission
adx_forumthreadtype
adx_pagetemplate
adx_poll
adx_polloption
adx_pollplacement
adx_portallanguage
adx_publishingstate
adx_redirect
adx_shortcut
adx_sitemarker
adx_sitesetting
adx_tag
adx_urlhistory
adx_webfile
adx_webform
adx_webformmetadata
adx_webformstep
adx_weblink
adx_weblinkset
adx_webpage
adx_webpageaccesscontrolrule
adx_webrole
adx_website
adx_websiteaccess
adx_websitebinding (iba stiahnutie)
adx_websitelanguage
adx_webtemplate
anotácia
Dôležité
- Vlastné tabuľky a tabuľky špecifické pre šablónu portálu (napríklad blog, komunita alebo portál nápadov) nie sú podporované pri použití prispôsobenia Microsoft Power Platform CLI.
- Prílohy obrázkových súborov k záznamom reklamy (adx_ad) sa nesťahujú pomocou Power Platform CLI. Ako riešenie použite pole Adresa URL obrázka alebo pridanie odkazu HTML v poli Kopírovať do záznamu webového súboru, ktorý obsahuje obrazový súbor.
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
| Názov vlastnosti | Description | Príklad |
|---|---|---|
| list | Zoznam všetkých webových lokalít portálu z aktuálneho prostredia Dataverse. | pac paportal list |
| download | Stiahnite si obsah webovej lokality portálu z aktuálnej organizácie v prostredí Dataverse. Má nasledujúce parametre: - path: Cesta, kam sa stiahne obsah webovej lokality (alias: -p) - webSiteId: ID webových stránok portálu na stiahnutie (alias: -id) - overwrite: (Voliteľné) true – prepísať existujúci obsah; false – zlyhať, ak priečinok už obsahuje obsah webovej lokality (alias: -o) |
pac paportal download --path "C:\portals" --webSiteId f88b70cc-580b-4f1a-87c3-41debefeb902 |
| upload | Nahrajte obsah webovej lokality portálu z aktuálnej organizácie v prostredí Dataverse. Má nasledovný parameter: - path: Cesta, kam sa ukladá obsah webovej lokality (alias: -p) -deploymentProfile: Odovzdajte údaje portálu s podrobnosťami prostredia definovanými prostredníctvom premenných profilu v súbore deployment-profiles/[názov-profilu].deployment.yaml |
pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile "profile-name" |
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>.nasadenie.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
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
Poznámka
Ak sa chcete dozvedieť o všetkých príkazoch používaných v CLI okrem portálov, prejdite na Bežné príkazy v Microsoft Power Platform CLI.
Súbory manifestov
Keď stiahnete obsah webovej stránky pomocou príkazu CLI pac paportal download, 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 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 bude len na čítanie, keď sa pripojí k rovnakému prostrediu (adresa URL prostredia sa zhoduje s názvom súboru), aby sa predišlo 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 lokality stiahne pomocou príkazu pac paportal download, pridajú sa odstránené záznamy zo súboru manifestu prostredia (org-url-manifest.yml) do súboru manifest.yml. Takže, keď nahráte obsah webovej lokality pomocou príkazu pac paportal upload, dôjde k odstráneniu súborov z prostredia (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í.
Poznámka
Ak chcete odstrániť záznamy obsahu lokality v jednom prostredí a tiež odstrániť rovnaké záznamy obsahu v inom prostredí pomocou PAC CLI, budete musieť spustiť príkaz pac paportal download pred a po odstránení obsahu záznamu webovej lokality. Manifest.yml bude sledovať tieto zmeny a odstráni zodpovedajúce záznamy v cieľovom prostredí, keď sa spustí príkaz pac paportal upload.
Použitie rozšírenia Visual Studio Code
Môžete tiež použiť rozšírenie VS Code Power Platform VS Code Extension a využiť vstavaný jazyk Liquid od IntelliSense, pomoc pri dokončovaní kódu, rady a interakciu 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 hľadiská
- 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žitie Microsoft Power Platform CLI s portálmi