Power Automate-Flows zu einer Code-App hinzufügen

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 Direktflows, 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 sofortiger Cloud-Flow, der den Power Apps-Trigger verwendet
  • @microsoft/power-apps Version 1.1.1 oder höher

Wenn sich der Flow nicht in einer Lösung befindet, siehe Vorhandenen Cloud-Flow zu einer Lösung hinzufügen.

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 Befehl pa app add flow, um den Flow zur 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 pa app add flow ausführt, muss Zugriff auf den Flow 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 Flow-Konfiguration zu power.config.json hinzu.

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 successfalse ist.

Ö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

Verwenden Sie pa app remove flow, um einen Datenfluss anhand seines Datenquellennamens zu entfernen:

pa app remove flow --flow-name ApprovalWorkflow

Oder entfernen Sie sie über ihre Flow-ID:

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

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

Ausführen und Veröffentlichen der App

Führen Sie die App lokal aus:

npm run dev

Erstellen Sie die App, und verwenden Sie pa app push, um sie zu veröffentlichen:

npm run build
pa app push

Einschränkungen und Überlegungen

Limitation Einzelheiten
Power Apps-Trigger erforderlich Nur Sofortflows, die den Power Apps-Auslöser verwenden, werden unterstützt.
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