> For the complete documentation index, see [llms.txt](https://hub.equipme.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://hub.equipme.io/pro/dokumentation/automation/flow-designer.md).

# Der Flow-Designer

Der Flow-Designer in Equipme Pro: Komponenten einfügen und verbinden, Variablen und Modifier, Bedingungen, Schleifen, Zeitsteuerung, Webhooks, Testen, Fehlerbehandlung und Starten.

**Pfad:** „Automation“ → „Workflows“ → Flow öffnen

Im **Flow-Designer** baust du einen Flow per Drag & Drop zusammen. Er öffnet sich im Vollbild, sobald du einen Flow anlegst oder öffnest; die Seitenleiste von Pro klappt dabei ein. Über den **Zurück-Pfeil in der Pro-Kopfzeile** kehrst du zur [Flow-Liste](https://hub.equipme.io/pro/dokumentation/automation/workflows.md) zurück.

## Aufbau

| Bereich                  | Inhalt                                                                                                                                                                                                                            |
| ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Kopfzeile**            | Name des Flows, Hinweis auf ungültige Komponenten, **„Start flow“** bzw. **„Stop flow“** und das Menü des Flows                                                                                                                   |
| **Links: Komponenten**   | Alle verfügbaren Bausteine, gruppiert in **„Utilities“** (Hilfsbausteine wie Filter, Timer, HTTP) und **„Applications“** (Connectoren wie Equipme Pro, weclapp, Autotask, Microsoft). Über „Filter connectors“ suchst du gezielt. |
| **Mitte: Arbeitsfläche** | Hier liegen die Komponenten und ihre Verbindungen.                                                                                                                                                                                |
| **Rechts: Inspector**    | Einstellungen der ausgewählten Komponente                                                                                                                                                                                         |
| **Werkzeugleiste**       | Rückgängig/Wiederholen, Zoom („Zoom to fit“, „Zoom in“, „Zoom out“), Diagramm ausrichten, Tastenkürzel und „Logs“                                                                                                                 |

**Arbeitsfläche bedienen:** Mehrere Komponenten wählst du mit gedrückter Umschalttaste aus. Mit Strg/Cmd + C und Strg/Cmd + V kopierst du Komponenten innerhalb des Designers. Mit „Zoom to fit“ holst du einen großen Flow vollständig ins Bild; die Ausrichten-Schaltfläche ordnet alle Komponenten übersichtlich von links nach rechts an.

## Komponenten hinzufügen und verbinden

1. **Trigger zuerst:** Jeder Flow beginnt mit einem Trigger. Für den Einstieg bietet der Designer häufig genutzte Trigger an: **Timer**, **OnStart**, **Scheduler** und **Webhook**. Trigger aus Connectoren (z. B. *New Sales Order* aus „Equipme Pro“) ziehst du aus der linken Leiste auf die Arbeitsfläche.
2. **Aktionen ergänzen:** Ziehe weitere Komponenten auf die Arbeitsfläche. Bei Connectoren wählst du im Inspector unter **„Action“** die konkrete Aktion.
3. **Verbinden:** Jede Komponente hat **Ports** – Eingänge links, Ausgänge rechts. Ziehe eine Linie vom Ausgang einer Komponente zum Eingang der nächsten. Nur so fließen Daten weiter.
4. **Account wählen:** Braucht die Komponente eine Verbindung, wählst du im Inspector einen vorhandenen [Account](https://hub.equipme.io/pro/dokumentation/automation/accounts.md) oder legst mit **„Connect account“** bzw. **„Connect a new account“** einen neuen an.
5. **Felder ausfüllen:** Pflichtfelder sind markiert. Solange etwas fehlt, zeigt die Kopfzeile z. B. „1 component is invalid.“; ein Klick darauf führt zur betroffenen Komponente.

**Komponenten umbenennen:** Im Inspector über „Rename“. Namen wie „ERP-Auftrag anlegen“ machen den Flow für andere verständlich.

## Eingaben und Variablen

In fast jedes Feld kannst du statt eines festen Werts eine **Variable** einsetzen – Daten aus einem vorherigen Schritt.

1. Klicke im Feld auf das Symbol **„Variables“**.
2. Wähle unter „Connectors“ die Komponente und den Wert, z. B. die Auftragsnummer aus *New Sales Order*. Unter „General“ findest du allgemeine Werte.
3. Die Variable erscheint im Feld und wird bei jeder Ausführung mit dem aktuellen Wert gefüllt.

Es stehen nur Werte von Komponenten zur Verfügung, die **vor** der aktuellen Komponente liegen und mit ihr verbunden sind. Fehlt eine erwartete Variable, prüfe die Verbindungen und klicke „Refresh variables“.

## Modifier: Werte umwandeln

Klicke auf eine eingefügte Variable, um sie im Dialog **„Modify variable“** umzuwandeln. Mit **„Add modifier“** wählst du eine Funktion aus Kategorien wie Text, Zahl, Datum, Liste, Objekt oder Steuerung, z. B.:

* Text in Großbuchstaben, kürzen, ersetzen oder zusammensetzen,
* Datum formatieren oder um Tage verschieben,
* Zahlen teilen, runden oder summieren,
* aus einer Liste das erste Element, die Anzahl oder einzelne Felder holen.

Modifier lassen sich hintereinander schalten. Mit **„Test your modifier“** probierst du das Ergebnis mit Beispieldaten aus, bevor der Flow läuft.

## Bedingungen und Filter

* **Filter** (Utilities): Lassen eine Nachricht nur weiter, wenn eine Regel erfüllt ist – z. B. „Contains“, „Equal“, „NotEqual“, „Greater than“, „LessThan“, „Range“ oder „IsNotEmpty“. Verbinde den passenden Ausgang mit dem nächsten Schritt.
* **Condition** (Controls): Prüft einen Ausdruck mit Und/Oder-Verknüpfungen und gibt das Ergebnis über die Ausgänge „true“ oder „false“ weiter – so verzweigst du den Flow.
* **Switch** (Controls): Mehrere Fälle mit je eigenem Ausgang, dazu „else“ für alles andere.

Nachrichten, die eine Bedingung nicht erfüllen, enden dort ohne Fehler.

## Listen in Schleifen abarbeiten

Viele Aktionen liefern Listen, z. B. alle offenen Fulfillment-Positionen. Um jeden Eintrag einzeln zu verarbeiten:

1. Füge **Each** (Controls) ein und gib im Feld „Field“ die Liste als Variable an.
2. Each schickt jeden Eintrag einzeln über den Ausgang „item“ weiter; am Ende meldet es sich einmal über „done“.
3. Soll die Reihenfolge eingehalten werden oder braucht der nächste Schritt alle Ergebnisse, schalte **„Sequential“** ein und schließe die Schleife mit **Continue Each** ab.
4. Bei Schnittstellen mit Begrenzungen setzt du eine Verzögerung („Delay“) zwischen den Einträgen.

Für einfache Umformungen ganzer Listen reichen oft die Listen-Modifier, ganz ohne Schleife. Viele Listen-Aktionen des equipme Connectors bieten außerdem „Output Type“ → „One item at a time“.

## Zeitsteuerung

| Komponente    | Zweck                                                                                      |
| ------------- | ------------------------------------------------------------------------------------------ |
| **OnStart**   | Löst einmal aus, wenn du den Flow startest.                                                |
| **Timer**     | Löst in festen Abständen aus (mindestens alle 5 Minuten).                                  |
| **Scheduler** | Löst nach Zeitplan aus, z. B. jeden Werktag um 6 Uhr. Prüfe die eingestellte **Zeitzone**. |
| **Wait**      | Hält eine Nachricht für eine Zeitspanne oder bis zu einem Zeitpunkt an.                    |

## Webhook-Trigger

Ein **Webhook**-Trigger stellt eine eigene Adresse („Webhook URL“) bereit, die du im Inspector kopierst. Ruft ein anderes System – z. B. dein Lagerverwaltungssystem – diese Adresse auf, startet der Flow mit den übermittelten Daten.

* Mit „Immediate response“ erhält der Aufrufer sofort eine Bestätigung.
* Soll der Aufrufer eine eigene Antwort bekommen, schalte „Immediate response“ aus und setze später im Flow eine **Response**-Komponente.

Behandle die Webhook-Adresse vertraulich: Jeder, der sie kennt, kann den Flow starten.

## Testen

{% hint style="danger" %}
Beim Testen werden alle Aktionen **wirklich ausgeführt**: Aufträge im ERP werden angelegt, Status in Pro geändert, E-Mails verschickt. Teste mit einem **Testkunden**, Testdaten und – wo möglich – Test- oder Sandbox-Accounts.
{% endhint %}

So testest du einen Flow:

1. Schränke den Trigger auf Testdaten ein, z. B. per „Customers“ auf deinen Testkunden.
2. Bietet der Designer **„Test flow“** an, führst du den Flow damit einmal aus, ohne ihn zu starten. Sonst startest du ihn mit **„Start flow“** und löst den Trigger mit einem Testvorgang aus.
3. Öffne **„Logs“** in der Werkzeugleiste und prüfe je Schritt Ein- und Ausgaben (siehe [Insights](https://hub.equipme.io/pro/dokumentation/automation/insights.md)).
4. Passt alles, entferne die Test-Einschränkung und starte den Flow für den Echtbetrieb.

## Fehlerbehandlung und Wiederholungen

* **Vorübergehende Fehler** wie Zeitüberschreitungen, Verbindungsabbrüche oder überlastete Schnittstellen werden automatisch nach und nach wiederholt. Das kann Minuten bis Stunden dauern.
* **Dauerhafte Fehler** wie fehlende Berechtigungen, ungültige Werte oder nicht gefundene Einträge werden nicht wiederholt. Die Nachricht bleibt im Protokoll als Fehler stehen; andere Nachrichten laufen weiter.
* Bei wichtigen Schritten kannst du im Menü der Komponente unter „Error handling“ festlegen, was nach einem Fehler passiert – z. B. einen eigenen Fehler-Ausgang, den du mit einer Benachrichtigung verbindest (siehe [Insights](https://hub.equipme.io/pro/dokumentation/automation/insights.md#bei-fehlern-benachrichtigt-werden)).

## Starten

Ein Flow läuft erst, wenn du **„Start flow“** klickst. Mit **„Stop flow“** hältst du ihn an. Änderungen an laufenden Flows beschreibt [Workflows verwalten](https://hub.equipme.io/pro/dokumentation/automation/workflows.md#einen-laufenden-flow-andern).

## Menü des Flows

| Eintrag                             | Wirkung                                                                                                                          |
| ----------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| **„Rename“**                        | Flow umbenennen                                                                                                                  |
| **„Share“**                         | Flow zum Ansehen freigeben (siehe [Flows teilen](https://hub.equipme.io/pro/dokumentation/automation/workflows.md#flows-teilen)) |
| **„Change Description“**            | Beschreibung hinterlegen, z. B. Zweck und Ansprechpartner                                                                        |
| **„Export SVG“** / **„Export PNG“** | Diagramm als Bild speichern (Rechtsklick → „Speichern unter“), z. B. für die Dokumentation                                       |
| **„Print“**                         | Diagramm drucken                                                                                                                 |

## Häufige Fragen

**Ich finde eine Variable nicht im Auswahlfeld.**

Die liefernde Komponente muss vor der aktuellen liegen und mit ihr verbunden sein. Klicke „Refresh variables“. Bei Triggern hilft es, den Flow einmal mit Testdaten laufen zu lassen.

**Der Flow lässt sich nicht starten.**

Prüfe die Meldung in der Kopfzeile, z. B. „2 components are invalid.“, und fülle die fehlenden Pflichtfelder.

**Wo sehe ich die Zwischenergebnisse eines Schritts?**

Unter „Logs“ in der Werkzeugleiste oder in [Insights](https://hub.equipme.io/pro/dokumentation/automation/insights.md). Dort zeigt jeder Eintrag die Daten, die ein Schritt erhalten oder weitergegeben hat.

**Warum ist die Leiste „Persönlich“/„Team“ im Designer verschwunden?**

Im geöffneten Flow-Designer ist sie ausgeblendet. Der Flow bleibt in dem Bereich, in dem du ihn angelegt hast.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://hub.equipme.io/pro/dokumentation/automation/flow-designer.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
