Del via

pac lerret

Opererer med Power Apps .msapp-filer

[Denne artikkelen inneholder dokumentasjon for forhåndsversjonen og kan bli endret.]

Viktig!

Kommandoer

Kommando Description
pac lerret opprette Generer en lerretsapp fra en egendefinert kobling
pac lerret nedlasting Last ned lerretsapp som .msapp-fil
pac-lerretsliste Listelerretapper
pac lerret pakke (Forhåndsvisning) Pakke kilder inn i en msapp-fil
pac lerret pakke ut (Forhåndsvisning) Pakke ut en msappfil i kilder
pac lerret validere (Forhåndsvisning) Valider PA.yaml-kilden for en fil som ikke er tilordnet msapp

pac lerret opprette

Generer en lerretsapp fra en egendefinert kobling

Denne kommandoen genererer en .msapp lerretsapp basert på OpenAPI-definisjonen for en eksisterende egendefinert kobling. Appen vil inneholde skjermer, kontrolloppsett og Power Fx-kode generert basert på hvordan handlingene til den egendefinerte koblingen er definert, med et forhåndsdefinert utseende. Appen kan brukes til direkte å utøve handlingene som er definert i den egendefinerte koblingen.

Beslutningstakere kan importere de genererte .msapp til Power Apps Studio for å spille av appen, eller gjøre endringer og gjøre ytterligere tilpasninger. Importer den genererte appen til Power Apps Studio ved å navigere til Åpne fil>>bla gjennom i Studio.

Eksempler

Eksemplene nedenfor viser bruken av pac canvas create kommandoen.

Opprett en lerretsapp basert på en Åpen API-definisjon etter visningsnavn

Dette eksemplet oppretter en lerretsapp (som en *.msapp-fil) basert på en Åpen API-definisjon ved hjelp av visningsnavnet for koblingen.

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

Opprette en lerretsapp basert på en Åpen API-definisjon etter ID

Dette eksemplet oppretter en lerretsapp (som en *.msapp-fil) basert på en Åpen API-definisjon ved hjelp av ID-en for koblingen.

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

Enten connector-display-name eller connector-id er nødvendig.

Obligatoriske parametere for oppretting av lerret

--msapp

Banen til MSAPP-filen som skal genereres

Valgfrie parametere for oppretting av lerret

--connector-display-name

Visningsnavnet for koblingen du vil generere Power App fra.

--connector-id

ID-en til koblingen du vil generere Power App fra.

--environment

Målmiljø-IDen eller URL-adressen. Standardverdien er miljøet for den aktive dataverse godkjenningsprofilen.

Merknader

Vurderinger og begrensninger:

  • Den egendefinerte koblingen det refereres til med connector-display-name eller connector-id parameterne, må være en del av en løsning.
  • Når du har importert appen til Studio, vil det ikke være noen tilknytning til den egendefinerte koblingen. Oppretteren må manuelt legge til en referanse til den egendefinerte koblingen som appen ble generert fra før appen kan spilles av. Se Legge til datatilkoblinger i lerretsapper for trinn. Inntil dette er gjort, kan det hende du ser formelfeil i appen som løses når koblingsreferansen er lagt til. Navnet på den egendefinerte koblingen du legger til i appen, må samsvare med visningsnavnet for den egendefinerte koblingen som det refereres til i canvas create kommandoen.
  • Appen vil inneholde ett skjermbilde for hver POST og GET handling som koblingen definerer.
    • Andre verb som er tilgjengelige i egendefinerte koblinger, støttes ikke.
  • Kontrollene som gjengis på hver handlings skjerm, genereres dynamisk basert på hvordan inndata- og utdatatypene for hver handling defineres. Enkelte typer inndata og utdata som er definert i den egendefinerte koblingen, støttes ikke av canvas create. Kommandoen genererer advarsler i konsollen når disse oppstår. Spesifikke tilfeller:
    • Matriser med objekter og matriser med matriser støttes ikke som inndata
    • Kontroller genereres ikke for objekter eller nestede matriser utover en dybde på 20
    • Filtyper og binærformat støttes ikke for inndata eller utdata.

pac lerret nedlasting

Last ned lerretsapp som .msapp-fil

Obligatoriske parametere for nedlasting av lerret

--name -n

Lerretsapp nøyaktig, delvis navn eller app-ID

Valgfrie parametere for nedlasting av lerret

--environment -env

Angir måldataverset. Verdien kan være en GUID- eller absolutt URL-adresse for https. Når det ikke er angitt, brukes den aktive organisasjonen som er valgt for gjeldende godkjenningsprofil.

--extract-to-directory -d

Katalognavn som lerretsappen skal pakkes ut til

--file-name -f

Filnavn (vanligvis med .msapp-filtype). Hvis filen ikke er angitt, lagres den i gjeldende katalog med appname.msapp

--overwrite -o

Tillat overskriving av fil

Denne parameteren krever ingen verdi. Det er en bryter.

pac-lerretsliste

Listelerretapper

Valgfrie parametere for lerretsliste

--environment -env

Angir måldataverset. Verdien kan være en GUID- eller absolutt URL-adresse for https. Når det ikke er angitt, brukes den aktive organisasjonen som er valgt for gjeldende godkjenningsprofil.

pac lerret pakke

(Forhåndsvisning) Pakke kilder inn i en msapp-fil

Eksempel

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

Obligatoriske parametere for lerretspakke

--msapp

Bane til MSAPP-fil

--sources

Katalog til kilder som skal pakkes

Merknader

Oppretter en .msapp fil fra de tidligere utpakkede kildefilene. Resultatet kan åpnes i Power Apps Studio ved å navigere til Åpne fil>>bla gjennom.

Når du har pakket ut, kan kildefilene redigeres og administreres med eksterne verktøy som Visual Studio Code og GitHub.

pac lerret pakke ut

(Forhåndsvisning) Pakke ut en msappfil i kilder

Eksempel

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

pac canvas unpack --msapp HelloWorld.msapp

Pakker ut til standardkatalogen HelloWorld_src .

Obligatoriske parametere for utpakking av lerret

--msapp

Bane til MSAPP-fil

Valgfrie parametere for utpakking av lerret

--sources

Katalog til kilder som skal pakkes ut

Merknader

Pakker ut .msapp kildefilen.

.msapp Last ned filen fra Power Apps Studio ved å navigere til Fillagring>som>denne datamaskinen.

Hvis kildeparameteren ikke er angitt, brukes en katalog med samme navn og plassering som .msapp filen med _src suffiks.

Mappestruktur

Utpakking og pakkeegenskaper bruker følgende mappestruktur:

  • \src – kontroll- og komponentfiler. Dette inneholder kildene.
    • *.fx.yaml – formlene som er trukket ut fra control.json filen.

      Note

      Dette er stedet der du kan redigere formlene.

    • CanvasManifest.json – en manifestfil som inneholder informasjonen som vanligvis finnes i toppteksten, egenskapene og publishInfo.
    • *.json - Råfilen control.json .
    • \EditorState*.editorstate.json – bufret informasjon som Power Apps Studio kan bruke.
  • \Datakilder – alle datakildene som brukes av appen.
  • \Tilkoblinger – Tilkoblingsforekomster lagret med appen og brukes når du laster inn i Power Apps Studio på nytt.
  • \Aktiva – Mediefiler som er innebygd i appen.
  • \pkgs – en nedlastet kopi av eksterne referanser, for eksempel maler, API-definisjonsfiler og komponentbiblioteker. Disse ligner på NuGet/NPM-referanser.
  • \other - Alle diverse filer som kreves for å opprette .msapp.
    • entropy.json – flyktige elementer (for eksempel tidsstempel) pakkes ut til denne filen. Dette bidrar til å redusere støyende forskjeller i andre filer samtidig som vi sikrer at vi fortsatt kan reise rundt.
    • Inneholder andre filer fra msapp, for eksempel hva som er i \references.

Filformat

Filene .fx.yaml bruker et delsett av YAML. I likhet med Excel skal alle uttrykk begynne med et likhetstegn =. Mer informasjon: Power Fx YAML Formula Grammar

Slå sammen endringer med Power Apps Studio

Når du slår sammen endringer som gjøres i to forskjellige Power Apps Studio-økter:

  • Kontroller at alle kontrollnavnene er unike. Hvis du for eksempel setter inn en knapp i to forskjellige økter, kan det føre til to Button1 kontroller. Vi anbefaler at du gir navn til kontrollene kort tid etter at du har opprettet dem. Verktøyet godtar ikke to kontroller med samme navn.
  • For disse filene kan du flette dem slik du vanligvis gjør:
    • \src*.fx.yaml
  • Hvis det er konflikter eller feil, kan du slette disse filene:
    • \src\editorstate*.json – disse filene inneholder valgfri informasjon i Power Apps Studio.
    • \other\entropy.jspå
  • For eventuelle konflikter i disse filene er det greit å godta den nyeste versjonen:
    • \checksum.jspå
  • Hvis det er noen sammenslåingskonflikter under disse banene, er det ikke trygt å slå sammen. Gi oss beskjed hvis dette skjer ofte. vi skal arbeide med å restrukturere filformatet for å unngå konflikter.
    • \Tilkoblinger*
    • \Datakilder*
    • \pkgs*
    • CanvasManifest.json

Åpen kilde

Lerretskommandoene i Microsoft Power Platform CLI er åpen kildekode. Diskuter forbedringer, ta opp problemer og få tilgang til koden fra power apps-verktøyrepositoriet.

pac lerret validere

(Forhåndsvisning) Valider PA.yaml-kilden for en fil som ikke er tilordnet msapp

Obligatoriske parametere for lerretsvalidering

--directory -d

Bane til den utpakkede msapp-katalogen som inneholder PA.yaml-filer som skal valideres

Se også

Kommandogrupper for Microsoft Power Platform CLI
Oversikt over Microsoft Power Platform CLI

  • Last updated on