Podpora portálů pro Microsoft Power Platform CLI

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

Požadavky

Před použitím příkazů Microsoft Power Platform CLI pro portály se ujistěte, že je váš portál nakonfigurován tak, aby umožňoval podporu této funkce.

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.

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 Microsoft Power Platform CLI otevřete příkazový řádek a spusťte pac k ověření, že výstup obsahuje "paportal" - příkaz pro portály Power Apps.

Příkazy Microsoft Power Platform CLI pro portály

Příkaz Microsoft Power Platform CLI pro portály je “paportal”.

V následujících částech jsou uvedeny další podrobnosti o různých vlastnostech příkazu paportal".

Parametry

Název vlastnosti	Popis	Příklad
seznam	Seznam všech webů portálu z aktuálního prostředí Dataverse.	pac paportal list
stáhnout	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
nahrát	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: 5ad86900-b5d7-43ac-8359-482529724979
      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.

Použití rozšíření Visual Studio Code pro portály (preview)

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

Viz také

• Rozhraní příkazového řádku Microsoft Power Platform
• Použití rozšíření Visual Studio Code pro portály (preview)