Hinzufügen von Power Automate Flüssen zu einer Code-App

In diesem Artikel erfahren Sie, wie Sie Power Automate Cloudflüsse in einer Power Apps Code-App mithilfe der Power Apps CLI ermitteln, hinzufügen, aufrufen, aktualisieren und entfernen.

Wichtig

Code-Apps unterstützen nur lösungsfähige Sofortflüsse, die den Power Apps Trigger verwenden. Geplante Flüsse, automatisierte Flüsse und Instant Flows, die andere Trigger verwenden, werden nicht unterstützt.

Voraussetzungen

  • Eine Power Apps-Code-App, die mit pa app init initialisiert wurde
  • Ein lösungsfähiger soforter Cloudfluss, der den Power Apps Trigger verwendet
  • @microsoft/power-apps Version 1.1.1 oder höher

Wenn sich der Fluss nicht in einer Lösung befindet, lesen Sie "Hinzufügen eines vorhandenen Cloudflusses zu einer Lösung".

Schritt 1: Auflisten der verfügbaren Flüsse

Verwenden Sie den pa app list-flows Befehl, um die lösungsfähigen Flüsse in der aktuellen Umgebung auflisten:

pa app list-flows

Dieser Befehl gibt die verfügbaren Flüsse zurück:

Name                    Status   Modified On   Flow ID
──────────────────────────────────────────────────────────────────────────────
Approval Workflow       Started  2026-01-15    a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1
Send Notification       Started  2026-02-01    b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2

Total flows: 2

Verwenden Sie den --search Parameter, um die Ergebnisse nach Namen zu filtern:

pa app list-flows --search approval

Kopieren Sie die Fluss-ID für den Fluss, den Sie hinzufügen möchten.

Hinweis

Der Befehl listet nur lösungsfähige Flüsse auf. Wenn kein Fluss aufgeführt ist, fügen Sie ihn zuerst einer Lösung hinzu.

Schritt 2: Hinzufügen des Flusses

Verwenden Sie den pa app add flow Befehl, um den Fluss der Code-App hinzuzufügen:

pa app add flow --flow-id <flow-id>

Beispiel:

pa app add flow --flow-id a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1

Wenn Sie den Befehl erneut mit derselben Ablauf-ID ausführen, werden die generierten Dateien mit der neuesten Ablaufdefinition aktualisiert.

Funktionsweise des Befehls

Der Befehl:

  • Lädt die OpenAPI-Definition des Flusses herunter.
  • Generiert stark typierte TypeScript-Modelle und -Dienste.
  • Fügt den Fluss und die zugehörigen Verbindungsverweise zu power.config.json.

Wichtig

Die Person, die ausgeführt wird pa app add flow , muss Zugriff auf den Fluss und die zugrunde liegenden Verbindungen haben. Der Befehl schlägt fehl, wenn die Person keinen Zugriff auf eine erforderliche Verbindung hat.

Generierte Dateien

Die CLI erstellt Dateien ähnlich dem folgenden Beispiel:

src/
  services/
    ApprovalWorkflowService.ts
  models/
    ApprovalWorkflowModel.ts
schemas/
  logicflows/
    ApprovalWorkflow.Schema.json

Die CLI fügt außerdem die Flusskonfiguration hinzu power.config.json.

Schritt 3: Aufrufen des Flusses

Die generierte Dienstklasse stellt eine statische Run Methode bereit. Die Methodensignatur basiert auf den Eingabeparametern in der OpenAPI-Definition des Flusses.

Fluss mit Eingabeparametern

import { ApprovalWorkflowService } from './services/ApprovalWorkflowService';

const result = await ApprovalWorkflowService.Run({
  requester: 'Alex',
  amount: 1500,
});

if (result.success) {
  console.log('Flow triggered. Response:', result.data);
} else {
  console.error('Flow failed:', result.error);
}

Ablauf ohne Eingabeparameter

import { SendNotificationService } from './services/SendNotificationService';

const result = await SendNotificationService.Run();

if (result.success) {
  console.log('Flow triggered.');
}

Das Ergebnis enthält die folgenden Eigenschaften:

Eigenschaft Typ Beschreibung
success boolean Gibt an, ob der Fluss erfolgreich ausgelöst wurde.
data Variiert Enthält die eingegebene Antwort aus dem Fluss, falls verfügbar.
error Error Enthält Fehlerinformationen, wenn success dies der Wert ist false.

Öffnen Sie die generierte Dienstdatei, um die genauen Eingabe- und Ausgabetypen für den Fluss zu überprüfen.

Aktualisieren eines Flusses

Wenn sich die Ablaufdefinition ändert, führen Sie die Ausführung pa app add flow erneut mit derselben Ablauf-ID aus:

pa app add flow --flow-id a1b2c3d4-e5f6-7890-abcd-ef1234567890

Der Befehl aktualisiert die generierten Dateien und behält den vorhandenen Flusseintrag in power.config.json.

Flow entfernen

Dient pa app remove flow zum Entfernen eines Flusses anhand des Datenquellennamens:

pa app remove flow --flow-name ApprovalWorkflow

Oder entfernen Sie sie anhand der Ablauf-ID:

pa app remove flow --flow-id a1b2c3d4-e5f6-7890-abcd-ef1234567890

Mit dem Befehl wird der Fluss entfernt power.config.json und die Modelle und Dienste neu generiert.

Ausführen und Veröffentlichen der App

Führen Sie die App lokal aus:

npm run dev

Erstellen und Veröffentlichen der App:

npm run build
pa app push

Einschränkungen und Überlegungen

Limitation Einzelheiten
Power Apps Trigger erforderlich Nur instant flows that use the Power Apps trigger are supported.
Lösungsfähige Abläufe erforderlich Der Fluss muss zu einer Lösung gehören, bevor Sie ihn hinzufügen können.
Maker-Zugriff erforderlich Die Person, die den Fluss hinzufügt, muss Zugriff auf den Fluss und seine zugrunde liegenden Verbindungen haben.
Dataverse-Berechtigungen erforderlich Endbenutzer benötigen ausreichende Dataverse-Berechtigungen, um den Fluss aufzurufen. Weisen Sie die Sicherheitsrolle "App Opener" oder eine entsprechende Rolle zu.
Manuelle Aktualisierung erforderlich Führen Sie den Vorgang pa app add flow erneut aus, nachdem sich die Flussdefinition geändert hat.
  • Last updated on