Delen via

pac canvas

Werken met .msapp-bestanden van Power Apps

[Dit artikel maakt deel uit van de voorlopige documentatie en kan nog veranderen.]

Belangrijk

  • De pack opdrachten en unpack opdrachten zijn afgeschaft.
  • Als u de canvas-app wilt beheren, gebruikt u de Git-integratie van Power Platform.
  • De create opdracht is algemeen beschikbaar.

Commands

Command Description
pac canvas maken Een canvas-app genereren op basis van een aangepaste connector
pac canvas downloaden Canvas-app downloaden als .msapp-bestand
pac canvas list Canvas-apps weergeven
pac canvas pack (Preview) Bronnen inpakken in een msapp-bestand
pac canvas uitpakken (Preview) Een msapp-bestand uitpakken in bronnen
pac canvas valideren (Preview) Valideer de .pa.yaml-bron voor een uitgepakt msapp-bestand

pac canvas maken

Een canvas-app genereren op basis van een aangepaste connector

Met deze opdracht wordt een canvas-app .msapp gegenereerd op basis van de OpenAPI-definitie van een bestaande aangepaste connector. De app bevat schermen, besturingsindeling en Power Fx-code die wordt gegenereerd op basis van hoe de acties van de aangepaste connector worden gedefinieerd, met een vooraf gedefinieerd uiterlijk. De app kan worden gebruikt om rechtstreeks de acties uit te oefenen die zijn gedefinieerd in de aangepaste connector.

Makers kunnen de gegenereerde .msapp gegevens importeren in Power Apps Studio om de app af te spelen of om wijzigingen uit te voeren en verdere aanpassingen aan te brengen. Importeer de gegenereerde app in Power Apps Studio door te navigeren naar Bladeren> bestand> openen in Studio.

Voorbeelden

In de volgende voorbeelden ziet u het gebruik van de pac canvas create opdracht.

Een canvas-app maken op basis van een Open API-definitie op weergavenaam

In dit voorbeeld wordt een canvas-app (als een *.msapp-bestand) gemaakt op basis van een Open API-definitie met behulp van de weergavenaam van de connector.

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

Een canvas-app maken op basis van een Open API-definitie op id

In dit voorbeeld wordt een canvas-app (als een *.msapp-bestand) gemaakt op basis van een Open API-definitie met behulp van de id van de connector.

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

connector-display-name Of connector-id zijn vereist.

Vereiste parameters voor het maken van canvas

--msapp

Pad naar .msapp-bestand dat moet worden gegenereerd

Optionele parameters voor het maken van canvas

--connector-display-name

De weergavenaam van de connector waaruit de Power App moet worden gegenereerd.

--connector-id

De id van de connector waaruit de Power App moet worden gegenereerd.

--environment

De id of URL van de doelomgeving. De standaardwaarde is de omgeving van uw momenteel actieve Dataverse-verificatieprofiel.

Opmerkingen

Overwegingen en beperkingen:

  • De aangepaste connector waarnaar wordt verwezen met de connector-display-name of connector-id parameters, moet deel uitmaken van een oplossing.
  • Na het importeren van de app in Studio is er geen koppeling naar de aangepaste connector. De maker moet handmatig een verwijzing toevoegen naar de aangepaste connector waaruit de app is gegenereerd voordat de app kan worden afgespeeld. Zie Gegevensverbindingen toevoegen aan canvas-apps voor stappen. Totdat dit is gebeurd, ziet u mogelijk formulefouten in de app die worden opgelost zodra de connectorreferentie is toegevoegd. De naam van de aangepaste connector die u aan de app toevoegt, moet overeenkomen met de weergavenaam van de aangepaste connector waarnaar in de canvas create opdracht wordt verwezen.
  • De app bevat één scherm voor elke POST actie GET die door de connector wordt gedefinieerd.
    • Andere werkwoorden die beschikbaar zijn in aangepaste connectors, worden niet ondersteund.
  • De besturingselementen die op het scherm van elke actie worden weergegeven, worden dynamisch gegenereerd op basis van hoe de invoer- en uitvoertypen van elke actie worden gedefinieerd. Bepaalde typen invoer en uitvoer die zijn gedefinieerd in de aangepaste connector, worden niet ondersteund door canvas create. De opdracht genereert waarschuwingen in de console wanneer deze worden aangetroffen. Specifieke gevallen:
    • Matrices van objecten en matrices van matrices worden niet ondersteund als invoer
    • Besturingselementen worden niet gegenereerd voor objecten of geneste matrices buiten een diepte van 20
    • De typen 'Bestand' en 'binaire indeling' worden niet ondersteund voor invoer of uitvoer.

pac canvas downloaden

Canvas-app downloaden als .msapp-bestand

Vereiste parameters voor het downloaden van canvas

--name -n

Exacte, gedeeltelijke naam of app-id van canvas-app

Optionele parameters voor het downloaden van canvas

--environment -env

Hiermee geeft u de doel Dataverse. De waarde kan een GUID- of absolute HTTPS-URL zijn. Wanneer dit niet is opgegeven, wordt de actieve organisatie gebruikt die is geselecteerd voor het huidige verificatieprofiel.

--extract-to-directory -d

Mapnaam voor het extraheren van canvas-app naar

--file-name -f

Bestandsnaam (meestal met de extensie .msapp). Als het opgegeven bestand niet is opgeslagen in de huidige map met 'appname'.msapp

--overwrite -o

Bestand overschrijven toestaan

Voor deze parameter is geen waarde vereist. Het is een switch.

pac canvas list

Canvas-apps weergeven

Optionele parameters voor canvaslijst

--environment -env

Hiermee geeft u de doel Dataverse. De waarde kan een GUID- of absolute HTTPS-URL zijn. Wanneer dit niet is opgegeven, wordt de actieve organisatie gebruikt die is geselecteerd voor het huidige verificatieprofiel.

pac canvas pack

(Preview) Bronnen inpakken in een msapp-bestand

Example

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

Vereiste parameters voor canvaspack

--msapp

Pad naar .msapp-bestand

--sources

Map naar bronnen die moeten worden verpakt

Opmerkingen

Hiermee maakt u een .msapp bestand van de eerder uitgepakte bronbestanden. Het resultaat kan worden geopend in Power Apps Studio door te navigeren naar Bladeren door bestand>openen>.

Nadat de bronbestanden zijn uitgepakt, kunnen ze worden bewerkt en beheerd met externe hulpprogramma's zoals Visual Studio Code en GitHub.

pac canvas uitpakken

(Preview) Een msapp-bestand uitpakken in bronnen

Example

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

pac canvas unpack --msapp HelloWorld.msapp

Uitpakken naar standaardmap HelloWorld_src .

Vereiste parameters voor het uitpakken van canvas

--msapp

Pad naar .msapp-bestand

Optionele parameters voor canvas uitpakken

--sources

Map naar bronnen die moeten worden uitgepakt

Opmerkingen

Pak het .msapp bronbestand uit.

Download het .msapp bestand vanuit Power Apps Studio door te navigeren naar Bestand>opslaan als>deze computer.

Als de parameter bronnen niet is opgegeven, wordt een map met dezelfde naam en locatie als het .msapp bestand gebruikt met _src achtervoegsel.

Mapstructuur

De eigenschappen uitpakken en inpakken gebruiken de volgende mapstructuur:

  • \src - Beheer- en onderdeelbestanden. Dit bevat de bronnen.
    • *.fx.yaml - De formules die zijn geëxtraheerd uit het control.json bestand.

      Opmerking

      Dit is de plek om uw formules te bewerken.

    • CanvasManifest.json - Een manifestbestand dat de informatie bevat die normaal gesproken aanwezig is in de koptekst, eigenschappen en publishInfo.
    • *.json - Het onbewerkte control.json bestand.
    • \EditorState*.editorstate.json - In cache opgeslagen gegevens voor Power Apps Studio die u kunt gebruiken.
  • \DataSources - Alle gegevensbronnen die door de app worden gebruikt.
  • \Connections - Verbindingsexemplaren die zijn opgeslagen met de app en worden gebruikt bij het opnieuw laden in Power Apps Studio.
  • \Assets - Mediabestanden die zijn ingesloten in de app.
  • \pkgs - Een gedownloade kopie van externe verwijzingen, zoals sjablonen, API-definitiebestanden en onderdeelbibliotheken. Deze zijn vergelijkbaar met NuGet/NPM-verwijzingen.
  • \other - Alle diverse bestanden die nodig zijn om het .msappbestand opnieuw te maken.
    • entropy.json - Vluchtige elementen (zoals tijdstempels) worden uitgepakt in dit bestand. Dit helpt bij het verminderen van ruisverschillen in andere bestanden, terwijl we ervoor zorgen dat we nog steeds terug kunnen reizen.
    • Bevat andere bestanden van de msapp, zoals wat zich in \rdeducties bevinden.

Bestandsformaat

De .fx.yaml bestanden maken gebruik van een subset van YAML. Net als in Excel moeten alle expressies beginnen met een gelijkteken =. Meer informatie: Grammatica van Power Fx YAML-formules

Wijzigingen samenvoegen met Power Apps Studio

Bij het samenvoegen van wijzigingen die zijn aangebracht in twee verschillende Power Apps Studio-sessies:

  • Zorg ervoor dat alle namen van besturingselementen uniek zijn. Als u bijvoorbeeld een knop in twee verschillende sessies invoegt, kan dit leiden tot twee Button1 besturingselementen. U wordt aangeraden de besturingselementen kort nadat u ze hebt gemaakt een naam te geven. Het hulpprogramma accepteert geen twee besturingselementen met dezelfde naam.
  • Voor deze bestanden voegt u ze samen zoals u dat normaal doet:
    • \src*.fx.yaml
  • Als er conflicten of fouten zijn, kunt u deze bestanden verwijderen:
    • \src\editorstate*.json - Deze bestanden bevatten optionele informatie in Power Apps Studio.
    • \other\entropy.jsop
  • Voor eventuele conflicten in deze bestanden is het goed om de nieuwste versie te accepteren:
    • \checksum.jsop
  • Als er samenvoegingsconflicten onder deze paden zijn, is het niet veilig om samen te voegen. Laat ons weten of dit vaak gebeurt; We werken aan het herstructureren van de bestandsindeling om conflicten te voorkomen.
    • \Verbindingen*
    • \DataSources*
    • \pkgs*
    • CanvasManifest.json

Open source

De canvasopdrachten in Microsoft Power Platform CLI zijn open source. Bespreek verbeteringen, los problemen op en open de code vanuit de opslagplaats voor taalprogramma's van Power Apps.

pac canvas valideren

(Preview) Valideer de .pa.yaml-bron voor een uitgepakt msapp-bestand

Vereiste parameters voor het valideren van canvas

--directory -d

Pad naar de uitgepakte msapp-map met .pa.yaml-bestanden om te valideren

Zie ook

Microsoft Power Platform CLI-opdrachtgroepen
Overzicht van Microsoft Power Platform CLI

  • Last updated on