Podpora portálů pro Microsoft Power Platform CLI
Poznámka
S účinností od 12. října 2022 jsou portály Power Apps Power Pages. Další informace: Služba Microsoft Power Pages je nyní obecně dostupná (blog)
Zanedlouho migrujeme a sloučíme dokumentaci k portálům Power Apps s dokumentací k Power Pages.
Microsoft Power Platform CLI (Command Line Interface) je jednoduché rozhraní příkazového řádku pro vývojáře, které umožňuje vývojářům a tvůrcům aplikací vytvářet komponenty kódu.
Nástroje Microsoft Power Platform CLI jsou prvním krokem k ucelenému příběhu správy životních cyklů aplikací (ALM), kde mohou podnikoví vývojáři a nezávislí výrobci softwaru rychle a efektivně vytvářet, sestavovat, ladit a publikovat svá rozšíření a přizpůsobení. Další informace najdete v článku Co je Microsoft Power Platform CLI?
S touto funkcí podporují portály Microsoft Power Apps aplikace Microsoft Power Platform CLI pro povolení CI / CD (Continuous Integration / Continuous Deployment) konfigurace portálu. Nyní můžete odhlásit konfiguraci portálu do řízení zdroje a přesunout konfiguraci portálu do libovolného prostředí pomocí rozhraní příkazového řádku Microsoft Power Platform.
Poznámka
Tato funkce je obecně dostupná počínaje Power Platform CLI verze 1.9.8. Chcete-li získat informace o instalaci nejnovější verze, viz Instalace Microsoft Power Platform CLI.
Proč použít Microsoft Power Platform CLI pro vývoj portálů?
S podporou portálů pro Microsoft Power Platform CLI nyní můžete pro přizpůsobení portálů používat funkci podobnou offline, a to provedením změn v obsahu portálů. Jakmile jsou všechna přizpůsobení nebo změny uloženy, nahrajte je na portál. Při stahování obsahu portálů pomocí Microsoft Power Platform CLI, je obsah strukturován do formátů YAML a HTML, což usnadňuje jeho přizpůsobení a umožňuje profesionální prostředí pro vývoj.
Zde je seznam funkcí a schopností, z nichž portály těží z podpory Microsoft Power Platform CLI:
Jednoduché používání
Podpora stahování / nahrávání dat portálu do / z místního systému souborů
Stavějte na existujícím nástroji Microsoft Power Platform CLI.
Správa životního cyklu aplikací (ALM)
Sledujte změny konfigurace portálu v rámci organizace
Přesun konfiguračních souborů mezi organizacemi nebo klienty
Profesionální vývoj a podniková podpora
Pomáhá bezproblémové integraci s jakýmikoli nástroji pro řízení zdrojů, jako je například „git“
Snadné nastavení kanálů CI/CD
Instalace Microsoft Power Platform CLI
Podrobné pokyny najdete v části Instalace rozhraní příkazového řáduk Microsoft Power Platform.
Podporované tabulky
Podpora portálů pro Microsoft Power Platform CLI je omezena na níže uvedené tabulky.
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 (pouze ke stažení)
adx_websitelanguage
adx_webtemplate
annotation
Důležité
- Vlastní tabulky a tabulky specifické pro šablony portálu (například blog, komunita nebo portál nápadů) nejsou podporovány pro přizpůsobení pomocí Microsoft Power Platform CLI.
- Přílohy obrázkových souborů k záznamům reklamy (adx_ad) se nestahují pomocí Power Platform CLI. Jako náhradní řešení použijte pole Adresa URL obrázku nebo přidáním odkazu HTML do pole Kopírovat do záznamu webového souboru obsahujícího obrazový soubor.
Instalace a ověření Microsoft Power Platform CLI pro portály
Chcete-li se dozvědět více o instalaci Microsoft Power Platform CLI, přejděte na Instalace Microsoft Power Platform CLI.
Po instalaci prostředí příkazového řádku Microsoft Power Platform otevřete příkazový řádek a spuštěním příkazu pac ověřte, že výstup obsahuje "paportal" - příkaz pro portály Power Apps.
Příkazy Microsoft Power Platform CLI pro portály
Příkaz rozhraní Microsoft Power Platform CLI pro portály se jmenuje „paportal”.
V následujících částech jsou uvedeny další podrobnosti o různých vlastnostech příkazu „paportal“.
Parametry
| Název vlastnosti | Description | Příklad |
|---|---|---|
| list | Seznam všech webů portálu z aktuálního prostředí Dataverse. | pac paportal list |
| download | Stáhněte obsah portálového webu z aktuálního prostředí organizace Dataverse. Obsahuje následující parametry: - path: Cesta, kam bude obsah webu stažen (alias: -p) - webSiteId: ID webu portálu ke stažení (alias: -id) - overwrite: (Volitelné) pravda – přepis existujícího obsahu, nepravda – selhání, pokud složka již obsahuje obsah webu (alias: -o) |
pac paportal download --path "C:\portals" --webSiteId f88b70cc-580b-4f1a-87c3-41debefeb902 |
| upload | Nahrajte obsah portálového webu do aktuálního prostředí organizace Dataverse. Obsahuje následující parametr: - path: Cesta, kam bude obsah webu uložen (alias: -p). -deploymentProfile: Nahrajte data portálu s definovanými podrobnostmi prostředí prostřednictvím proměnných profilu v souboru deployment-profiles/[název-profilu].deployment.yaml |
pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile "profile-name" |
Použití profilu nasazení
Přepínač deploymentProfile (profil nasazení) umožňuje definovat sadu proměnných pro prostředí ve formátu YAML. Můžete například mít různé profily nasazení (například vývojové, testovací nebo provozní), které mají v profilu definovány různé podrobnosti schématu.
Pokud vytváříte testovací profil, můžete vytvořit soubor v části deployment-profiles s názvem „test.deployment.yml“ (tj. <profileTag>.deployment.yml). A můžete spustit příkaz se značkou (<profileTag>) pro použití tohoto profilu:
pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile test
V tomto souboru můžete mít název tabulky (entity) s jejím ID, seznam atributů a hodnoty, které chcete přepsat při nahrávání konfigurace portálu pomocí parametru deploymentProfile.
Kromě toho můžete použít proměnnou OS pro přístup k proměnným prostředí operačního systému.
Zde je příklad tohoto souboru YAML profilu „test.deployment.yml“, který má jedinečné podrobnosti schématu:
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
Chcete-li se dozvědět o všech příkazech použitých v rozhraní CLI kromě portálů, přejděte na Běžné příkazy v Microsoft Power Platform CLI.
Soubory manifestu
Při stahování obsahu webu pomocí příkazu pac paportal download budou spolu se stažením obsahu webu také vygenerovány dva soubory manifestu;
- Soubor manifestu prostředí (org-url-manifest.yml)
- Soubor manifestu odstranění sledování (manifest.yml)
Soubor manifestu prostředí (org-url-manifest.yml)
Soubor manifestu prostředí je generován pokaždé, když je spuštěn příkaz pac paportal download.
Po každém stažení přečte nástroj PAC CLI existující soubor manifestu prostředí a aktualizuje položky odstraněné v prostředí, nebo vytvoří soubor manifestu prostředí, pokud neexistuje.
Když spustíte příkaz pac paportal upload k nahrání obsahu webu portálu. Přečte soubor manifestu prostředí a identifikuje změny provedené od posledního stažení a nahraje pouze aktualizovaný obsah. To pomáhá při optimalizaci procesu nahrávání, protože se nahrává pouze aktualizovaný obsah webových stránek namísto nahrávání veškerého obsahu při každém příkazu k nahrávání.
Soubor manifestu prostředí bude možné pouze číst, když se připojí ke stejnému prostředí (adresa URL prostředí se shoduje s názvem souboru), aby se předešlo náhodným změnám.
Soubor manifestu odstranění sledování (manifest.yml)
Tento soubor slouží ke sledování záznamů odstraněných z prostředí.
Když je obsah webu stažen pomocí příkazu pac paportal download, přidají se záznamy odstraněné ze souboru manifestu prostředí (org-url-manifest.yml) do souboru manifest.yml. Takže když nahrajete obsah web u pomocí příkazu pac paportal upload, budou soubory z prostředí odstraněny (dokonce i z jiného prostředí). Tento soubor nebude odstraněn a bude použit bez ohledu na to, ke kterému prostředí jste připojeni.
Poznámka
Chcete-li odstranit záznamy obsahu webu v jednom prostředí a současně odstranit stejné záznamy obsahu v jiném prostředí pomocí rozhraní PAC CLI, budete muset spustit příkaz pac paportal download před a po smazání obsahu záznamu webu. Soubor manifest.yml bude sledovat tyto změny a odstraní odpovídající záznamy v cílovém prostředí, když dojde ke spuštění příkazu pac paportal upload.
Použití rozšíření Visual Studio Code pro portály
Můžete také použít příponu VS Code Power Platform Rozšíření VS kódu, abyste mohli těžit z integrovaného jazyka Liquid od IntelliSense, pomoci s dokončováním kódu, nápovědy a interakce s Microsoft Power Platform CLI pomocí integrovaného terminálu VS Code. Více informací: Použití rozšíření Visual Studio Code pro portály (preview)
Další důležité informace
- Pokud cesta k souboru překračuje omezení maximální délky cesty, je ohlášena chyba. Více informací: Omezení maximální délky cesty v systému Windows
- U duplicitních záznamů, jako je duplicitní název webové stránky, Microsoft Power Platform CLI vytvoří dvě různé složky—jednu s názvem webové stránky a druhý se stejným názvem s předponou hash kódu. Například „Moje stránka“ a „Moje stránka-hash-kód".
Další kroky
Kurz: Použití Microsoft Power Platform CLI s portály