Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Das Azure Logic Apps Workflow SDK (Microsoft.Azure.Workflows.Sdk) bietet fließende Builder-APIs zur programmatischen Erstellung von Logic Apps-Workflow-Definitionen in C#. Dieses SDK ermöglicht es Entwicklern, Workflows mit einem typsicheren, IntelliSense-fähigen Ansatz anstelle von JSON-Autoren zu definieren.
Übersicht über die Architektur
Das SDK verwendet ein fluent-Builder-Muster, um Workflows mittels Methodenkettung zu erstellen:
- Einstiegspunkte: WorkflowFactory zum Erstellen von Workflows, WorkflowActions und WorkflowTriggers zum Zugriff auf Operationen
-
Fließende Verkettung:
Trigger → .Then(Action1) → .Then(Action2) → ... - Abhängigkeitsinjektion: Unterstützung über IWorkflowProvider und WorkflowProviderExtensions für die Workflow-Registrierung
Referenz zur Klassenbibliothek
Workflow-Komposition und Kettenbildung
Typen, die definieren, wie Workflow-Operationen in Ausführungsgraphen zusammengesetzt werden.
| Typ | Beschreibung | Link |
|---|---|---|
| IChainableNode | Ein Fluent-Chaining-Vertrag, der das Methodenmuster für die Then() Zusammensetzung von Operationen bereitstellt |
IChainableNode |
| IWorkflow-Betrieb | Benannte Workflow-Operation mit Identität und nachgeschalteten Kindverbindungen | IWorkflow-Betrieb |
| OperationChain | Gerichtete Kettenverfolgung von Start- und Endknoten; Unterstützungen Join() für Fächer-In-Muster |
OperationChain |
| WorkflowFactory | Factory-Methoden zur Erstellung von zustandsvollen, zustandslosen und Agenten-Workflow-Definitionen | WorkflowFactory |
Aktionstypen
Typen zur Definition von Workflow-Aktionen, die nach dem Auslösen von Triggern ausgeführt werden.
| Typ | Beschreibung | Link |
|---|---|---|
| IWorkflowAction | Schnittstelle für Aktionsschritte mit Run-after-Konfiguration | IWorkflowAction |
| IVariableWorkflowAction | Erweiterte Aktionsschnittstelle für variable Operationen | IVariableWorkflowAction |
| Typisierte Workflow-Aktionsschnittstellen | Typsichere Schnittstellen (IBodyWorkflowAction<T>, IOutputWorkflowAction<T>) für stark typisierte Ausgaben |
Typisierte Aktionsschnittstellen |
| WorkflowActionBase | Abstrakte Basisklasse mit gemeinsamer Aktionsfunktionalität | WorkflowActionBase |
| WorkflowBuiltInActions | Factory für integrierte Aktionen: HTTP, Compose, Response, CustomCode, NestedWorkflow, Agent | WorkflowBuiltInActions |
| WorkflowControlActions | Factory für Steuerfluss: Scope, Condition, ForEach, Untill, Switch, Termin | WorkflowControlActions |
| WorkflowVariableActions | Factory für Variablenoperationen: Initialisieren, Setzen, Inkrementieren, Reduzieren, Anhängen | WorkflowVariableActions |
| WorkflowManagedActions | Erweiterbare verwaltete Steckeraktionen (automatisch generiert aus Verbinderdefinitionen) | WorkflowManagedActions |
Triggertypen
Typen zur Definition von Workflow-Auslösern, die die Ausführung initiieren.
| Typ | Beschreibung | Link |
|---|---|---|
| IWorkflowTrigger | Schnittstelle für den Root-Trigger, der die Workflow-Ausführung einleitet | IWorkflowTrigger |
| Typisierte Workflow-Trigger-Schnittstellen | Typsichere Schnittstellen (IOutputWorkflowTrigger<T>, IBodyWorkflowTrigger<T>) für stark typisierte Ausgaben |
Typisierte Trigger-Schnittstellen |
| WorkflowTriggerBase | Abstrakte Basisklasse mit gemeinsamer Trigger-Funktionalität | WorkflowTriggerBase |
| WorkflowBuiltInTriggers | Factory für eingebaute Trigger: HTTP Request, Recurrence, Conversational Agent | WorkflowBuiltInTriggers |
| WorkflowManagedTriggers | Erweiterbare verwaltete Connector-Trigger (automatisch generiert aus Connector-Definitionen) | WorkflowManagedTriggers |
Eintrittspunkte & Anmeldung
Statische Einstiegspunkte und Hilfsmittel zur Abhängigkeitsinjektion.
| Typ | Beschreibung | Link |
|---|---|---|
| WorkflowActions | Statischer Eintrittspunkt, der Zugang zu BuiltIn und Managed Aktionsfabriken ermöglicht |
WorkflowActions |
| WorkflowTriggers | Statischer Einstiegspunkt, der Zugang zu BuiltIn und Managed Auslösefabriken ermöglicht |
WorkflowTriggers |
| IWorkflowProvider | Schnittstelle zur Bereitstellung von Workflow-Definitionen für die Host-Registrierung | IWorkflowProvider |
| WorkflowProviderExtensions | DI-Erweiterungsmethoden: AddWorkflowProvider<T>, AddWorkflowProviders(assembly) |
WorkflowProviderExtensions |
Laufzeit & Kontext
Typen, die während der Workflow-Ausführung verwendet werden.
| Typ | Beschreibung | Link |
|---|---|---|
| WorkflowKontext | Abstrakter Kontext, der Laufzeitzugriff auf Aktions- und Triggerergebnisse bietet | WorkflowKontext |
| AgentToolContext | Schnittstelle und Klasse bieten typisierten Parameterzugriff für KI-Agenten-Tools | AgentToolContext |
Getting Started
Um das Logic Apps Standard SDK in Ihrer Anwendung zu verwenden:
-
Beziehen Sie sich auf das SDK: Füge das NuGet-Paket
Microsoft.Azure.Workflows.Sdkzu deinem Projekt hinzu - IWorkflowProvider implementieren: Erstellen Sie Workflow-Definitionen durch die Implementierung der IWorkflowProvider-Schnittstelle
- Verwenden Sie WorkflowFactory: Erstellen Sie Workflow-Definitionen mit WorkflowFactory-Methoden für stateful, stateless oder agentenbasierte Workflows
- Zugriffsaktionen und -trigger:Verwenden Sie WorkflowActions und WorkflowTriggers als Einstiegspunkte für verfügbare Operationen
-
Bauen Sie mit Fluent Chaining: Erstellen Sie Workflows mit der Fluent-API:
trigger.Then(action1).Then(action2)
Das SDK unterstützt drei Workflow-Typen: Stateful (hält den Zustand zwischen den Läufen aufrecht), Stateless (läuft ohne Statusaufrechterhaltung) und Agent (KI-gestützte Workflows mit konversationellen Funktionen).