Podpora Microsoft Power Platform CLI pro 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 viz Co je Microsoft Power Platform CLI?

Microsoft Power Platform CLI umožňuje používat postupy CI/CD (Continuous Integration / Continuous Deployment) pro konfiguraci webů Power Pages. Nyní můžete zapsat konfiguraci webu do správy zdrojového kódu a přesunout konfiguraci webu do libovolného prostředí pomocí rozhraní příkazového řádku Microsoft Power Platform CLI.

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, jděte do části Instalace Microsoft Power Platform CLI.
• Počínaje Power Platform CLI verze 1.27 je příkaz pac paportal změněn na pac powerpages. paportal nadále funguje, ale do budoucna doporučujeme používat powerpages. Tento článek bude brzy aktualizován tak, aby používal powerpages namísto paportal.

Proč použít Microsoft Power Platform CLI pro vývoj webů?

S Microsoft Power Platform CLI nyní můžete pro vlastní nastavení webů používat funkci podobnou režimu offline, a to provedením změn v obsahu webů. Jakmile jsou všechna vlastní nastavení nebo změny uloženy, můžete nahrát konfiguraci webu zpět do Microsoft Dataverse. Při stahování obsahu webů 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í 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 konfigurace webů 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 webu 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ásledující 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	Popis	Příklad
list	Seznam všech webů portálu z aktuálního prostředí Dataverse. Můžete přidat parametr -v k označení, zda web používá standardní, nebo vylepšený datový model	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) - modelVersion: 1 nebo 2 pro označení, zda data webu, která mají být stažena, používají standardní (1) nebo vylepšený datový model (2).	pac paportal download --path "C:\portals" --webSiteId f88b70cc-580b-4f1a-87c3-41debefeb902 --modelVersion 2
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 - modelVersion: 1 nebo 2 pro označení, zda data webu, která mají být nahrána, používají standardní (1) nebo vylepšený datový model (2).	pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile "profile-name" --modelVersion 2

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 --modelVersion 2

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

Když stáhnete obsah webu pomocí příkazu rozhraní příkazového řádku pac paportal download, spolu se stažením obsahu webu se také vygenerují 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í je pouze pro čtení, když se připojuje 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.

Poznámka:

• Soubor manifestu prostředí není navržen tak, aby sledoval změny při nasazení webu do různých prostředí.
• Soubor manifestu prostředí je navržen pro použití vývojáři k místnímu nasazení v jejich vývojářském prostředí a měl by být přidán do seznamu ignorovaných Gitů.

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 odstraněné záznamy ze souboru manifestu prostředí (org-url-manifest.yml) do souboru manifest.yml. Když tedy nahrajete obsah webu pomocí příkazu pac paportal upload, budou odstraněny soubory z prostředí (i když jej nahrajete do 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. Tento soubor je třeba vzít v úvahu při odesílání změn do ovládacího prvku zdroje, aby bylo možné zvážit odstranění položek v cílovém prostředí.

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 downloadpř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ší 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é

• Microsoft Power Platform CLI
• Použití rozšíření Visual Studio Code (Preview)