pac canvas

Power Apps-en .msapp fitxategiekin funtzionatzea.

[Aurre-argitaratutako dokumentazioaren parte da artikulu hau, eta baliteke aldaketak jasatea.]

Important

  • Komandoak packunpack desagertu egin dira.
  • Zure mihise-aplikazioa iturburua kontrolatzeko, erabili Power Platform Git integrazioa.
  • Komandoa create orokorrean eskuragarri.

Commands

Command Description
pac canvas create Sortu mihise-aplikazio bat konektore pertsonalizatu batetik
pac canvas download Deskargatu oihaleko aplikazioa .msapp fitxategi gisa
pac canvas list Zerrendatu mihise-aplikazioak
pac canvas pack (Aurrebista) Paketatu iturburuak msapp fitxategi batean
pac canvas unpack (Aurrebista) Erauztu msapp fitxategi bat iturburuetan

pac canvas create

Sortu mihise-aplikazio bat konektore pertsonalizatu batetik

Komando honek oihalezko aplikazio bat .msapp sortuko du lehendik dagoen konektore pertsonalizatu baten OpenAPI definizioan oinarrituta. Aplikazioak pantailak, kontrol diseinua eta Power Fx kodea izango ditu, konektore pertsonalizatuaren ekintzak nola definitzen diren oinarrituta, aurrez definitutako itxura eta sentimenduarekin. Aplikazioa konektore pertsonalizatuan definitutako ekintzak zuzenean erabiltzeko erabil daiteke.

Sortzaileek sortutako .msapp produktuak Power Apps Studio-ra inportatu ditzakete aplikazioa erreproduzitzeko, edo edizioak egiteko eta pertsonalizazio gehiago egiteko. Inportatu sortutako aplikazioa Power Apps Studio-ra Fitxategiaireki>Arakatu> nabigatuz.

Examples

Ondorengo adibideek komandoaren pac canvas create erabilera erakusten dute.

Sortu mihise-aplikazio bat Open API definizioan oinarrituta, bistaratze-izenaren arabera

Adibide honek mihise-aplikazio bat sortzen du (*.msapp fitxategi gisa) Open API definizioan oinarrituta, konektorearen bistaratze-izena erabiliz.

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

Sortu mihise-aplikazio bat Open API definizioan oinarrituta IDaren arabera

Adibide honek mihise-aplikazio bat sortzen du (*.msapp fitxategi gisa) Open API definizioan oinarrituta, konektorearen IDa erabiliz.

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

connector-display-name Beharrezkoa edo connector-id beharrezkoa da.

Beharrezko parametroak honako canvas create

--msapp

Sortu beharreko .msapp fitxategiaren bide-izena

Aukerako parametroak canvas create

--connector-display-name

Power App sortzeko konektorearen bistaratze-izena.

--connector-id

Power App sortzeko konektorearen IDa.

--environment

Helburuko ingurunearen IDa edo URLa. Balio lehenetsia unean aktibo dagoen Dataverse-ren autentifikazio-profilaren ingurunea da.

Remarks

Kontuak eta mugak:

  • or parametroekin erreferentzia egiten den connector-display-nameconnector-id konektore pertsonalizatuak irtenbide baten parte izan behar du.
  • Aplikazioa Studio-ra inportatu ondoren, ez da konektore pertsonalizatuarekin loturarik egongo. Egileak eskuz gehitu behar dio aplikazioa sortu zen konektore pertsonalizatuari erreferentzia bat aplikazioa erreproduzitu aurretik. Ikus Gehitu datu-konexioak mihise-aplikazioei urratsak ikusteko. Hori egin arte, aplikazioan formula akatsak ikus ditzakezu, konektorearen erreferentzia gehitu ondoren konponduko direnak. Aplikazioari gehitzen diozun konektore pertsonalizatuaren izenak bat etorri behar du komandoan canvas create aipatzen den konektore pertsonalizatuaren bistaratze-izenarekin.
  • Aplikazioak pantaila bat izango du konektoreak definitzen duen ekintza bakoitzeko POSTGET .
    • Konektore pertsonalizatuetan erabilgarri dauden beste aditz batzuk ez dira onartzen.
  • Ekintza bakoitzaren pantailan errendatutako kontrolak dinamikoki sortzen dira, ekintza bakoitzaren sarrera eta irteera motak nola definitzen diren oinarrituta. Konektore pertsonalizatuan definitutako sarrera eta irteera mota batzuk ez dira onartzen canvas create. Komandoak abisuak sortuko ditu kontsolan horiek aurkitzen direnean. Specific cases:
    • Objektuen matrizeak eta matrizeen matrizeak ez dira sarrera gisa onartzen
    • Kontrolak ez dira sortzen 20 sakonera baino gehiagoko objektuentzat edo matrize habiaratuentzat
    • "Fitxategia" eta "formatu bitarra" motak ez dira onartzen sarreran edo irteeran.

pac canvas download

Deskargatu oihaleko aplikazioa .msapp fitxategi gisa

Beharrezko parametroak honako canvas download

--name -n

Canvas aplikazioaren izen zehatza, partziala edo aplikazioaren IDa

Aukerako parametroak canvas download

--environment -env

Helburuko Dataverse-a zehazten du. Balioa Guid edo https URL absolutua izan daiteke. Zehaztu ezean, uneko autentifikazio-profilerako hautatutako erakunde aktiboa erabiliko da.

--extract-to-directory -d

Oihaleko aplikazioa erauzteko direktorio-izena

--file-name -f

Fitxategi-izena (normalean .msapp luzapenarekin). Ematen ez bada, fitxategia uneko direktorioan gordeko da 'appname'.msapp

--overwrite -o

Baimendu fitxategia gainidaztea

Parametro honek ez du baliorik behar. Aldaketa bat da.

pac canvas list

Zerrendatu mihise-aplikazioak

Aukerako parametroak canvas list

--environment -env

Helburuko Dataverse-a zehazten du. Balioa Guid edo https URL absolutua izan daiteke. Zehaztu ezean, uneko autentifikazio-profilerako hautatutako erakunde aktiboa erabiliko da.

pac canvas pack

(Aurrebista) Paketatu iturburuak msapp fitxategi batean

Example

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

Beharrezko parametroak honako canvas pack

--sources

Paketatu beharreko iturburuen direktorioa

Aukerako parametroak canvas pack

--disable-load-from-yaml

Zehaztutakoan, paketatutako aplikazioa kargatzea desgaitzen du 'Src' direktorioko *.pa.yaml fitxategietatik. 'Iturburu-kodea' diseinuarekin soilik onartzen da.

Parametro honek ez du baliorik behar. Aldaketa bat da.

--layout

Iturburuen direktorioan erabili beharreko diseinua. Oharra: 'Esperimentala' diseinua zaharkituta eta etorkizuneko bertsio batean kenduko da. Erabili 'Iturburu-kodea' diseinua onartutako azken diseinuan.

Erabili balio hauetako bat:

  • Experimental
  • SourceCode

--msapp

.msapp fitxategiaren bide-izena

--overwrite

Baimendu fitxategia gainidaztea

Parametro honek ez du baliorik behar. Aldaketa bat da.

Remarks

Fitxategi bat sortzen du .msapp aurrez despaketatutako iturburu-fitxategietatik abiatuta. Emaitza Power Apps Studio-n ireki daiteke Fitxategi>ireki>arakatuz nabigatuz.

Despaketatu ondoren, iturburu-fitxategiak kanpoko tresnekin editatu eta kudeatu daitezke, hala nola Visual Studio Code eta GitHub.

pac canvas unpack

(Aurrebista) Erauztu msapp fitxategi bat iturburuetan

Example

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

pac canvas unpack --msapp HelloWorld.msapp

Direktorio lehenetsian HelloWorld_src despaketatzen du.

Beharrezko parametroak honako canvas unpack

--msapp

.msapp fitxategiaren bide-izena

Aukerako parametroak canvas unpack

--layout

Iturburuen direktorioan erabili beharreko diseinua. Oharra: 'Esperimentala' diseinua zaharkituta eta etorkizuneko bertsio batean kenduko da. Erabili 'Iturburu-kodea' diseinua onartutako azken diseinuan.

Erabili balio hauetako bat:

  • Experimental
  • SourceCode

--overwrite

Baimendu fitxategia gainidaztea

Parametro honek ez du baliorik behar. Aldaketa bat da.

--sources

Despaketatu beharreko iturburuen direktorioa

Remarks

Iturburu-fitxategia .msapp despaketatzen du.

Deskargatu fitxategia .msapp Power Apps Studio-tik Fitxategia> Gordeordenagailu> nabigatuz.

Iturburuen parametroa zehazten ez bada, fitxategiaren .msapp izen eta kokaleku bereko direktorioa erabiliko da atzizkiarekin_src.

Folder structure

Despaketatze eta paketatzearen propietateek honako karpeta-egitura erabiltzen dute:

  • \src - Kontrol eta osagaien fitxategiak. Iturriak biltzen ditu.
    • *.fx.yaml - Fitxategitik control.json ateratako formulak.

      Note

      Hau da zure formulak editatzeko lekua.

    • CanvasManifest.json - Goiburuan, propietateetan eta publishInfo-n normalean dagoen informazioa duen manifestu-fitxategia.
    • *.json - Fitxategi gordina control.json .
    • \EditorState*.editorstate.json - Cachean gordeta dagoen informazioa Power Apps Studio-k erabiltzeko.
  • \DataSources - Aplikazioak erabiltzen dituen datu-iturri guztiak.
  • \Konexioak : aplikazioarekin gordetako konexio-instantziak eta Power Apps Studio-n birkargatzean erabiltzen dira.
  • \Aktiboak - Aplikazioan kapsulatutako multimedia fitxategiak.
  • \pkgs - Kanpoko erreferentzien deskargatutako kopia, hala nola txantiloiak, APIen definizio-fitxategiak eta osagaien liburutegiak. NuGet/NPM erreferentzien antzekoak dira.
  • \other - Fitxategi berriak berriro sortzeko .msappbeharrezkoak diren fitxategi guztiak
    • entropy.json - Elementu lurrunkorrak (denbora-zigiluak esaterako) fitxategi honetara erauzten dira. Horrek beste fitxategi batzuetan desberdintasun zaratatsuak murrizten laguntzen du, joan-etorriko bidaia egin dezakegula ziurtatuz.
    • MSAPP-eko beste fitxategi batzuk gordetzen ditu, hala nola \references-en daudenak.

File format

Fitxategiek .fx.yamlYAML azpimultzo bat erabiltzen dute. Excel-en antzera, adierazpen guztiek zeinu =berdinarekin hasi behar dute. Informazio gehiago: Power Fx YAML formula gramatika

Aldaketak Power Apps Studio-rekin bateratzea

Power Apps Studio-ko bi saio desberdinetan egindako aldaketak bateratzean:

  • Ziurtatu kontrol-izen guztiak bakarrak direla. Adibidez, botoi bat bi saio desberdinetan txertatzeak bi Button1 kontrol sor ditzake. Kontrolei izena jartzea gomendatzen dizugu sortu bezain laster. Tresnak ez ditu izen bereko bi kontrol onartzen.
  • Fitxategi hauetarako, batu itzazu normalean egiten duzun bezala:
    • \src*.fx.yaml
  • Gatazkak edo akatsak izanez gero, fitxategi hauek ezaba ditzakezu:
    • \src\editorstate*.json - Fitxategi hauek Power Apps Studio-n aukerako informazioa dute.
    • \other\entropy.json
  • Fitxategi hauetan gatazkak izanez gero, bertsio berriena onartzea komeni da:
    • \checksum.json
  • Bide horien azpian batu gatazkak badaude, ez da segurua batu. Jakin dezagun hori maiz gertatzen bada; Fitxategi formatua berregituratzen lan egingo dugu, gatazkak saihesteko.
    • \Connections*
    • \DataSources*
    • \pkgs*
    • CanvasManifest.json

Open source

Microsoft Power Platform CLI-ko kanvas-eko komandoak kode irekikoak dira. Hobekuntzak eztabaidatu, arazoak planteatu eta Power Apps lengoaien tresnen biltegitik sartu kodea.

See also

Microsoft Power Platform CLI komando-taldeak
Microsoft Power Platform CLI ikuspegi orokorra

  • Last updated on