Kopīgot, izmantojot

pac canvas

Darbs ar Power Apps .msapp failiem.

[Šis raksts ir pirmsizlaides dokumentācija, kas var mainīties.]

Svarīgi

  • Un pack komandas ir unpack novecojušas.
  • Lai avota kontrolētu savu audekla programmu, izmantojiet Power Platform Git integrāciju.
  • Komanda create ir vispārēji pieejama.

Komandas

Komanda Apraksts
pac canvas create Audekla programmas ģenerēšana no pielāgota savienotāja
pac canvas download Audekla programmas lejupielāde .msapp faila formātā
pac canvas list Audekla programmu saraksts
pac canvas pack (Priekšskatījums) Avotu iepakošana msapp failā
pac canvas unpack (Priekšskatījums) MSAPP faila izvilkšana avotos
pac canvas validate (Priekšskatījums) Pārbaudiet .pa.yaml avotu izspiestam msapp failam

pac canvas create

Audekla programmas ģenerēšana no pielāgota savienotāja

Šī komanda ģenerēs audekla .msapp programmu, pamatojoties uz esoša pielāgota savienotāja OpenAPI definīciju. Programmā būs ekrāni, vadīklu izkārtojums un Power Fx kods, kas ģenerēts, pamatojoties uz to, kā ir definētas pielāgotā savienotāja darbības, ar iepriekš definētu izskatu un darbību. Programmu var izmantot, lai tieši veiktu pielāgotajā savienotājā definētās darbības.

Veidotāji var importēt ģenerēto .msapp saturu Power Apps Studio, lai atskaņotu programmu vai veiktu rediģēšanu un veiktu turpmākus pielāgojumus. Importējiet ģenerēto programmu Power Apps Studio, pārejot uz Failu>atvēršanas>pārlūkošana Studio.

Piemēri

Tālāk sniegtajos piemēros ir parādīta pac canvas create komandas izmantošana.

Audekla programmas izveide, pamatojoties uz atvērto API definīciju pēc parādāmā nosaukuma

Šajā piemērā tiek izveidota audekla programma (kā *.msapp fails), pamatojoties uz atvērto API definīciju, izmantojot savienotāja parādāmo nosaukumu.

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

Audekla programmas izveide, pamatojoties uz atvērto API definīciju pēc id

Šajā piemērā tiek izveidota audekla programma (kā *.msapp fails), pamatojoties uz atvērto API definīciju, izmantojot savienotāja ID.

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

Vai nu connector-display-name ir connector-id nepieciešams.

Nepieciešamie parametri canvas create

--msapp

Ceļš uz ģenerējamo .msapp failu

Neobligātie parametri canvas create

--connector-display-name

Savienotāja parādāmais nosaukums, no kura ģenerēt Power App.

--connector-id

Savienotāja ID, no kura ģenerēt Power App.

--environment

Mērķa vides ID vai URL. Noklusējuma vērtība ir jūsu pašlaik aktīvā Dataverse autentifikācijas profila vide.

Piezīmes

Apsvērumi un ierobežojumi:

  • Pielāgotajam savienotājam, uz kuru ir atsauce ar parametriem orconnector-display-name, connector-id ir jābūt risinājuma daļai.
  • Pēc programmas importēšanas Studio nebūs saistība ar pielāgoto savienotāju. Veidotājam ir manuāli jāpievieno atsauce uz pielāgoto savienotāju, no kura programma tika ģenerēta, pirms programmas atskaņošanas. Skatiet rakstu Datu savienojumu pievienošana audekla programmām, lai uzzinātu darbības. Kamēr tas nav izdarīts, programmā var tikt parādītas formulas kļūdas, kas tiks novērstas, kad tiks pievienota savienotāja atsauce. Pielāgotā savienotāja nosaukumam, ko pievienojat programmai, ir jāatbilst komandā canvas create norādītā pielāgotā savienotāja parādāmajam nosaukumam.
  • Lietotnē būs viens ekrāns katrai POSTGET darbībai, ko definē savienotājs.
    • Citi darbības vārdi, kas pieejami pielāgotajos savienotājos, netiek atbalstīti.
  • Katras darbības ekrānā atveidotās vadīklas tiek dinamiski ģenerētas, pamatojoties uz to, kā tiek definēti katras darbības ievades un izvades tipi. Noteiktus pielāgotajā savienotājā definētos ievades un izvades tipus neatbalsta canvas create. Komanda konsolē ģenerēs brīdinājumus, kad tie rodas. Īpašie gadījumi:
    • Objektu masīvi un masīvu masīvi netiek atbalstīti kā ievades
    • Vadīklas netiek ģenerētas objektiem vai ligzdotiem masīviem, kas atrodas ārpus 20 dziļuma
    • "Faila" un "binārā formāta" tipi netiek atbalstīti ievadei vai izvadei.

pac canvas download

Audekla programmas lejupielāde .msapp faila formātā

Nepieciešamie parametri canvas download

--name -n

Precīzs pamatnes programmas nosaukums, daļējs nosaukums vai programmas ID

Neobligātie parametri canvas download

--environment -env

Norāda mērķa Dataverse. Vērtība var būt GUID vai absolūtais https URL. Ja tas nav norādīts, tiks izmantota aktīvā organizācija, kas atlasīta pašreizējam autentifikācijas profilam.

--extract-to-directory -d

Direktorija nosaukums, uz kuru izvilkt audekla programmu

--file-name -f

Faila nosaukums (parasti ar paplašinājumu .msapp). Ja tas nav norādīts, fails tiek saglabāts pašreizējā direktorijā ar 'appname'.msapp

--overwrite -o

Atļaut faila pārrakstīšanu

Šim parametram nav nepieciešama vērtība. Tas ir slēdzis.

pac canvas list

Audekla programmu saraksts

Neobligātie parametri canvas list

--environment -env

Norāda mērķa Dataverse. Vērtība var būt GUID vai absolūtais https URL. Ja tas nav norādīts, tiks izmantota aktīvā organizācija, kas atlasīta pašreizējam autentifikācijas profilam.

pac canvas pack

(Priekšskatījums) Avotu iepakošana msapp failā

Piemērs

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

Nepieciešamie parametri canvas pack

--msapp

Ceļš uz .msapp failu

--sources

Iesaiņojamo avotu direktorijs

Piezīmes

Izveido .msapp failu no iepriekš izsaiņotiem avota failiem. Rezultātu var atvērt Power Apps Studio, pārejot uz Faila>atvēršanas>pārlūkošana.

Pēc izsaiņošanas avota failus var rediģēt un pārvaldīt, izmantojot ārējus rīkus, piemēram, Visual Studio Code un GitHub.

pac canvas unpack

(Priekšskatījums) MSAPP faila izvilkšana avotos

Piemērs

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

pac canvas unpack --msapp HelloWorld.msapp

Izpako noklusējuma HelloWorld_src direktorijā.

Nepieciešamie parametri canvas unpack

--msapp

Ceļš uz .msapp failu

Neobligātie parametri canvas unpack

--sources

Katalogs avotiem, kas jāizpako

Piezīmes

Izsaiņo avota .msapp failu.

Lejupielādējiet .msapp failu no Power Apps Studio, pārejot uz Fails>Saglabāt kā>šo datoru.

Ja parametrs avoti nav norādīts, direktorijs ar tādu pašu nosaukumu un atrašanās vietu kā .msapp fails tiek izmantots ar _src sufiksu.

Mapes struktūra

Izpakošanas un iepakošanas rekvizīti izmanto šādu mapju struktūru:

  • \src - Vadības un komponentu faili. Tas satur avotus.
    • *.fx.yaml — no faila izvilktās control.json formulas.

      Piezīmes

      Šī ir vieta, kur rediģēt formulas.

    • CanvasManifest.json — manifesta fails, kas satur informāciju, kas parasti atrodas galvenē, rekvizītos un publishInfo.
    • *.json - neapstrādāts control.json fails.
    • \EditorState*.editorstate.json — kešatmiņā saglabātā informācija, ko izmantot Power Apps Studio.
  • \DataSources — visi programmas izmantotie datu avoti.
  • \Savienojumi — savienojuma instances, kas saglabātas kopā ar programmu un izmantotas, atkārtoti ielādējot Power Apps Studio.
  • \Līdzekļi — programmā iegultie multivides faili.
  • \pkgs - Ārējo atsauču, piemēram, veidņu, API definīciju failu un komponentu bibliotēku, lejupielādēta kopija. Tās ir līdzīgas NuGet/NPM atsaucēm.
  • \other — visi dažādi faili, kas nepieciešami, lai atkārtoti izveidotu .msapp.
    • entropy.json — šajā failā tiek izvilkti gaistoši elementi (piemēram, laika zīmogi). Tas palīdz samazināt trokšņainās atšķirības citos failos, vienlaikus nodrošinot, ka mēs joprojām varam braukt turp un atpakaļ.
    • Glabā citus failus no msapp, piemēram, to, kas atrodas \references.

Faila formāts

Failos .fx.yaml tiek izmantota YAML apakškopa. Līdzīgi kā programmā Excel, visām izteiksmēm jāsākas ar vienādības zīmi =. Papildinformācija: Power Fx YAML formulas gramatika

Izmaiņu sapludināšana ar Power Apps Studio

Sapludinot izmaiņas, kas veiktas divās dažādās Power Apps Studio sesijās:

  • Pārliecinieties, vai visi vadīklu nosaukumi ir unikāli. Piemēram, ievietojot pogu divās dažādās sesijās, var tikt iegūtas divas Button1 vadīklas. Ieteicams nosaukt vadīklas drīz pēc to izveides. Rīks nepieņem divas vadīklas ar vienādu nosaukumu.
  • Sapludiniet šos failus kā parasti:
    • \src*.fx.yaml
  • Ja rodas konflikti vai kļūdas, varat izdzēst šos failus:
    • \src\editorstate*.json — šie faili satur neobligātu informāciju Power Apps Studio.
    • \other\entropy.jsieslēgts
  • Jebkādu konfliktu gadījumā šajos failos ir atļauts akceptēt jaunāko versiju:
    • \checksum.jsieslēgts
  • Ja šajos ceļos ir kādi sapludināšanas konflikti, sapludināšana nav droša. Informējiet mūs, ja tas notiek bieži; Mēs strādāsim pie faila formāta pārstrukturēšanas, lai izvairītos no konfliktiem.
    • \Savienojumus*
    • \Datu avoti*
    • \pkgs*
    • CanvasManifest.json

Atvērtais kods

Microsoft Power Platform CLI audekla komandas ir atvērtā koda. Apspriediet uzlabojumus, izvirziet problēmas un piekļūstiet kodam no Power Apps valodu rīku repozitorija.

pac canvas validate

(Priekšskatījums) Pārbaudiet .pa.yaml avotu izspiestam msapp failam

Nepieciešamie parametri canvas validate

--directory -d

Ceļš uz izvilkto msapp direktoriju, kas satur .pa.yaml failus, lai apstiprinātu

Skatiet arī:

Microsoft Power Platform CLI komandu grupas
Microsoft Power Platform CLI pārskats

  • Last updated on