NGO.Tools Hilfe

Für Administratoren

Prozesse

Ein Prozess ist ein einzelner Durchlauf eines Workflows. Du siehst die laufenden und abgeschlossenen Prozesse eines Workflows. Du öffnest ihre Details mit Diagramm, Aufgaben-Verlauf und Variablen und wechselst von dort in den Workflow. Das hilft dir, wenn du wissen willst, wo ein Durchlauf gerade steht oder wie er gelaufen ist. Neue Prozesse kannst du außerdem über die API mit Startvariablen starten.

Aktualisiert am 27.09.2026

Prozesse eines Workflows anzeigen

  1. Öffne im Menü die Seite Workflows.#

    Die Liste zeigt alle Workflows mit ihrem Namen.

  2. Klicke in der Zeile des Workflows auf das Listen-Symbol Prozesse.#

    Die Zahl am Symbol zeigt, wie viele Prozesse des Workflows gerade laufen. Läuft keiner, erscheint keine Zahl. Du kannst den Workflow auch über das Stift-Symbol Bearbeiten im Editor öffnen und dort oben auf Prozesse klicken. Auch dort steht die Zahl der laufenden Prozesse daneben.

  3. Wähle oben einen der Reiter Alle, Laufend oder Abgeschlossen.#

    Am Reiter „Laufend“ steht die Zahl der laufenden Prozesse.

  4. Sortiere oder filtere die Tabelle bei Bedarf.#

    Du kannst nach „Kontakt“, „Gestartet“ und „Abgeschlossen“ sortieren. Mit dem durchsuchbaren Filter „Kontakt“ zeigst du nur die Prozesse eines bestimmten Kontakts an.

  5. Klicke in der Zeile eines Prozesses auf das Augen-Symbol Anschauen, um seine Details zu öffnen.#

    Der Titel der Detailseite setzt sich aus dem Namen des Workflows und der Nummer des Prozesses zusammen, getrennt durch „#“.

Laufende Prozesse im Editor einblenden

  1. Öffne den Workflow im Editor. Klicke dazu in der Übersicht Workflows auf das Stift-Symbol Bearbeiten.#
  2. Klicke oben auf Laufende Prozesse.#

    Das Diagramm zeigt nun an jeder Aktivität, wie viele laufende Prozesse dort gerade eine offene Aufgabe haben.

  3. Klicke erneut auf Laufende Prozesse, um die Zahlen wieder auszublenden.#

Workflow aus einem Prozess öffnen

  1. Öffne die Detailseite des Prozesses über Workflows→Prozesse→Anschauen.#
  2. Klicke oben auf Workflow öffnen.#

    Die Schaltfläche trägt ein Symbol mit einem Pfeil nach außen. Der zugehörige Workflow öffnet sich im Editor.

Prozess über die API starten

  1. Ermittle die ID des Workflows, den du starten möchtest.#

    Die ID steht in der Adresse der Workflow-Seiten, zum Beispiel im Editor vor „/modeler“.

  2. Sende eine POST-Anfrage an/api/v2/process-definitions/{ID}/start.#

    Setze statt {ID} die ID des Workflows ein. Sie muss angegeben werden.

  3. Übergib bei Bedarf Startvariablen im Feld variables.#

    Die Startvariablen sind Schlüssel-Wert-Paare und legen den Anfangszustand des Prozesses fest, zum Beispiel{"variables": {"contactId": 42}}. Das Feld ist optional. Ohne das Feld startet der Prozess ohne Startvariablen.

  4. Prüfe die Antwort.#

    Die Antwort enthält den neu gestarteten Prozess. Er läuft sofort und erscheint auf der Seite „Prozesse“ des Workflows im Reiter „Laufend“.

Übersicht „Prozesse“

Diese Seite öffnest du über das Symbol „Prozesse“ in der Übersicht „Workflows“ oder über die Schaltfläche „Prozesse“ im Editor. Sie zeigt alle Prozesse eines Workflows. Die zuletzt gestarteten Prozesse stehen oben. Neue Prozesse kannst du hier nicht anlegen.

  • Reiter: „Alle“, „Laufend“ mit der Zahl der laufenden Prozesse und „Abgeschlossen“.
  • Status: der Zustand des Prozesses als farbige Kennzeichnung.
  • Aktuelle Aktivität: die Aktivitäten, an denen der Prozess gerade offene Aufgaben hat, durch Komma getrennt.
  • Kontakt: der Kontakt, dem der Prozess zugeordnet ist.
  • Auslöser: wodurch der Prozess gestartet wurde.
  • Gestartet und Abgeschlossen: Datum und Uhrzeit von Start und Ende des Prozesses.
  • Fehlt ein Wert, steht in der Zelle „—“. Nach „Kontakt“, „Gestartet“ und „Abgeschlossen“ kannst du sortieren. Mit dem Filter „Kontakt“ grenzt du die Liste ein.
  • Über das Augen-Symbol „Anschauen“ öffnest du die Detailseite eines Prozesses. Der Name des Workflows in der Pfadnavigation führt in den Editor.

Detailseite eines Prozesses

Die Detailseite öffnest du auf der Seite „Prozesse“ über das Augen-Symbol „Anschauen“. Oben findest du die Schaltfläche „Workflow öffnen“. Die Seite ist in folgende Bereiche gegliedert:

  • Details: „Status“, „Kontakt“ (nur wenn ein Kontakt zugeordnet ist), „Auslöser“, „Gestartet“ und „Abgeschlossen“. Fehlt ein Zeitpunkt, steht dort „—“.
  • Diagramm: der Workflow mit dem Weg dieses Prozesses. Abgeschlossene Aktivitäten sind grün markiert („Abgeschlossene Aktivität“), aktuelle blau („Aktuelle Aktivität“). Kennzeichnungen wie „erreicht“, „abgeschlossen“ und „Offen“ zeigen den Stand. Mit dem Kästchen „Verlauf im Diagramm anzeigen“ blendest du die Markierungen ein oder aus. Es ist anfangs aktiviert.
  • Aufgaben-Verlauf: alle Aufgaben des Prozesses in der Reihenfolge ihrer Entstehung. Spalten: „Aktivität“, „Status“ („Offen“ oder „Abgeschlossen“), „Erreicht“, „Gestartet“ und „Abgeschlossen“. Ohne Aufgaben steht dort „Noch keine Aufgaben ausgeführt.“
  • Hinweise: erscheint nur, wenn zu diesem Prozess Warnungen vorliegen.
  • Variablen: anfangs zugeklappt. Zeigt die Werte des Prozesses alphabetisch nach Namen. Ja/Nein-Werte erscheinen als „ja“ oder „nein“, leere Werte als „—“. Ohne Werte steht dort „Keine Variablen gesetzt.“

Häufige Fragen

Warum steht in der Workflow-Liste keine Zahl am Symbol „Prozesse“?

Die Zahl zeigt nur laufende Prozesse. Läuft gerade kein Prozess des Workflows, erscheint keine Zahl. Abgeschlossene Prozesse findest du auf der Seite „Prozesse“ in den Reitern „Abgeschlossen“ und „Alle“.

Warum passt das Diagramm nicht genau zum Ablauf eines Prozesses?

Manchmal zeigt das Diagramm den aktuellen Stand des Workflows statt des Stands zur Laufzeit des Prozesses. Stammt der Verlauf nur aus den Aufgaben, fehlen außerdem Ereignisse und Verzweigungen. In beiden Fällen weist dich ein Hinweis über dem Diagramm darauf hin.

Was bedeutet „Gelöschte Variable #…“ bei den Variablen?

Die Variable wurde inzwischen aus dem Workflow gelöscht. Der Wert, den der Prozess hatte, bleibt trotzdem sichtbar. Statt des Namens steht die Nummer der gelöschten Variable da.

Was passiert mit den Prozessen, wenn ich einen Workflow lösche?

Mit dem Workflow werden auch alle seine Prozesse samt Verlauf und Aufgaben unwiderruflich gelöscht. Vorher zeigt dir die Bestätigung, wie viele Prozesse betroffen sind.