Deli z drugimi prek

pac canvas

Delovanje z datotekami .msapp za Power Apps

[Ta članek je del predizdajne dokumentacije in se lahko spremeni.]

Pomembno

  • Ukazi packunpack in ukazi so zastareli.
  • Če želite nadzorovati aplikacijo za platno, uporabite integracijo platforme Power Platform Git.
  • Ukaz create je na splošno na voljo.

Ukazi

Ukaz Opis
pac canvas create Ustvarjanje aplikacije platno iz povezovalnika po meri
prenos pac canvas Prenesite aplikacijo platno kot datoteko .msapp
pac canvas list Seznam aplikacij na platnu
pac canvas pack (Predogled) Pripravi vire v datoteko msapp
razpakiranje pac canvas (Predogled) Ekstrahiranje datoteke msapp v vire
preverjanje veljavnosti platna pac (Predogled) Preverite veljavnost vira .pa.yaml za razširjeno datoteko msapp

pac canvas create

Ustvarjanje aplikacije platno iz povezovalnika po meri

S tem ukazom boste ustvarili aplikacijo .msapp na platnu, ki temelji na definiciji OpenAPI obstoječega povezovalnika po meri. Aplikacija bo vsebovala zaslone, postavitev kontrolnikov in kodo Power Fx, ustvarjeno na podlagi tega, kako so določena dejanja povezovalnika po meri z vnaprej določenim videzom in načinom delovanja. Z aplikacijo lahko neposredno izvajate dejanja, določena v povezovalniku po meri.

Ustvarjalci lahko uvozijo ustvarjene .msapp datoteke v Power Apps Studio za predvajanje aplikacije ali za urejanje in nadaljnje prilagoditve. Uvozite ustvarjeno aplikacijo v Power Apps Studio tako, da odprete brskanje po>datotekah>v aplikaciji Studio.

Primeri

Ti primeri prikazujejo uporabo ukaza pac canvas create .

Ustvarjanje aplikacije na platnu, ki temelji na definiciji Open API s prikazanim imenom

V tem primeru se ustvari program za platno (kot datoteka *.msapp), ki temelji na definiciji Open API z uporabo prikazanega imena povezovalnika.

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

Ustvarjanje aplikacije na platnu, ki temelji na definiciji Open API z ID-jem

V tem primeru se ustvari program za platno (kot datoteka *.msapp), ki temelji na definiciji Open API z ID-jem povezovalnika.

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

Potrebujete connector-display-name ali ne connector-id .

Zahtevani parametri za ustvarjanje platna

--msapp

Pot do datoteke .msapp, ki bo ustvarjena

Izbirni parametri za ustvarjanje platna

--connector-display-name

Prikazano ime povezovalnika, iz ki bo ustvaril Power App.

--connector-id

ID povezovalnika, iz katerem bo ustvarjen Power App.

--environment

ID ciljnega okolja ali URL. Privzeta vrednost je okolje trenutno aktivnega profila Dataverse Auth.

Pripombe

Priporočila in omejitve:

  • Povezovalnik po meri, na katerega se sklicujete connector-display-name s connector-id parametri ali mora biti del rešitve.
  • Ko uvozite aplikacijo v studio, ne bo povezave s povezovalnikom po meri. Izdelovalec mora ročno dodati sklic na povezovalnik po meri, iz katerega je bila aplikacija ustvarjena, preden je mogoče predvajati aplikacijo. Če želite navodila, glejte Dodajanje podatkovnih povezav na aplikacije na platnu. Dokler tega ne naredite, se lahko v aplikaciji prikaže napaka formule, ki se bo razrešila, ko boste dodali sklic povezovalnika. Ime povezovalnika po meri, ki ga dodate v aplikacijo, se mora ujemati s prikazanim imenom povezovalnika po meri, na katerega se sklicuje ukaz canvas create .
  • Aplikacija bo vsebovala en zaslon za vsako dejanje in POST dejanje GET , ki ga določi povezovalnik.
    • Drugi glagoli, ki so na voljo v povezovalnikih po meri, niso podprti.
  • Kontrolniki, upodobljeni na zaslonu posameznega dejanja, so dinamično ustvarjeni na podlagi tega, kako so določene vhodne in izhodne vrste vsakega dejanja. Nekatere vrste vhoda in izhoda, določene v povezovalniku po meri, ne podpirajo canvas create. Ukaz bo ustvaril opozorila v konzoli, ko bodo zaznana. Posebni primeri:
    • Matrike predmetov in matrik matrik niso podprte kot vhodi
    • Kontrolniki niso ustvarjeni za predmete ali ugnezdene matrike, ki presegajo globino 20
    • Vrste »Datoteka« in »dvojiška oblika« niso podprte za vnos ali izhod.

prenos pac canvas

Prenesite aplikacijo platno kot datoteko .msapp

Zahtevani parametri za prenos platna

--name -n

Natančno, delno ime aplikacije ali ID aplikacije Canvas

Izbirni parametri za prenos platna

--environment -env

Določa ciljni Dataverse. Vrednost je lahko GUID ali absolutni URL https. Če ni določeno, bo uporabljena aktivna organizacija, ki je izbrana za trenutni profil za preverjanje pristnosti.

--extract-to-directory -d

Ime imenika za ekstrahiranje aplikacije platno v

--file-name -f

Ime datoteke (običajno s pripono .msapp). Če datoteka ni na voljo, je shranjena v trenutnem imeniku z »appname«.msapp

--overwrite -o

Dovoli prepis datoteke

Ta parameter ne zahteva vrednosti. Stikalo je.

pac canvas list

Seznam aplikacij na platnu

Izbirni parametri za seznam platna

--environment -env

Določa ciljni Dataverse. Vrednost je lahko GUID ali absolutni URL https. Če ni določeno, bo uporabljena aktivna organizacija, ki je izbrana za trenutni profil za preverjanje pristnosti.

pac canvas pack

(Predogled) Pripravi vire v datoteko msapp

Primer

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

Zahtevani parametri za paket platna

--msapp

Pot do datoteke .msapp

--sources

Imenik do virov, ki bodo pakirani

Pripombe

Ustvari datoteko .msapp iz prej nepakiranih izvornih datotek. Rezultat lahko odprete v programu Power Apps Studio tako, da se pobrskate po možnosti »Odpri>datoteko>«.

Po razpakiranju lahko izvorne datoteke urejate in upravljate z zunanjimi orodji, kot sta koda Visual Studio in GitHub.

razpakiranje pac canvas

(Predogled) Ekstrahiranje datoteke msapp v vire

Primer

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

pac canvas unpack --msapp HelloWorld.msapp

Razpakiraj v privzeti HelloWorld_src imenik.

Zahtevani parametri za razpakiranje platna

--msapp

Pot do datoteke .msapp

Izbirni parametri za razpakiranje platna

--sources

Imenik do virov, ki bodo razpakirani

Pripombe

Razpakira izvorno .msapp datoteko.

Prenesite datoteko iz .msapp programa Power Apps Studio tako, da odprete možnost Shrani>kot>ta računalnik.

Če parameter virov ni naveden, je imenik z .msapp istim imenom in mestom kot datoteka uporabljena _src s pripono.

Struktura mape

Lastnosti razpakiranja in pakiranja uporabljajo to strukturo map:

  • \src – Datoteke kontrolnikov in komponent. To vsebuje vire.
    • *.fx.yaml – formule, izvlečene iz control.json datoteke.

      opomba,

      Tukaj lahko urejate formule.

    • CanvasManifest.json - datoteka manifesta, ki vsebuje informacije, ki so običajno prisotne v glavi, lastnostih in publishInfo.
    • *.json – neobdelana control.json datoteka.
    • \EditorState*.editorstate.json – predpomnjene informacije, ki jih lahko uporablja Power Apps Studio.
  • \DataSources – vsi viri podatkov, ki jih uporablja program.
  • \Connections – primerki povezave, shranjeni s programom in uporabljeni pri vnovičnem nanosu v Power Apps Studio.
  • \Assets – Predstavnostne datoteke, vdelane v aplikacijo.
  • \pkgs – prenesena kopija zunanjih sklicev, kot so predloge, datoteke z definicijami API-ja in knjižnice komponent. Ti so podobni sklicem NuGet/NPM.
  • \other – Vse razne datoteke, potrebne za vnovično ustvarjanje .msappdatoteke .
    • entropy.json – v to datoteko so izvlečeni hlapni elementi (kot so časovne žige). To pomaga zmanjšati glasne razlike v drugih datotekah, hkrati pa zagotavlja, da lahko še vedno krožna pot.
    • Ima druge datoteke iz msapp, na primer kaj je v \references.

Oblika zapisa datoteke

Datoteke .fx.yaml uporabljajo podnabor YAML. Podobno kot v Excelu se morajo vsi izrazi začeti z enačaj =. Več informacij: Power Fx YAML Formula Grammar

Spajanje sprememb s storitvijo Power Apps Studio

Pri spajanju sprememb, ki so bile narejene v dveh različnih sejah Power Apps Studio:

  • Zagotovite, da so vsa imena kontrolnikov enolična. Če na primer vstavite gumb v dve različni seji, lahko pride do dveh kontrolnikov Button1 . Priporočamo, da kontrolnike poimenujte kmalu po tem, ko jih ustvarite. Orodje ne sprejema dveh kontrolnikov z istim imenom.
  • Za te datoteke jih spojite kot običajno:
    • \src*.fx.yaml
  • Če obstajajo spori ali napake, lahko izbrišete te datoteke:
    • \src\editorstate*.json – Te datoteke vsebujejo izbirne informacije v programu Power Apps Studio.
    • \other\entropy.jsv
  • Za vse spore v teh datotekah lahko sprejmete najnovejšo različico:
    • \checksum.jsv
  • Če so pod temi potmi spori pri spajanju, spajanje ni varno. Sporočite nam, ali se to dogaja pogosto; prestrukturiranje oblike zapisa datoteke bomo prestrukturiranje, da se izognemo sporom.
    • \Povezave*
    • \Viri podatkov*
    • \Pkgs*
    • CanvasManifest.json

Odpri vir

Ukazi na platnu v platformi Microsoft Power Platform CLI so odprto kodo. Razpravljajte o izboljšavah, zaženite težave in dostopajte do kode v skladišču jezikovnih orodij za Power Apps.

preverjanje veljavnosti platna pac

(Predogled) Preverite veljavnost vira .pa.yaml za razširjeno datoteko msapp

Zahtevani parametri za preverjanje veljavnosti platna

--directory -d

Pot do ekstrahiranega imenika msapp, ki vsebuje datoteke .pa.yaml za preverjanje veljavnosti

Glej tudi

Microsoft Power Platform CLI Command Groups
Pregled okolja Microsoft Power Platform CLI

  • Last updated on