Sdílet prostřednictvím

pac canvas

Provoz se soubory .msapp v Power Apps

[Tento článek představuje předběžnou dokumentaci a může se změnit.]

Důležité

  • Příkazy pack a unpack příkazy jsou zastaralé.
  • Ke správě zdrojového kódu v aplikaci plátna použijte integraci Gitu s Power Platform.
  • Příkaz create je obecně dostupný.

Commands

Command Description
pac canvas create Generování aplikace plátna z vlastního konektoru
pac canvas download Stažení aplikace plátna jako souboru .msapp
pac canvas list Výpis aplikací plátna
pac canvas pack (Preview) Zabalení zdrojů do souboru msapp
pac canvas unpack (Preview) Extrahování souboru msapp do zdrojů
pac canvas validate (Preview) Ověřte zdroj .pa.yaml pro rozbalený soubor msapp.

pac canvas create

Generování aplikace plátna z vlastního konektoru

Tento příkaz vygeneruje .msapp aplikaci plátna na základě definice OpenAPI existujícího vlastního konektoru. Aplikace bude obsahovat obrazovky, rozložení ovládacího prvku a kód Power Fx vygenerovaný na základě toho, jak jsou definovány akce vlastního konektoru s předdefinovaným vzhledem a chováním. Aplikaci můžete použít k přímému cvičení akcí definovaných ve vlastním konektoru.

Tvůrci můžou importovat vygenerované .msapp do Power Apps Studia, aby mohli aplikaci přehrát, nebo provádět úpravy a provádět další úpravy. Naimportujte vygenerovanou aplikaci do Power Apps Studia tak, že přejdete donabídky Otevřít>soubor>v rámci studia.

Examples

Následující příklady ukazují použití pac canvas create příkazu.

Vytvoření aplikace plátna založené na definici open API podle zobrazovaného názvu

Tento příklad vytvoří aplikaci plátna (jako soubor *.msapp) založenou na definici rozhraní Open API pomocí zobrazovaného názvu konektoru.

pac canvas create --msapp HelloWorld.msapp --connector-display-name "My Custom Connector"

Vytvoření aplikace plátna na základě definice open API podle ID

Tento příklad vytvoří aplikaci plátna (jako soubor *.msapp) založenou na definici rozhraní OPEN API pomocí ID konektoru.

pac canvas create --msapp HelloWorld.msapp --connector-id 00000000-0000-0000-0000-000000000000

Buď connector-display-name nebo connector-id jsou povinné.

Požadované parametry pro vytvoření plátna

--msapp

Cesta k souboru .msapp, který se má vygenerovat

Volitelné parametry pro vytvoření plátna

--connector-display-name

Zobrazovaný název konektoru pro vygenerování aplikace Power App.

--connector-id

ID konektoru pro vygenerování aplikace Power App.

--environment

ID cílového prostředí nebo adresa URL. Výchozí hodnota je prostředí aktuálně aktivního profilu ověřování Dataverse.

Poznámky

Důležité informace a omezení:

  • Vlastní konektor odkazovaný s parametry connector-display-name musí connector-id být součástí řešení.
  • Po importu aplikace do studia nedojde k přidružení k vlastnímu konektoru. Tvůrce musí ručně přidat odkaz na vlastní konektor, ze kterého byla aplikace vygenerována, než se dá přehrát. Postup najdete v tématu Přidání datových připojení k aplikacím plátna . Dokud to nebude hotové, můžou se v aplikaci zobrazit chyby vzorců, které se vyřeší po přidání odkazu na konektor. Název vlastního konektoru, který přidáte do aplikace, se musí shodovat se zobrazeným názvem vlastního konektoru, na který se odkazuje v canvas create příkazu.
  • Aplikace bude obsahovat jednu obrazovku pro každou POST akci, GET kterou konektor definuje.
    • Jiné příkazy dostupné ve vlastních konektorech se nepodporují.
  • Ovládací prvky vykreslené na obrazovce každé akce se dynamicky generují na základě způsobu definování vstupních a výstupních typů jednotlivých akcí. Některé typy vstupu a výstupu definované ve vlastním konektoru nejsou podporovány canvas create. Příkaz vygeneruje upozornění v konzole, když jsou tyto výstrahy zjištěny. Konkrétní případy:
    • Pole objektů a polí polí nejsou podporována jako vstupy.
    • Ovládací prvky nejsou generovány pro objekty nebo vnořené pole nad hloubkou 20
    • Typy "Soubor" a "binární formát" nejsou podporovány pro vstup nebo výstup.

pac canvas download

Stažení aplikace plátna jako souboru .msapp

Požadované parametry pro stažení plátna

--name -n

Přesné, částečné jméno nebo ID aplikace plátna

Volitelné parametry pro stažení plátna

--environment -env

Určuje cílovou službu Dataverse. Hodnota může být identifikátor GUID nebo absolutní adresa URL https. Pokud nezadáte, použije se aktivní organizace vybraná pro aktuální profil ověřování.

--extract-to-directory -d

Název adresáře pro extrahování aplikace plátna do

--file-name -f

Název souboru (obvykle s příponou .msapp). Pokud není zadaný soubor uložen v aktuálním adresáři s názvem appname.msapp

--overwrite -o

Povolit přepsání souboru

Tento parametr nevyžaduje žádnou hodnotu. Je to přepínač.

pac canvas list

Výpis aplikací plátna

Volitelné parametry pro seznam plátna

--environment -env

Určuje cílovou službu Dataverse. Hodnota může být identifikátor GUID nebo absolutní adresa URL https. Pokud nezadáte, použije se aktivní organizace vybraná pro aktuální profil ověřování.

pac canvas pack

(Preview) Zabalení zdrojů do souboru msapp

Example

pac canvas pack --sources MyHelloWorldFiles --msapp HelloWorld.msapp

Požadované parametry pro balíček plátna

--msapp

Cesta k souboru .msapp

--sources

Adresář ke zdrojům, které se mají zabalit

Poznámky

.msapp Vytvoří soubor z dříve rozbalených zdrojových souborů. Výsledek můžete otevřít v Power Apps Studiu tak, že přejdete na>Otevřít>soubor pro procházení.

Po rozbalení můžete zdrojové soubory upravovat a spravovat pomocí externích nástrojů, jako je Visual Studio Code a GitHub.

pac canvas unpack

(Preview) Extrahování souboru msapp do zdrojů

Example

pac canvas unpack --msapp HelloWorld.msapp --sources MyHelloWorldFiles

pac canvas unpack --msapp HelloWorld.msapp

Rozbalí výchozí HelloWorld_src adresář.

Požadované parametry pro rozbalení plátna

--msapp

Cesta k souboru .msapp

Volitelné parametry pro rozbalení plátna

--sources

Adresář ke zdrojům, které se mají rozbalit

Poznámky

Rozbalí .msapp zdrojový soubor.

.msapp Stáhněte si soubor z Power Apps Studia tak, že přejdete na Soubor>Uložit jako>tento počítač.

Pokud není zadaný parametr zdroje , použije se adresář se stejným názvem a umístěním jako .msapp soubor s _src příponou.

Struktura složek

Vlastnosti rozbalení a balení používají následující strukturu složek:

  • \src - Řízení a soubory komponent. Obsahuje zdroje.
    • *.fx.yaml – vzorce extrahované ze control.json souboru.

      Poznámka:

      Toto je místo pro úpravy vzorců.

    • CanvasManifest.json – soubor manifestu, který obsahuje informace, které se obvykle nacházejí v hlavičce, vlastnostech a publishInfo.
    • *.json - Nezpracovaný control.json soubor.
    • \EditorState*.editorstate.json – informace uložené v mezipaměti pro Power Apps Studio, které se mají použít.
  • \Zdroje dat – Všechny zdroje dat používané aplikací
  • \Připojení – Instance připojení uložené s aplikací a používané při opětovném načítání do Power Apps Studia
  • \Assets – Multimediální soubory vložené do aplikace.
  • \pkgs – stažená kopie externích odkazů, jako jsou šablony, definiční soubory rozhraní API a knihovny komponent. Jsou podobné odkazům NuGet nebo NPM.
  • \other - Všechny různé soubory potřebné k opětovnému .msappvytvoření souboru .
    • entropy.json – Do tohoto souboru se extrahují nestálé prvky (například časová razítka). To pomáhá snížit hlučné rozdíly v jiných souborech a zároveň zajistit, že můžeme stále dokola.
    • Obsahuje další soubory z msappu, například to, co je v \rodvozovat.

Formát souboru

Soubory .fx.yaml používají podmnožinu YAML. Podobně jako v Excelu by všechny výrazy měly začínat symbolem =rovná se . Další informace: Power Fx YAML Formula Grammar

Sloučení změn se sadou Power Apps Studio

Při slučování změn provedených ve dvou různých relacích Power Apps Studia:

  • Ujistěte se, že jsou všechny názvy ovládacích prvků jedinečné. Vložení tlačítka do dvou různých relací může například vést ke dvěma Button1 ovládacím prvkům. Doporučujeme, abyste ovládací prvky pojmenovali brzy po jejich vytvoření. Nástroj nepřijímá dva ovládací prvky se stejným názvem.
  • U těchto souborů je sloučíte obvyklým způsobem:
    • \src*.fx.yaml
  • Pokud dojde ke konfliktům nebo chybám, můžete tyto soubory odstranit:
    • \src\editorstate*.json – tyto soubory obsahují volitelné informace v Power Apps Studiu.
    • \other\entropy.jszapnuto
  • V případě případných konfliktů v těchto souborech je v pořádku přijmout nejnovější verzi:
    • \checksum.jszapnuto
  • Pokud v těchto cestách dojde ke konfliktům při slučování, není bezpečné je sloučit. Dejte nám vědět, jestli k tomu dochází často; budeme pracovat na restrukturalizaci formátu souboru, abychom se vyhnuli konfliktům.
    • \Konexe*
    • \Zdroje dat*
    • \pkgs*
    • CanvasManifest.json

Otevřený zdrojový kód

Příkazy plátna v rozhraní příkazového řádku Microsoft Power Platform jsou open source. Proberte vylepšení, vyvolávání problémů a přístup k kódu z úložiště nástrojů jazyka Power Apps.

pac canvas validate

(Preview) Ověřte zdroj .pa.yaml pro rozbalený soubor msapp.

Požadované parametry pro ověření plátna

--directory -d

Cesta k extrahovanému adresáři msapp obsahujícímu soubory .pa.yaml k ověření

Viz také

Skupiny příkazů rozhraní příkazového řádku Microsoft Power Platform
Přehled rozhraní příkazového řádku Microsoft Power Platform

  • Last updated on