> For the complete documentation index, see [llms.txt](https://help.vario-software.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.vario-software.de/vario-cloud-handbuch/system/workflows/workflows-erstellen.md).

# Workflows erstellen

So legst Du einen Workflow an, wählst den passenden Auslöser und baust den Ablauf im Editor auf.

Um Dir den Einstieg in die Arbeit mit Workflows zu erleichtern, zeigen wir Dir die einzelnen Schritte anhand des Beispiel-Workflows **„Lieferungs- und Zahlungsmodalitäten für Angebote“**.

<details>

<summary><mark style="color:$primary;"><strong>Beispiel:</strong></mark> Lieferungs- und Zahlungsmodalitäten für Angebote</summary>

Dieser Workflow vereinfacht die **Erstellung von Angeboten** für **Interessenten**, bei denen noch **keine Geschäftsbeziehung** hinterlegt ist.

**Standardablauf ohne Workflow:**

Beim Anlegen eines Angebots für eine Adresse **ohne Geschäftsbeziehung** (z. B. bei neuen Interessenten) müssen die **Zahlungs- und Lieferbedingungen manuell** eingetragen werden.

**Ablauf mit Workflow:**

Mit Hilfe des Workflows werden die **Zahlungs- und Lieferungsmodalitäten** in diesem Fall **automatisch vorausgefüllt**, sobald das neue Angebot erstellt wird.

Der Workflow prüft dazu:

* ob es sich um einen **Beleg** der Kategorie **Angebot** handelt,
* und ob **keine Geschäftsbeziehung** vom Typ **Kunde** bei der Adresse hinterlegt ist.

Wenn beide Bedingungen zutreffen, werden die Modalitäten aus im Workflow festgelegten **Standardwerten** übernommen.

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FWFLg6jkqlZXUr97pGps4%2Fimage.png?alt=media&amp;token=b8a7f0c2-2e91-42ca-8592-2baeaad6c509" alt=""><figcaption></figcaption></figure>

Auf den **Aufbau** und die einzelnen **Elemente eines Workflows** gehen wir im Abschnitt [**Workflow-Elemente**](https://help.vario-software.de/vario-cloud-handbuch/system/workflows/workflow-elemente.md#workflow-elemente) detailliert ein.

</details>

## Workflow erstellen

Um einen neuen Workflow zu erstellen, gehe folgendermaßen vor:

{% stepper %}
{% step %}
Wähle **»+Workflow«** aus.
{% endstep %}

{% step %}
Gib dem Workflow eine **Bezeichnung**, wähle den gewünschten **Auslöser** aus und klicke auf **»Anlegen«**.

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FEmIOtWX6smXL8zOC3jzn%2Fimage.png?alt=media&amp;token=f43c48e0-6f5f-40eb-82bc-15c3f0044ed9" alt="Workflow anlegen" width="479"><figcaption></figcaption></figure>

{% hint style="info" icon="books" %}

#### Auslöser

Die **Auslöser** legen fest, welche Aktion in VARIO Cloud den **Start** eines Workflows **auslöst**. Sie sind nach Funktionsbereiche wie **Belege**, **CRM/Office** oder **Adressen** unterteilt. Je nach Bereich stehen unterschiedliche Auslöser zu Verfügung, wie zum Beispiel das Speichern eines Datensatzes und die Übernahme eines Beleges.

**Wichtig:** **Pro Auslöser kann nur ein Hauptworkflow gleichzeitig aktiv sein.** Ein zweiter eigenständiger Workflow mit demselben Auslöser lässt sich daher nicht zusätzlich aktivieren. Das ist vorgesehenes Verhalten.

Für mehrere Automatisierungen verwendest Du **Unter-Workflows**, die Du in den bestehenden Hauptworkflow einbindest. Wie das geht, erfährst Du unter [Mehrere Automatisierungen für denselben Auslöser](#mehrere-automatisierungen-fur-denselben-ausloser).

Mit der Wahl des Auslösers wird gleichzeitig bestimmt, ob der Workflow **synchron** oder **asynchron** ausgeführt wird. Eine Übersicht aller verfügbaren Auslöser und deren Zuordnung zu synchronen oder asynchronen Workflows findest Du im Abschnitt [**Synchrone und Asynchrone Workflows**](https://help.vario-software.de/vario-cloud-handbuch/system/workflows.md#synchrone-und-asynchrone-workflows).

**Beispiel Auslöser**

Für unseren Beispiel-Workflow **„Lieferungs- und Zahlungsmodalitäten für Angebote“** verwenden wir den Auslöser **Beleg: Bei Erstellung**. Dieser löst einen **asynchronen Workflow** aus, der unmittelbar **nach dem Anlegen eines Belegs** gestartet wird.
{% endhint %}
{% endstep %}

{% step %}
Im nächsten Schritt kannst Du die **„Bezeichnung“** und **„Beschreibung“** für das **Start**-Element ggf. anpassen. Bestätige mit **»Anlegen«**.
{% endstep %}

{% step %}
Nach dem Anlegen öffnet sich die **Workflow-Konfiguration**. Hier kannst Du per **Drag-and-Drop** weitere Elemente zur Darstellung hinzufügen.

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FHoK7yeoQ5qLqNei1otpT%2Fimage.png?alt=media&amp;token=7ba47ce1-f758-4e52-9c79-48002e397591" alt="Element Abfrage hinzufügen" width="563"><figcaption></figcaption></figure>

{% hint style="info" icon="books" %}

#### Workflow-Elemente

Mit den einzelnen **Workflow-Elementen** bestimmst Du die **Schritte** innerhalb eines Workflows und legst fest, **was an jeder Stelle passieren soll**.

– Das **Start**-Element markiert den **Beginn** des Workflows.

– Ein **Abschließen**-Element signalisiert das **erfolgreiche Ende** des Ablaufs.

– Mit den Elementen **Benutzeraktion** und **Benutzerskript** definierst Du die konkrete **Abläufe.**

Im Abschnitt [**Workflow-Elemente**](https://help.vario-software.de/vario-cloud-handbuch/system/workflows/workflow-elemente.md) findest Du eine ausführliche Beschreibung aller verfügbaren Elemente und ihrer Einsatzmöglichkeiten.
{% endhint %}
{% endstep %}

{% step %}
Beim Hinzufügen eines Elements öffnet sich ein Pop-up-Fenster, in dem Du die **Einstellungen** bzw. das **Skript** für das Element festlegen kannst. Die verfügbaren Optionen variieren je nach Elementtyp. Mit einem **Doppelklick** auf ein bereits eingefügtes Element kannst Du es jederzeit **nachträglich bearbeiten**.
{% endstep %}

{% step %}
Über die **Andockpunkte** an den Elementen kannst Du diese in der gewünschte Reihenfolge miteinander verbinden und so den **Verlauf des Workflows** festlegen.

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FdXJARP6mfxVRhhcloEIF%2Fimage.png?alt=media&amp;token=9a33ee4f-91a4-4a3d-8328-c7c25f7ab198" alt="Elemente verbinden" width="563"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Durch **Gedrückthalten des Konfigurationsbereichs** kannst Du den Workflow **frei verschieben**.
{% endstep %}

{% step %}
Mit dem **Mausrad** oder der Zoom-Leiste am rechten Rad lässt sich die Ansicht **vergrößern oder verkleinern**.
{% endstep %}

{% step %}
Der Button **»Automatisch anordnen«** hilft Dir, die Elemente **automatisch** übersichtlich anzuordnen, dass der Workflow **übersichtlich** bleibt – besonders nützlich bei komplexeren Workflows.

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FEMdp1SnhMseyNtTp6Yag%2Fimage.png?alt=media&amp;token=b1dcf4f0-8492-4a99-bc47-7ebd33f24379" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Jeder Workflow benötigt ein **End-Element**. Hierfür stehen Dir die Elemente **Abschließen** und **Fehler** zur Verfügung. Weitere Informationen zu diesen findest Du im nächsten Abschnitt.

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2F5gzAGmhACkZYUFLRtCXs%2Fimage.png?alt=media&amp;token=ca0b2dd7-de25-4049-ae02-1cc9574e45bd" alt="Abschließen Element" width="563"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Klicke auf **»Speichern«**, um den Workflow als **Entwurf** zu sichern. Über **»Workflow aktivieren«** kann der Workflow anschließend **aktiviert** werden.

{% hint style="success" %}
**Glückwunsch, damit hast Du Deinen ersten Workflow erstellt!** 😀
{% endhint %}

{% hint style="danger" %}

#### Bevor Du ein Workflow aktivierst

Stelle sicher, dass der Workflow **vollständig** und **korrekt** konfiguriert ist, bevor Du ihn aktivierst. Ein aktivierter Workflow wirkt sich **unmittelbar auf die Funktionsweise** in den jeweiligen Bereichen von VARIO Cloud aus – fehlerhafte Konfigurationen können zu **unerwünschten Abläufen oder Datenänderungen** führen.
{% endhint %}
{% endstep %}

{% step %}
Über dem Button **»Workflow«** kannst Du die Bezeichnung des Workflows anpassen.

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2Fpm0EMK5TaMiIOxsL2YTy%2Fimage.png?alt=media&amp;token=9df66ca3-1d2c-478a-b620-a2560456e955" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}

#### Workflow-Trigger-IDs über den Support-Modus

Wenn der **Support-Modus** aktiviert ist, wird beim Auslösen eines Workflows eine Infobox mit den **IDs** der möglichen **Workflow-Auslöser** für den jeweiligen Datensatz angezeigt. Im gezeigten Screenshot siehst Du beispielsweise die potenziellen Auslöser **vor** und **nach** dem Speichern einer Adresse.

<img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FlhBXFctvLHGNTWTo08VM%2Fimage.png?alt=media&amp;token=09fc4883-f2a4-4531-b950-51e678c652ef" alt="Workflow-Trigger-IDs über den Support-Modus" data-size="original">
{% endhint %}
{% endstep %}
{% endstepper %}

### Elemente und Verbindungen entfernen

Öffne den Workflow über **»Bearbeiten«**. Dafür benötigst Du das Recht zum Bearbeiten von Workflows. Bei einem aktiven Workflow bearbeitest Du den zugehörigen [Entwurf](https://help.vario-software.de/vario-cloud-handbuch/system/workflows/workflows-verwalten.md#workflows-sicher-bearbeiten).

* **Verbindung entfernen:** Klicke auf die Verbindungslinie. In ihrer Mitte erscheint ein **×**. Klicke darauf, um die Verbindung zu entfernen. Die beiden Elemente bleiben erhalten und können neu verbunden werden.
* **Element entfernen:** Klicke einmal auf das Element und anschließend auf das eingeblendete **×**. Dabei werden auch seine ein- und ausgehenden Verbindungen entfernt. Die vorherigen und nachfolgenden Elemente werden nicht automatisch miteinander verbunden.

Die ausgewählten Teile werden sofort aus dem Entwurf entfernt. Ergänze die benötigten Verbindungen und schließe die Bearbeitung mit **»Speichern«** ab. Prüfe den Ablauf, bevor Du den Entwurf aktivierst.

{% hint style="info" %}

#### Fehlermeldungen aus Workflows

Um sie von allgemeinen Systemfehlern zu unterscheiden, werden **Fehler**, die durch Workflows ausgelöst werden, in **Orange** statt in **Rot** angezeigt.
{% endhint %}

### Warum bricht mein Workflow mit „Workflow Rekursion“ ab?

Löst ein Workflow – direkt oder über andere Workflows – denselben Auslöser für denselben Datensatz erneut aus, würde sich der Ablauf endlos wiederholen. VARIO Cloud bricht den Workflow dann mit der Meldung **„Workflow Rekursion: …“** ab. Die Meldung nennt die Aufrufkette der beteiligten Workflows, die Du auch in den [Protokollen und Logs](https://help.vario-software.de/vario-cloud-handbuch/system/workflows/protokolle-und-logs.md) nachvollziehen kannst.

Prüfe in diesem Fall, ob ein Skript oder Element Deines Workflows den auslösenden Datensatz erneut speichert, und passe den Ablauf an, etwa mit einer Abfrage, die das erneute Speichern verhindert.

### Gilt ein Beleg-Workflow auch für Kassenbons?

Ja. Die Auslöser im Bereich **Belege**, z. B. **Vor dem Speichern** oder **Bei Erstellung**, gelten für jede Belegart, auch für Kassenbons, Kasseneröffnungen und Kassenabschlüsse. Einen Filter auf bestimmte Belegarten bietet der Auslöser nicht.

Grenze den Workflow deshalb selbst ein: Prüfe direkt nach dem Start in einer [Abfrage](https://help.vario-software.de/vario-cloud-handbuch/system/workflows/workflow-elemente.md#abfrage) die Belegart und führe alle Belege, die der Workflow nicht betreffen soll, ohne Änderung zum Ende.

{% hint style="warning" %}

#### Kasse vor Workflow-Fehlern schützen

Läuft ein Workflow mit dem Auslöser **Vor dem Speichern** bei einem Kassenbon in einen Fehler, kehrt der Bon in die Bearbeitung zurück und wird nicht abgeschlossen. Teste neue Beleg-Workflows deshalb auch an der Kasse und deaktiviere Workflows, die Du nicht mehr brauchst.
{% endhint %}

## Mehrere Automatisierungen für denselben Auslöser

Soll derselbe Auslöser mehrere Aufgaben erledigen, steuert **ein Hauptworkflow** den gesamten Ablauf. Die einzelnen Aufgaben kannst Du in eigenen **Unter-Workflows** getrennt aufbauen und wiederverwenden.

1. **Bestehenden Hauptworkflow bearbeiten:** Öffne den bereits aktiven Workflow des gewünschten Auslösers. Beim Bearbeiten entsteht ein Entwurf; der bisherige Workflow bleibt zunächst aktiv.
2. **Teilabläufe anlegen:** Erstelle für zusätzliche Aufgaben über **»+ Workflow«** einen Workflow mit aktiviertem Toggle **»Unter-Workflow«**. Er erhält keinen eigenen Auslöser. Konfiguriere und aktiviere ihn.
3. **Teilabläufe einbinden:** Füge im Entwurf des Hauptworkflows für jeden Teilablauf ein Element **Unter-Workflow** hinzu und wähle den jeweiligen aktiven Unter-Workflow aus. Verbinde die Elemente in der benötigten Reihenfolge. Mit **Abfragen** legst Du fest, unter welchen Bedingungen ein Teilablauf ausgeführt wird.
4. **Gesamten Ablauf prüfen und aktivieren:** Prüfe sowohl die bisherigen als auch die neuen Automatisierungen. Aktiviere anschließend den Entwurf des Hauptworkflows. Er ersetzt die bisherige Version.

**Beispiel:** Beim selben Auslöser sollen Adressdaten geprüft und bei Bedarf eine Aufgabe angelegt werden. Der Hauptworkflow verbindet diese Teilabläufe:

```
Start → Unter-Workflow „Adressdaten prüfen“
      → Unter-Workflow „Aufgabe bei Bedarf anlegen“ → Abschließen
```

Prüfe für jeden Teilablauf die benötigten Bedingungen. Trifft eine Bedingung nicht zu, führe den Ablauf am betreffenden Teilablauf vorbei zum nächsten Schritt weiter.

{% hint style="warning" %}
Unter-Workflows strukturieren **einen gemeinsamen Ablauf**. Sie starten keine voneinander unabhängigen Automatisierungen neben dem Hauptworkflow. Ein unbehandelter Fehler kann den gesamten Ablauf beenden; nachfolgende Teilabläufe werden dann nicht ausgeführt. Prüfe deshalb Reihenfolge, Bedingungen und [Protokolle und Logs](https://help.vario-software.de/vario-cloud-handbuch/system/workflows/protokolle-und-logs.md).
{% endhint %}

### Warum lässt sich mein zusätzlicher Workflow nicht aktivieren?

Ist für den Auslöser bereits ein anderer Hauptworkflow aktiv, ist die abgelehnte Aktivierung **kein Bug**. Deaktiviere den bestehenden Workflow nicht allein deshalb, um eine zusätzliche Automatisierung einzurichten: Dadurch würde die bisherige Automatisierung nicht mehr durch den Auslöser gestartet. Binde den zusätzlichen Teilablauf stattdessen als Unter-Workflow ein.

Eine **Nachfolgeversion** ersetzt den bisherigen Hauptworkflow; sie ergänzt keinen zweiten aktiven Workflow. Weitere Hinweise findest Du unter [Workflows verwalten](https://help.vario-software.de/vario-cloud-handbuch/system/workflows/workflows-verwalten.md#zusatzliche-automatisierung-oder-nachfolgeversion).

## Unter-Workflows

**Unter-Workflows** dienen dazu, eine **Gruppe von Workflow-Schritten** zu speichern, die in **verschiedene Workflows eingebunden** werden können.

Sie sind besonders hilfreich für:

* **wiederverwendbare Teilabläufe**, z. B. Standardaktionen,
* die **Strukturierung komplexer Workflows**, um diese übersichtlicher und wartbarer zu gestalten.

Unter-Workflows sind **nicht eigenständig lauffähig** und haben aus dem Grund **keinen eigenen Auslöser**. Auch wenn sie als aktiv markiert sind, haben sie **keinen** direkten Einfluss auf Prozesse in VARIO Cloud, solange sie nicht in einen **übergeordneten Workflow integriert** wurden.

### Unter-Workflows anlegen

Unter-Workflows kannst Du wie jeden anderen Workflow über den Button **»+ Workflow«** in der Übersicht erstellen.\
Durch das **Aktivieren** des Toggles **»Unter-Workflow«** legst Du fest, dass es sich nicht um einen eigenständigen Workflow, sondern um einen Unter-Workflow handelt.

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FzDiOthyec2oNtHvFSrmF%2Fimage.png?alt=media&amp;token=0ca148b5-4a4a-41eb-9060-9f45f2699a75" alt="Unter-Workflow anlegen" width="563"><figcaption></figcaption></figure>

Nach dem Anlegen kann der Unter-Workflow wie gewohnt **bearbeitet und konfiguriert** werden. Auch hier gilt:

* Ein **Start**-Element und mindestens ein **End-Element** (z. B. **Abschließen** oder **Fehler**) sind erforderlich.
* Der Unter-Workflow hat keinen eigenen synchronen oder asynchronen Ausführungsmodus; maßgeblich ist der Auslöser des Hauptworkflows. In einem **synchronen Hauptworkflow** dürfen auch die eingebundenen Unter-Workflows keine wartenden Elemente **Benutzeraktion**, **Timeout** oder **Warten (indirekt)** enthalten. Ein Unter-Workflow ohne solche Elemente kann auch in einem asynchronen Hauptworkflow verwendet werden.

### Unter-Workflow integrieren

Bevor ein Unter-Workflow in andere Workflows integriert werden kann, muss er zunächst **aktiviert** werden.

Innerhalb eines bestehenden Workflows kannst Du den Unter-Workflow anschließend über das Element **Unter-Workflow** einfügen. Dort wählst Du den gewünschten **Unter-Workflow** aus.

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2F7tg0jYcBawmRmzHa2BR2%2Fimage.png?alt=media&amp;token=36cf986e-6caf-44ea-8ad2-ec36978068f4" alt="Unter-Workflow integrieren" width="563"><figcaption></figcaption></figure>

{% hint style="info" %}

#### Sub-Workflows exportieren und importieren

Beim **Exportieren** **eines Workflows** werden **enthaltene Unter-Workflows** mit ihrem jeweiligen **Namen** gespeichert.

Beim **Import** **eines Workflows** gilt Folgendes:

* **Nicht vorhandene** Unter-Workflows werden anhand des Namens automatisch **neu angelegt**.
* **Bereits vorhandene** Unter-Workflow werden **übersprungen**.
  {% endhint %}


---

# 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://help.vario-software.de/vario-cloud-handbuch/system/workflows/workflows-erstellen.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.
