# Läufe und Aufgaben

> **Zielgruppe & Rolle**
>
> **Rolle**: Alle, die Flows betreuen oder Aufgaben aus Flows bekommen | **Voraussetzung**: „Flows ansehen“ bzw.
> „Flows erstellen“ für Läufe; „Aufgaben aus Flows bearbeiten“ für Aufgaben

# Läufe und Aufgaben

## Läufe

Jeder Start eines Flows ist ein **Lauf**. Unter **Automatisierung › Läufe** stehen alle Läufe, die Sie sehen dürfen,
die neuesten zuerst – mit Flow, Auslöser, wer gestartet hat, Start, Ende, Anzahl der Schritte und Fehler. Filtern Sie
nach Status (**Alle Status**) oder Flow (**Alle Flows**); die Läufe eines einzelnen Flows zeigt auch sein Bereich
**Läufe**.

| Status | Bedeutung |
|---|---|
| **Wartet auf Start** | Der Lauf ist angelegt und beginnt gleich. |
| **Läuft** | Ein Schritt wird ausgeführt. |
| **Wartet** | Der Lauf wartet – auf eine Aufgabe, eine Dauer oder einen Unter-Flow. |
| **Erfolgreich** | Der Lauf ist durch. |
| **Fehlgeschlagen** | Ein Schritt ist fehlgeschlagen, und kein Fehlerausgang hat ihn aufgefangen. |
| **Abgebrochen** | Jemand hat den Lauf abgebrochen, oder sein Zeitlimit ist abgelaufen. |

**Wer Läufe sieht:** Die Läufe eines persönlichen Flows sieht nur seine Besitzerin oder sein Besitzer – auch die
Administration nicht, denn sie enthalten, was diese Person lesen darf. Die Läufe von Mandanten-Flows sehen alle mit
„Flows ansehen“. Abgeschlossene Läufe werden nach 90 Tagen gelöscht.

### Einen Lauf ansehen

Ein Klick öffnet den Lauf mit dem **Diagramm** der gelaufenen Version und dem **Verlauf**: Jeder Schritt mit Status,
dem Ausgang, über den es weiterging („weiter über …“), seiner **Eingabe** und **Ausgabe**, Fehlversuchen und
**Fehlerdetails**. Schritte auf Zweigen, die nicht genommen wurden, stehen als **Übersprungen** da. Dazu kommen die
**Auslöserdaten**, die **Variablen**, das **Ergebnis** und das **YAML der gelaufenen Version**. Solange der Lauf läuft,
aktualisiert sich die Ansicht selbst.

Bei einem fehlgeschlagenen Lauf nennt die Kopfzeile den Knoten („Fehlgeschlagen bei …“). Häufige Ursachen: eine
fehlende Berechtigung, ein Ausdruck, der auf ein leeres Feld zugreift, oder ein Modul, das die Anfrage ablehnt. Der
Assistent erklärt Ihnen einen Lauf auf Wunsch („Warum ist der letzte Lauf von … fehlgeschlagen?“).

### Lauf abbrechen

**Abbrechen** beendet einen laufenden oder wartenden Lauf: Wartende Schritte werden abgebrochen; ein Schritt, der gerade
ein Modul aufruft, beendet seinen Aufruf, danach folgt nichts mehr. Offene Aufgaben des Laufs werden zurückgezogen,
Unter-Flows mit abgebrochen. Abbrechen darf, wer den Flow ändern darf.

### Grenzen eines Laufs

Ein Lauf hat höchstens 1000 Schritte und endet spätestens nach seinem Zeitlimit (Standard 30 Tage). Ein einzelner
Schritt hat ein Zeitlimit von 30 Sekunden (einstellbar bis 4 Minuten; KI-Schritte 2 Minuten).

## Aufgaben aus Flows

Mit dem Baustein **Aufgabe für Menschen** bittet ein Flow Personen um eine Entscheidung oder um Angaben:

- **Freigabe** – die Person entscheidet mit **Freigeben** oder **Ablehnen**, optional mit **Kommentar** und weiteren
  Feldern.
- **Formular** – die Person füllt Felder aus (Text, langer Text, Zahl, Ja/Nein, Auswahl, Datum) und **sendet** ab.

Der Lauf wartet, bis die Aufgabe beantwortet ist, und geht dann über **freigegeben**, **abgelehnt** bzw. **ausgefüllt**
weiter; die Antworten stehen den folgenden Schritten zur Verfügung (z. B. `nodes.freigabe.output.values.kostenstelle`).

### Aufgaben finden und beantworten

Die Zuständigen bekommen eine E-Mail mit Link. Ihre Aufgaben finden Sie

- unter **Automatisierung › Aufgaben aus Flows**, in den Reitern **Offen** und **Erledigt** (mit den Pfeiltasten
  blättern), und
- im **Eingang**, solange sie offen sind – dort beantworten Sie sie direkt. Aufgaben aus Flows lassen sich im Eingang
  nicht ausblenden; sie verschwinden, sobald sie beantwortet sind.

Eine Aufgabe zeigt Titel, Text, Flow, **Frist** und **Zuständig**. Pflichtfelder, die noch fehlen, nennt sie unter
„Noch auszufüllen“. Ist eine Aufgabe einer Gruppe zugewiesen, genügt die Antwort einer Person. Wer den Lauf sehen darf,
aber nicht zuständig ist, sieht die Aufgabe nur lesend.

> [!NOTE]
> Aufgaben beantworten immer Menschen im Portal – weder ein Flow noch der Assistent kann das. Ist am Knoten **Wer
> gestartet hat, darf nicht antworten** gesetzt, kann die Person, die den Lauf gestartet hat, die Aufgabe nicht selbst
> freigeben (Vier-Augen-Prinzip).

### Frist und Eskalation

- **Frist nach** – z. B. `3d`. Läuft die Frist ab, geht der Lauf **Bei Fristablauf** entweder über den Ausgang **Frist
  abgelaufen** weiter (etwa zu einer Erinnerungsmail) oder schlägt fehl. Die Aufgabe steht dann auf **Frist
  abgelaufen**.
- **Eskalation** – Stufen vor der Frist, z. B. nach einem Tag weitere Personen benachrichtigen (`notify`) oder die
  Aufgabe anderen übergeben (`reassign`). Auch sie werden per E-Mail informiert.

```yaml
freigabe:
  kind: human_task
  type: approval
  title: "Freigabe: {{ trigger.data.titel }}"
  assignTo: ["group:<Gruppen-ID>"]
  deadline: { after: 3d, action: timeout }
  escalation:
    - { after: 1d, notify: ["person:leitung@example.com"] }
  excludeStarter: true
```

Siehe auch: [Flows bauen](/knowledge/docs/products/portal/user-docs/automatisierung/flows-bauen.md), [Übersicht](/knowledge/docs/products/portal/user-docs/automatisierung.md).
