Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich. # Entwicklung von Workflows in Step Functions Workflow Studio Wenn Sie einen Workflow in der AWS Step Functions Konsole bearbeiten, verwenden Sie ein visuelles Tool namens Workflow Studio. Mit Workflow Studio können Sie drag-and-drop Status auf einer Arbeitsfläche anzeigen, um Ihre Workflows zu erstellen. Sie können Status hinzufügen, bearbeiten und konfigurieren, Eingabe- und Ausgabefilter festlegen, Ergebnisse transformieren und die Fehlerbehandlung einrichten. Wenn Sie Status in Ihrem Workflow ändern, validiert und generiert Workflow Studio automatisch die State-Machine-Definition. Mit dem integrierten Code-Editor können Sie den generierten Code überprüfen, die Konfiguration bearbeiten und sogar die Textdefinition ändern. Wenn Sie fertig sind, können Sie Ihren Workflow speichern, ausführen und dann die Ergebnisse überprüfen. Sie können über die Step Functions Functions-Konsole auf Workflow Studio zugreifen, wenn Sie einen Workflow erstellen oder bearbeiten. **Sie können Workflow Studio auch von einem visuellen Designer aus verwendenAWS Infrastructure Composer, um Infrastruktur als Code mit AWS Serverless Application Model und zu erstellenAWS CloudFormation.** Informationen zu den Vorteilen dieses Ansatzes finden Sie unter[Verwenden von Workflow Studio in Infrastructure Composer](use-wfs-in-app-composer.md). Workflow Studio hat drei Modi: **Design**, **Code** und **Config**. Im *Designmodus* können Sie drag-and-drop Status auf der Arbeitsfläche anzeigen. *Der Codemodus* bietet einen integrierten Code-Editor zum Bearbeiten Ihrer Workflow-Definitionen in der Konsole. Im *Konfigurationsmodus* können Sie Ihre Workflow-Konfiguration verwalten. **Arbeiten mit Workflow Studio in Visual Studio Code** Mit dem AWS Toolkit können Sie Workflow Studio von VS Code aus verwenden, um einzelne Zustände in Ihren Zustandsmaschinen zu visualisieren, zu erstellen und sogar zu testen. Sie geben Zustandseingaben ein und legen Variablen fest, starten den Test und können dann sehen, wie Ihre Daten transformiert werden. Sie können den Workflow anpassen und erneut testen. Wenn Sie fertig sind, können Sie die Änderungen anwenden, um die Zustandsmaschine zu aktualisieren. Weitere Informationen finden Sie unter [Arbeiten mit Workflow Studio](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/stepfunctions-workflowstudio.html) in der AWS Toolkit for Visual Studio Code. ## Entwurfsmodus Der Entwurfsmodus bietet eine grafische Oberfläche zur Visualisierung Ihrer Workflows, während Sie deren Prototypen erstellen. Die folgende Abbildung zeigt den Statusbrowser, die Workflow-Arbeitsfläche, den Inspektor und die kontextuelle Hilfe im **Designmodus** von Workflow Studio. ![\[Screenshot des Entwurfsmodus mit den Statusfenstern Browser, Workflow-Arbeitsfläche, Inspektor und Hilfe.\]](http://docs.aws.amazon.com/de_de/step-functions/latest/dg/images/wfs_main_01.png) 1. Die Modustasten schalten zwischen den drei Modi um. Sie können den Modus nicht wechseln, wenn Ihre ASL-Workflow-Definition ungültig ist. 1. Die [Staaten (Browser)](#workflow-studio-components-states) enthält die folgenden drei Registerkarten: + Die Registerkarte **Aktionen** enthält eine Liste von Aktionen AWS APIs, die Sie per Drag-and-Drop in Ihr Workflow-Diagramm auf der Arbeitsfläche ziehen können. Jede Aktion steht für einen [Workflow-Status der Aufgabe](state-task.md) Status. + Die Registerkarte **Flow** enthält eine Liste von Flow-Status, die Sie per Drag-and-Drop in Ihr Workflow-Diagramm auf der Arbeitsfläche ziehen können. + Die Registerkarte **Muster** enthält mehrere ready-to-use wiederverwendbare Bausteine, die Sie für eine Vielzahl von Anwendungsfällen verwenden können. Sie können diese Muster beispielsweise verwenden, um Daten in einem Amazon S3 S3-Bucket iterativ zu verarbeiten. 1. [Arbeitsfläche und Workflow-Diagramm](#workflow-studio-components-grapheditor)Hier ziehen Sie Status per Drag-and-Drop in Ihr Workflow-Diagramm, ändern die Reihenfolge der Status und wählen Status aus, die konfiguriert oder angezeigt werden sollen. 1. In [Inspektor-Panel](#workflow-studio-components-formdefinition) diesem Bereich können Sie die Eigenschaften jedes Status, den Sie auf der Leinwand ausgewählt haben, anzeigen und bearbeiten. Aktivieren Sie den Schalter **Definition**, um den Sprachcode für die Amazon-Staaten für Ihren Workflow anzuzeigen, wobei der aktuell ausgewählte Bundesstaat hervorgehoben ist. 1. Mit **Informationslinks** wird ein Fenster mit Kontextinformationen geöffnet, falls Sie Hilfe benötigen. Diese Bereiche enthalten auch Links zu verwandten Themen in der Step Functions Functions-Dokumentation. 1. Entwurfssymbolleiste — Enthält eine Reihe von Schaltflächen für allgemeine Aktionen wie Rückgängigmachen, Löschen und Vergrößern. 1. Hilfsschaltflächen — Eine Reihe von Schaltflächen, mit denen Sie Aufgaben ausführen können, z. B. das Speichern Ihrer Workflows oder das Exportieren ihrer ASL-Definitionen in eine JSON- oder YAML-Datei. ### Staaten (Browser) Im States-Browser können Sie Staaten auswählen, die Sie per Drag-and-Drop auf Ihre Workflow-Arbeitsfläche ziehen möchten. Die Registerkarte „**Aktionen**“ enthält eine Liste der Aufgabenstatus, die eine Verbindung zu HTTP-Endpunkten von Drittanbietern herstellen, und AWS APIs. Die Registerkarte **Flow** enthält eine Liste von Status, anhand derer Sie Ihren Workflow steuern und steuern können. Zu den Flow-Status gehören: Auswahl, Parallel, Zuordnung, Bestanden, Warten, Erfolgreich und Fehlgeschlagen. Die Registerkarte „**Muster**“ enthält ready-to-use wiederverwendbare vordefinierte Bausteine. Mit dem Suchfeld oben im Panel können Sie unter allen Statustypen suchen. ![\[Illustrative Sammlung von Screenshots, die Aktionen, Ablauf, Muster und Suche zeigen.\]](http://docs.aws.amazon.com/de_de/step-functions/latest/dg/images/wfe-states-browser-01.png) ### Arbeitsfläche und Workflow-Diagramm Nachdem Sie einen Status ausgewählt haben, den Sie Ihrem Workflow hinzufügen möchten, können Sie ihn auf die Arbeitsfläche ziehen und in Ihr Workflow-Diagramm einfügen. Sie können Status auch per Drag-and-Drop verschieben, um sie innerhalb Ihres Workflows zu verschieben. Wenn Ihr Workflow umfangreich ist, können Sie die Ansicht vergrößern oder verkleinern, um verschiedene Teile Ihres Workflow-Diagramms auf der Arbeitsfläche anzuzeigen. ### Inspektor-Panel Sie können alle Status, die Sie Ihrem Workflow hinzufügen, im **Inspektorfenster** auf der rechten Seite konfigurieren. Wählen Sie den Status aus, den Sie konfigurieren möchten, und Sie werden seine Konfigurationsoptionen im **Inspektorfenster** sehen. Um die automatisch generierte [ASL-Definition](concepts-amazon-states-language.md) für Ihren Workflow-Code zu sehen, aktivieren Sie den Schalter **Definition**. Die ASL-Definition, die dem ausgewählten Status zugeordnet ist, wird hervorgehoben angezeigt. ![\[Illustrativer Screenshot des Workflow Studio-Inspektors mit dem Konfigurationsfenster\]](http://docs.aws.amazon.com/de_de/step-functions/latest/dg/images/wfe-forms-definitions-01.png) ![\[Illustrativer Screenshot des Workflow Studio-Inspektorfensters mit der Codedefinition\]](http://docs.aws.amazon.com/de_de/step-functions/latest/dg/images/wfe-forms-definitions-02.png) ## Code-Modus Im **Codemodus** von Workflow Studio können Sie einen integrierten Code-Editor verwenden, um die [Verwendung von Amazon States Language zur Definition von Step Functions Functions-Workflows](concepts-amazon-states-language.md) (ASL-) Definition Ihrer Workflows in der Step Functions Functions-Konsole anzuzeigen, zu schreiben und zu bearbeiten. Der folgende Screenshot zeigt die Komponenten im **Codemodus**. ![\[Illustrativer Screenshot der Bearbeitung einer Workflow-Definition im Codemodus.\]](http://docs.aws.amazon.com/de_de/step-functions/latest/dg/images/wfs-code-mode.png) 1. Die Modustasten schalten zwischen den drei Modi um. Sie können den Modus nicht wechseln, wenn Ihre ASL-Workflow-Definition ungültig ist. 1. [Code-Editor](#wfs-interface-code-editor)Hier schreiben und bearbeiten Sie die [ASL-Definition](concepts-amazon-states-language.md) Ihrer Workflows im Workflow Studio. Der Code-Editor bietet auch Funktionen wie Syntaxhervorhebung und automatische Vervollständigung. 1. [Diagrammvisualisierung](#wfs-interface-code-graph-viz)— Zeigt eine grafische Echtzeitvisualisierung Ihres Workflows. 1. Hilfsschaltflächen — Eine Reihe von Schaltflächen zum Ausführen von Aufgaben, z. B. zum Speichern Ihrer Workflows oder zum Exportieren ihrer ASL-Definitionen in eine JSON- oder YAML-Datei. 1. Codesymbolleiste — Enthält eine Reihe von Schaltflächen, mit denen allgemeine Aktionen ausgeführt werden können, z. B. das Rückgängigmachen einer Aktion oder das Formatieren des Codes. 1. Grafiksymbolleiste — Enthält eine Reihe von Schaltflächen für allgemeine Aktionen, wie z. B. das Vergrößern und Verkleinern des Workflow-Diagramms. ### Code-Editor Der Code-Editor bietet eine IDE-ähnliche Oberfläche zum Schreiben und Bearbeiten Ihrer Workflow-Definitionen mithilfe von JSON im Workflow Studio. Der Code-Editor enthält mehrere Funktionen, z. B. Syntaxhervorhebung, Vorschläge zur automatischen Vervollständigung, Überprüfung der [ASL-Definition](concepts-amazon-states-language.md) und kontextsensitive Hilfeanzeige. Wenn Sie Ihre Workflow-Definition aktualisieren, wird ein Echtzeitdiagramm Ihres Workflows [Diagrammvisualisierung](#wfs-interface-code-graph-viz) gerendert. Sie können das aktualisierte Workflow-Diagramm auch in der [Entwurfsmodus](#wfs-interface-design-mode) sehen. Wenn Sie im Bereich [Entwurfsmodus](#wfs-interface-design-mode) oder im Bereich der Grafikvisualisierung einen Status auswählen, wird die ASL-Definition dieses Status im Code-Editor hervorgehoben angezeigt. Die ASL-Definition Ihres Workflows wird automatisch aktualisiert, wenn Sie einen Status im **Entwurfsmodus** oder im Bereich der Grafikvisualisierung neu anordnen, löschen oder hinzufügen. Der Code-Editor kann Vorschläge zur automatischen Vervollständigung von Feldern und Status machen. + Um eine Liste der Felder zu sehen, die Sie in einen bestimmten Status aufnehmen können, drücken Sie**Ctrl\$1Space**. + Um einen Codeausschnitt für einen neuen Status in Ihrem Workflow zu generieren, drücken Sie **Ctrl\$1Space** hinter der Definition des aktuellen Status. + Um eine Liste aller verfügbaren Befehle und **Tastenkombinationen** anzuzeigen, drücken Sie. **F1** ### Diagrammvisualisierung Das Bedienfeld zur Grafikvisualisierung zeigt Ihren Arbeitsablauf in einem grafischen Format. Wenn Sie Ihre Workflow-Definitionen in Workflow Studio schreiben, rendert der Bereich zur Grafikvisualisierung ein Echtzeitdiagramm Ihres Workflows. [Code-Editor](#wfs-interface-code-editor) Wenn Sie einen Status im Bereich der Grafikvisualisierung neu anordnen, löschen oder duplizieren, wird die Workflow-Definition im Code-Editor automatisch aktualisiert. Ebenso wird die Visualisierung automatisch aktualisiert, wenn Sie Ihre Workflow-Definitionen aktualisieren, neu anordnen, löschen oder einen Status im Code-Editor hinzufügen. Wenn der JSON-Code in der ASL-Definition Ihres Workflows ungültig ist, unterbricht der Bereich zur Grafikvisualisierung das Rendern und zeigt am unteren Rand des Bereichs eine Statusmeldung an. ## Konfigurationsmodus Im **Konfigurationsmodus** von Workflow Studio können Sie die allgemeine Konfiguration Ihrer Zustandsmaschinen verwalten. In diesem Modus können Sie Einstellungen wie die folgenden angeben: + **Details**: Legen Sie den **Namen und den **Typ** des** Workflows fest. Beachten Sie, dass beide **nicht geändert werden können**, nachdem Sie die Zustandsmaschine erstellt haben. + **Berechtigungen**: Sie können eine neue Rolle erstellen (empfohlen), eine bestehende Rolle auswählen oder einen ARN für eine bestimmte Rolle eingeben. Wenn Sie die Option zum Erstellen einer neuen Rolle auswählen, erstellt Step Functions eine Ausführungsrolle für Ihre Zustandsmaschinen mit den geringsten Rechten. Die generierten IAM-Rollen gelten für die Rollen, AWS-Region in denen Sie die Zustandsmaschine erstellen. Vor der Erstellung können Sie die Berechtigungen überprüfen, die Step Functions automatisch für Ihre Zustandsmaschine generiert. + **Protokollierung**: Sie können eine Protokollebene für Ihre Zustandsmaschine aktivieren und festlegen. Step Functions protokolliert die Ereignisse des Ausführungsverlaufs auf der Grundlage Ihrer Auswahl. Sie können optional einen vom Kunden verwalteten Schlüssel verwenden, um Ihre Protokolle zu verschlüsseln. Weitere Informationen zu Protokollebenen finden Sie unter[Protokollebenen für Ausführungsereignisse von Step Functions](cw-logs.md#cloudwatch-log-level). Unter **Zusätzliche Konfiguration** können Sie eine oder mehrere der folgenden **optionalen** Konfigurationsoptionen festlegen: + **X-Ray-Tracing aktivieren**: Sie können Traces X-Ray für State-Machine-Ausführungen an senden, auch wenn keine Trace-ID von einem Upstream-Dienst übergeben wird. Weitere Informationen finden Sie unter [Trace Step Functions fordern Daten an AWS X-Ray](concepts-xray-tracing.md). + **Version bei Erstellung veröffentlichen**: Eine *Version* ist ein nummerierter, unveränderlicher Snapshot einer Zustandsmaschine, den Sie ausführen können. Wählen Sie diese Option, um eine Version Ihrer Zustandsmaschine zu veröffentlichen, während Sie die Zustandsmaschine erstellen. Step Functions veröffentlicht Version 1 als erste Revision der State Machine. Weitere Informationen zu Versionen erhalten Sie unter [State-Machine-Versionen in Step Functions Functions-Workflows](concepts-state-machine-version.md). + **Mit einem vom Kunden verwalteten Schlüssel verschlüsseln**: Sie können einen Schlüssel angeben, den Sie direkt verwalten, um Ihre Daten zu verschlüsseln. Weitere Informationen finden Sie unter [Verschlüsselung von Daten im Ruhezustand](encryption-at-rest.md) + **Stichwörter**: Wählen Sie dieses Feld, um Tags hinzuzufügen, die Ihnen helfen, die mit Ihren Ressourcen verbundenen Kosten nachzuverfolgen und zu verwalten und für mehr Sicherheit in Ihren IAM-Richtlinien zu sorgen. Weitere Informationen zu Tags erhalten Sie unter [Zustandsmaschinen und Aktivitäten in Step Functions kennzeichnen](sfn-best-practices.md#concepts-tagging). # Erstellen eines Workflows mit Workflow Studio in Step Functions Erfahren Sie, wie Sie Workflows mit Step Functions Workflow Studio erstellen, bearbeiten und ausführen. Sobald Ihr Workflow fertig ist, können Sie ihn speichern, ausführen und exportieren. **Topics** + [Erstellen eines Zustandsautomaten](#workflow-studio-components-create) + [Entwerfen Sie einen Workflow](#workflow-studio-build) + [Führen Sie Ihren Workflow aus](#workflow-studio-components-create-run) + [Bearbeiten Sie Ihren Workflow](#workflow-studio-components-create-edit) + [Exportieren Sie Ihren Workflow](#workflow-studio-components-create-export) + [Erstellen eines Workflow-Prototyps mit Platzhaltern](#workflow-studio-components-create-prototype) ## Erstellen eines Zustandsautomaten In Workflow Studio können Sie entweder eine Startvorlage oder eine leere Vorlage auswählen, um einen Workflow zu erstellen. Eine Startvorlage ist ein ready-to-run Beispielprojekt, das automatisch den Workflow-Prototyp und die Workflow-Definition erstellt und alle zugehörigen AWS Ressourcen bereitstellt, die Ihr Projekt für Sie AWS-Konto benötigt. Sie können diese Startvorlagen verwenden, um sie unverändert bereitzustellen und auszuführen, oder die Workflow-Prototypen verwenden, um darauf aufzubauen. Weitere Informationen zu Starter-Vorlagen finden Sie unter[Stellen Sie eine Zustandsmaschine mithilfe einer Startvorlage für Step Functions bereit](starter-templates.md). Bei einer leeren Vorlage verwenden Sie den [Entwurfs](workflow-studio.md#wfs-interface-design-mode) - oder [Codemodus](workflow-studio.md#wfs-interface-code-mode), um Ihren benutzerdefinierten Workflow zu erstellen. ### Erstellen Sie eine Zustandsmaschine mithilfe einer Startvorlage 1. Öffnen Sie die [Step Functions Functions-Konsole](https://console.aws.amazon.com/states/home?region=us-east-1#/) und wählen Sie **Create State Machine**. 1. Führen **Sie im Dialogfeld „Vorlage auswählen**“ einen der folgenden Schritte aus, um ein Beispielprojekt auszuwählen: + Geben Sie **Task Timer** in das Feld Nach Schlüsselwort suchen einen Text ein, und wählen Sie dann in den Suchergebnissen die Option **Task-Timer** aus. + Durchsuchen Sie die Beispielprojekte, die im rechten Bereich unter **Alle** aufgeführt sind, und wählen Sie dann **Task Timer** aus. 1. Wählen Sie **Next** (Weiter), um fortzufahren. 1. Wählen Sie aus, wie die Vorlage verwendet werden soll: 1. Wählen Sie **Vorlage verwenden**, um mit Ihrer Auswahl fortzufahren. 1. **Eine Demo ausführen** — erstellt eine Zustandsmaschine mit Schreibschutz. Nach der Überprüfung können Sie den Workflow und alle zugehörigen Ressourcen erstellen. 1. **Darauf aufbauen** — bietet eine bearbeitbare Workflow-Definition, die Sie mit Ihren eigenen Ressourcen überprüfen, anpassen und bereitstellen können. (Verwandte Ressourcen, wie Funktionen oder Warteschlangen, werden **nicht** automatisch erstellt.) ### Erstellen Sie einen Workflow mit einer leeren Vorlage Wenn Sie mit einer leeren Arbeitsfläche beginnen möchten, erstellen Sie einen Workflow aus der leeren Vorlage. 1. Öffnen Sie die [Step Functions Functions-Konsole](https://console.aws.amazon.com/states/home?region=us-east-1#/). 1. Wählen Sie **Create State Machine (Zustandsautomaten erstellen)**. 1. Wählen Sie **Aus leerem Feld erstellen**. 1. Geben Sie Ihrem Zustandsmaschine einen Namen und wählen Sie dann **Weiter**, um Ihren Zustandsmaschine in Workflow Studio zu bearbeiten. Sie können jetzt mit dem Entwerfen Ihres Workflows beginnen [Entwurfsmodus](workflow-studio.md#wfs-interface-design-mode) oder Ihre Workflow-Definition in schreiben[Code-Modus](workflow-studio.md#wfs-interface-code-mode). 1. Wählen Sie **Config**, um die Konfiguration Ihres Workflows in der zu verwalten[Konfigurationsmodus](workflow-studio.md#wfs-interface-config-mode). Geben Sie beispielsweise einen Namen für Ihren Workflow ein und wählen Sie dessen Typ aus. ## Entwerfen Sie einen Workflow Wenn Sie den Namen des Bundesstaates kennen, den Sie hinzufügen möchten, verwenden Sie das Suchfeld oben in der[Staaten (Browser)](workflow-studio.md#workflow-studio-components-states), um ihn zu finden. Suchen Sie andernfalls im Browser nach dem gewünschten Status und fügen Sie ihn der Arbeitsfläche hinzu. Sie können Status in Ihrem Workflow neu anordnen, indem Sie sie an eine andere Stelle in Ihrem Workflow ziehen. Wenn Sie einen Status auf die Leinwand ziehen, wird eine Linie angezeigt, die angibt, wo der Status in Ihren Workflow eingefügt wird, wie im folgenden Screenshot gezeigt: ![\[Illustrativer Screenshot, der die blaue Linie zeigt, die das Ziel für einen Status angibt.\]](http://docs.aws.amazon.com/de_de/step-functions/latest/dg/images/wfe-design-02.png) Nachdem ein Status auf der Arbeitsfläche abgelegt wurde, wird sein Code automatisch generiert und der Workflow-Definition hinzugefügt. Um die Definition zu sehen, aktivieren Sie den Schalter **Definition** im [Inspektorfenster](workflow-studio.md#workflow-studio-components-formdefinition). Sie können wählen[Code-Modus](workflow-studio.md#wfs-interface-code-mode), ob Sie die Definition mit dem integrierten Code-Editor bearbeiten möchten. Nachdem Sie einen Status auf der Arbeitsfläche abgelegt haben, können Sie ihn im [Inspektor-Panel](workflow-studio.md#workflow-studio-components-formdefinition) Bereich auf der rechten Seite konfigurieren. Dieser Bereich enthält die Registerkarten **Konfiguration**, **Eingabe**, **Ausgabe** und **Fehlerbehandlung** für jeden Status oder jede API-Aktion, die Sie auf der Arbeitsfläche platzieren. Sie konfigurieren die Status, die Sie in Ihre Workflows aufnehmen, auf der Registerkarte **Konfiguration**. Die Registerkarte „**Konfiguration**“ für die Lambda-API-Aktion „Aufrufen“ bietet beispielsweise die folgenden Optionen: + **Name des Bundesstaates**: Sie können den Status mit einem benutzerdefinierten Namen identifizieren oder den generierten Standardnamen akzeptieren. + Die **API** zeigt, welche API-Aktion vom Staat verwendet wird. + **Integrationstyp**: Sie können den Serviceintegrationstyp auswählen, der zum Aufrufen von API-Aktionen für andere Dienste verwendet wird. + **Der Funktionsname** bietet Optionen für: + **Geben Sie einen Funktionsnamen** ein: Sie können Ihren Funktionsnamen oder seinen ARN eingeben. + **Funktionsnamen zur Laufzeit aus der Statuseingabe abrufen**: Sie können diese Option verwenden, um den Funktionsnamen dynamisch aus der Statuseingabe abzurufen, basierend auf dem von Ihnen angegebenen Pfad. + **Funktionsnamen wählen**: Sie können direkt aus den Funktionen auswählen, die in Ihrem Konto und Ihrer Region verfügbar sind. + **Nutzlast**: Sie können wählen, ob Sie die Statuseingabe, ein JSON-Objekt oder keine Nutzlast verwenden möchten, um sie als Nutzlast an Ihre Lambda-Funktion zu übergeben. Wenn Sie JSON wählen, können Sie sowohl statische Werte als auch Werte einbeziehen, die aus der Statuseingabe ausgewählt wurden. + (Optional) In einigen Bundesstaaten gibt es die Option „Auf **Abschluss der Aufgabe warten**“ oder „Auf **Rückruf warten**“. Sofern verfügbar, können Sie eines der folgenden [Serviceintegrationsmuster](connect-to-resource.md) wählen: + **Keine Option ausgewählt**: Step Functions verwendet das [Request Response (Antwort anfordern)](connect-to-resource.md#connect-default) Integrationsmuster. Step Functions wartet auf eine HTTP-Antwort und wechselt dann zum nächsten Status. Step Functions wartet nicht darauf, dass ein Job abgeschlossen ist. Wenn keine Optionen verfügbar sind, verwendet der Staat dieses Muster. + **Warten Sie, bis die Aufgabe abgeschlossen** ist: Step Functions verwendet das [Ausführen einer Aufgabe (.sync)](connect-to-resource.md#connect-sync) Integrationsmuster. + Auf **Rückruf warten**: Step Functions verwendet das [Warten Sie auf einen Rückruf mit Task Token](connect-to-resource.md#connect-wait-token) Integrationsmuster. + (Optional) Um auf Ressourcen zuzugreifen, die AWS-Konten in Ihren Workflows unterschiedlich konfiguriert sind, bietet Step Functions [kontenübergreifenden Zugriff](concepts-access-cross-acct-resources.md). **Die IAM-Rolle für kontoübergreifenden Zugriff bietet Optionen** für: + Geben **Sie den ARN für die IAM-Rolle** an: Geben Sie die IAM-Rolle an, die die entsprechenden Ressourcenzugriffsberechtigungen enthält. Diese Ressourcen sind in einem Zielkonto verfügbar, AWS-Konto auf das Sie kontenübergreifende Anrufe tätigen. + **Rufen Sie den ARN der IAM-Rolle zur Laufzeit aus der Statuseingabe ab: Geben Sie einen Referenzpfad zu einem vorhandenen Schlüssel-Wert-Paar in der JSON-Eingabe des Bundesstaates an, das die IAM-Rolle** enthält. + **Im nächsten Status** können Sie den Status auswählen, in den Sie als Nächstes wechseln möchten. + (Optional) Das **Kommentarfeld** hat keinen Einfluss auf den Workflow, aber Sie können es verwenden, um Ihren Workflow mit Anmerkungen zu versehen. In einigen Bundesstaaten werden zusätzliche generische Konfigurationsoptionen verfügbar sein. Beispielsweise enthält die Amazon `RunTask` ECS-State-Konfiguration ein `API Parameters` Feld, das mit Platzhalterwerten gefüllt ist. Für diese Bundesstaaten können Sie die Platzhalterwerte durch Konfigurationen ersetzen, die Ihren Anforderungen entsprechen. **Um einen Status zu löschen** Sie können die Rücktaste drücken, mit der rechten Maustaste klicken und **Status löschen** wählen oder in der [Entwurfs-Werkzeugleiste](workflow-studio.md#wfs-interface-design-mode) **Löschen** wählen. ## Führen Sie Ihren Workflow aus Wenn Ihr Workflow einsatzbereit ist, können Sie ihn ausführen und seine Ausführung von der [Step Functions Functions-Konsole aus verfolgen](https://console.aws.amazon.com/states/home). **Um einen Workflow in Workflow Studio auszuführen** 1. Wählen Sie im **Design** -, **Code** - oder **Konfigurationsmodus** die Option **Ausführen.** Das Dialogfeld „**Ausführung starten**“ wird auf einer neuen Registerkarte geöffnet. 1. Gehen **Sie im Dialogfeld Ausführung starten** wie folgt vor: 1. (Optional) Geben Sie einen benutzerdefinierten Ausführungsnamen ein, um den generierten Standard zu überschreiben. **Nicht-ASCII-Namen und Protokollierung** Step Functions akzeptiert Namen für Zustandsmaschinen, Ausführungen, Aktivitäten und Beschriftungen, die Nicht-ASCII-Zeichen enthalten. Da solche Zeichen Amazon CloudWatch daran hindern, Daten zu protokollieren, empfehlen wir, nur ASCII-Zeichen zu verwenden, damit Sie die Step Functions Functions-Metriken verfolgen können. 1. (Optional) Geben Sie im **Eingabefeld Eingabewerte** im JSON-Format ein, um Ihren Workflow auszuführen. 1. Wählen Sie **Start execution (Ausführung starten)** aus. 1. Die Step Functions Functions-Konsole leitet Sie zu einer Seite weiter, die mit Ihrer Ausführungs-ID betitelt ist, die als Seite mit den *Ausführungsdetails* bezeichnet wird. Sie können die Ausführungsergebnisse im Verlauf und nach Abschluss des Workflows überprüfen. Um die Ausführungsergebnisse zu überprüfen, wählen Sie in der **Diagrammansicht** einzelne Status und anschließend die einzelnen Registerkarten im [Einzelheiten zu den Schritten](concepts-view-execution-details.md#exec-details-intf-step-details) Bereich aus, um die Details der einzelnen Status, einschließlich Eingabe, Ausgabe und Definition, anzuzeigen. Einzelheiten zu den Ausführungsinformationen, die Sie auf der Seite mit den *Ausführungsdetails* einsehen können, finden Sie unter[Überblick über die Ausführungsdetails](concepts-view-execution-details.md#exec-details-interface-overview). ## Bearbeiten Sie Ihren Workflow Sie können einen vorhandenen Workflow visuell im [Entwurfsmodus](workflow-studio.md#wfs-interface-design-mode) Workflow Studio bearbeiten. Wählen Sie in der [Step Functions Functions-Konsole](https://console.aws.amazon.com/states/home) auf der Seite **State Machines** den Workflow aus, den Sie bearbeiten möchten. Der Workflow wird im **Entwurfsmodus** von Workflow Studio geöffnet. Sie können die Workflow-Definition auch in bearbeiten[Code-Modus](workflow-studio.md#wfs-interface-code-mode). Wählen Sie die **Code-Schaltfläche**, um die Workflow-Definition in Workflow Studio anzuzeigen oder zu bearbeiten. **Anmerkung** Wenn Sie Fehler in Ihrem Workflow sehen, müssen Sie diese im **Entwurfsmodus** beheben. Sie können nicht in den **Code** - oder **Konfigurationsmodus** wechseln, wenn in Ihrem Workflow Fehler auftreten. Wenn Sie Änderungen an Ihrem Workflow speichern, haben Sie die Möglichkeit, auch eine neue **Version** zu veröffentlichen. Bei Versionen können Sie wählen, ob Sie die Originalversion oder alternative Versionen Ihres Workflows ausführen möchten. Weitere Informationen zur Verwaltung von Workflows mit Versionen finden Sie unter [State-Machine-Versionen in Step Functions Functions-Workflows](concepts-state-machine-version.md) ## Exportieren Sie Ihren Workflow Sie können die Definition Ihres Workflows [Sprache der Amazonas-Staaten](concepts-amazon-states-language.md) (ASL) und Ihr Workflow-Diagramm exportieren: 1. Wählen Sie Ihren Workflow in der [Step Functions Functions-Konsole](https://console.aws.amazon.com/states/home) aus. 1. Wählen Sie auf der *Detailseite des State Machines* die Option **Bearbeiten** aus. 1. Wählen Sie die Dropdownschaltfläche „**Aktionen**“ und führen Sie dann eine oder beide der folgenden Aktionen aus: + Um das Workflow-Diagramm in eine SVG- oder PNG-Datei zu **exportieren, wählen Sie unter Diagramm exportieren** das gewünschte Format aus. + Um die Workflow-Definition als JSON- oder YAML-Datei zu exportieren, wählen Sie unter **Exportdefinition** das gewünschte Format aus. ## Erstellen eines Workflow-Prototyps mit Platzhaltern Sie können Workflow Studio oder [Workflow Studio](use-wfs-in-app-composer.md) verwenden, um Prototypen neuer Workflows Infrastructure Composer zu erstellen, die *Platzhalterressourcen enthalten, die als Ressourcen* bezeichnet werden, die noch nicht existieren. So erstellen Sie einen Workflow-Prototyp: 1. Melden Sie sich bei der [Step Functions Functions-Konsole](https://console.aws.amazon.com/states/home?region=us-east-1#/) an. 1. Wählen Sie **Create State Machine (Zustandsautomaten erstellen)**. 1. Wählen Sie „**Aus leerem Feld erstellen“**. 1. Geben Sie Ihrem Zustandsmaschine einen Namen und wählen Sie dann **Weiter**, um Ihren Zustandsmaschine in Workflow Studio zu bearbeiten. 1. Der [Entwurfsmodus](workflow-studio.md#wfs-interface-design-mode) von Workflow Studio wird geöffnet. Entwerfen Sie Ihren Workflow in Workflow Studio. Um Platzhalter-Ressourcen einzubeziehen: 1. **Wählen Sie den Bundesstaat aus, für den Sie eine Platzhalterressource hinzufügen möchten, und gehen Sie dann unter Konfiguration wie folgt vor:** + Wählen Sie für Lambda Invoke-Status die Option **Funktionsname** und dann **Funktionsname eingeben** aus. Sie können auch einen benutzerdefinierten Namen für Ihre Funktion eingeben. + Wählen Sie für den Status „Nachricht senden“ von Amazon SQS die Option „**Warteschlangen-URL**“ und anschließend „**Warteschlangen-URL eingeben**“. Geben Sie eine Platzhalter-URL für die Warteschlange ein. + Wählen Sie für Amazon SNS Publish States unter **Thema** einen Themen-ARN aus. + Für alle anderen Staaten, die unter **Aktionen** aufgeführt sind, können Sie die Standardkonfiguration verwenden. **Anmerkung** Wenn Sie Fehler in Ihrem Arbeitsablauf feststellen, müssen Sie diese im **Entwurfsmodus** beheben. Sie können nicht in den **Code** - oder **Konfigurationsmodus** wechseln, wenn in Ihrem Workflow Fehler auftreten. 1. **(Optional) Um die automatisch generierte ASL-Definition Ihres Workflows anzuzeigen, wählen Sie Definition.** 1. (Optional) Um die Workflow-Definition in Workflow Studio zu aktualisieren, wählen Sie die **Codeschaltfläche**. **Anmerkung** Wenn Sie Fehler in Ihrer Workflow-Definition sehen, müssen Sie diese im **Codemodus** beheben. Sie können nicht in den **Entwurfs** - oder **Konfigurationsmodus** wechseln, wenn in Ihrer Workflow-Definition Fehler auftreten. 1. (Optional) Um den Namen des Zustandsmaschinen zu bearbeiten, wählen Sie das Bearbeitungssymbol neben dem Standardnamen des Zustandsmaschinen von **MyStateMachine**und geben Sie im Feld Name des **Zustandsmaschinen einen Namen** ein. Sie können auch zum wechseln, [Konfigurationsmodus](workflow-studio.md#wfs-interface-config-mode) um den Standardnamen des Zustandsmaschinen zu bearbeiten. 1. Geben Sie Ihre Workflow-Einstellungen an, z. B. den Zustandsmaschinentyp und seine Ausführungsrolle. 1. Wählen Sie **Erstellen** aus. Sie haben jetzt einen neuen Workflow mit Platzhalterressourcen erstellt, die für Prototypen verwendet werden können. Sie können Ihre Workflow-Definition und das Workflow-Diagramm [exportieren](#workflow-studio-components-create-export). + Um Ihre Workflow-Definition als JSON- oder YAML-Datei zu exportieren, wählen Sie im **Design** - oder **Codemodus** die **Drop-down-Schaltfläche Aktionen**. Wählen Sie dann unter **Definition exportieren** das Format aus, das Sie exportieren möchten. Sie können diese exportierte Definition als Ausgangspunkt für die lokale Entwicklung mit dem verwenden [AWS Toolkit for Visual Studio Code](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/building-stepfunctions.html). + Um Ihr Workflow-Diagramm in eine SVG- oder PNG-Datei zu exportieren, wählen Sie im **Design** - oder **Codemodus** die Dropdownschaltfläche **Aktionen** aus. Wählen Sie dann unter **Exportdefinition** das gewünschte Format aus. # Konfiguration von Zuständen, Eingaben und Ausgaben mit Workflow Studio in Step Functions **Status verwalten und Daten transformieren** Erfahren Sie mehr über das [Übergeben von Daten zwischen Zuständen mithilfe von Variablen](workflow-variables.md) und das [Transformieren von Daten mit JSONata](transforming-data.md). Jeder Staat trifft eine Entscheidung oder führt eine Aktion auf der Grundlage von Eingaben aus, die er erhält. In den meisten Fällen leitet er dann die Ausgabe an andere Staaten weiter. **In Workflow Studio können Sie auf den Registerkarten Eingabe und Ausgabe des Bedienfelds konfigurieren, wie ein Status seine Eingabe- und **Ausgabedaten** filtert und manipuliert.** [Inspektor-Panel](workflow-studio.md#workflow-studio-components-formdefinition) Verwenden Sie die **Informationslinks**, um bei der Konfiguration von Eingaben und Ausgaben auf die kontextuelle Hilfe zuzugreifen. ![\[Illustrativer Screenshot mit Statuseingaben und -ausgängen und dem Informationshilfebereich\]](http://docs.aws.amazon.com/de_de/step-functions/latest/dg/images/wfs_input_output_01.png) Ausführliche Informationen darüber, wie Step Functions Eingabe und Ausgabe verarbeitet, finden Sie unter[Eingabe und Ausgabe in Step Functions verarbeiten](concepts-input-output-filtering.md). ## Konfigurieren Sie die Eingabe für einen Status Jeder Status erhält Eingaben aus dem vorherigen Status als JSON. Wenn Sie die Eingabe filtern möchten, können Sie den `InputPath` Filter auf der Registerkarte **Eingabe** im [Inspektor-Panel](workflow-studio.md#workflow-studio-components-formdefinition) Bereich verwenden. Das `InputPath` ist eine Zeichenfolge, die mit beginnt `$` und einen bestimmten JSON-Knoten identifiziert. Diese werden als [Referenzpfade](amazon-states-language-paths.md) bezeichnet und folgen der JsonPath Syntax. Um die Eingabe zu filtern: + Wählen Sie **Eingabe filtern mit InputPath**. + Geben Sie einen [JsonPath](https://datatracker.ietf.org/wg/jsonpath/about/)für den `InputPath` Filter gültigen Wert ein. Beispiel, **\$1.data**. Ihr `InputPath` Filter wird zu Ihrem Workflow hinzugefügt. **Example Beispiel 1: Verwenden Sie den InputPath Filter in Workflow Studio** Angenommen, die Eingabe für Ihren Status enthält die folgenden JSON-Daten. ``` { "comment": "Example for InputPath", "dataset1": { "val1": 1, "val2": 2, "val3": 3 }, "dataset2": { "val1": "a", "val2": "b", "val3": "c" } } ``` Um den `InputPath` Filter anzuwenden, wählen Sie **Eingabe filtern mit InputPath** und geben Sie dann einen entsprechenden Referenzpfad ein. Wenn Sie eingeben**\$1.dataset2.val1**, wird der folgende JSON-Code als Eingabe an den Status übergeben. ``` {"a"} ``` Ein Referenzpfad kann auch eine Auswahl von Werten enthalten. Wenn es sich bei den Daten, auf die Sie verweisen, um Daten handelt `{ "a": [1, 2, 3, 4] }` und Sie den Referenzpfad `$.a[0:2]` als `InputPath` Filter anwenden, ist das folgende Ergebnis. ``` [ 1, 2 ] ``` [Status des parallelen Workflows](state-parallel.md)[Workflow-Status zuordnen](state-map.md), und [Workflow-Status übergeben](state-pass.md) Flow-Status verfügen über eine zusätzliche Eingabefilteroption, die auf der jeweiligen `Parameters` Registerkarte **Eingabe** aufgerufen wird. Dieser Filter wird nach dem InputPath Filter wirksam und kann verwendet werden, um ein benutzerdefiniertes JSON-Objekt zu erstellen, das aus einem oder mehreren Schlüssel-Wert-Paaren besteht. Die Werte der einzelnen Paare können entweder statische Werte sein, sie können aus der Eingabe ausgewählt werden, oder sie können [Zugreifen auf Ausführungsdaten aus dem Context-Objekt in Step Functions](input-output-contextobject.md) mit einem Pfad aus dem ausgewählt werden. **Anmerkung** Um anzugeben, dass ein Parameter einen Referenzpfad verwendet, um auf einen JSON-Knoten in der Eingabe zu verweisen, muss der Parametername mit enden`.$`. **Example Beispiel 2: Erstellen Sie eine benutzerdefinierte JSON-Eingabe für den Parallel-Status** Angenommen, die folgenden JSON-Daten sind die Eingabe für einen Parallelstatus. ``` { "comment": "Example for Parameters", "product": { "details": { "color": "blue", "size": "small", "material": "cotton" }, "availability": "in stock", "sku": "2317", "cost": "$23" } } ``` Um einen Teil dieser Eingabe auszuwählen und zusätzliche Schlüssel-Wert-Paare mit einem statischen Wert zu übergeben, können Sie im Feld **Parameter** auf der Registerkarte **Eingabe** des Status **Parallel** Folgendes angeben. ``` { "comment": "Selecting what I care about.", "MyDetails": { "size.$": "$.product.details.size", "exists.$": "$.product.availability", "StaticValue": "foo" } } ``` Die folgenden JSON-Daten werden das Ergebnis sein. ``` { "comment": "Selecting what I care about.", "MyDetails": { "size": "small", "exists": "in stock", "StaticValue": "foo" } } ``` ## Konfigurieren Sie die Ausgabe eines Zustands Jeder Status erzeugt eine JSON-Ausgabe, die gefiltert werden kann, bevor sie an den nächsten Status übergeben wird. Es sind mehrere Filter verfügbar, und jeder wirkt sich auf unterschiedliche Weise auf die Ausgabe aus. Die für jeden Status verfügbaren Ausgabefilter sind auf der Registerkarte „**Ausgabe**“ im **Inspektorfenster** aufgeführt. Für [Workflow-Status der Aufgabe](state-task.md) Bundesstaaten werden alle von Ihnen ausgewählten Ausgabefilter in der folgenden Reihenfolge verarbeitet: 1. `ResultSelector`: Verwenden Sie diesen Filter, um das Ergebnis des Status zu manipulieren. Sie können ein neues JSON-Objekt mit Teilen des Ergebnisses erstellen. 1. `Zustandsausgabe mithilfe von ResultPath In-Step-Funktionen angeben`: Verwenden Sie diesen Filter, um eine Kombination aus der Statuseingabe und dem Aufgabenergebnis auszuwählen, die an die Ausgabe übergeben werden soll. 1. `Filtern der Statusausgabe mit OutputPath`: Verwenden Sie diesen Filter, um die JSON-Ausgabe zu filtern und auszuwählen, welche Informationen aus dem Ergebnis an den nächsten Status übergeben werden. ### Benutze ResultSelector `ResultSelector`ist ein optionaler Ausgabefilter für die folgenden Staaten: + [Workflow-Status der Aufgabe](state-task.md)Staaten, bei denen es sich ausschließlich um Staaten handelt, die auf der Registerkarte **Aktionen** von aufgeführt sind[Staaten (Browser)](workflow-studio.md#workflow-studio-components-states). + [Workflow-Status zuordnen](state-map.md)Staaten, auf der Registerkarte **Flow** des States-Browsers. + [Status des parallelen Workflows](state-parallel.md)Staaten, auf der Registerkarte **Flow** des States-Browsers. `ResultSelector`kann verwendet werden, um ein benutzerdefiniertes JSON-Objekt zu erstellen, das aus einem oder mehreren Schlüssel-Wert-Paaren besteht. Die Werte jedes Paares können entweder statische Werte sein oder aus dem Ergebnis des Zustands mit einem Pfad ausgewählt werden. **Anmerkung** Um anzugeben, dass ein Parameter einen Pfad verwendet, um auf einen JSON-Knoten im Ergebnis zu verweisen, muss der Parametername mit enden`.$`. **Example Beispiel für die Verwendung eines ResultSelector Filters** In diesem Beispiel verwenden Sie, `ResultSelector` um die Antwort des Amazon CreateCluster EMR-API-Aufrufs für einen Amazon `CreateCluster` EMR-Status zu manipulieren. Das Folgende ist das Ergebnis des Amazon `CreateCluster` EMR-API-Aufrufs. ``` { "resourceType": "elasticmapreduce", "resource": "createCluster.sync", "output": { "SdkHttpMetadata": { "HttpHeaders": { "Content-Length": "1112", "Content-Type": "application/x-amz-JSON-1.1", "Date": "Mon, 25 Nov 2019 19:41:29 GMT", "x-amzn-RequestId": "1234-5678-9012" }, "HttpStatusCode": 200 }, "SdkResponseMetadata": { "RequestId": "1234-5678-9012" }, "ClusterId": "AKIAIOSFODNN7EXAMPLE" } } ``` **Um einen Teil dieser Informationen auszuwählen und ein zusätzliches Schlüssel-Wert-Paar mit einem statischen Wert zu übergeben, geben Sie Folgendes in das **ResultSelector**Feld auf der Registerkarte Ausgabe des Bundesstaates ein.** ``` { "result": "found", "ClusterId.$": "$.output.ClusterId", "ResourceType.$": "$.resourceType" } ``` Die Verwendung `ResultSelector` führt zu dem folgenden Ergebnis. ``` { "result": "found", "ClusterId": "AKIAIOSFODNN7EXAMPLE", "ResourceType": "elasticmapreduce" } ``` ### Benutzen ResultPath Die Ausgabe eines Zustands kann eine Kopie seiner Eingabe, des von ihm erzeugten Ergebnisses oder eine Kombination aus Eingabe und Ergebnis sein. Verwenden Sie `ResultPath`, um zu steuern, welche Kombination daraus an die Statusausgabe weitergeleitet wird. Weitere Anwendungsfälle von finden `ResultPath` Sie unter[Zustandsausgabe mithilfe von ResultPath In-Step-Funktionen angeben](input-output-resultpath.md). `ResultPath`ist ein optionaler Ausgabefilter für die folgenden Zustände: + [Workflow-Status der Aufgabe](state-task.md)Staaten, das sind alles Staaten, die auf der Registerkarte „**Aktionen**“ des Status-Browsers aufgeführt sind. + [Workflow-Status zuordnen](state-map.md)Staaten, auf der Registerkarte **Flow** des States-Browsers. + [Status des parallelen Workflows](state-parallel.md)Staaten, auf der Registerkarte **Flow** des States-Browsers. + [Workflow-Status übergeben](state-pass.md)Staaten, auf der Registerkarte **Flow** des States-Browsers. `ResultPath`kann verwendet werden, um das Ergebnis zur ursprünglichen Statuseingabe hinzuzufügen. Der angegebene Pfad gibt an, wo das Ergebnis hinzugefügt werden soll. **Example Beispiel für die Verwendung eines ResultPath Filters** Nehmen wir an, das Folgende ist die Eingabe für einen Task-Status. ``` { "details": "Default example", "who": "AWS Step Functions" } ``` Das Ergebnis des Task-Status ist das Folgende. ``` Hello, AWS Step Functions ``` Sie können dieses Ergebnis zur Eingabe des Status hinzufügen, indem Sie einen [Referenzpfad](amazon-states-language-paths.md) anwenden `ResultPath` und eingeben, der angibt, wo das Ergebnis hinzugefügt werden soll, z. B.`$.taskresult`: Damit `ResultPath` ist das Folgende das JSON, das als Ausgabe des Status übergeben wird. ``` { "details": "Default example", "who": "AWS Step Functions", "taskresult": "Hello, AWS Step Functions!" } ``` ### Benutze OutputPath Mit dem `OutputPath` Filter können Sie unerwünschte Informationen herausfiltern und nur den Teil von JSON übergeben, den Sie benötigen. Das `OutputPath` ist eine Zeichenfolge, die mit beginnt `$` und Knoten innerhalb von JSON-Text identifiziert. **Example Beispiel für die Verwendung eines OutputPath Filters** Stellen Sie sich vor, ein Lambda Invoke-API-Aufruf gibt zusätzlich zum Ergebnis der Lambda-Funktion Metadaten zurück. ``` { "ExecutedVersion": "$LATEST", "Payload": { "foo": "bar", "colors": [ "red", "blue", "green" ], "car": { "year": 2008, "make": "Toyota", "model": "Matrix" } }, "SdkHttpMetadata": { "AllHttpHeaders": { "X-Amz-Executed-Version": ["$LATEST"] ... ``` Sie können es verwenden`OutputPath`, um die zusätzlichen Metadaten herauszufiltern. Standardmäßig lautet der Wert des **OutputPath**Filters für Lambda Invoke-Zustände, die mit dem Workflow Studio erstellt wurden. `$.Payload` Dieser Standardwert entfernt die zusätzlichen Metadaten und gibt eine Ausgabe zurück, die der direkten Ausführung der Lambda-Funktion entspricht. Das Beispiel für das Ergebnis der Lambda Invoke-Aufgabe und der Wert von `$.Payload` für den **Ausgabefilter** übergeben die folgenden JSON-Daten als Ausgabe. ``` { "foo": "bar", "colors": [ "red", "blue", "green" ], "car": { "year": 2008, "make": "Toyota", "model": "Matrix" } } ``` Der `OutputPath` Filter ist der letzte Ausgabefilter, der wirksam wird. Wenn Sie also zusätzliche Ausgabefilter wie `ResultSelector` oder verwenden`ResultPath`, sollten Sie den Standardwert von `$.Payload` für den `OutputPath` Filter entsprechend ändern. # Richten Sie Ausführungsrollen mit Workflow Studio in Step Functions ein Sie können Workflow Studio verwenden, um Ausführungsrollen für Ihre Workflows einzurichten. Jede Step Functions Zustandsmaschine benötigt eine AWS Identity and Access Management (IAM) -Rolle, die der Zustandsmaschine die Berechtigung erteilt, Aktionen auf AWS-Services und Ressourcen auszuführen oder HTTPS aufzurufen APIs. Diese Rolle wird als *Ausführungsrolle* bezeichnet. Die Ausführungsrolle muss IAM Richtlinien für jede Aktion enthalten, z. B. Richtlinien, die es der Zustandsmaschine ermöglichen, eine AWS Lambda Funktion aufzurufen, einen AWS Batch Job auszuführen oder die Stripe-API aufzurufen. Step Functionserfordert in den folgenden Fällen, dass Sie eine Ausführungsrolle angeben: + Sie erstellen eine Zustandsmaschine in der Konsole AWS SDKs oder AWS CLI mithilfe der [CreateStateMachine](https://docs.aws.amazon.com/step-functions/latest/apireference/API_CreateStateMachine.html)API. + Sie [testen](test-state-isolation.md) einen Status in der Konsole oder AWS CLI mithilfe der [TestState](https://docs.aws.amazon.com/step-functions/latest/apireference/API_TestState.html)API. AWS SDKs **Topics** + [Über automatisch generierte Rollen](#wfs-auto-gen-roles) + [Automatisches Generieren von Rollen](#auto-generating-roles) + [Probleme bei der Rollengenerierung lösen](#resolve-role-gen-problem) + [Rolle zum Testen von HTTP-Aufgaben in Workflow Studio](#test-state-role-http) + [Rolle zum Testen einer optimierten Serviceintegration in Workflow Studio](#test-state-role-optimized) + [Rolle zum Testen einer AWS SDK-Dienstintegration in Workflow Studio](#test-state-role-aws-sdk) + [Rolle zum Testen von Ablaufzuständen in Workflow Studio](#test-state-role-flow) ## Über automatisch generierte Rollen Wenn Sie in der Step Functions Konsole eine Zustandsmaschine erstellen, kann [Workflow Studio](workflow-studio.md) automatisch eine Ausführungsrolle für Sie erstellen, die die erforderlichen IAM Richtlinien enthält. Workflow Studio analysiert Ihre State-Machine-Definition und generiert Richtlinien mit den geringsten Rechten, die zur Ausführung Ihres Workflows erforderlich sind. Workflow Studio kann IAM Richtlinien für Folgendes generieren: + [HTTP-Aufgaben](call-https-apis.md), die HTTPS aufrufen APIs. + Aufgabenstatus, die andere AWS-Services mithilfe [optimierter Integrationen](integrate-optimized.md) aufrufen, z. B. [LambdaInvoke [DynamoDB GetItem](connect-batch.md)](connect-lambda.md), oder. [AWS Glue StartJobRun](connect-glue.md) + [Aufgabenstatus, die verschachtelte Workflows ausführen.](connect-stepfunctions.md) + [Status verteilter Karten](state-map-distributed.md), einschließlich [Richtlinien](iam-policies-eg-dist-map.md) zum Starten untergeordneter Workflow-Ausführungen, zum Auflisten von Amazon S3 Buckets und zum Lesen oder Schreiben von S3-Objekten. + [X-Ray](concepts-xray-tracing.md)Ablaufverfolgung. Jede Rolle, die in Workflow Studio automatisch generiert wird, enthält eine [Richtlinie](concepts-xray-tracing.md#xray-iam), die dem Zustandsmaschine Berechtigungen zum Senden von Traces erteilt. X-Ray + [Verwendung von CloudWatch Logs zur Protokollierung des Ausführungsverlaufs in Step Functions](cw-logs.md)wenn die Protokollierung auf der Zustandsmaschine aktiviert ist. Workflow Studio kann AWS-Services mithilfe von [AWS SDK-Integrationen](supported-services-awssdk.md) keine IAM Richtlinien für Task-Status generieren, die andere aufrufen. ## Automatisches Generieren von Rollen 1. Öffnen Sie die [Step Functions Functions-Konsole](https://console.aws.amazon.com/states/home), wählen Sie im Menü **State Machines** und dann **Create State Machine** aus. Sie können auch eine bestehende Zustandsmaschine aktualisieren. Lesen Sie Schritt 4, wenn Sie eine Zustandsmaschine aktualisieren. 1. Wählen Sie Aus **leerem Feld erstellen aus**. 1. Geben Sie Ihrem Zustandsmaschine einen Namen und wählen Sie dann **Weiter**, um Ihren Zustandsmaschine in Workflow Studio zu bearbeiten. 1. Wählen Sie den Tab **Config**. 1. Scrollen Sie nach unten zum Abschnitt „**Berechtigungen**“ und gehen Sie wie folgt vor: 1. Stellen Sie sicher, dass Sie für die **Ausführungsrolle** die Standardauswahl **Neue Rolle erstellen** beibehalten. Workflow Studio generiert automatisch alle erforderlichen IAM Richtlinien für jeden gültigen Status in Ihrer Zustandsmaschinen-Definition. Es zeigt ein Banner mit der Nachricht an: **Eine Ausführungsrolle wird mit vollen Rechten erstellt.** ![\[Illustrativer Screenshot der Registerkarte „Config“ mit Vorschau der automatisch generierten Berechtigungen.\]](http://docs.aws.amazon.com/de_de/step-functions/latest/dg/images/wfs-full-permissions-role.png) **Tipp** Um die Berechtigungen zu überprüfen, die Workflow Studio automatisch für Ihren Zustandsmaschine generiert, wählen Sie **Automatisch generierte Berechtigungen überprüfen** aus. **Anmerkung** Wenn Sie die von Step Functions erstellte IAM-Rolle löschen, kann Step Functions sie später nicht mehr neu erstellen. Ebenso kann Step Functions ihre ursprünglichen Einstellungen später nicht wiederherstellen, wenn Sie die Rolle ändern (z. B. indem Sie Step Functions aus den Principals in der IAM-Richtlinie entfernen). Wenn Workflow Studio nicht alle erforderlichen IAM Richtlinien generieren kann, wird ein Banner mit der Meldung **Berechtigungen für bestimmte Aktionen können nicht automatisch generiert werden angezeigt. Eine IAM Rolle wird nur mit Teilberechtigungen erstellt.** Informationen zum Hinzufügen der fehlenden Berechtigungen finden Sie unter[Probleme bei der Rollengenerierung lösen](#resolve-role-gen-problem). 1. Wählen Sie **Erstellen**, wenn Sie eine Zustandsmaschine erstellen. Wählen Sie andernfalls **Speichern** aus. 1. Wählen Sie im daraufhin angezeigten Dialogfeld die Option **Bestätigen** aus. Workflow Studio speichert Ihren Zustandsmaschine und erstellt die neue Ausführungsrolle. ## Probleme bei der Rollengenerierung lösen In den folgenden Fällen kann Workflow Studio nicht automatisch eine Ausführungsrolle mit allen erforderlichen Berechtigungen generieren: + In Ihrer Zustandsmaschine sind Fehler aufgetreten. Stellen Sie sicher, dass Sie alle Validierungsfehler in Workflow Studio behoben haben. Stellen Sie außerdem sicher, dass Sie alle serverseitigen Fehler beheben, die beim Speichern auftreten. + Ihr Zustandsmaschine enthält Aufgaben, die AWS SDK-Integrationen verwenden. Workflow Studio kann in diesem Fall keine IAM Richtlinien [automatisch generieren](#auto-generating-roles). Workflow Studio zeigt ein Banner mit der Nachricht an. **Berechtigungen für bestimmte Aktionen können nicht automatisch generiert werden. Eine IAM Rolle wird nur mit Teilberechtigungen erstellt.** Wählen Sie in der Tabelle **Automatisch generierte Berechtigungen überprüfen** den Inhalt unter **Status** aus, um weitere Informationen zu den Richtlinien zu erhalten, die Ihrer Ausführungsrolle fehlen. Workflow Studio kann immer noch eine Ausführungsrolle generieren, aber diese Rolle enthält nicht IAM Richtlinien für alle Aktionen. Mithilfe der Links unter den **Links zur Dokumentation** können Sie Ihre eigenen Richtlinien schreiben und sie der Rolle hinzufügen, nachdem sie generiert wurde. Diese Links sind auch nach dem Speichern der Zustandsmaschine verfügbar. ## Rolle zum Testen von HTTP-Aufgaben in Workflow Studio [Zum Testen](call-https-apis.md#http-task-test) eines HTTP-Aufgabenstatus ist eine Ausführungsrolle erforderlich. Wenn Sie keine Rolle mit ausreichenden Berechtigungen haben, verwenden Sie eine der folgenden Optionen, um eine Rolle zu erstellen: + **Automatische Generierung einer Rolle mit Workflow Studio (empfohlen)** — Dies ist die sichere Option. Schließen Sie das Dialogfeld **Teststatus** und folgen Sie den Anweisungen unter[Automatisches Generieren von Rollen](#auto-generating-roles). Dazu müssen Sie zuerst Ihren Zustandsmaschine erstellen oder aktualisieren und dann zu Workflow Studio zurückkehren, um Ihren Status zu testen. + **Verwenden Sie eine Rolle mit Administratorzugriff** — Wenn Sie berechtigt sind, eine Rolle mit Vollzugriff auf alle Dienste und Ressourcen zu erstellen AWS, können Sie diese Rolle verwenden, um jede Art von Status in Ihrem Workflow zu testen. Zu diesem Zweck können Sie eine Step Functions Servicerolle erstellen und ihr die [AdministratorAccess Richtlinie](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_job-functions.html#jf_administrator) in der IAM Konsole hinzufügen [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/). ## Rolle zum Testen einer optimierten Serviceintegration in Workflow Studio Für Aufgabenstatus, die [optimierte Serviceintegrationen](integrate-optimized.md) aufrufen, ist eine Ausführungsrolle erforderlich. Wenn Sie keine Rolle mit ausreichenden Berechtigungen haben, verwenden Sie eine der folgenden Optionen, um eine Rolle zu erstellen: + **Automatische Generierung einer Rolle mit Workflow Studio (empfohlen)** — Dies ist die sichere Option. Schließen Sie das Dialogfeld **Teststatus** und folgen Sie den Anweisungen unter[Automatisches Generieren von Rollen](#auto-generating-roles). Dazu müssen Sie zuerst Ihren Zustandsmaschine erstellen oder aktualisieren und dann zu Workflow Studio zurückkehren, um Ihren Status zu testen. + **Verwenden Sie eine Rolle mit Administratorzugriff** — Wenn Sie berechtigt sind, eine Rolle mit Vollzugriff auf alle Dienste und Ressourcen zu erstellen AWS, können Sie diese Rolle verwenden, um jede Art von Status in Ihrem Workflow zu testen. Zu diesem Zweck können Sie eine Step Functions Servicerolle erstellen und ihr die [AdministratorAccess Richtlinie](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_job-functions.html#jf_administrator) in der IAM Konsole hinzufügen [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/). ## Rolle zum Testen einer AWS SDK-Dienstintegration in Workflow Studio Für Aufgabenstatus, die [AWS SDK-Integrationen](supported-services-awssdk.md) aufrufen, ist eine Ausführungsrolle erforderlich. Wenn Sie keine Rolle mit ausreichenden Berechtigungen haben, verwenden Sie eine der folgenden Optionen, um eine Rolle zu erstellen: + **Automatische Generierung einer Rolle mit Workflow Studio (empfohlen)** — Dies ist die sichere Option. Schließen Sie das Dialogfeld **Teststatus** und folgen Sie den Anweisungen unter[Automatisches Generieren von Rollen](#auto-generating-roles). Dazu müssen Sie zuerst Ihren Zustandsmaschine erstellen oder aktualisieren und dann zu Workflow Studio zurückkehren, um Ihren Status zu testen. Gehen Sie wie folgt vor: 1. Schließen Sie das Dialogfeld **Status testen** 1. Wählen Sie die Registerkarte **Config**, um den Konfigurationsmodus anzuzeigen. 1. Scrollen Sie nach unten zum Abschnitt „**Berechtigungen**“. 1. Workflow Studio zeigt ein Banner mit der Nachricht an. **Berechtigungen für bestimmte Aktionen können nicht automatisch generiert werden. Eine IAM Rolle wird nur mit Teilberechtigungen erstellt.** Wählen Sie **Automatisch generierte Berechtigungen überprüfen** aus. 1. In der Tabelle **„Automatisch generierte Berechtigungen überprüfen**“ wird eine Zeile mit der Aktion angezeigt, die dem Aufgabenstatus entspricht, den Sie testen möchten. Unter den Links zur **Dokumentation finden Sie Links**, um Ihre eigenen IAM Richtlinien in eine benutzerdefinierte Rolle zu schreiben. + **Verwenden Sie eine Rolle mit Administratorzugriff** — Wenn Sie berechtigt sind, eine Rolle mit Vollzugriff auf alle Dienste und Ressourcen zu erstellen AWS, können Sie diese Rolle verwenden, um jeden Status in Ihrem Workflow zu testen. Zu diesem Zweck können Sie eine Step Functions Servicerolle erstellen und ihr die [AdministratorAccess Richtlinie](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_job-functions.html#jf_administrator) in der IAM Konsole hinzufügen [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/). ## Rolle zum Testen von Ablaufzuständen in Workflow Studio Sie benötigen eine Ausführungsrolle, um Flussstatus in Workflow Studio zu testen. Ablaufstatus sind die Zustände, die den Ausführungsablauf steuern[Workflow-Status „Auswahl“](state-choice.md), wie[Status des parallelen Workflows](state-parallel.md),[Workflow-Status zuordnen](state-map.md),[Workflow-Status übergeben](state-pass.md),[Workflow-Status warten](state-wait.md),[Workflow-Status erfolgreich](state-succeed.md), oder[Workflow-Status „Fehlgeschlagen“](state-fail.md). Die [TestState](https://docs.aws.amazon.com/step-functions/latest/apireference/API_TestState.html)API funktioniert nicht mit Zuordnungs- oder Parallel-Status. Verwenden Sie eine der folgenden Optionen, um eine Rolle zum Testen eines Flow-Status zu erstellen: + **Verwenden Sie eine beliebige Rolle in Ihrem AWS-Konto (empfohlen)** — Flow-Status erfordern keine spezifischen IAM Richtlinien, da sie keine AWS Aktionen oder Ressourcen aufrufen. Daher kannst du jede IAM Rolle in deinem verwenden AWS-Konto. 1. Wählen Sie im Dialogfeld **Teststatus** eine beliebige Rolle aus der Dropdownliste **Ausführungsrolle** aus. 1. Wenn in der Dropdownliste keine Rollen angezeigt werden, gehen Sie wie folgt vor: 1. Wählen Sie in der IAM Konsole [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/)**Rollen** aus. 1. Wählen Sie eine Rolle aus der Liste aus und kopieren Sie ihren ARN von der Seite mit den Rollendetails. Sie müssen diesen ARN im Dialogfeld **Teststatus angeben**. 1. Wählen Sie im Dialogfeld **Teststatus** in der Dropdownliste ****Ausführungsrolle** die Option Einen Rollen-ARN eingeben** aus. 1. Fügen Sie den ARN in die **Rolle ARN** ein. + **Verwenden Sie eine Rolle mit Administratorzugriff** — Wenn Sie berechtigt sind, eine Rolle mit Vollzugriff auf alle Dienste und Ressourcen zu erstellen AWS, können Sie diese Rolle verwenden, um jeden Status in Ihrem Workflow zu testen. Zu diesem Zweck können Sie eine Step Functions Servicerolle erstellen und ihr die [AdministratorAccess Richtlinie](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_job-functions.html#jf_administrator) in der IAM Konsole hinzufügen [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/). # Konfigurieren Sie die Fehlerbehandlung mit Workflow Studio in Step Functions **Status verwalten und Daten transformieren** Erfahren Sie mehr über das [Übergeben von Daten zwischen Zuständen mithilfe von Variablen](workflow-variables.md) und das [Transformieren von Daten mit JSONata](transforming-data.md). Sie können die Fehlerbehandlung im visuellen Editor von Workflow Studio konfigurieren. Wenn ein Status einen Fehler meldet, führt Step Functions standardmäßig dazu, dass die Workflow-Ausführung vollständig fehlschlägt. Für Aktionen und einige Ablaufstatus können Sie konfigurieren, wie Step Functions mit Fehlern umgeht. Auch wenn Sie die Fehlerbehandlung konfiguriert haben, können einige Fehler dennoch dazu führen, dass die Ausführung eines Workflows fehlschlägt. Weitere Informationen finden Sie unter [Umgang mit Fehlern in Step Functions Functions-Workflows](concepts-error-handling.md). Konfigurieren Sie in Workflow Studio die Fehlerbehandlung auf der Registerkarte **Fehlerbehandlung** von[Inspektor-Panel](workflow-studio.md#workflow-studio-components-formdefinition). ## Wiederholung bei Fehlern Sie können dem Aktionsstatus und dem [Status des parallelen Workflows](state-parallel.md) Flow-Status eine oder mehrere Regeln hinzufügen, um die Aufgabe erneut zu versuchen, wenn ein Fehler auftritt. Diese Regeln werden *Retrier* genannt. Um einen Retrier hinzuzufügen, wählen Sie das Bearbeitungssymbol im Feld **Retrier \$11** und konfigurieren Sie dann seine Optionen: + (Optional) Fügen Sie im Feld **Kommentar** Ihren Kommentar hinzu. Es hat keinen Einfluss auf den Workflow, kann aber verwendet werden, um Ihren Workflow zu kommentieren. + Platzieren Sie den Cursor in das Feld **Fehler** und wählen Sie einen Fehler aus, durch den der Abruf ausgelöst wird, oder geben Sie einen benutzerdefinierten Fehlernamen ein. Sie können mehrere Fehler auswählen oder hinzufügen. + (Optional) Legen Sie ein **Intervall** fest. Dies ist die Zeit in Sekunden, bevor Step Functions seinen ersten Wiederholungsversuch durchführt. Es folgen weitere Wiederholungen in Intervallen, die Sie mit **Max. Anzahl der Versuche** und **Backoff-Rate** konfigurieren können. + **(Optional) Legen Sie „Max. Versuche“ fest.** Dies ist die maximale Anzahl von Wiederholungsversuchen, bevor Step Functions dazu führt, dass die Ausführung fehlschlägt. + (Optional) Stellen Sie die **Backoff-Rate** ein. Dies ist ein Multiplikator, der bestimmt, um wie viel sich das Wiederholungsintervall bei jedem Versuch verlängert. **Anmerkung** Nicht alle Optionen zur Fehlerbehandlung sind für alle Bundesstaaten verfügbar. Bei Lambda Invoke ist standardmäßig ein Retrier konfiguriert. ## Fehler abfangen Sie können den Aktionszuständen und den [Workflow-Status zuordnen](state-map.md) Ablaufstatus eine oder mehrere Regeln hinzufügen, um einen Fehler abzufangen. [Status des parallelen Workflows](state-parallel.md) Diese Regeln werden *Catcher* genannt. Um einen Catcher hinzuzufügen, wählen Sie **Neuen Catcher hinzufügen** und konfigurieren Sie dann seine Optionen: + (Optional) Fügen Sie im Feld **Kommentar** Ihren Kommentar hinzu. Es hat keinen Einfluss auf den Workflow, kann aber verwendet werden, um Ihren Workflow zu kommentieren. + Platzieren Sie den Cursor in das Feld **Fehler** und wählen Sie einen Fehler aus, durch den der Catcher ausgelöst wird, oder geben Sie einen benutzerdefinierten Fehlernamen ein. Sie können mehrere Fehler auswählen oder hinzufügen. + Wählen Sie im Feld **Fallback-Status** einen [Fallback-Status](concepts-error-handling.md#error-handling-fallback-states) aus. Dies ist der Status, in den der Workflow als Nächstes wechselt, nachdem ein Fehler erkannt wurde. + (Optional) Fügen Sie in dem **ResultPath**Feld einen `ResultPath` Filter hinzu, um den Fehler zur ursprünglichen Statuseingabe hinzuzufügen. Der [`ResultPath`](input-output-resultpath.md)muss gültig sein [JsonPath](https://datatracker.ietf.org/wg/jsonpath/about/). Dies wird in den Fallback-Status gesendet. ## Timeouts Sie können ein Timeout für Aktionsstatus konfigurieren, um die maximale Anzahl von Sekunden festzulegen, für die Ihr Status ausgeführt werden kann, bevor er fehlschlägt. Verwenden Sie Timeouts, um zu verhindern, dass Ausführungen hängenbleiben. Um ein Timeout zu konfigurieren, geben Sie die Anzahl der Sekunden ein, die Ihr Bundesstaat warten soll, bevor die Ausführung fehlschlägt. Weitere Informationen zu Timeouts finden Sie unter `TimeoutSeconds` im [Workflow-Status der Aufgabe](state-task.md) Status. ## HeartbeatSeconds Sie können eine *Heartbeat-Benachrichtigung* oder eine regelmäßige Benachrichtigung konfigurieren, die von Ihrer Aufgabe gesendet wird. Wenn Sie ein Taktintervall festlegen und Ihr Bundesstaat in den konfigurierten Intervallen keine Heartbeat-Benachrichtigungen sendet, wird die Aufgabe als fehlgeschlagen markiert. Um einen Heartbeat zu konfigurieren, legen Sie eine positive Ganzzahl ungleich Null für Sekunden fest. Weitere Informationen finden Sie unter `HeartBeatSeconds` in [Workflow-Status der Aufgabe](state-task.md) state. # Verwenden von Workflow Studio Infrastructure Composer zur Erstellung von Step Functions Functions-Workflows Workflow Studio ist verfügbar inInfrastructure Composer, um Sie beim Entwerfen und Erstellen Ihrer Workflows zu unterstützen. Workflow Studio in Infrastructure Composer bietet eine visuelle IaC-Umgebung (Infrastructure as Code), mit der Sie Workflows auf einfache Weise in Ihre serverlosen Anwendungen integrieren können, die mit IaC-Tools wie Vorlagen erstellt wurden. CloudFormation AWS Infrastructure Composerist ein Visual Builder, der Sie bei der Entwicklung AWS SAM und Erstellung von AWS CloudFormation Vorlagen mithilfe einer einfachen grafischen Oberfläche unterstützt. Mit entwerfen Sie eine AnwendungsarchitekturInfrastructure Composer, indem Sie sie auf einer visuellen Leinwand ziehen, gruppieren und verbinden AWS-Services . Infrastructure Composererstellt dann aus Ihrem Design eine IaC-Vorlage, die Sie verwenden können, um Ihre Anwendung mit der AWS SAM Befehlszeilenschnittstelle (AWS SAMCLI) oder CloudFormation bereitzustellen. Weitere Informationen über Infrastructure Composer finden Sie unter [Was ist Infrastructure Composer](https://docs.aws.amazon.com/application-composer/latest/dg/what-is-composer.html). Wenn Sie Workflow Studio in verwendenInfrastructure Composer, verbindet Infrastructure Composer die einzelnen Workflow-Schritte mit AWS Ressourcen und generiert die Ressourcenkonfigurationen in einer AWS SAM Vorlage. Infrastructure Composerfügt außerdem die IAM Berechtigungen hinzu, die für die Ausführung Ihres Workflows erforderlich sind. Mit Workflow Studio in Infrastructure Composer können Sie Prototypen Ihrer Anwendungen erstellen und sie in produktionsreife Anwendungen umwandeln. Wenn Sie Workflow Studio in verwendenInfrastructure Composer, können Sie zwischen der Infrastructure Composer Arbeitsfläche und Workflow Studio hin und her wechseln. **Topics** + [Verwenden von Workflow Studio in Infrastructure Composer](#procedure-use-wfs-in-app-composer) + [Dynamisches Verweisen auf Ressourcen mithilfe von CloudFormation Definitionsersetzungen](#use-cfn-sub-edit-state-machine-resource) + [Connect Aufgaben zur Serviceintegration mit erweiterten Komponentenkarten](#connect-service-integrations-enhanced-cards) + [Importieren Sie bestehende Projekte und synchronisieren Sie sie lokal](#import-projects-local-sync) + [Exportieren Sie Step Functions Functions-Workflows direkt in AWS Infrastructure Composer](#export-wsf-projects-into-app-composer) + [Nicht verfügbare Funktionen von Workflow Studio in AWS Infrastructure Composer](#wfs-features-unavailable-app-composer) ## Verwenden Sie Workflow Studio inInfrastructure Composer, um einen serverlosen Workflow zu erstellen 1. Öffnen Sie die [Infrastructure Composer-Konsole](https://console.aws.amazon.com/composer/home) und wählen Sie **Projekt erstellen**, um ein Projekt zu erstellen. 1. Geben Sie im Suchfeld in der **Ressourcenpalette** **state machine** ein. 1. Ziehen Sie die **Step FunctionsState Machine-Ressource** auf die Arbeitsfläche. 1. Wählen Sie **In Workflow Studio bearbeiten**, um Ihre State Machine-Ressource zu bearbeiten. Die folgende Animation zeigt, wie Sie zum Workflow Studio wechseln können, um Ihre State-Machine-Definition zu bearbeiten. ![\[Eine Animation, die veranschaulicht, wie Sie Workflow Studio in verwenden könnenInfrastructure Composer.\]](http://docs.aws.amazon.com/de_de/step-functions/latest/dg/images/use-wfs-in-app-composer.gif) Die Integration mit Workflow Studio zur Bearbeitung von Zustandsmaschinen, in denen Ressourcen erstellt wurden, Infrastructure Composer ist nur für [https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/sam-resource-statemachine.html](https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/sam-resource-statemachine.html)Ressourcen verfügbar. Diese Integration ist nicht für Vorlagen verfügbar, die die [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-stepfunctions-statemachine.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-stepfunctions-statemachine.html)Ressource verwenden. ## Verweisen Sie dynamisch auf Ressourcen mithilfe von CloudFormation Definitionsersetzungen in Workflow Studio In Workflow Studio können Sie Definitionsersetzungen in Ihrer CloudFormation Workflow-Definition verwenden, um dynamisch auf Ressourcen zu verweisen, die Sie in Ihrer IaC-Vorlage definiert haben. Sie können Ihrer Workflow-Definition mithilfe der `${dollar_sign_brace}` Notation Platzhalterersetzungen hinzufügen, die bei der Stapelerstellung durch tatsächliche Werte ersetzt werden. CloudFormation Weitere Informationen zu Definitionsersetzungen finden Sie unter. [DefinitionSubstitutions in Vorlagen AWS SAM](concepts-sam-sfn.md#sam-definition-substitution-eg) Die folgende Animation zeigt, wie Sie Platzhalterersetzungen für die Ressourcen in Ihrer State-Machine-Definition hinzufügen können. ![\[Die Animation zeigt, wie Sie Platzhalterersetzungen für Ressourcen in Ihrer Zustandsmaschine hinzufügen.\]](http://docs.aws.amazon.com/de_de/step-functions/latest/dg/images/use-def-sub-wfs-app-composer.gif) ## Connect Aufgaben zur Serviceintegration mit erweiterten Komponentenkarten Sie können die Aufgaben, die [optimierte Serviceintegrationen](integrate-optimized.md) aufrufen, mit [erweiterten Komponentenkarten](https://docs.aws.amazon.com/application-composer/latest/dg/reference-cards.html#reference-cards-enhanced-components) in Infrastructure Composer Canvas verbinden. Dadurch werden automatisch alle Platzhalterersetzungen zugeordnet, die durch die `${dollar_sign_brace}` Notation in Ihrer Workflow-Definition und der `DefinitionSubstitution` Eigenschaft für Ihre Ressource angegeben sind. `StateMachine` Außerdem werden die entsprechenden AWS SAM Richtlinien für die Zustandsmaschine hinzugefügt. Wenn Sie Aufgaben zur optimierten Serviceintegration [Standardkomponentenkarten](https://docs.aws.amazon.com/application-composer/latest/dg/using-composer-cards.html#using-composer-cards-component-intro) zuordnen, wird die Verbindungslinie nicht auf der Infrastructure Composer Arbeitsfläche angezeigt. Die folgende Animation zeigt, wie Sie eine optimierte Aufgabe mit einer erweiterten Komponentenkarte verbinden und die Änderungen im [https://docs.aws.amazon.com/application-composer/latest/dg/using-change-inspector.html](https://docs.aws.amazon.com/application-composer/latest/dg/using-change-inspector.html) anzeigen können. ![\[Die Animation zeigt, wie Aufgaben miteinander verknüpft und Serviceintegrationen optimiert werden.\]](http://docs.aws.amazon.com/de_de/step-functions/latest/dg/images/make-connections-wfs-app-composer.gif) Sie können [AWS SDK-Integrationen](supported-services-awssdk.md) in Ihrem Task-Status nicht mit erweiterten Komponentenkarten oder optimierten Serviceintegrationen mit Standardkomponentenkarten verbinden. Für diese Aufgaben können Sie die Ersetzungen im Bereich „**Ressourceneigenschaften**“ auf der Infrastructure Composer Arbeitsfläche zuordnen und Richtlinien zur Vorlage hinzufügen. AWS SAM **Tipp** **Alternativ können Sie auch Platzhalterersetzungen für Ihren Zustandsmaschine unter **Definitionsersetzungen** im Bereich Ressourceneigenschaften zuordnen.** Wenn Sie dies tun, müssen Sie die erforderlichen Berechtigungen für AWS-Service Ihre Task-State-Aufrufe in der Rolle State-Machine-Ausführung hinzufügen. Informationen zu den Berechtigungen, die Ihre Ausführungsrolle möglicherweise benötigt, finden Sie unter[Richten Sie Ausführungsrollen mit Workflow Studio in Step Functions ein](manage-state-machine-permissions.md). Die folgende Animation zeigt, wie Sie die Zuordnung der Platzhalterersetzung im Bereich „**Ressourceneigenschaften**“ manuell aktualisieren können. ![\[Die Animation zeigt, wie die Zuordnung von Platzhalterersetzungen im Bereich mit den Ressourceneigenschaften aktualisiert wird.\]](http://docs.aws.amazon.com/de_de/step-functions/latest/dg/images/manual-update-placeholder-mapping.gif) ## Importieren Sie bestehende Projekte und synchronisieren Sie sie lokal Sie können bestehende CloudFormation AWS SAM Projekte öffnen, um sie Infrastructure Composer zum besseren Verständnis zu visualisieren und ihre Entwürfe zu ändern. Mit Infrastructure Composer der [lokalen Synchronisierungsfunktion](https://docs.aws.amazon.com/application-composer/latest/dg/reference-features-local-sync.html) können Sie Ihre Vorlagen- und Codedateien automatisch synchronisieren und auf Ihrem lokalen Build-Computer speichern. Die Verwendung des lokalen Synchronisierungsmodus kann Ihre bestehenden Entwicklungsabläufe ergänzen. Stellen Sie sicher, dass Ihr Browser die [File System Access API](https://docs.aws.amazon.com/application-composer/latest/dg/reference-fsa.html) unterstützt, die es Webanwendungen ermöglicht, Dateien in Ihrem lokalen Dateisystem zu lesen, zu schreiben und zu speichern. Wir empfehlen, entweder Google Chrome oder Microsoft Edge zu verwenden. ## Exportieren Sie Step Functions Functions-Workflows direkt in AWS Infrastructure Composer Die AWS Step Functions Konsole bietet die Möglichkeit, einen gespeicherten State-Machine-Workflow als Vorlage zu exportieren, die von als erweiterte IaC-Ressource erkannt wirdInfrastructure Composer. Diese Funktion erstellt eine IaC-Vorlage als AWS SAM Schema und leitet Sie zu. Infrastructure Composer Weitere Informationen finden Sie unter [Exportieren Sie Ihren Workflow in IaC-Vorlagen](exporting-iac-templates.md). ## Nicht verfügbare Funktionen von Workflow Studio in AWS Infrastructure Composer Wenn Sie Workflow Studio in verwendenInfrastructure Composer, sind einige der Funktionen von Workflow Studio nicht verfügbar. Darüber hinaus unterstützt der Abschnitt **API-Parameter**, der [Inspektor-Panel](workflow-studio.md#workflow-studio-components-formdefinition) im Bereich verfügbar ist, CloudFormation Definitionsersetzungen. Sie können die Substitutionen [Code-Modus](workflow-studio.md#wfs-interface-code-mode) mithilfe der `${dollar_sign_brace}` Notation hinzufügen. Weitere Informationen zu dieser Notation finden Sie unter[DefinitionSubstitutions in Vorlagen AWS SAM](concepts-sam-sfn.md#sam-definition-substitution-eg). In der folgenden Liste werden die Funktionen von Workflow Studio beschrieben, die nicht verfügbar sind, wenn Sie Workflow Studio in verwendenInfrastructure Composer: + [Starter-Vorlagen](starter-templates.md) — Starter-Vorlagen sind ready-to-run Beispielprojekte, mit denen die Workflow-Prototypen und -Definitionen automatisch erstellt werden. Diese Vorlagen stellen alle zugehörigen AWS Ressourcen bereit, die Ihr Projekt für Sie AWS-Konto benötigt. + [Konfigurationsmodus](workflow-studio.md#wfs-interface-config-mode) — In diesem Modus können Sie die Konfiguration Ihrer Zustandsmaschinen verwalten. Sie können Ihre State-Machine-Konfigurationen in Ihren IaC-Vorlagen aktualisieren oder den Bereich mit den **Ressourceneigenschaften** Infrastructure Composer auf der Leinwand verwenden. Informationen zum Aktualisieren von Konfigurationen im Bereich mit den **Ressourceneigenschaften** finden Sie unter[Connect Aufgaben zur Serviceintegration mit erweiterten Komponentenkarten](#connect-service-integrations-enhanced-cards). + [TestState](test-state-isolation.md)-API + Option zum Importieren oder Exportieren von Workflow-Definitionen über die Dropdownschaltfläche „**Aktionen**“ in Workflow Studio. Wählen Sie stattdessen im Infrastructure Composer **Menü** **Öffnen** > **Projektordner**. Stellen Sie sicher, dass Sie den [lokalen Synchronisierungsmodus](https://docs.aws.amazon.com/application-composer/latest/dg/reference-features-local-sync.html) aktiviert haben, damit Ihre Änderungen im Infrastructure Composer Canvas automatisch direkt auf Ihrem lokalen Computer gespeichert werden. + Schaltfläche „**Ausführen**“. Wenn Sie Workflow Studio in verwendenInfrastructure Composer, Infrastructure Composer generiert es den IaC-Code für Ihren Workflow. Daher müssen Sie zuerst die Vorlage bereitstellen. Führen Sie dann den Workflow in der Konsole oder über die aus AWS Command Line Interface(AWS CLI).