Zdieľať cez

pac canvas

Fungovanie so súbormi .msapp služby Power Apps

[Tento článok je predbežnou dokumentáciou a môže sa zmeniť.]

Dôležité

  • Príkazy pack a unpack sú zastarané.
  • Ak chcete zdrojovo ovládať svoju aplikáciu plátna, použite integráciu Git s Power Platformou.
  • Príkaz create je všeobecne dostupný.

Príkazy

Command Popis
pac canvas create Generovanie aplikácie s plátnom z vlastného konektora
pac canvas download Stiahnutie aplikácie plátna ako súboru .msapp
pac canvas list Zobrazenie zoznamu aplikácií plátna
pac canvas pack (Ukážka) Zbalenie zdrojov do súboru msapp
pac canvas unpack (Ukážka) Extrahovanie súboru msapp do zdrojov
pac canvas validate (Ukážka) Overenie zdroja .pa.yaml pre rozbalený súbor msapp

pac canvas create

Generovanie aplikácie s plátnom z vlastného konektora

Tento príkaz vygeneruje aplikáciu s plátnom .msapp na základe definície súboru OpenAPI existujúceho vlastného konektora. Aplikácia bude obsahovať obrazovky, ovládacie rozloženie a kód služby Power Fx vygenerovaný na základe definovania akcií vlastného konektora s preddefinovaným vzhľadom a prostredím. Aplikáciu možno použiť na priame vykonávanie akcií definovaných vo vlastnom konektore.

Tvorcovia môžu importovať vygenerované .msapp do služby Power Apps Studio, aby mohli prehrať aplikáciu, alebo vykonávať úpravy a vykonať ďalšie prispôsobenia. Importujte vygenerované aplikácie do aplikácie Power Apps Studio prechodom na položky Súbor>Otvoriť>prehľadávať v rámci programu Studio.

Príklady

Nasledujúce príklady zobrazujú použitie pac canvas create príkazu.

Vytvorenie plátnovej aplikácie na základe definície otvoreného rozhrania API podľa zobrazovaného názvu

Tento príklad vytvorí aplikáciu plátna (vo forme súboru *.msapp) na základe definície rozhrania Open API pomocou zobrazovaného názvu konektora.

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

Vytvorenie plátnovej aplikácie na základe definície otvoreného rozhrania API podľa ID

Tento príklad vytvorí aplikáciu plátna (vo forme súboru *.msapp) na základe definície rozhrania Open API pomocou ID konektora.

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

Vyžaduje sa buď connector-display-name licencia, alebo connector-id .

Povinné parametre pre canvas create

--msapp

Cesta k súboru .msapp, ktorý sa má vygenerovať

Voliteľné parametre pre canvas create

--connector-display-name

Zobrazovaný názov konektora, z ktorom sa má vygenerovať aplikácia Power App.

--connector-id

ID konektora, z ktorom sa má vygenerovať aplikácia Power App.

--environment

Cieľové ID prostredia alebo URL adresa. Predvolená hodnota je prostredie aktuálne aktívneho profilu Dataverse Auth.

Poznámky

Dôležité informácie a obmedzenia:

  • Vlastný konektor, na ktorý sa odkazuje s connector-display-name parametrami alebo connector-id , musí byť súčasťou Riešenia.
  • Po importovaní aplikácie do služby Studio nebude k vlastnému konektoru žiadne priradenie. Tvorca musí manuálne pridať odkaz na vlastný konektor, z ktorého bola aplikácia vygenerovaná pred prehratím aplikácie. Kroky nájdete v téme Pridanie pripojení údajov do plátnových aplikácií . Kým to neurobíte, v aplikácii sa môžu zobraziť chyby vzorca, ktoré sa vyriešia po pridaní odkazu na konektor. Názov vlastného konektora, ktorý pridáte do aplikácie, sa musí zhodovať so zobrazovaným názvom vlastného konektora, na ktorý sa odkazuje v príkaze canvas create .
  • Aplikácia bude obsahovať jednu obrazovku pre každú z akcií POST , GET ktoré konektor definuje.
    • Ostatné slovesá dostupné vo vlastných konektoroch nie sú podporované.
  • Ovládacie prvky vykreslené na obrazovke jednotlivých akcií sa dynamicky generujú na základe toho, ako sú definované vstupné a výstupné typy jednotlivých akcií. Určité typy vstupu a výstupu definované vo vlastnom konektore nie sú podporované možnosťou canvas create. Príkaz vygeneruje v konzole upozornenia, keď sa vyskytnú. Konkrétne prípady:
    • Polia objektov a polí polí nie sú ako vstupy podporované
    • Ovládacie prvky nie sú generované pre objekty ani vnorené polia nad rámec hĺbky 20.
    • Typy súborov a binárnych formátov nie sú podporované pre zadanie ani výstup.

pac canvas download

Stiahnutie aplikácie plátna ako súboru .msapp

Povinné parametre pre canvas download

--name -n

Plátnová aplikácia s presným, čiastočným názvom alebo ID aplikácie

Voliteľné parametre pre canvas download

--environment -env

Určuje cieľovú hodnotu Dataverse. Hodnotou môže byť identifikátor GUID alebo absolútna URL adresa protokolu https. Ak nie je určené, použije sa aktívna organizácia vybratá pre aktuálny profil overenia.

--extract-to-directory -d

Názov adresára, do ktorý sa má extrahovať aplikácia plátna

--file-name -f

Názov súboru (zvyčajne s príponou .msapp). Ak súbor nezadáte, uloží sa do aktuálneho adresára s 'appname'.msapp

--overwrite -o

Povoliť prepísanie súboru

Tento parameter nevyžaduje žiadnu hodnotu. Je to prepínač.

pac canvas list

Zobrazenie zoznamu aplikácií plátna

Voliteľné parametre pre canvas list

--environment -env

Určuje cieľovú hodnotu Dataverse. Hodnotou môže byť identifikátor GUID alebo absolútna URL adresa protokolu https. Ak nie je určené, použije sa aktívna organizácia vybratá pre aktuálny profil overenia.

pac canvas pack

(Ukážka) Zbalenie zdrojov do súboru msapp

Príklad

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

Povinné parametre pre canvas pack

--msapp

Cesta k súboru .msapp

--sources

Adresár do zdrojov, ktoré sa majú zbaliť

Poznámky

Vytvorí .msapp súbor z predtým rozbalených zdrojových súborov. Výsledok je možné otvoriť v aplikácii Power Apps Studio prechodom na položku Súbor>Otvoriť>prehľadávanie.

Po rozbalení sa zdrojové súbory môžu upravovať a spravovať pomocou externých nástrojov, ako sú Visual Studio Code a GitHub.

pac canvas unpack

(Ukážka) Extrahovanie súboru msapp do zdrojov

Príklad

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

pac canvas unpack --msapp HelloWorld.msapp

Rozbalí sa do predvoleného HelloWorld_src adresára.

Povinné parametre pre canvas unpack

--msapp

Cesta k súboru .msapp

Voliteľné parametre pre canvas unpack

--sources

Adresár pre zdroje, ktoré sa majú rozbaliť

Poznámky

Rozbaľte zdrojový .msapp súbor.

.msapp Stiahnite si súbor zo služby Power Apps Studio prechodom na položky Súbor>Uložiť ako>tento počítač.

Ak nie je zadaný parameter zdrojov , adresár s rovnakým názvom a umiestnením, ako .msapp je súbor, sa použije s príponou _src .

Štruktúra priečinkov

Vlastnosti rozbalenia a balíka používajú nasledujúcu štruktúru priečinkov:

  • \src – súbory s ovládacími prvkami a súčasťami. Zdroj obsahuje.
    • *.fx.yaml – vzorce extrahované zo control.json súboru.

      Poznámka

      Toto je miesto, kde môžete upravovať vzorce.

    • CanvasManifest.json – súbor manifestu, ktorý obsahuje informácie, ktoré sa bežne nachádzajú v hlavičke, vlastnostiach a publikovaníInfo.
    • *.json – nespracovaný control.json súbor.
    • \EditorState*.editorstate.json – informácie uložené vo vyrovnávacej pamäti pre aplikáciu Power Apps Studio na použitie.
  • \DataSources – všetky zdroje údajov, ktoré aplikácia používa.
  • \Pripojenia – inštancie pripojenia uložené v aplikácii a používané pri opätovnom načítaní do aplikácie Power Apps Studio.
  • \Assets – mediálne súbory vložené do aplikácie.
  • \pkgs – stiahnutia kópie externých odkazov, ako sú napríklad šablóny, súbory definícií rozhrania API a knižnice súčastí. Tieto názvy sú podobné ako odkazy na NuGet/NPM.
  • \other – Všetky rôzne súbory potrebné na opätovné vytvorenie zostavy .msapp.
    • entropy.json – do tohto súboru sa extrahujú nestále prvky (napríklad časové pečiatky). Vďaka tomu je možné znížiť hlučné rozdiely v iných súboroch a zároveň zabezpečiť, aby sme ich mohli stále zaokrúhliť.
    • Obsahuje ďalšie súbory aplikácie msapp, napríklad informácie o tom, čo je v \references.

Formát súboru

Súbory .fx.yaml používajú podmnožinu yaml. Podobne ako v Exceli, aj všetky výrazy by mali začínať znamienkom =rovnosti . Ďalšie informácie: Gramatika vzorca YAML v jazyku Power Fx

Zlúčenie zmien v aplikácii Power Apps Studio

Pri zlučovaní zmien, ktoré sa vykonávajú v dvoch rôznych reláciách programu Power Apps Studio:

  • Skontrolujte, či sú všetky názvy ovládacích prvkov jedinečné. Napríklad vloženie tlačidla do dvoch rôznych relácií môže mať za následok dva Button1 ovládacie prvky. Ovládacie prvky odporúčame pomenovať hneď po ich vytvorení. Nástroj neprijíma dva ovládacie prvky s rovnakým názvom.
  • V prípade týchto súborov ich zlúčte ako zvyčajne:
    • \src*.fx.yaml
  • Ak dôjde ku konfliktom alebo chybám, môžete odstrániť tieto súbory:
    • \src\editorstate*.json – tieto súbory obsahujú voliteľné informácie v aplikácii Power Apps Studio.
    • \other\entropy.jsna
  • V prípade akýchkoľvek konfliktov v týchto súboroch je v poriadku prijať najnovšiu verziu:
    • \checksum.jsna
  • Ak sa pri týchto cestách nachádzajú konflikty zlúčenia, nie je bezpečné ich zlúčiť. V prípade, že sa to stáva často, dajte nám vedieť. Budeme pracovať na reštrukturalizácii formátu súborov, aby sa zabránilo konfliktom.
    • \Pripojenia*
    • \DataSources*
    • \pkgs*
    • CanvasManifest.json

Open-source

Príkazy plátna v rozhraní Microsoft Power Platform CLI sú open-source. Prediskutujte vylepšenia, nastolte problémy a získajte prístup k kódu z odkladacieho priestoru jazykových nástrojov služby Power Apps.

pac canvas validate

(Ukážka) Overenie zdroja .pa.yaml pre rozbalený súbor msapp

Povinné parametre pre canvas validate

--directory -d

Cesta k extrahovanému adresáru msapp obsahujúcemu súbory .pa.yaml na overenie

Pozri tiež

Microsoft Power Platform CLI Command Groups
Prehľad rozhrania Microsoft Power Platform CLI

  • Last updated on