pac canvas

  • Artikel

Wird mit MSAPP-Dateien von Power Apps ausgeführt

[Dieser Artikel ist Teil der Dokumentation zur Vorschauversion und kann geändert werden.]

Wichtig

  • Die Befehle pack und unpack sind in öffentlicher Vorschauversion.
  • Funktionen in der Vorschau sind nicht für den produktiven Einsatz gedacht und können eine eingeschränkte Funktionalität aufweisen. Diese Funktionen stehen vor der offiziellen Veröffentlichung zur Verfügung, damit Kunden frühzeitig Zugriff erhalten und Feedback geben können.
  • Der Befehl create ist allgemein verfügbar.

Befehle

Command Beschreibung des Dataflows
pac canvas create Eine Canvas-App aus einem benutzerdefinierten Konnektor generieren
pac canvas download Canvas-App als .msapp-Datei herunterladen
pac canvas list Canvas-Apps auflisten
pac canvas pack (Vorschauversion) Quellen in MSAPP-Datei packen
pac canvas unpack (Vorschauversion) Eine MSAPP-Datei in Quellen extrahieren

pac canvas create

Eine Canvas-App aus einem benutzerdefinierten Konnektor generieren

Dieser Befehl generiert eine .msapp Canvas-App, basierend auf der OpenAPI-Definition eines vorhandenen benutzerdefinierten Connectors. Die App enthält Anzeigen, ein Steuerungslayout und Power Fx-Code, der basierend darauf generiert wird, wie die Aktionen des benutzerdefinierten Connectors definiert sind, mit einem vordefinierten Aussehen und Verhalten. Die App kann verwendet werden, um die im benutzerdefinierten Connector definierten Aktionen direkt auszuführen.

Erstellende Personen können die generierte .msapp in Power Apps Studio importieren, um die App auszuführen oder Bearbeitungen und weitere Anpassungen vorzunehmen. Importieren Sie die generierte App in Power Apps Studio, indem Sie zu Datei>Öffnen>Durchsuchen innerhalb von Studio navigieren.

Beispiele

Die folgenden Beispiele zeigen die Verwendung des pac canvas create Befehls.

Erstellen Sie eine Canvas-App basierend auf einer offenen API-Definition von Anzeigename

In diesem Beispiel wird eine Canvas-App (als *.msapp-Datei) basierend auf einer offenen API-Definition erstellt, indem Anzeigename des Konnektors verwendet wird.

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

Erstellen Sie eine Canvas-App basierend auf einer offenen API-Definition nach ID

In diesem Beispiel wird eine Canvas-App (als *.msapp-Datei) basierend auf einer offenen API-Definition erstellt, indem die ID des Konnektors verwendet wird.

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

Entweder connector-display-name oder connector-id sind erforderlich.

Erforderliche Parameter für das Erstellen der Canvas

--msapp

Pfad zur .msapp-Datei

Optionale Parameter für das Erstellen der Canvas

--connector-display-name

Der Anzeigename des Konnektors, über den die Power App generiert werden soll.

--connector-id

Die ID des Konnektors, über den die Power App generiert werden soll.

--environment

Die ID oder URL der Zielumgebung. Der Standardwert ist die Umgebung Ihres derzeit aktiven Dataverse-Authentifizierungsprofils.

Anmerkungen

Überlegungen und Einschränkungen:

  • Der benutzerdefinierte Connector, auf den mit den Parametern connector-display-name oder connector-id verwiesen wird, muss Teil einer Lösung sein.
  • Nach dem Importieren der App in Studio besteht keine Zuordnung zum benutzerdefinierten Connector. Der Ersteller muss dem benutzerdefinierten Connector, aus dem die App generiert wurde, bevor die App ausgeführt werden kann, manuell einen Verweis hinzufügen. Siehe Datenverbindungen zu Canvas-Apps hinzufügen für Schritte. Bis dies erledigt ist, werden Ihnen in der App vielleicht Formelfehler angezeigt, die sich auflösen, sobald der Connector-Verweis hinzugefügt wird. Der Name des benutzerdefinierten Connectors, den Sie der App hinzufügen, muss mit dem Anzeigename des benutzerdefinierten Connectors übereinstimmen, auf den im Befehl canvas create verwiesen wird.
  • Die App enthält jeweils eine Anzeige für jede POST- und GET-Aktion, die der Connector definiert.
    • Andere Verben, die in benutzerdefinierten Connectors verfügbar sind, werden nicht unterstützt.
  • Die in der Anzeige jeder Aktion gerenderte Steuerelemente werden dynamisch generiert, basierend darauf, wie die Eingabe- und Ausgabetypen jeder Aktion definiert werden. Bestimmte Eingabe- und Ausgabetypen, die im benutzerdefinierten Connector definiert sind, werden von canvas create nicht unterstützt. Der Befehl generiert Warnungen in der Konsole, wenn diese auftreten. Spezifische Fälle:
    • Arrays von Objekten und Arrays von Arrays werden nicht als Eingaben unterstützt
    • Es werden keine Steuerelemente für Objekte oder geschachtelte Arrays jenseits einer Tiefe von 20 generiert
    • Die Typen „Datei“ und „Binärformat“ werden nicht für Eingabe oder Ausgabe unterstützt.

pac canvas download

Canvas-App als .msapp-Datei herunterladen

Erforderliche Parameter für canvas download

--name -n

Genauer, teilweiser Name der Canvas-App oder App-ID

Optionale Parameter für canvas download

--environment -env

Gibt das Ziel-Dataverse an. Der Wert kann eine GUID oder eine absolute HTTPS-URL sein. Wenn nichts angegeben wird, wird die für das aktuelle Authentifizierungsprofil ausgewählte aktive Organisation verwendet.

--extract-to-directory -d

Verzeichnisname zum Extrahieren der Canvas-App in

--file-name -f

Dateiname (normalerweise mit der Erweiterung „.msapp“). Wenn nicht angegeben, wird die Datei im aktuellen Verzeichnis mit „appname“.msapp gespeichert

--overwrite -o

Überschreiben der Datei zulassen

Dieser Parameter benötigt keinen Wert. Es ist ein Umschalter.

pac canvas list

Canvas-Apps auflisten

Optionale Parameter für canvas list

--environment -env

Gibt das Ziel-Dataverse an. Der Wert kann eine GUID oder eine absolute HTTPS-URL sein. Wenn nichts angegeben wird, wird die für das aktuelle Authentifizierungsprofil ausgewählte aktive Organisation verwendet.

pac canvas pack

(Vorschauversion) Quellen in MSAPP-Datei packen

Beispiel

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

Erforderliche Parameter für das Paken der Canvas

--msapp

Pfad zur MSAPP-Datei

--sources

Verzeichnis der Quellen, die gepackt werden sollen

Anmerkungen

Erstellt eine .msapp-Datei aus den zuvor entpackten Quelldateien. Das Ergebnis kann in Power Apps Studio geöffnet werden, indem Sie zu Datei>Öffnen>Durchsuchen navigieren.

Nach dem Entpacken können die Quelldateien mit externen Tools bearbeitet und verwaltet werden, wie z. B. Visual Studio Code und GitHub.

pac canvas unpack

(Vorschauversion) Eine MSAPP-Datei in Quellen extrahieren

Beispiel

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

pac canvas unpack --msapp HelloWorld.msapp

Entpackt in ein standardmäßiges HelloWorld_src-Verzeichnis.

Erforderliche Parameter für das Entpacken der Canvas

--msapp

Pfad zur MSAPP-Datei

Optionale Parameter für das Entpacken der Canvas

--sources

Verzeichnis der Quellen, die entpackt werden sollen

Anmerkungen

Entpackt die .msapp-Quelldatei.

Laden Sie die .msapp-Datei von Power Apps Studio herunter, indem Sie zu Datei>Speichern unter>Dieser Computer navigieren.

Wenn der Parameter sources nicht angegeben ist, wird ein Verzeichnis mit dem gleichen Namen und Speicherort wie die .msapp-Datei mit dem Suffix _src verwendet.

Ordnerstruktur

Die Eigenschaften „Entpacken“ und „Packen“ verwenden die folgende Ordnerstruktur:

  • \src – Steuer- und Komponentendateien. Hier sind die Quellen enthalten.
    • *.fx.yaml - Die aus der control.json-Datei extrahierten Formeln.

      Notiz

      Hier können Sie Ihre Formeln bearbeiten.

    • CanvasManifest.json - Eine Manifestdatei, die die normalerweise im Header, in den Eigenschaften und in den publishInfo enthaltenen Informationen enthält.
    • *.json - Die rohe control.json Datei.
    • \EditorState*.editorstate.json - Zwischengespeicherte Informationen zur Verwendung durch Power Apps Studio.
  • \DataSources – Alle von der App verwendeten Datenquellen.
  • \Connections – Verbindungsinstanzen, die mit der App gespeichert und beim erneuten Laden in Power Apps Studio verwendet werden.
  • \Assets – In die App eingebettete Mediendateien.
  • \pkgs – Eine heruntergeladene Kopie externer Referenzen, z. B. Vorlagen, API-Definitionsdateien und Komponentenbibliotheken. Diese sind mit NuGet/NPM-Referenzen vergleichbar.
  • \other – Alle sonstigen Dateien, die benötigt werden, um die .msapp-Datei neu zu erstellen.
    • entropy.json - Flüchtige Elemente (wie Zeitstempel) werden in diese Datei extrahiert. Dies trägt dazu bei, Unterschiede in anderen Dateien zu reduzieren und gleichzeitig sicherzustellen, dass wir immer noch einen Roundtrip durchführen können.
    • Enthält andere Dateien aus der msapp, z. B. den Inhalt von \references.

Dateiformat

Die .fx.yaml-Dateien verwenden eine Teilmenge von YAML. Ähnlich wie bei Excel sollten alle Ausdrücke mit einem Gleichheitszeichen = beginnen. Mehr Informationen: Power Fx YAML-Formelgrammatik

Zusammenführen von Änderungen mit Power Apps Studio

Beim Zusammenführen von Änderungen, die in zwei verschiedenen Power Apps Studio-Sitzungen vorgenommen werden, ist Folgendes zu beachten:

  • Stellen Sie sicher, dass alle Steuerelementnamen eindeutig sind. Wenn Sie beispielsweise eine Schaltfläche in zwei verschiedene Sitzungen einfügen, können sich hierdurch zwei Button1-Steuerelemente ergeben. Wir empfehlen, die Steuerelemente kurz nach der Erstellung zu benennen. Das Tool akzeptiert keine zwei Steuerelemente mit demselben Namen.
  • Führen Sie diese Dateien wie gewohnt zusammen:
    • \src*.fx.yaml
  • Bei Konflikten oder Fehlern können Sie diese Dateien löschen:
    • \src\editorstate*.json – Diese Dateien enthalten optionale Informationen in Power Apps Studio.
    • \other\entropy.json
  • Bei Konflikten in diesen Dateien ist es in Ordnung, die aktuelle Version zu akzeptieren:
    • \checksum.json
  • Wenn unter diesen Pfaden Konflikte bei der Zusammenführung auftreten, ist eine Zusammenführung nicht sicher. Lassen Sie uns wissen, wenn dies häufiger vorkommt. Wir werden dann versuchen, das Dateiformat umzustrukturieren, um Konflikte zu vermeiden.
    • \Verbindungen*
    • \DataSources*
    • \pkgs*
    • CanvasManifest.json

Open Source

Die Canvas-Befehle in der Microsoft Power Platform-CLI sind Open Source. Besprechen Sie Verbesserungen, melden Sie Probleme und greifen Sie auf den Code zu über das Power Apps-Repository für Sprachtools.

Siehe auch

Microsoft Power Platform CLI-Befehlsgruppen
Microsoft Power Platform CLI – Übersicht