Jagamisviis:

pac canvas

Power Appsi .msapp-failidega töötamine

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

Oluline

Käsud

Käsk Kirjeldus
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 validate (Eelvaade) Tihendamata msapp-faili .pa.yaml-allika valideerimine

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.

Näited

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.

Märkused

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. Erijuhud:
    • 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

Näide

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

Nõutavad parameetrid: canvas pack

--msapp

Msapp-faili tee

--sources

Kataloog pakitavatesse allikatesse

Märkused

.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

Näide

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

--sources

Lahtipakkitavate allikate kataloog

Märkused

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.

Kausta struktuur

Atribuutide lahtipakkimine ja pakkimine kasutavad järgmist kaustastruktuuri:

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

      Märkus.

      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.

Failivorming

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.jssisse
  • Nende failide vastuolude korral on soovitatav aktsepteerida uusim versioon.
    • \checksum.jssisse
  • Kui nende teede all esineb ühendamiskonflikte, pole ühendamine turvaline. Andke meile teada, kui see juhtub sageli; tegeleme failivormingu ümberkorraldamisega, et vältida konflikte.
    • \Ühendused*
    • \DataSources*
    • \pkgs*
    • CanvasManifest.json

Ava allikas

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.

pac canvas validate

(Eelvaade) Tihendamata msapp-faili .pa.yaml-allika valideerimine

Nõutavad parameetrid: canvas validate

--directory -d

Valideerimiseks ekstraktitud msapp-kausta tee, mis sisaldab pa.yaml-faile

Vaata ka

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

  • Last updated on