# Arbeitsabläufe einrichten

Erfahren Sie, wie Sie Arbeitsabläufe im Dashboard einrichten.

Erstellen Sie einen Workflow, um eine Aufgabe zu automatisieren. Sie können Workflows durch Stripe-Ereignisse auslösen oder programmgesteuert aufrufen.

## Before you begin

- Sie können bis zu 50 aktive Workflows gleichzeitig ausführen.
- Erstellen Sie eine [Sandbox](https://docs.stripe.com/sandboxes.md), um das Erstellen und Ausführen von Abläufen zu testen. Auf diese Weise können Sie mit neuen Funktionen experimentieren, Probleme und Fehler beheben, ohne den Live-Betrieb zu beeinträchtigen.
- Vergewissern Sie sich, dass Sie die [Funktionsweise von Workflows](https://docs.stripe.com/workflows/define-workflows.md) nachvollziehen können.

## Arbeitsablauf erstellen

1. Gehen Sie im Dashboard zu [Workflows](https://dashboard.stripe.com/workflows).
2. Klicken Sie auf **Neuer Workflow**, um den Workflow-Generator zu öffnen.
3. Klicken Sie auf **Unbenannter Arbeitsablauf** und geben Sie einen Namen für den Ablauf ein.
4. Klicken Sie auf **Auslöser hinzufügen**.
   - Jeder Ablauf kann nur einen Auslöser haben.
   - Ein [Auslöser](https://docs.stripe.com/workflows/define-workflows.md#triggers) ist ein beliebiges öffentliches Stripe-API-Ereignis, mit dem Sie Ihren Workflow starten können. Sie können auch einen [programmgesteuerten Trigger](https://docs.stripe.com/workflows/programmatic-triggers.md) auswählen, um den Workflow manuell oder über die API zu starten.
   - Wählen Sie einen der vorgeschlagenen Auslöser aus. Sie können suchen oder nach Kategorien stöbern.
5. Nachdem Sie einen Auslöser ausgewählt haben, legen Sie fest, wann Ihr Workflow ausgeführt werden soll, indem Sie eine [Bedingung](https://docs.stripe.com/workflows/define-workflows.md#trigger-conditions) hinzufügen.
   - Listenbedingungen werten bis zu 100 Elemente aus. Wenn Sie z. B. Bedingungen für ein Feld einrichten, das eine Liste von Elementen enthält, wertet der Arbeitsablauf nur die ersten 100 Elemente aus, um zu bestimmen, ob die Bedingung erfüllt ist. Wir bewerten keine Elemente, die das Limit überschreiten.
   - Ihr Workflow wird nur ausgeführt, wenn die Auslösebedingungen erfüllt sind.
6. Klicken Sie auf **Schritt hinzufügen**. Sie können entweder eine [Aktion](https://docs.stripe.com/workflows/define-workflows.md#actions), eine [Bedingung](https://docs.stripe.com/workflows/define-workflows.md#conditions) oder eine [Schleife](https://docs.stripe.com/workflows/loops.md) auswählen.
   - Dynamische Werte werden aus einem bestimmten Schritt abgerufen, der veraltet sein kann, wenn sich das Objekt ändert, nachdem dieser Schritt ausgeführt wurde oder ein Ereignis ausgelöst hat. Jede Aktion wird jedoch mit der aktuellten Version des Objekts ausgeführt.
7. Konfigurieren Sie anschließend die Aktion, indem Sie Werte zu den Parametern hinzufügen. Sie müssen alle Pflichtfelder ausfüllen, damit der Workflow ausgeführt werden kann. Diese Eigenschaften sind als **Pflichtfeld** gekennzeichnet.
8. Fügen Sie gegebenenfalls weitere Schritte hinzu.
9. Klicken Sie auf **Veröffentlichen**.

### Wählen Sie eine Ereignisquelle aus (Plattformen verbinden)

Wenn Sie eine Connect-Plattform nutzen, wird Ihnen bei der Konfiguration Ihres Auslöser eine zusätzliche Option angezeigt: **Auslöser überwachen**. Damit legen Sie fest, welche Ereignisse eines Kontos den Workflow auslösen.

- **Ihr Konto**: Der Workflow wird durch Ereignisse aus Ihrem Plattformkonto ausgelöst (Standard).
- **Verbundenes Konto**: Der Workflow wird durch Ereignisse aus einem Ihrer verbundenen Konten ausgelöst.

Wählen Sie die Ereignisquelle aus, die Ihrem Anwendungsfall entspricht. Sie können nicht beide auswählen. Ein Workflow überwacht jeweils nur eine Ereignisquelle.

Sie können auch einzelne Aktionen so konfigurieren, dass sie für das verbundene Konto oder Ihr Plattformkonto ausgeführt werden. Weitere Informationen finden Sie unter [Aktionen für verbundene Konten](https://docs.stripe.com/workflows/define-workflows.md#actions-on-connected-accounts).

Beispiele für Workflows, die Sie erstellen können, finden Sie unter [Anwendungsfälle](https://docs.stripe.com/workflows/use-cases.md).

## Einen Ablauf testen

Nachdem Sie Ihren Ablauf gespeichert und aktiviert haben, testen Sie ihn. Sie müssen den Auslöser, die Auslöserbedingungen (falls zutreffend) und die aufeinanderfolgenden Schritte, die Sie angewendet haben, testen.

So testen Sie beispielsweise einen Arbeitsablauf, der immer dann ausgelöst wird, wenn neue Kundinnen/Kunden erstellt werden:

1. Erstellen Sie eine [Sandbox](https://docs.stripe.com/sandboxes.md), um Ihre Arbeitsabläufe sicher zu testen, ohne Ihr Live-Konto zu beeinträchtigen.
2. Gehen Sie im Dashboard zu [Kundinnen/Kunden](https://dashboard.stripe.com/customers).
3. Klicken Sie auf **+ Neuer Kunde/Neue Kundin**.
4. Geben Sie die Kundendetails ein und überprüfen Sie, ob der Name mit dem Vornamen des Kunden/der Kundin beginnt (zum Beispiel „Peter“).
5. Klicken Sie auf **Kunden/Kundin hinzufügen**.

### Mit verbundenen Konten testen

So testen Sie einen Workflow, der bei Ereignissen in verbundenen Konten ausgelöst wird:

1. Verwenden Sie eine Sandbox-Umgebung mit mindestens einem verbundenen Konto.
2. Erstellen oder simulieren Sie ein Ereignis auf dem verbundenen Konto, das Ihrem Auslöser entspricht. Wenn Ihr Workflow beispielsweise bei `payment_intent.succeeded` ausgelöst wird, erstellen Sie eine Testzahlung auf einem verbundenen Konto.
3. Vergewissern Sie sich, dass der Workflow-Lauf im **Ausführungsverlauf** angezeigt wird. In den Ausführungsdetails wird angezeigt, welches verbundene Konto den Lauf ausgelöst hat.

Falls Sie in Ihrer Sandbox noch keine verbundenen Konten haben, richten Sie bitte zunächst Testkonten ein. Weitere Informationen finden Sie unter [Connect-Integrationen testen](https://docs.stripe.com/connect/testing.md).

> Aktionen, die auf verbundene Konten angewendet werden, können fehlschlagen, wenn das Konto nicht über die erforderlichen Berechtigungen verfügt. Überprüfen Sie die Ausführungsdetails, um Berechtigungsfehler zu diagnostizieren.

## Einen Arbeitsablauf beobachten

Nachdem Sie den Arbeitsablauf ausgelöst haben, überprüfen Sie die Ausführungsdetails:

1. Gehen Sie im Dashboard zu [Workflows](https://dashboard.stripe.com/workflows).

2. Klicken Sie auf den entsprechenden Arbeitsablauf.

3. Zeigen Sie unter **Letzte Ausführungen** den neuesten Ausführungseintrag an, der den von Ihnen erstellten und ausgelösten Testablauf darstellt.

   - Wenn der Ablauf erfolgreich ausgeführt wurde, wird im Status das Badge **Erfolgreich** angezeigt.
   - Wenn der Ablauf fehlgeschlagen ist, wird im Status das Badge **Fehlgeschlagen** angezeigt.

4. Klicken Sie auf die Ausführung, um die Details der einzelnen Schritte anzuzeigen, die vom Ablauf ausgeführt werden. Wenn Sie auf einen Schritt klicken, können Sie auch auf **In Workbench überprüfen** klicken, um entwicklerorientierte [Workbench](https://docs.stripe.com/workbench.md)-Protokolle anzuzeigen, die aus den im Ablauf ausgeführten Aktionen generiert wurden.

   - Workbench ist für Auslöserereignisse verfügbar, sodass Sie direkt zur Registerkarte „Ereignisse“ in Workbench navigieren können, sowie für Aktionen, bei denen Sie auf das entsprechende Anforderungsprotokoll zugreifen können.
   - Dies ist für Ablaufspezifische Schritte wie das Senden von E-Mails oder das Auswerten von Bedingungen, einschließlich Verzweigungen, nicht verfügbar.

5. Klicken Sie in der Ansicht **Historie ausführen** auf das Überlaufmenü (⋯) > **Ressource prüfen**, um eine JSON-Ansicht des Objekts zu untersuchen, das den Workflow mit [Workbench](https://docs.stripe.com/workbench/overview.md#inspector) ausgelöst hat.

### Fehlgeschlagene Arbeitsabläufe

Wenn der Ablauf fehlschlägt:

1. Klicken Sie in der Ansicht **Ausführungsverlauf** auf die Schritte, bei denen die Fehlermeldung nicht angezeigt wurde.
2. Verwenden Sie die Fehlermeldungen, um die Schritte zu beheben. Sie können auch auf **In Workbench prüfen** klicken, um die vom Arbeitsablauf generierten [Workbench](https://docs.stripe.com/workbench.md)-Protokolle speziell für Entwickler/innen anzuzeigen.
3. Nachdem Sie das Problem behoben haben, erstellen Sie einen neuen Workflow-Lauf, um die Korrektur zu überprüfen.
![Workbench-Ansicht mit Arbeitsabläufen](https://b.stripecdn.com/docs-statics-srv/assets/workbench.d7d4401e2bd1fcd3e0884433acbf33a2.png)

Workbench-Ansicht mit Arbeitsabläufen

## Einen Ablauf deaktivieren

Sie haben die Möglichkeit, Arbeitsabläufe zu aktivieren, zu deaktivieren oder zu löschen. Nachdem Sie einen Ablauf deaktiviert haben, betrachtet Stripe ihn als inaktiv und reagiert nicht mehr auf Auslöser.

Sie können bis zu 50 Workflows gleichzeitig aktiv halten und insgesamt 50 Workflows (aktive und inaktive) haben. Wenn Sie 50 Workflows haben, können Sie keinen weiteren erstellen. Wenn Sie 50 aktive Workflows haben und einen neuen aktivieren möchten, müssen Sie zunächst einen bestehenden aktiven Workflow deaktivieren.

So deaktivieren Sie einen Arbeitsablauf:

1. 1. Gehen Sie zu [Workflows](https://dashboard.stripe.com/workflows) und wählen Sie den entsprechenden Workflow aus.
2. Klicken Sie auf **Deaktivieren**. Wenn Sie den Ablauf wieder aktivieren möchten, klicken Sie auf **Aktivieren**.

### Einen Arbeitsablauf löschen

Das Löschen eines Ablaufs ist dauerhaft. Nach dem Löschen kann ein Arbeitsablauf nicht wiederhergestellt werden. Überprüfen Sie dies noch einmal, bevor Sie einen Arbeitsablauf löschen. Erwägen Sie im Zweifelsfall eine Deaktivierung statt einer Löschung.

So löschen Sie einen Arbeitsablauf:

1. Gehen Sie zu [Workflows](https://dashboard.stripe.com/workflows) und wählen Sie den entsprechenden Workflow aus.
2. Klicken Sie neben **Deaktivieren** auf das Überlaufmenü (⋯) > **Arbeitsablauf löschen**.
3. Klicken Sie im Modal auf **Löschen**.

Der Arbeitsablauf wird nun zusammen mit den Ausführungsdetails endgültig gelöscht.

## Optional: Vergangene Versionen anzeigen

Sie können alle zuvor aktivierten Versionen eines Workflows direkt im Workflow-Editor anzeigen:

1. Öffnen Sie den Workflow im Editor.
2. Klicken Sie auf das Dropdown-Menü „Version“ neben dem Namen des Workflows.
3. Wählen Sie eine beliebige frühere Version aus, um die vollständige Konfiguration auf der Leinwand anzuzeigen.

Auf diese Weise können Sie jederzeit sehen, wie ein Workflow konfiguriert wurde. Dies hilft Ihnen, Änderungen oder Fehlerbehebungen bei früheren Ausführungen zu verstehen.

## See also

- [Arbeitsabläufe](https://docs.stripe.com/workflows/define-workflows.md)
- [Anwendungsfälle](https://docs.stripe.com/workflows/use-cases.md)
- [Durch Einzüge iterieren](https://docs.stripe.com/workflows/loops.md)
- [Benutzerdefinierte Aktionen erstellen](https://docs.stripe.com/workflows/custom-actions.md)
- [Workflows programmgesteuert auslösen](https://docs.stripe.com/workflows/programmatic-triggers.md)