Del via

pac canvas

Drift med .msapp-filer i Power Apps

[Denne artikel er dokumentation til den foreløbige udgivelse. Der kan forekomme ændringer.]

Vigtige oplysninger

  • Kommandoerne pack og unpack frarådes.
  • Hvis du vil styre din lærredsapp, skal du bruge Git Integration til Power Platform.
  • Kommandoen create er offentlig tilgængelig.

Kommandoer

Command Beskrivelse
pac canvas create Opret en lærredsapp fra en brugerdefineret connector
pac canvas download Download lærredsapp som .msapp-fil
pac canvas list Vis lærredsapps
pac canvas pack (eksempelvisning) Pak kilder til en msapp-fil
pac canvas unpack (eksempelvisning) Udpak en msapp-fil i kilder
pac canvas validate (eksempelvisning) Valider .pa.yaml-kilden for en ikke-pakket msapp-fil

pac canvas create

Opret en lærredsapp fra en brugerdefineret connector

Denne kommando genererer en .msapp lærredsapp baseret på OpenAPI-definitionen af en eksisterende brugerdefineret connector. Appen indeholder skærmbilleder, kontrollayout og Power Fx-kode, der genereres baseret på, hvordan handlingerne for den brugerdefinerede connector defineres med et foruddefineret udseende og funktionalitet. Appen kan bruges til direkte at udføre de handlinger, der er defineret i den brugerdefinerede connector.

Oprettere kan importere de genererede .msapp i Power Apps Studio for at afspille appen eller for at foretage ændringer og foretage yderligere tilpasninger. Importér den oprettede app til Power Apps Studio ved at gå til Åbn fil>>i Studio.

Eksempler

Følgende eksempler viser brugen af pac canvas create kommandoen.

Opret en lærredsapp baseret på en Open API-definition efter vist navn

I dette eksempel oprettes en lærredsapp (som en *.msapp-fil) baseret på en Open API-definition ved hjælp af connectorens viste navn.

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

Opret en lærredsapp baseret på en Open API-definition efter id

I dette eksempel oprettes en lærredsapp (som en *.msapp-fil) baseret på en Open API-definition ved hjælp af connectorens id.

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

Enten connector-display-name eller connector-id er påkrævet.

Obligatoriske parametre for canvas create

--msapp

Sti til .msapp-fil, der skal genereres

Valgfrie parametre for canvas create

--connector-display-name

Det viste navn på connectoren, som Power App skal genereres fra.

--connector-id

Id'et for den connector, som Power App skal genereres fra.

--environment

Destinationsmiljø-id'et eller URL-adressen. Standardværdien er miljøet for din aktive Dataverse Auth-profil.

Bemærkninger

Overvejelser og begrænsninger:

  • Den brugerdefinerede connector, der refereres til med parametrene connector-display-name eller connector-id , skal være en del af en løsning.
  • Når du har importeret appen til Studio, er der ingen tilknytning til den brugerdefinerede connector. Opretteren skal manuelt føje en reference til den brugerdefinerede connector, som appen blev oprettet ud fra, før appen kan afspilles. Se Føj dataforbindelser til lærredsapps for at få trin. Indtil dette er gjort, kan du få vist formelfejl i appen, som vil blive løst, når connectorreferencen er tilføjet. Navnet på den brugerdefinerede connector, du føjer til appen, skal svare til det viste navn på den brugerdefinerede connector, der refereres til i kommandoen canvas create .
  • Appen indeholder én skærm for hver POST og GET handling, som connectoren definerer.
    • Andre verber, der er tilgængelige i brugerdefinerede connectors, understøttes ikke.
  • De kontrolelementer, der gengives på hver handlings skærm, genereres dynamisk baseret på, hvordan input- og outputtyperne for hver handling defineres. Visse typer input og output, der er defineret i den brugerdefinerede connector, understøttes ikke af canvas create. Kommandoen genererer advarsler i konsollen, når disse registreres. Særlige tilfælde:
    • Matrixer af objekter og matrixer af matrixer understøttes ikke som input
    • Kontrolelementer genereres ikke for objekter eller indlejrede matrixer ud over en dybde på 20
    • Typerne "Fil" og "binært format" understøttes ikke for input eller output.

pac canvas download

Download lærredsapp som .msapp-fil

Obligatoriske parametre for canvas download

--name -n

Nøjagtigt, delvist navn eller app-id for lærredsapp

Valgfrie parametre for canvas download

--environment -env

Angiver måldataversen. Værdien kan være et GUID eller en absolut HTTPS URL-adresse. Når den ikke er angivet, bruges den aktive organisation, der er valgt til den aktuelle godkendelsesprofil.

--extract-to-directory -d

Mappenavn, som lærredsappen skal udtrækkes til

--file-name -f

Filnavn (normalt med filtypenavnet .msapp). Hvis den ikke er angivet, gemmes filen i den aktuelle mappe med 'appname'.msapp

--overwrite -o

Tillad overskrivning af fil

Denne parameter kræver ingen værdi. Det er en kontakt.

pac canvas list

Vis lærredsapps

Valgfrie parametre for canvas list

--environment -env

Angiver måldataversen. Værdien kan være et GUID eller en absolut HTTPS URL-adresse. Når den ikke er angivet, bruges den aktive organisation, der er valgt til den aktuelle godkendelsesprofil.

pac canvas pack

(eksempelvisning) Pak kilder til en msapp-fil

Eksempel

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

Obligatoriske parametre for canvas pack

--msapp

Sti til .msapp-fil

--sources

Mappe til kilder, der skal pakkes

Bemærkninger

Opretter en .msapp fil ud fra de tidligere udpakkede kildefiler. Resultatet kan åbnes i Power Apps Studio ved at gå til Åbn fil>>gennemsyn.

Når kildefilerne er pakket ud, kan de redigeres og administreres med eksterne værktøjer, f.eks. Visual Studio Code og GitHub.

pac canvas unpack

(eksempelvisning) Udpak en msapp-fil i kilder

Eksempel

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

pac canvas unpack --msapp HelloWorld.msapp

Pakker ud til standardmappen HelloWorld_src .

Obligatoriske parametre for canvas unpack

--msapp

Sti til .msapp-fil

Valgfrie parametre for canvas unpack

--sources

Mappe til kilder, der skal pakkes ud

Bemærkninger

Pakker kildefilen ud .msapp .

.msapp Download filen fra Power Apps Studio ved at gå til Gem fil>som>denne computer.

Hvis kildeparameteren ikke er angivet, bruges en mappe med samme navn og placering som .msapp filen med _src suffiks.

Mappestruktur

Udpaknings- og pakkeegenskaberne bruger følgende mappestruktur:

  • \src – Kontrol- og komponentfiler. Dette indeholder kilderne.
    • *.fx.yaml – De formler, der er udtrukket fra control.json filen.

      Notat

      Her kan du redigere formlerne.

    • CanvasManifest.json – En manifestfil, der indeholder de oplysninger, der normalt findes i headeren, egenskaberne og publishInfo.
    • *.json - Den rå control.json fil.
    • \EditorState*.editorstate.json – Cachelagrede oplysninger, som Power Apps Studio kan bruge.
  • \DataSources – Alle de datakilder, der bruges af appen.
  • \Connections – Forbindelsesforekomster, der er gemt sammen med appen, og som bruges, når der genindlæses i Power Apps Studio.
  • \Assets – Mediefiler, der er integreret i appen.
  • \pkgs – En downloadet kopi af eksterne referencer, f.eks. skabeloner, API-definitionsfiler og komponentbiblioteker. Disse svarer til NuGet/NPM-referencer.
  • \other – Alle diverse filer, der kræves for at genoprette .msapp.
    • entropy.json – Flygtige elementer (f.eks. tidsstempler) udpakkes til denne fil. Dette hjælper med at reducere støjende forskelle i andre filer og samtidig sikre, at vi stadig kan rundtur.
    • Indeholder andre filer fra msappen, f.eks. hvad der er i \references.

Filformat

Filerne .fx.yaml bruger et undersæt af YAML. På samme måde som Excel skal alle udtryk begynde med et lighedstegn =. Flere oplysninger: Power Fx YAML Formula Grammar

Fletning af ændringer med Power Apps Studio

Når du fletter ændringer, der er foretaget i to forskellige Power Apps Studio-sessioner:

  • Sørg for, at alle kontrolelementnavne er entydige. Hvis du f.eks. indsætter en knap i to forskellige sessioner, kan det resultere i to Button1 kontrolelementer. Vi anbefaler, at du navngiver kontrolelementerne, kort efter du har oprettet dem. Værktøjet accepterer ikke to kontrolelementer med samme navn.
  • For disse filer skal du flette dem, som du normalt gør:
    • \src*.fx.yaml
  • Hvis der er konflikter eller fejl, kan du slette disse filer:
    • \src\editorstate*.json – Disse filer indeholder valgfrie oplysninger i Power Apps Studio.
    • \other\entropy.jsden
  • Hvis der er konflikter i disse filer, er det ok at acceptere den nyeste version:
    • \checksum.jsden
  • Hvis der er nogen flettekonflikter under disse stier, er det ikke sikkert at flette. Giv os besked, hvis dette sker ofte; Vi arbejder på at omstrukturere filformatet for at undgå konflikter.
    • \Forbindelser*
    • \DataSources*
    • \pkgs*
    • CanvasManifest.json

Åben kildekode

Lærredskommandoerne i kommandolinjegrænsefladen til Microsoft Power Platform er åben kildekode. Diskuter forbedringer, hæv problemer, og få adgang til koden fra lageret med værktøjer til Power Apps-sprog.

pac canvas validate

(eksempelvisning) Valider .pa.yaml-kilden for en ikke-pakket msapp-fil

Obligatoriske parametre for canvas validate

--directory -d

Sti til den udpakkede msapp-mappe, der indeholder .pa.yaml-filer, der skal valideres

Se også

Kommandolinjekommandogrupper for Microsoft Power Platform
Oversigt over kommandolinjegrænsefladen til Microsoft Power Platform

  • Last updated on