Megosztás:

pac canvas

Power Apps .msapp-fájlok használata

[Ez a cikk egy előzetes kiadási dokumentáció, amely a későbbiekben változhat.]

Fontos

  • A pack parancsok elavultak unpack .
  • A vászonalapú alkalmazás forrásvezérléséhez használja a Power Platform Git-integrációt.
  • A create parancs általánosan elérhető.

Commands

Command Description
pac canvas create Vászonalapú alkalmazás létrehozása egyéni összekötőből
pac canvas download Vászonalapú alkalmazás letöltése .msapp fájlként
pac canvas list Vászonalapú alkalmazások listázása
pac canvas pack (Előzetes verzió) Források csomagolása msapp-fájlba
pac canvas unpack (Előzetes verzió) Msapp-fájl kinyerése forrásokba
pac canvas validate (Előzetes verzió) A .pa.yaml forrás ellenőrzése kibontott msapp-fájlhoz

pac canvas create

Vászonalapú alkalmazás létrehozása egyéni összekötőből

Ez a parancs létrehoz egy .msapp vászonalapú alkalmazást egy meglévő egyéni összekötő OpenAPI-definíciója alapján. Az alkalmazás képernyőket, vezérlőelrendezést és Power Fx-kódot fog tartalmazni, amelyek az egyéni összekötő műveleteinek definiálása alapján jönnek létre, előre meghatározott megjelenéssel és érzettel. Az alkalmazás az egyéni összekötőben definiált műveletek közvetlen gyakorlására használható.

A készítők importálhatják a létrehozott .msapp adatokat a Power Apps Studióba az alkalmazás lejátszásához, illetve szerkesztéshez és további testreszabásokhoz. Importálja a létrehozott alkalmazást a Power Apps Studióba aFájlmegnyitás>>tallózása a Studióban lépéssel.

Példák

Az alábbi példák a parancs használatát pac canvas create mutatják be.

Vászonalapú alkalmazás létrehozása open API-definíció alapján megjelenítendő név alapján

Ez a példa létrehoz egy vászonalapú alkalmazást (*.msapp fájlként) egy Open API-definíció alapján az összekötő megjelenítendő nevével.

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

Vászonalapú alkalmazás létrehozása open API-definíció alapján azonosító alapján

Ez a példa létrehoz egy vászonalapú alkalmazást (*.msapp fájlként) egy Open API-definíció alapján az összekötő azonosítójával.

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

connector-display-name Vagy connector-id szükség van gombra.

Kötelező paraméterek a következőhöz: canvas create

--msapp

A létrehozandó .msapp fájl elérési útja

Választható paraméterek a következőhöz: canvas create

--connector-display-name

A Power Appot létrehozó összekötő megjelenítendő neve.

--connector-id

A Power Appot létrehozó összekötő azonosítója.

--environment

A célkörnyezet azonosítója vagy URL-címe. Az alapértelmezett érték a jelenleg aktív Dataverse hitelesítési profil környezete.

Megjegyzések

Szempontok és korlátozások:

  • A vagy paraméterekkel connector-display-nameconnector-id hivatkozott egyéni összekötőnek egy megoldás részét kell képeznie.
  • Miután importálta az alkalmazást a Studióba, nem lesz társítás az egyéni összekötőhöz. A készítőnek manuálisan kell hozzáadnia egy hivatkozást arra az egyéni összekötőre, amelyből az alkalmazás létrejött az alkalmazás lejátszása előtt. A lépésekért tekintse meg az Adatkapcsolatok hozzáadása vászonalapú alkalmazásokhoz című témakört. Amíg ez nem történik meg, az alkalmazásban képlethibák léphetnek fel, amelyek az összekötő referenciájának hozzáadása után megoldódnak. Az alkalmazáshoz hozzáadott egyéni összekötő nevének meg kell egyeznie a parancsban canvas create hivatkozott egyéni összekötő megjelenítendő nevével.
  • Az alkalmazás mindegyikhez POSTGET egy képernyőt és az összekötő által definiált műveletet tartalmaz.
    • Az egyéni összekötőkben elérhető egyéb igék nem támogatottak.
  • Az egyes műveletek képernyőjén megjelenített vezérlők dinamikusan jönnek létre az egyes műveletek bemeneti és kimeneti típusainak meghatározása alapján. Az egyéni összekötőben meghatározott bemeneti és kimeneti típusokat a program nem támogatja canvas create. A parancs figyelmeztetéseket fog generálni a konzolon, amikor ezek előfordulnak. Konkrét esetek:
    • Az objektumok és tömbök tömbjei bemenetként nem támogatottak
    • A vezérlők nem jönnek létre olyan objektumokhoz vagy beágyazott tömbökhöz, amelyek mélysége meghaladja a 20-at
    • A "Fájl" és a "bináris formátum" típus nem támogatott a bemenethez és a kimenethez.

pac canvas download

Vászonalapú alkalmazás letöltése .msapp fájlként

Kötelező paraméterek a következőhöz: canvas download

--name -n

Vászonalapú alkalmazás pontos, részleges neve vagy alkalmazásazonosítója

Választható paraméterek a következőhöz: canvas download

--environment -env

A céladat-adatverset adja meg. Az érték lehet guid vagy abszolút https URL-cím. Ha nincs megadva, a rendszer az aktuális hitelesítési profilhoz kiválasztott aktív szervezetet használja.

--extract-to-directory -d

A vászonalapú alkalmazás kinyeréséhez használt címtárnév

--file-name -f

Fájlnév (általában .msapp kiterjesztéssel). Ha a megadott fájl nincs megadva, a rendszer az aktuális könyvtárba menti az "appname".msapp fájllal

--overwrite -o

Fájl felülírása engedélyezése

Ehhez a paraméterhez nincs szükség értékre. Ez egy kapcsoló.

pac canvas list

Vászonalapú alkalmazások listázása

Választható paraméterek a következőhöz: canvas list

--environment -env

A céladat-adatverset adja meg. Az érték lehet guid vagy abszolút https URL-cím. Ha nincs megadva, a rendszer az aktuális hitelesítési profilhoz kiválasztott aktív szervezetet használja.

pac canvas pack

(Előzetes verzió) Források csomagolása msapp-fájlba

Example

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

Kötelező paraméterek a következőhöz: canvas pack

--msapp

Az .msapp fájl elérési útja

--sources

A csomagolandó források könyvtára

Megjegyzések

Létrehoz egy .msapp fájlt a korábban kicsomagolt forrásfájlokból. Az eredmény megnyitható a Power Apps Studióban aFájlmegnyitás>>tallózása elemre lépve.

A kicsomagolás után a forrásfájlok szerkeszthetők és kezelhetők olyan külső eszközökkel, mint a Visual Studio Code és a GitHub.

pac canvas unpack

(Előzetes verzió) Msapp-fájl kinyerése forrásokba

Example

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

pac canvas unpack --msapp HelloWorld.msapp

Kicsomagolás az alapértelmezett HelloWorld_src könyvtárba.

Kötelező paraméterek a következőhöz: canvas unpack

--msapp

Az .msapp fájl elérési útja

Választható paraméterek a következőhöz: canvas unpack

--sources

Kicsomagolandó források könyvtára

Megjegyzések

Kicsomagolja a forrásfájlt .msapp .

Töltse le a fájlt a .msapp Power Apps Studióból a Fájl>mentése>számítógépre lépéssel.

Ha a forrásparaméter nincs megadva, a rendszer egy olyan könyvtárat használ, amelynek neve és helye megegyezik a .msapp fájl utótagjával _src .

Mappastruktúra

A kicsomagolás és a csomagolás tulajdonságai a következő mappastruktúrát használják:

  • \src – Vezérlő- és összetevőfájlok. Ez tartalmazza a forrásokat.
    • *.fx.yaml – A fájlból control.json kinyert képletek.

      Megjegyzés:

      Itt szerkesztheti a képleteket.

    • CanvasManifest.json – Jegyzékfájl, amely a fejlécben, a tulajdonságokban és a publishInfo-ban általában megtalálható információkat tartalmazza.
    • *.json - A nyers control.json fájl.
    • \EditorState*.editorstate.json – Gyorsítótárazott információk a Power Apps Studió számára.
  • \DataSources – Az alkalmazás által használt összes adatforrás.
  • \Kapcsolatok – Az alkalmazással mentett és a Power Apps Studióba való újratöltéskor használt kapcsolatpéldányok.
  • \Assets – Az alkalmazásba beágyazott médiafájlok.
  • \pkgs – Külső hivatkozások, például sablonok, API-definíciós fájlok és összetevőtárak letöltött másolata. Ezek hasonlóak a NuGet-/NPM-hivatkozásokhoz.
  • \other – Az újra létrehozásához .msappszükséges összes egyéb fájl.
    • entropy.json – A fájlba az illékony elemek (például időbélyegek) lesznek kinyerve. Ez segít csökkenteni a zajos különbségeket a többi fájlban, miközben biztosítjuk, hogy továbbra is oda-vissza tudjunk utazni.
    • Más fájlokat is tárol az msappból, például \rkövetkeztetéseket.

Fájlformátum

A .fx.yaml fájlok a YAML egy részhalmazát használják. Az Excelhez hasonlóan minden kifejezésnek egyenlő előjellel kell kezdődnie =. További információ: Power Fx YAML-képletek nyelvtana

Módosítások egyesítése a Power Apps Studióval

Két különböző Power Apps Studio-munkamenetben végrehajtott módosítások egyesítésekor:

  • Győződjön meg arról, hogy az összes vezérlőnév egyedi. Ha például két különböző munkamenetbe szúr be egy gombot, az két Button1 vezérlőt eredményezhet. Javasoljuk, hogy a vezérlőket a létrehozásuk után rövid időn belül nevezze el. Az eszköz nem fogad el két azonos nevű vezérlőt.
  • Ezekhez a fájlokhoz a szokásos módon egyesítse őket:
    • \src*.fx.yaml
  • Ütközések vagy hibák esetén törölheti az alábbi fájlokat:
    • \src\editorstate*.json – Ezek a fájlok opcionális információkat tartalmaznak a Power Apps Studióban.
    • \other\entropy.jsbekapcsolva
  • A fájlok ütközései esetén a legújabb verziót érdemes elfogadni:
    • \checksum.jsbekapcsolva
  • Ha ezekben az útvonalakban egyesítési ütközések vannak, az egyesítés nem biztonságos. Tudassa velünk, hogy ez gyakran előfordul-e; Az ütközések elkerülése érdekében dolgozunk a fájlformátum átalakításán.
    • \Kapcsolatok*
    • \DataSources*
    • \pkgs*
    • CanvasManifest.json

Nyílt forráskód

A Microsoft Power Platform parancssori felületének vászonparancsai nyílt forráskódúak. A Power Apps nyelvi eszköztárából megismeri a fejlesztéseket, problémákat vet fel, és hozzáférhet a kódhoz.

pac canvas validate

(Előzetes verzió) A .pa.yaml forrás ellenőrzése kibontott msapp-fájlhoz

Kötelező paraméterek a következőhöz: canvas validate

--directory -d

Az érvényesítendő .pa.yaml fájlokat tartalmazó kinyert msapp könyvtár elérési útja

Lásd még

Microsoft Power Platform parancssori felület parancscsoportjai
A Microsoft Power Platform parancssori felületének áttekintése

  • Last updated on