Hinzufügen von Power-Automate-Flows zu einer Code-App (Vorschau)

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

Voraussetzungen

• Eine initialisierte Power-Apps-Codeanwendung. Siehe Schnellstart: Erstellen einer Code-App mithilfe der npm CLI.
• Ein Power Automate-Fluss, der lösungsbewusst ist und ein Sofortablauf mit dem PowerApps-Triggertyp ist. Wenn Ihr Workflow noch nicht Teil einer Lösung ist, lesen Sie "Hinzufügen eines bestehenden Workflows zu einer Lösung".
• Die @microsoft/power-apps npm-Paketversion 1.1.1 oder höher.

Schritt 1: Auflisten der verfügbaren Flüsse

Führen Sie den folgenden Befehl aus, um alle lösungsfähigen Flüsse in Ihrer aktuellen Umgebung auflisten:

npx power-apps list-flows

Der Befehl gibt eine Tabelle mit verfügbaren Flüssen aus:

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 die --search Option, um Ergebnisse nach Namen zu filtern:

npx power-apps list-flows --search approval

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

Schritt 2: Hinzufügen eines Flusses zu Ihrer Code-App

Führen Sie den folgenden Befehl aus und ersetzen Sie <flow-id> durch den Wert aus dem vorherigen Schritt:

npx power-apps add-flow --flow-id <flow-id>

Example:

npx power-apps add-flow --flow-id a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1

Wenn der Befehl erfolgreich ist, bestätigt die CLI, dass der Fluss hinzugefügt wurde:

Flow added successfully.

Was add-flow tut

Der Befehl lädt die OpenAPI-Definition des Flusses herunter, generiert stark typisierte TypeScript-Dateien in Ihrem Projekt und aktualisiert power.config.json mit den Verbindungsverweisen des Flusses.

Generierte Dateien

Nach dem Ausführen add-flowerstellt die CLI die folgenden Dateien in Ihrem Projekt (Dateinamen werden vom Anzeigenamen des Flusses abgeleitet):

src/
  services/
    ApprovalWorkflowService.ts   ← generated service class with typed methods
  models/
    ApprovalWorkflowModel.ts     ← generated TypeScript types for inputs/outputs
schemas/
  logicflows/
    ApprovalWorkflow.Schema.json ← flow's OpenAPI schema (do not edit manually)

Der folgende Eintrag wird ebenfalls hinzugefügt:power.config.json

"<uuid>": {
  "id": "/providers/microsoft.powerapps/apis/shared_logicflows",
  "displayName": "Logic flows",
  "dataSources": ["ApprovalWorkflow"],
  "workflowDetails": {
    "workflowEntityId": "<dataverse-entity-guid>",
    "workflowDisplayName": "Approval Workflow",
    "workflowName": "<flow-id>",
    "dependencies": {
      "shared_office365": "<dependency-uuid>"
    }
  }
}

Schritt 3: Aufrufen des Flusses aus Ihrer App

Die generierte Dienstklasse macht eine Run statische Methode verfügbar. Die genaue Signatur hängt davon ab, ob der Trigger des Flusses Eingabeparameter definiert.

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);
}

Flow ohne Eingabeparameter

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

const result = await SendNotificationService.Run();

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

Das result Objekt hat die folgende Form:

Aktualisieren eines Flusses

Wenn sich die Definition des Ablaufs ändert – z. B. fügt der Autor einen neuen Parameter hinzu oder aktualisiert Verbindungsreferenzen – führen Sie add-flow erneut mit derselben Ablauf-ID aus, um die neueste Definition zu übernehmen und die Dienstdateien neu zu generieren.

npx power-apps add-flow --flow-id a1b2c3d4-e5f6-7890-abcd-ef1234567890

Der Befehl passt zum Datenfluss anhand von workflowEntityId und verwendet die vorhandene UUID in power.config.json, sodass keine manuelle Bereinigung erforderlich ist.

Entfernen eines Flusses

Um einen Fluss aus Ihrer Code-App zu entfernen, verwenden Sie remove-flow. Sie können den Fluss entweder anhand seines Datenquellennamens (wie in power.config.json) oder anhand seiner ursprünglichen Fluss-ID identifizieren:

Nach Datenquellenname:

npx power-apps remove-flow --flow-name ApprovalWorkflow

Nach Ablauf-ID:

npx power-apps remove-flow --flow-id a1b2c3d4-e5f6-7890-abcd-ef1234567890

Der Befehl:

• Entfernt den Fluss von power.config.json.
• Regeneriert alle Modelldienste.

Bereitstellen Ihrer App

Nach dem Hinzufügen von Flüssen und der lokalen Überprüfung der App mit npm run dev, Erstellen und Bereitstellen wie gewohnt:

npm run build
npx power-apps push

Einschränkungen und Überlegungen

Beachten Sie beim Hinzufügen von Flüssen zu einer Code-App die folgenden Einschränkungen und Überlegungen.

Verwandte Artikel

• Schnellstart: Erstellen einer Code-App mithilfe der npm CLI
• Hinzufügen einer Datenquelle zu einer Code-App
• Hinzufügen eines vorhandenen Flusses zu einer Lösung
• Benutzersicherheit in einer Umgebung konfigurieren