Deli putem


pac platno

Rad sa Power Apps .msapp datotekama

[Ovaj članak predstavlja preliminarnu dokumentaciju i može se promeniti.]

Važno

  • Komande packunpack i komande nisu odobrene.
  • Da biste kontrolisali podlogu za crtanje, koristite Power Platform Git integraciju.
  • Komanda create je obično dostupna.

Komande

Command Opis
pac canvas create Generiši aplikaciju podloge za crtanje pomoću prilagođenog konektora
pac canvas download Preuzmite aplikaciju platna kao .msapp datoteku
pac canvas list Aplikacije za podlogu za crtanje liste
pac canvas pack (Pregled) Zapakujte izvore u msapp datoteku
pac canvas unpack (Pregled) Izdvajanje msapp datoteke u izvore
pac canvas validate (Pregled) Provera valjanosti .pa.yaml izvora za raspakovanu msapp datoteku

pac canvas create

Generiši aplikaciju podloge za crtanje pomoću prilagođenog konektora

Ova komanda će generisati .msapp aplikaciju podloge za crtanje zasnovanu na OpenAPI definiciji postojećeg prilagođenog konektora. Aplikacija će sadržati ekrane, raspored kontrole i generisan Power Fx kôd na osnovu toga kako su definisane radnje prilagođenog konektora, sa unapred definisanim izgledom i doživljajom. Aplikacija može da se koristi za direktno vežbanje radnji definisanih u prilagođenom konektoru.

Makers can import the generated .msapp into Power Apps Studio to play the app, or to do edits and make further customizations. Uvezite generisanu aplikaciju u Power Apps Studio tako što ćete preći na pregledanje>otvorenih> datotekau okviru studija.

Primeri

Sledeći primeri pokazuju upotrebu komande pac canvas create .

Kreiranje aplikacije podloge za crtanje zasnovane na Definiciji open API-ja po imenu za prikaz

Ovaj primer kreira aplikaciju podloge za crtanje (kao *.msapp datoteku) zasnovanu na Definiciji Open API-ja pomoću imena za prikaz konektora.

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

Kreiranje aplikacije podloge za crtanje zasnovane na definiciji Open API-ja po ID-u

Ovaj primer kreira aplikaciju podloge za crtanje (kao *.msapp datoteku) zasnovanu na Definiciji Open API-ja pomoću ID-a konektora.

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

Ili connector-display-name su connector-id obavezni.

Obavezni parametri za kreiranje podloge za crtanje

--msapp

Putanja do .msapp datoteke koja će se generisati

Opcionalni parametri za kreiranje podloge za crtanje

--connector-display-name

Ime za prikaz konektora iz kog se generiše Power App.

--connector-id

ID konektora iz kog se generiše Power App.

--environment

ID ili URL ciljnog okruženja. Podrazumevana vrednost je okruženje trenutno aktivnog Dataverse profila potvrde identiteta.

Primedbe

Razmatranja i ograničenja:

  • Prilagođeni konektor na koji se upućuje connector-display-nameconnector-id sa parametrima mora da bude deo rešenja.
  • Kada uvezete aplikaciju u Studio, neće biti povezivanja sa prilagođenim konektorom. Proizvođač mora ručno da doda referencu na prilagođeni konektor iz kojeg je aplikacija generisana pre nego što može da se reprodukuje aplikacija. Korake potražite u članku Dodavanje podataka za povezivanje u aplikacije podloge za crtanje. Dok to ne uradite, možda ćete videti greške u formuli u aplikaciji koje će se rešiti kada se doda referenca konektora. Ime prilagođenog konektora koji dodate u aplikaciju mora da se podudara sa imenom za prikaz prilagođenog konektora na koji se upućuje u komandi canvas create .
  • Aplikacija će sadržati po jedan ekran za svaku POST radnju GET koju konektor definiše.
    • Drugi glagoli dostupni u prilagođenim konektorima nisu podržani.
  • Kontrole vizuelizovane na ekranu svake radnje dinamički se generišu na osnovu definisanja tipova unosa i izlaza svake radnje. Određeni tipovi unosa i izlaza definisani u prilagođenom konektoru nisu podržani od strane canvas create. Komanda će generisati upozorenja u konzoli kada se na njih naiđe. Određeni slučajevi:
    • Nizovi objekata i nizova nizova nisu podržani kao unosi
    • Kontrole se ne generišu za objekte ili ugnežđene nizove izvan dubine od 20
    • Tipovi "Datoteka" i "binarni format" nisu podržani za unos ili izlaz.

pac canvas download

Preuzmite aplikaciju platna kao .msapp datoteku

Obavezni parametri za preuzimanje podloge za crtanje

--name -n

Tačna aplikacija podloge za crtanje, delimično ime ili ID aplikacije

Opcionalni parametri za preuzimanje podloge za crtanje

--environment -env

Navodi ciljni Dataverse. Vrednost može biti GUID ili apsolutni https URL. Kada nije navedeno, koristiće se aktivna organizacija izabrana za trenutni profil potvrde potvrde.

--extract-to-directory -d

Ime direktorijuma u koje se izdvaja aplikacija podloge za crtanje

--file-name -f

Ime datoteke (obično sa oznakom tipa datoteke .msapp). Ako se datoteka koja nije obezbeđena čuva se u trenutnom direktorijumu sa "appname".msapp

--overwrite -o

Dozvoli zamenu datoteke

Ovaj parametar ne zahteva nikakvu vrednost. To je prekidaи.

pac canvas list

Aplikacije za podlogu za crtanje liste

Opcionalni parametri za listu podloge za crtanje

--environment -env

Navodi ciljni Dataverse. Vrednost može biti GUID ili apsolutni https URL. Kada nije navedeno, koristiće se aktivna organizacija izabrana za trenutni profil potvrde potvrde.

pac canvas pack

(Pregled) Zapakujte izvore u msapp datoteku

Primer

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

Obavezni parametri za paket podloge za crtanje

--msapp

Putanja do .msapp datoteke

--sources

Direktorijum u izvore koje treba zapakovati

Primedbe

Kreira datoteku .msapp od prethodno raspakovanih izvornih datoteka. Rezultat se može otvoriti u programskom dodatku Power Apps Studio tako što ćete preći na pregledanje>otvorenih>datoteka.

Kada se raspakuju, izvorne datoteke se mogu uređivati i upravljati spoljnim alatkama kao što su Visual Studio Code i GitHub.

pac canvas unpack

(Pregled) Izdvajanje msapp datoteke u izvore

Primer

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

Raspakuša se u podrazumevani HelloWorld_src direktorijum.

Obavezni parametri za raspakunu podloge za crtanje

--msapp

Putanja do .msapp datoteke

Opcionalni parametri za raspakunu podloge za crtanje

--sources

Direktorijum u izvore koje treba raspakovati

Primedbe

Raspakuša izvornu .msapp datoteku.

Preuzmite datoteku .msapp iz aplikacije Power Apps Studio tako što ćete preći na datoteku>Sačuvaj kao>ovaj računar.

Ako parametar izvora nije naveden, .msapp_src direktorijum sa istim imenom i lokacijom kao datoteka koristi se sa sufiksom.

Struktura fascikle

Svojstva raspak i paketa koriste sledeću strukturu fascikli:

  • \src - Datoteke kontrole i komponente. Ovo sadrži izvore.
    • *.fx.yaml - Formule izdvojene iz datoteke control.json .

      Belešku

      Ovo je mesto za uređivanje formula.

    • CanvasManifest.json – datoteka manifesta koja sadrži informacije koje obično postoje u zaglavlju, svojstvima i objavljivanju informacija.
    • *.json - Siroиki dosije control.json .
    • \EditorState*.editorstate.json – Keširane informacije koje power Apps Studio može da koristi.
  • \DataSources - Svi izvori podataka koje aplikacija koristi.
  • \Connections – Instance veze sačuvane sa aplikacijom i koriste se prilikom ponovnog učitavanja u Power Apps Studio.
  • \Assets – Medijske datoteke ugrađene u aplikaciju.
  • \pkgs - preuzeta kopija spoljnih referenci, kao što su predlošci, datoteke definicije API-ja i biblioteke komponenti. Slične su nuGet/NPM referencama.
  • \other - Sve raznolike datoteke potrebne za ponovno kreiranje .msapp.
    • entropy.json – Nepostojani elementi (kao što su vremenske oznake) izdvojuju se u ovu datoteku. To doprinosi smanjenju gadnih razlika u drugim datotekama i osigurava da i dalje možemo da se povratno odazivamo.
    • Čuva druge datoteke iz aplikacije msapp, kao što je ono što se \rfunkcijama.

Format datoteke

Datoteke .fx.yaml koriste podskup usluge YAML. Slično programu Excel, svi izrazi treba da počinju znakom jednakosti =. Više informacija: Power Fx YAML gramatika formule

Objedinjavanje promena pomoću programskog dodatka Power Apps Studio

Prilikom objedinjavanja promena koje su napravljene u dve različite Power Apps Studio sesije:

  • Uverite se da su sva imena kontrola jedinstvena. Na primer, umetanje dugmeta u dve različite sesije može dovesti do dve Button1 kontrole. Preporučujemo da kontrole imenujete ubrzo nakon kreiranja. Alatka ne prihvata dve kontrole sa istim imenom.
  • Za ove datoteke, objedinite ih kao i obično:
    • \src*.fx.yaml
  • Ako postoje neusaglašenosti ili greške, možete da izbrišete ove datoteke:
    • \src\editorstate*.json – Ove datoteke sadrže opcionalne informacije u programu Power Apps Studio.
    • \other\entropy.jsuključeno
  • Za sve neusaglašenosti u ovim datotekama, u redu je da prihvatite najnoviju verziju:
    • \checksum.jsuključeno
  • Ako u ovim putanjama postoje neusaglašenosti objedinjavanja, nije bezbedno objedinjavanje. Javite nam ako se to često dešava; radićemo na restrukturiranju formata datoteke da bismo izbegli neusaglašenosti.
    • \Veze*
    • \Izvori podataka*
    • \pkgs*
    • CanvasManifest.json

Otvori izvor

Komande podloge za crtanje u MICROSOFT Power Platform CLI su otvoreni izvor. Diskutujte o poboljšanjima, povećajte probleme i pristupite kodu iz power Apps depoa za alatke za jezik.

pac canvas validate

(Pregled) Provera valjanosti .pa.yaml izvora za raspakovanu msapp datoteku

Provera valjanosti obaveznih parametara za podlogu za crtanje

--directory -d

Putanja do izdvojenog direktorijuma msapp koji sadrži .pa.yaml datoteke za proveru valjanosti

Takođe pogledajte

Microsoft Power Platform CLI Command Groups
Microsoft Power Platform CLI pregled