Dalintis per

pac canvas

"Power Apps" .msapp failų eksploatavimas

[Šis straipsnis yra negalutinio leidimo dokumentacija ir gali keistis.]

Svarbu

Komandas

Komanda Apibūdinimas
pac canvas create Drobės taikomosios programos generavimas naudojant pasirinktinę jungtį
pac canvas download Atsisiųsti drobės programėlę kaip .msapp failą
pac canvas list Pateikti drobės programėlių sąrašą
pac canvas pack (Peržiūra) Šaltinių pakavimas į "msapp" failą
pac canvas unpack (Peržiūra) "msapp" failo išskleidimas į šaltinius
pac canvas validate (Peržiūra) Išskleisto msapp failo .pa.yaml šaltinio tikrinimas

pac canvas create

Drobės taikomosios programos generavimas naudojant pasirinktinę jungtį

Ši komanda sugeneruos .msapp drobės programą pagal esamos pasirinktinės jungties OpenAPI apibrėžimą. Programėlėje bus rodomi ekranai, valdymo išdėstymas ir sugeneruotas "Power Fx" kodas, atsižvelgiant į tai, kaip apibrėžiami pasirinktinės jungties veiksmai, iš anksto apibrėžta išvaizda ir pojūtis. Programą galima naudoti norint tiesiogiai vykdyti veiksmus, apibrėžtus pasirinktinėje jungtyje.

Kūrėjai gali importuoti sugeneruotus .msapp duomenis į "Power Apps Studio", kad galėtų paleisti programėlę arba redaguoti ir atlikti tolesnius tinkinimus. Importuokite sugeneruotą taikomąją programą į "Power Apps Studio" pereidami į "Studio" failų>atidarymo>naršymą .

Pavyzdžiai

Tolesniuose pavyzdžiuose parodytas komandos naudojimas pac canvas create .

Drobės taikomosios programos kūrimas pagal "Open API" apibrėžimą pagal rodomą pavadinimą

Šiame pavyzdyje sukuriama drobės taikomoji programa (kaip *.msapp failas), pagrįsta "Open API" apibrėžimu, naudojant rodomą jungties pavadinimą.

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

Drobės taikomosios programos kūrimas pagal "Open API" apibrėžimą pagal ID

Šiame pavyzdyje sukuriama drobės taikomoji programa (kaip *.msapp failas), pagrįsta "Open API" aprašu, naudojant jungties ID.

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

Bet kuris connector-display-name iš jų arba connector-id yra būtinas.

Būtini parametrai canvas create

--msapp

Kelias į .msapp failą, kuris bus sugeneruotas

Pasirinktiniai parametrai, skirti canvas create

--connector-display-name

Rodomas jungties, iš kurios generuojamas "Power App", pavadinimas.

--connector-id

Jungties ID, iš kurio generuojamas "Power App".

--environment

Tikslinės aplinkos ID arba URL. Numatytoji reikšmė yra jūsų šiuo metu aktyvaus "Dataverse Auth" profilio aplinka.

Pastabos

Aspektai ir apribojimai:

  • Pasirinktinė jungtis, connector-display-name nurodyta su parametrais, connector-id turi būti sprendimo dalis.
  • Importavus programą į "Studio", nebus susiejimo su pasirinktinė jungtimi. Kūrėjas turi rankiniu būdu įtraukti nuorodą į pasirinktinę jungtį, iš kurios programa buvo sugeneruota, kad būtų galima paleisti programėlę. Veiksmus žr . Duomenų ryšių įtraukimas į drobės taikomąsias programas . Kol tai padarysite, taikomojoje programoje gali būti formulių klaidų, kurios bus išspręsmos įtraukus jungties nuorodą. Pasirinktinės jungties, kurią įtraukiate į taikomąją programą, pavadinimas turi atitikti komandoje canvas create nurodytos pasirinktinės jungties rodomą pavadinimą.
  • Taikomojoje programoje bus po vieną ekraną kiekvienam POST ir GET veiksmą, kurį apibrėžia jungtis.
    • Kiti veiksmažodžiai, galimi pasirinktinėse jungtyse, nepalaikomi.
  • Kiekvieno veiksmo ekrane generuojami valdikliai dinamiškai generuojami atsižvelgiant į tai, kaip apibrėžiami kiekvieno veiksmo įvesties ir išvesties tipai. Tam tikrų tipų įvesties ir išvesties, apibrėžtų pasirinktinėje jungtyje, nepalaiko canvas create. Komanda sugeneruos įspėjimus konsolėje, kai jie atsiras. Konkretūs atvejai:
    • Objektų masyvai ir masyvų masyvai nepalaikomi kaip įvestys
    • Valdikliai negeneruojami objektams arba įdėtiesiems masyvams, esantiems už 20 gylio ribų
    • Įvesties arba išvesties tipai "Failas" ir "dvejetainis formatas" nepalaikomi.

pac canvas download

Atsisiųsti drobės programėlę kaip .msapp failą

Būtini parametrai canvas download

--name -n

Tikslus drobės programos pavadinimas, dalinis pavadinimas arba taikomosios programos ID

Pasirinktiniai parametrai, skirti canvas download

--environment -env

Nurodo tikslinį "Dataverse". Reikšmė gali būti GUID arba absoliutus https URL. Jei nenurodyta, bus naudojama aktyvi organizacija, pasirinkta dabartiniam autentifikavimo profiliui.

--extract-to-directory -d

Katalogo pavadinimas, išskleisti drobės programą

--file-name -f

Failo vardas (paprastai su .msapp plėtiniu). Jei nepateiktas failas įrašomas dabartiniame kataloge su "appname".msapp

--overwrite -o

Leisti perrašyti failą

Šiam parametrui nereikia reikšmės. Tai jungiklis.

pac canvas list

Pateikti drobės programėlių sąrašą

Pasirinktiniai parametrai, skirti canvas list

--environment -env

Nurodo tikslinį "Dataverse". Reikšmė gali būti GUID arba absoliutus https URL. Jei nenurodyta, bus naudojama aktyvi organizacija, pasirinkta dabartiniam autentifikavimo profiliui.

pac canvas pack

(Peržiūra) Šaltinių pakavimas į "msapp" failą

Pavyzdžiui

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

Būtini parametrai canvas pack

--msapp

Kelias į .msapp failą

--sources

Katalogų, į kuriuos reikia supakuoti šaltinius

Pastabos

.msapp Sukuria failą iš anksčiau išpakuotų šaltinio failų. Rezultatą galima atidaryti naudojant "Power Apps Studio" nuėjus į Failo atidarymo>>naršymas.

Išpakavus šaltinio failus galima redaguoti ir valdyti naudojant išorinius įrankius, pvz., "Visual Studio Code" ir "GitHub".

pac canvas unpack

(Peržiūra) "msapp" failo išskleidimas į šaltinius

Pavyzdžiui

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

pac canvas unpack --msapp HelloWorld.msapp

Išpakuoja į numatytąjį HelloWorld_src katalogą.

Būtini parametrai canvas unpack

--msapp

Kelias į .msapp failą

Pasirinktiniai parametrai, skirti canvas unpack

--sources

Išpakuotų šaltinių katalogas

Pastabos

Išpakuoja .msapp šaltinio failą.

.msapp Atsisiųskite failą iš "Power Apps Studio" pereidami į Įrašyti failą>kaip>šį kompiuterį.

Jei šaltinių parametras nenurodytas, su plėtiniu naudojamas .msapp katalogas tokiu pačiu pavadinimu ir vieta, kaip _src ir failas.

Aplankų struktūra

Išpakavimo ir paketo ypatybės naudoja šią aplankų struktūrą:

  • \src – valdiklių ir komponentų failai. Jame yra šaltinių.
    • *.fx.yaml – iš control.json failo išskleistos formulės.

      Pastaba.

      Čia galite redaguoti formules.

    • CanvasManifest.json – deklaracijos failas, kuriame yra informacija, paprastai pateikiama antraštėje, ypatybėse ir publishInfo.
    • *.json – pirminis control.json failas.
    • \EditorState*.editorstate.json – "Power Apps Studio" talpykloje esanti informacija.
  • \DataSources – visi taikomosios programos naudojami duomenų šaltiniai.
  • \Connections – ryšio egzemplioriai, įrašyti su programa ir naudojami iš naujo įkeliant į "Power Apps Studio".
  • \Assets – į taikomąją programą įdėti medijos failai.
  • \pkgs – atsisiųsta išorinių nuorodų kopija, pvz., šablonai, API aprašų failai ir komponentų bibliotekos. Jos panašios į NuGet/NPM nuorodas.
  • \other – visi įvairūs failai, reikalingi iš naujo sukurti .msapp.
    • entropy.json – kintamieji elementai (pvz., laiko žymos) išgaunami į šį failą. Tai padeda sumažinti triukšmingus skirtumus kituose failuose ir kartu užtikrinti, kad vis tiek galėsime keliauti pirmyn ir atgal.
    • Turi kitų failų iš "msapp", pvz., kas yra \rįžvalgose.

Failo formatas

Failai .fx.yaml naudoja YAML poaigį. Panašiai kaip "Excel", visos išraiškos turi prasidėti lygybės ženklu =. Daugiau informacijos: "Power Fx YAML Formula Grammar"

Pakeitimų suliejimas naudojant "Power Apps Studio"

Kai suliejate keitimus, atliktus dviejuose skirtinguose "Power Apps Studio" seansuose:

  • Įsitikinkite, kad visi valdiklių pavadinimai yra unikalūs. Pavyzdžiui, įterpus mygtuką dviejuose skirtinguose seansuose, gali būti naudojami du Button1 valdikliai. Rekomenduojame netrukus po to, kai juos sukursite, pavadinti valdiklius. Įrankis nepriima dviejų valdiklių tokiu pačiu pavadinimu.
  • Suliekite šiuos failus kaip įprastai:
    • \src*.fx.yaml
  • Jei yra konfliktų arba klaidų, galite panaikinti šiuos failus:
    • \src\editorstate*.json – šiuose failuose yra pasirinktinės informacijos "Power Apps Studio".
    • \other\entropy.jsįjungta
  • Jei kyla šių failų konfliktų, galite priimti naujausią versiją:
    • \checksum.jsįjungta
  • Jei šiuose keliuose yra suliejimo konfliktų, suliejimas nėra saugus. Praneškite mums, jei taip nutinka dažnai; mes stengsimės pertvarkyti failo formatą, kad išvengtume konfliktų.
    • \Ryšius*
    • \Duomenų šaltiniai*
    • \pkgs*
    • CanvasManifest.json

Atidaryti šaltinį

Drobės komandos "Microsoft Power Platform" CLI yra atvirojo kodo. Aptarkite patobulinimus, iškelkite problemų ir pasiekite kodą iš "Power Apps" kalbos įrankių saugyklos.

pac canvas validate

(Peržiūra) Išskleisto msapp failo .pa.yaml šaltinio tikrinimas

Būtini parametrai canvas validate

--directory -d

Kelias į išskleistą msapp katalogą, kuriame yra .pa.yaml failų, kad būtų galima patikrinti

Taip pat žr.

"Microsoft Power Platform" CLI komandų grupės
"Microsoft Power Platform" CLI apžvalga

  • Last updated on