pac canvas

Töötamine Power Apps .msapp-failidega.

[See artikkel on väljalaske-eelne dokumentatsioon ja seda võidakse muuta.]

Important

Commands

Command Description
pac canvas create Lõuendirakenduse genereerimine kohandatud konnektori abil
pac canvas download Lõuendirakenduse allalaadimine .msapp-failina
pac canvas list Loendilõuendirakendused
pac canvas pack (Eelvaade) Allikate pakkimine msapp-faili
pac canvas unpack (Eelvaade) Msapp-faili ekstraktimine allikatesse

pac canvas create

Lõuendirakenduse genereerimine kohandatud konnektori abil

See käsk loob .msapp lõuendirakenduse olemasoleva kohandatud konnektori OpenAPI-määratluse põhjal. Rakendus sisaldab ekraane, juhtpaigutust ja genereeritud Power Fx-koodi vastavalt kohandatud konnektori toimingute määratlemise viisile eelmääratletud ilme ja tunde järgi. Rakendust saab kasutada kohandatud konnektoris määratletud toimingute otse teostamiseks.

Makerid saavad genereeritud .msapp importida Power Apps Studiosse rakenduse esitamiseks või redigeerimiseks ja täiendavate kohanduste tegemiseks. Genereeritud rakenduse importimiseks Power Apps Studiosse navigeerides faili>avamiseks>Sirvi stuudios.

Examples

Järgmised näited näitavad käsu kasutamist pac canvas create .

Lõuendirakenduse loomine open API määratluse põhjal kuvatava nime järgi

Selles näites luuakse konnektori kuvatava nimega lõuendirakendus (*.msapp-failina), mis põhineb Open API määratlusel.

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

Lõuendirakenduse loomine ID-põhise Open API määratluse põhjal

Selles näites luuakse konnektori ID-ga lõuendirakendus (*.msapp-failina), mis põhineb Open API määratlusel.

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

Üks connector-display-name või connector-id on nõutav.

Nõutavad parameetrid: canvas create

--msapp

Loodava msapp-faili tee

Valikulised parameetrid: canvas create

--connector-display-name

Konnektori kuvatav nimi, mille põhjal Power App luuakse.

--connector-id

Konnektori ID, mille põhjal Power App luuakse.

--environment

Sihtkeskkonna ID või URL. Vaikeväärtus on teie praegu aktiivse Dataverse Auth-profiili keskkond.

Remarks

Kaalutlused ja piirangud.

  • Kohandatud konnektor, millele või connector-display-name parameetritele viidatakseconnector-id, peab olema lahenduse osa.
  • Pärast rakenduse importimist stuudiosse ei seostata kohandatud konnektoriga. Enne rakenduse mängimist peab tegija käsitsi lisama viite kohandatud konnektorile, millest rakendus loodi. Juhised leiate teemast Andmeühenduste lisamine lõuendirakendustega . Kuni see pole tehtud, võite rakenduses näha valemivigu, mis pärast konnektoriviite lisamist laheneb. Rakendusse lisatava kohandatud konnektori nimi peab ühtima käsus canvas create viidatud kohandatud konnektori kuvatava nimega.
  • Rakendus sisaldab iga konnektori määratletud toimingu jaoks POSTGET ühte ekraani.
    • Muid kohandatud konnektorites saadaolevaid tegusõnne ei toetata.
  • Iga toimingu ekraanil renderdatud juhtelemendid luuakse dünaamiliselt olenevalt sellest, kuidas iga toimingu sisend- ja väljundtüübid on määratletud. Teatud tüüpi kohandatud konnektoris määratletud sisendit ja väljundit ei toeta .canvas create Käsk genereerib konsoolis nende ilmnemisel hoiatused. Specific cases:
    • Objektide massiive ja massiive ei toetata sisendina
    • Juhtelemente ei looda objektide ega pesastatud massiivide jaoks, mis on pikemad kui 20 sügavust
    • Faili- ja kahendvormingu tüüpe ei toetata sisendi ega väljundi puhul.

pac canvas download

Lõuendirakenduse allalaadimine .msapp-failina

Nõutavad parameetrid: canvas download

--name -n

Rakenduse Lõuend täpne, osaline nimi või rakenduse ID

Valikulised parameetrid: canvas download

--environment -env

Määrab sihtandmekanali. Väärtus võib olla GUID või absoluutne HTTPS-i URL. Kui seda pole määratud, kasutatakse praeguse autentimisprofiili jaoks valitud aktiivset organisatsiooni.

--extract-to-directory -d

Kataloogi nimi, millesse ekstraktitakse lõuendirakendus

--file-name -f

Faili nimi (tavaliselt laiendiga .msapp). Kui sisestatud fail on salvestatud praegusesse kausta rakendusega appname.msapp

--overwrite -o

Luba faili ülekirjutamine

See parameeter ei vaja väärtust. See on lüliti.

pac canvas list

Loendilõuendirakendused

Valikulised parameetrid: canvas list

--environment -env

Määrab sihtandmekanali. Väärtus võib olla GUID või absoluutne HTTPS-i URL. Kui seda pole määratud, kasutatakse praeguse autentimisprofiili jaoks valitud aktiivset organisatsiooni.

pac canvas pack

(Eelvaade) Allikate pakkimine msapp-faili

Example

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

Nõutavad parameetrid: canvas pack

--sources

Kataloog pakitavatesse allikatesse

Valikulised parameetrid: canvas pack

--disable-load-from-yaml

Kui see on määratud, keelab see pakitud rakenduse laadimise *.pa.yaml failidest 'Src' kataloogis. Toetatud ainult 'SourceCode' paigutusega.

See parameeter ei vaja väärtust. See on lüliti.

--layout

Allikate kataloogi paigutus. Märkus: 'Eksperimentaalne' paigutus on aegunud ja eemaldatakse tulevases väljaandes. Kasuta 'SourceCode' paigutust uusima toetatud paigutuse jaoks.

Kasutage ühte järgmistest väärtustest.

  • Experimental
  • SourceCode

--msapp

Msapp-faili tee

--overwrite

Luba faili ülekirjutamine

See parameeter ei vaja väärtust. See on lüliti.

Remarks

.msapp Loob faili varem lahtipakkimata lähtefailidest. Tulemi saab avada Power Apps Studios, kui liigute jaotisse Faili>avamine>Sirvi.

Pärast lahtipakkimist saab lähtefaile redigeerida ja hallata väliste tööriistadega (nt Visual Studio Code ja GitHub).

pac canvas unpack

(Eelvaade) Msapp-faili ekstraktimine allikatesse

Example

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

pac canvas unpack --msapp HelloWorld.msapp

Lahtipakkimine vaikekataloogi HelloWorld_src .

Nõutavad parameetrid: canvas unpack

--msapp

Msapp-faili tee

Valikulised parameetrid: canvas unpack

--layout

Allikate kataloogi paigutus. Märkus: 'Eksperimentaalne' paigutus on aegunud ja eemaldatakse tulevases väljaandes. Kasuta 'SourceCode' paigutust uusima toetatud paigutuse jaoks.

Kasutage ühte järgmistest väärtustest.

  • Experimental
  • SourceCode

--overwrite

Luba faili ülekirjutamine

See parameeter ei vaja väärtust. See on lüliti.

--sources

Lahtipakkitavate allikate kataloog

Remarks

Pakkib .msapp lähtefaili lahti.

Laadige .msapp fail power Apps Studiost alla, liikes suvandisse Faili>salvestamine selle arvutina>.

Kui allikate parameetrit pole määratud, kasutatakse järelliidetega failiga sama nime ja asukohaga .msapp_src kausta.

Folder structure

Atribuutide lahtipakkimine ja pakkimine kasutavad järgmist kaustastruktuuri:

  • \src – juhtelemendi- ja komponendifailid. See sisaldab allikaid.
    • *.fx.yaml – failist control.json ekstraktitud valemid.

      Note

      Siin saate valemeid redigeerida.

    • CanvasManifest.json – manifestifail, mis sisaldab tavaliselt päises, atribuudis ja publishInfos leiduvat teavet.
    • *.json – toorfail control.json .
    • \EditorState*.editorstate.json – vahemällu salvestatud teave Power Apps Studio kasutamiseks.
  • \DataSources – kõik rakenduse kasutatavad andmeallikad
  • \Connections – rakendusega salvestatud ühenduseeksemplarid, mida kasutatakse Power Apps Studiosse uuesti laadimisel.
  • \Assets – rakendusse manustatud meediumifailid.
  • \pkgs – välisviidete (nt mallid, API definitsioonifailid ja komponenditeegid) allalaaditud koopia. Need sarnanevad NuGeti/NPM-viidetega.
  • \other – kõik muud failid, mida on vaja faili uuesti loomiseks .msapp.
    • entropy.json – sellesse faili ekstraktitakse lenduvad elemendid (nt ajatemplid). See aitab vähendada teiste failide liiasuste erinevusi, tagades samas, et saaksime siiski edasi-tagasi reisida.
    • Sisaldab muid msappi faile, näiteks \rtuletatud faile.

File format

Failid .fx.yaml kasutavad YAML-i alamhulka. Sarnaselt Exceliga peaksid kõik avaldised algama võrdusmärgiga =. Lisateave: Power Fx YAML Formula Grammar

Muudatuste ühendamine Power Apps Studio abil

Kahe erineva Power Apps Studio seansi ajal tehtud muudatuste ühendamisel tehke järgmist.

  • Veenduge, et kõik juhtelemendinimed oleksid kordumatud. Näiteks nupu lisamisel kahele erinevale seansile võib tekkida kaks Button1 juhtelementi. Soovitame juhtelementidele nimi anda varsti pärast nende loomist. Tööriist ei aktsepteeri kahte sama nimega juhtelementi.
  • Nende failide korral ühendage need tavapärasel viisil.
    • \src*.fx.yaml
  • Konfliktide või tõrgete korral saate need failid kustutada.
    • \src\editorstate*.json – need failid sisaldavad valikulist teavet Power Apps Studios.
    • \other\entropy.json
  • Nende failide vastuolude korral on soovitatav aktsepteerida uusim versioon.
    • \checksum.json
  • Kui nende teede all esineb ühendamiskonflikte, pole ühendamine turvaline. Andke meile teada, kui see juhtub sageli; tegeleme failivormingu ümberkorraldamisega, et vältida konflikte.
    • \Connections*
    • \DataSources*
    • \pkgs*
    • CanvasManifest.json

Open source

Microsoft Power Platform CLI lõuendikäsud on avatud lähtekoodiga. Arutage täiustusi, tõstatage probleeme ja avage Power Appsi keeletööriistade hoidlast kood.

See also

Microsoft Power Platform CLI käsurühmad
Microsoft Power Platform CLI ülevaade

  • Last updated on