Dela via

pac-arbetsyta

Arbeta med .msapp-filer för Power Apps

[Den här artikeln är en förhandsversion av dokumentationen och kan komma att ändras.]

Viktigt!

  • Kommandona pack och unpack är inaktuella.
  • Om du vill källstyra din arbetsyteapp använder du Power Platform Git-integreringen.
  • Kommandot create är allmänt tillgängligt.

Commands

Befallning Description
pac canvas create Generera en arbetsyteapp från en anpassad anslutningsapp
pac canvas download Ladda ned arbetsyteappen som .msapp-fil
pac-arbetsytelista Lista appar för arbetsytor
pac-arbetsytepaket (Förhandsversion) Packa källor i en msapp-fil
pac canvas packa upp (Förhandsversion) Extrahera en msapp-fil till källor
pac canvas validate (Förhandsversion) Verifiera .pa.yaml-källan för en uppackad msapp-fil

pac canvas create

Generera en arbetsyteapp från en anpassad anslutningsapp

Det här kommandot genererar en .msapp app för arbetsytor baserat på OpenAPI-definitionen för en befintlig anpassad anslutningsapp. Appen innehåller skärmar, kontrolllayout och Power Fx-kod som genereras baserat på hur åtgärderna i den anpassade anslutningsappen definieras, med ett fördefinierat utseende. Appen kan användas för att direkt utföra de åtgärder som definierats i den anpassade anslutningsappen.

Skapare kan importera de genererade .msapp till Power Apps Studio för att spela upp appen eller göra ändringar och göra ytterligare anpassningar. Importera den genererade appen till Power Apps Studio genom att gå till Arkiv>Öppna>bläddra i Studio.

Examples

I följande exempel visas användningen av pac canvas create kommandot.

Skapa en arbetsyteapp baserat på en Öppen API-definition efter visningsnamn

I det här exemplet skapas en arbetsyteapp (som en *.msapp-fil) baserat på en Öppen API-definition med hjälp av anslutningsappens visningsnamn.

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

Skapa en app för arbetsytor baserat på en Öppen API-definition efter ID

I det här exemplet skapas en arbetsyteapp (som en *.msapp-fil) baserat på en Öppen API-definition med hjälp av anslutningsappens ID.

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

Antingen connector-display-name eller connector-id krävs.

Obligatoriska parametrar för att skapa arbetsytor

--msapp

Sökväg till .msapp-fil som ska genereras

Valfria parametrar för att skapa arbetsytor

--connector-display-name

Visningsnamnet för anslutningsappen som powerappen ska genereras från.

--connector-id

ID:t för anslutningsappen som power app ska genereras från.

--environment

Målmiljöns ID eller URL. Standardvärdet är miljön för din aktiva autentiseringsprofil för Dataverse.

Anmärkningar

Överväganden och begränsningar:

  • Den anpassade anslutningsappen som refereras till med parametrarna connector-display-name eller connector-id måste vara en del av en lösning.
  • När du har importerat appen till Studio finns det ingen association till den anpassade anslutningsappen. Tillverkaren måste manuellt lägga till en referens till den anpassade anslutningsapp som appen genererades från innan appen kan spelas upp. Se Lägga till dataanslutningar till appar för arbetsytor för steg. Tills detta är klart kan du se formelfel i appen som löses när anslutningsreferensen har lagts till. Namnet på den anpassade anslutningsapp som du lägger till i appen måste matcha visningsnamnet för den anpassade anslutningsapp som canvas create refereras till i kommandot .
  • Appen innehåller en skärm för var och en POST och GET den åtgärd som anslutningsappen definierar.
    • Andra verb som är tillgängliga i anpassade anslutningsappar stöds inte.
  • Kontrollerna som återges på varje åtgärds skärm genereras dynamiskt baserat på hur indata- och utdatatyperna för varje åtgärd definieras. Vissa typer av indata och utdata som definierats i den anpassade anslutningsappen stöds inte av canvas create. Kommandot genererar varningar i konsolen när dessa påträffas. Specifika fall:
    • Matriser med objekt och matriser med matriser stöds inte som indata
    • Kontroller genereras inte för objekt eller kapslade matriser utöver ett djup på 20
    • Typerna "Fil" och "binärt format" stöds inte för indata eller utdata.

pac canvas download

Ladda ned arbetsyteappen som .msapp-fil

Obligatoriska parametrar för nedladdning av arbetsytor

--name -n

Exakt arbetsyteapp, partiellt namn eller app-ID

Valfria parametrar för nedladdning av arbetsytor

--environment -env

Anger måldataversum. Värdet kan vara en GUID- eller absolut https-URL. När det inte anges används den aktiva organisation som valts för den aktuella autentiseringsprofilen.

--extract-to-directory -d

Katalognamn för att extrahera arbetsyteapp till

--file-name -f

Filnamn (vanligtvis med .msapp-tillägget). Om den inte tillhandahålls sparas filen i den aktuella katalogen med "appname".msapp

--overwrite -o

Tillåt filöverskrivning

Den här parametern kräver inget värde. Det är en växel.

pac-arbetsytelista

Lista appar för arbetsytor

Valfria parametrar för arbetsytelista

--environment -env

Anger måldataversum. Värdet kan vara en GUID- eller absolut https-URL. När det inte anges används den aktiva organisation som valts för den aktuella autentiseringsprofilen.

pac-arbetsytepaket

(Förhandsversion) Packa källor i en msapp-fil

Example

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

Obligatoriska parametrar för arbetsytepaket

--msapp

Sökväg till .msapp-fil

--sources

Katalog till källor som ska packas

Anmärkningar

Skapar en .msapp fil från de tidigare uppackade källfilerna. Resultatet kan öppnas i Power Apps Studio genom att gå till Arkiv>öppna>bläddra.

När källfilerna har packats upp kan de redigeras och hanteras med externa verktyg som Visual Studio Code och GitHub.

pac canvas packa upp

(Förhandsversion) Extrahera en msapp-fil till källor

Example

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

pac canvas unpack --msapp HelloWorld.msapp

Packar upp till standardkatalogen HelloWorld_src .

Obligatoriska parametrar för att packa upp arbetsytor

--msapp

Sökväg till .msapp-fil

Valfria parametrar för att packa upp arbetsytor

--sources

Katalog till källor som ska packas upp

Anmärkningar

Packar .msapp upp källfilen.

.msapp Ladda ned filen från Power Apps Studio genom att gå till Spara fil>som>den här datorn.

Om parametern sources inte har angetts används en katalog med samma namn och plats som .msapp filen med _src suffixet.

Mappstrukturen

Packa upp och packa upp egenskaper använder följande mappstruktur:

  • \src – Kontroll- och komponentfiler. Detta innehåller källorna.
    • *.fx.yaml – formler som extraherats från control.json filen.

      Anmärkning

      Det här är platsen där du kan redigera formler.

    • CanvasManifest.json – en manifestfil som innehåller den information som normalt finns i rubriken, egenskaperna och publishInfo.
    • *.json – Raw-filen control.json .
    • \EditorState*.editorstate.json – Cachelagrad information som Power Apps Studio kan använda.
  • \DataSources – alla datakällor som används av appen.
  • \Anslutningar – Anslutningsinstanser som sparats med appen och används vid inläsning till Power Apps Studio igen.
  • \Assets – Mediefiler som är inbäddade i appen.
  • \pkgs – en nedladdad kopia av externa referenser, till exempel mallar, API-definitionsfiler och komponentbibliotek. Dessa liknar NuGet/NPM-referenser.
  • \other – Alla diverse filer som behövs för att återskapa .msapp.
    • entropy.json – Flyktiga element (som tidsstämplar) extraheras till den här filen. Detta bidrar till att minska bullriga skillnader i andra filer samtidigt som vi ser till att vi fortfarande kan åka tur och retur.
    • Innehåller andra filer från msappen, till exempel vad som finns i \references.

Filformat

Filerna .fx.yaml använder en delmängd av YAML. I likhet med Excel bör alla uttryck börja med ett likhetstecken =. Mer information: Power Fx YAML Formel grammatik

Slå samman ändringar med Power Apps Studio

När du sammanfogar ändringar som görs i två olika Power Apps Studio-sessioner:

  • Kontrollera att alla kontrollnamn är unika. Om du till exempel infogar en knapp i två olika sessioner kan det resultera i två Button1 kontroller. Vi rekommenderar att du namnger kontrollerna strax efter att du har skapat dem. Verktyget accepterar inte två kontroller med samma namn.
  • För dessa filer sammanfogar du dem som vanligt:
    • \src*.fx.yaml
  • Om det uppstår konflikter eller fel kan du ta bort dessa filer:
    • \src\editorstate*.json – Dessa filer innehåller valfri information i Power Apps Studio.
    • \other\entropy.jspå
  • För eventuella konflikter i dessa filer är det ok att acceptera den senaste versionen:
    • \checksum.jspå
  • Om det finns några sammanslagningskonflikter under dessa sökvägar är det inte säkert att slå samman. Låt oss veta om detta händer ofta; Vi arbetar med att omstrukturera filformatet för att undvika konflikter.
    • \Anslutningar*
    • \DataSources*
    • \Pkgs*
    • CanvasManifest.json

Öppen källkod

Arbetsytekommandona i Microsoft Power Platform CLI är öppen källkod. Diskutera förbättringar, skapa problem och få åtkomst till koden från lagringsplatsen för Power Apps-språkverktyg.

pac canvas validate

(Förhandsversion) Verifiera .pa.yaml-källan för en uppackad msapp-fil

Obligatoriska parametrar för verifiering av arbetsytor

--directory -d

Sökväg till den extraherade msapp-katalogen som innehåller .pa.yaml-filer för att verifiera

Se även

Microsoft Power Platform CLI-kommandogrupper
Översikt över Microsoft Power Platform CLI

  • Last updated on