Dijeli putem

pac canvas

Rad s datotekama Power Apps .msapp.

[Ovaj je članak dokumentacija predizdanja i podložan je promjenama.]

Važno

Naredbe

Naredba Opis
pac canvas create Generiranje aplikacije platna iz prilagođenog poveznika
pac canvas download Preuzmite aplikaciju platna kao .msapp datoteku
pac canvas list Aplikacije područja crtanja popisa
pac canvas pack (Pretpregled) Zapakirajte izvore u datoteku aplikacije msapp
pac canvas unpack (Pretpregled) Izdvajanje datoteke msapp u izvore
pac canvas validate (Pretpregled) Provjera valjanosti izvora .pa.yaml za raspakirani msapp datoteku

pac canvas create

Generiranje aplikacije platna iz prilagođenog poveznika

Ta će naredba generirati aplikaciju .msapp za platno utemeljenu na definiciji OpenAPI postojećeg prilagođenog poveznika. Aplikacija će sadržavati zaslone, raspored kontrole i kod dodatka Power Fx generiran na temelju definiranih akcija prilagođenog poveznika, s unaprijed definiranim izgledom i dojmom. Aplikacija se može koristiti za izravno izvršavanje radnji definiranih u prilagođenom povezniku.

Stvaratelji mogu uvesti generirane podatke .msapp u Power Apps Studio da bi reproducirali aplikaciju ili ih uređivati i dodatno prilagođavati. Uvezite generiranu aplikaciju u Power Apps Studio tako da odete na mogućnost Pregledavanje>otvorenih datoteka>unutar programa Studio.

Primjeri

Sljedeći primjeri pokazuju korištenje naredbe pac canvas create .

Stvaranje aplikacije platna na temelju definicije Open API-ja prema zaslonskim nazivima

U ovom se primjeru stvara aplikacija platna (kao *.msapp datoteka) utemeljena na definiciji Open API-ja pomoću zaslonskog naziva poveznika.

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

Stvaranje aplikacije platna na temelju definicije Open API-ja prema ID-ju

U ovom se primjeru stvara aplikacija platna (kao *.msapp datoteka) utemeljena na definiciji Open API-ja pomoću ID-a poveznika.

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

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

Obavezni parametri za canvas create

--msapp

Put do .msapp datoteke za generiranje

Neobavezni parametri za canvas create

--connector-display-name

Zaslonski naziv poveznika iz koji se generira aplikacija Power App.

--connector-id

ID poveznika iz koji će se generirati aplikacija Power App.

--environment

ID ili URL ciljnog okruženja. Zadana je vrijednost okruženje trenutno aktivnog profila za Dataverse Auth.

Primjedbe

Napomene i ograničenja:

  • Prilagođeni poveznik referenciran s parametrima connector-display-nameconnector-id mora biti dio rješenja.
  • Nakon uvoza aplikacije u Studio neće biti pridruživanja prilagođenom povezniku. Proizvođač mora ručno dodati referencu prilagođenom povezniku iz kojeg je aplikacija generirana da bi se aplikacija reproducirala. Korake potražite u članku Dodavanje podatkovnih veza u aplikacije za platno . Dok to ne učinite, u aplikaciji će se možda prikazati pogreške u formulama koje će se riješiti nakon dodavanja reference poveznika. Naziv prilagođenog poveznika koji dodate u aplikaciju mora odgovarati zaslonski naziv prilagođenog poveznika na koji se poziva naredba canvas create .
  • Aplikacija će sadržavati po jedan zaslon za svaku akciju POSTGET koju definira poveznik.
    • Ostali glagoli dostupni u prilagođenim poveznicima nisu podržani.
  • Kontrole prikazane na zaslonu svake akcije dinamički se generiraju na temelju definiranih vrsta ulaza i izlaza svake akcije. Određene vrste ulaza i izlaza definirane u prilagođenom konektoru ne podržava canvas create. Naredba će generirati upozorenja na konzoli kada se ta naredba pojavi. Posebni slučajevi:
    • Polja objekata i polja polja nisu podržana kao unosi
    • Kontrole se ne generiraju za objekte ni ugniježđena polja iznad dubine 20
    • Vrste "Datoteka" i "binarni oblik" nisu podržane za ulaz ili izlaz.

pac canvas download

Preuzmite aplikaciju platna kao .msapp datoteku

Obavezni parametri za canvas download

--name -n

Točan, djelomičan naziv aplikacije Canvas ili ID aplikacije

Neobavezni parametri za canvas download

--environment -env

Određuje ciljni Dataverse. Vrijednost može biti GUID ili apsolutni https URL. Kada nije navedeno, koristit će se aktivna tvrtka ili ustanova odabrana za trenutni profil za auth.

--extract-to-directory -d

Naziv direktorija u koji će se izdvojiti aplikacija platna

--file-name -f

Naziv datoteke (obično s nastavkom .msapp). Ako nije navedena datoteka spremljena u trenutnom direktoriju s "appname".msapp

--overwrite -o

Dopusti pisanje preko datoteke

Ovaj parametar ne zahtijeva vrijednost. To je prekidač.

pac canvas list

Aplikacije područja crtanja popisa

Neobavezni parametri za canvas list

--environment -env

Određuje ciljni Dataverse. Vrijednost može biti GUID ili apsolutni https URL. Kada nije navedeno, koristit će se aktivna tvrtka ili ustanova odabrana za trenutni profil za auth.

pac canvas pack

(Pretpregled) Zapakirajte izvore u datoteku aplikacije msapp

Primjer

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

Obavezni parametri za canvas pack

--msapp

Put do datoteke .msapp

--sources

Direktorij za izvore za pakiranje

Primjedbe

Stvara datoteku .msapp iz prethodno raspakiranih izvornih datoteka. Rezultat se može otvoriti u aplikaciji Power Apps Studio tako da otvorite pregledavanje>otvorenih>datoteka.

Nakon raspakiranja, izvorne datoteke mogu se uređivati i njima upravljati pomoću vanjskih alata kao što su Visual Studio Code i GitHub.

pac canvas unpack

(Pretpregled) Izdvajanje datoteke msapp u izvore

Primjer

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

pac canvas unpack --msapp HelloWorld.msapp

Otpakirira se u zadani HelloWorld_src direktorij.

Obavezni parametri za canvas unpack

--msapp

Put do datoteke .msapp

Neobavezni parametri za canvas unpack

--sources

Direktorij za izvore koji će se raspakirati

Primjedbe

Otpakira izvornu .msapp datoteku.

Preuzmite datoteku .msapp iz aplikacije Power Apps Studio tako da otvorite datoteka Spremi>kao ovo>računalo.

Ako parametar izvora nije naveden, .msapp s nastavkom se koristi direktorij s istim nazivom i mjestom _src kao datoteka.

Struktura mape

Svojstva raspakiranja i pakiranja koriste sljedeću strukturu mapa:

  • \src – datoteke kontrola i komponenti. Ovo sadrži izvore.
    • *.fx.yaml – formule izdvojene iz control.json datoteke.

      Napomena

      Ovo je mjesto za uređivanje formula.

    • CanvasManifest.json – datoteka manifesta koja sadrži informacije koje obično postoje u zaglavlju, svojstvima i publishInfo.
    • *.json - Neobrađena control.json datoteka.
    • \EditorState*.editorstate.json – predmemorirane informacije za korištenje dodatka Power Apps Studio.
  • \DataSources – svi izvori podataka koje aplikacija koristi.
  • \Connections – instance povezivanja spremljene s aplikacijom i koriste se prilikom ponovnog učitavanja u Power Apps Studio.
  • \Assets – medijske datoteke ugrađene u aplikaciju.
  • \pkgs – preuzeta kopija vanjskih referenci, kao što su predlošci, datoteke definicija API-ja i biblioteke komponenti. Slične su referencama za NuGet/NPM.
  • \other - Sve razni datoteke potrebne za ponovno stvaranje .msapp.
    • entropy.json – u tu se datoteku izdvajaju promjenjivi elementi (kao što su vremenske oznake). Time se smanjuju bučne razlike u drugim datotekama uz istovremeno osiguravanje da i dalje možemo putovanja.
    • Zadržava druge datoteke iz aplikacije msapp, kao što je \reference.

Oblik datoteke

Datoteke .fx.yaml koriste podskup servisa YAML. Slično programu Excel, svi bi izrazi trebali započinjati znakom jednakosti =. Dodatne informacije: Gramatika za formule Power Fx YAML

Spajanje promjena pomoću dodatka Power Apps Studio

Prilikom spajanja promjena unesenih u dvije različite sesije dodatka Power Apps Studio:

  • Provjerite jesu li svi nazivi kontrola jedinstveni. Umetanje gumba u dvije različite sesije, primjerice, može rezultirati dvju Button1 kontrola. Preporučujemo da kontrolama dodijelite naziv čim ih stvorite. Alat ne prihvaća dvije kontrole istog naziva.
  • Za te datoteke spojite ih na uobičajen način:
    • \src*.fx.yaml
  • Ako postoje sukobi ili pogreške, možete izbrisati ove datoteke:
    • \src\editorstate*.json – te datoteke sadrže neobavezne informacije u dodatku Power Apps Studio.
    • \other\entropy.jsuključena
  • Za sve sukobe u tim datotekama možete prihvatiti najnoviju verziju:
    • \checksum.jsuključena
  • Ako na tim putovima postoje sukobi spajanja, spajanje nije sigurno. Javite nam događa li se to često; radit ćemo na restrukturiranju oblika datoteke kako bismo izbjegli sukobe.
    • \Veze*
    • \DataSources*
    • \pkgs*
    • CanvasManifest.json

Otvoreni izvor

Naredbe platna u programu Microsoft Power Platform CLI su otvorenog koda. Raspravljajte o poboljšanjima, prikazujte probleme i pristupajte kodu iz spremišta jezičnih alata aplikacije Power Apps.

pac canvas validate

(Pretpregled) Provjera valjanosti izvora .pa.yaml za raspakirani msapp datoteku

Obavezni parametri za canvas validate

--directory -d

Put do izdvojenog direktorija msapp koji sadrži .pa.yaml datoteke za provjeru valjanosti

Vidi također

Microsoft Power Platform CLI Command Groups
Pregled CLI-ja za Microsoft Power Platform

  • Last updated on