Tutorial: Workflow erstellen
Mit dbxWorkflow_admin definieren Administratoren nachvollziehbare Abläufe. dbxWorkflow führt diese Definitionen anschließend Schritt für Schritt aus. Dieses Tutorial zeigt, wie aus einem fachlichen Ziel eine prüfbare Workflow-Definition entsteht.
Von der Idee zur Definition
Ziel klären
Was soll am Ende fachlich erreicht sein?
Schritte modellieren
Eingaben, Aktionen, Prüfungen und Entscheidungen ordnen.
Fachmodule binden
Auswahl, Vorbelegung und Finish-Logik verbinden.
Validieren
Speichern, neu starten und jeden Zweig testen.
1. Fachliches Ziel aufschreiben
Beginnen Sie nicht mit Feldern, sondern mit einem klaren Ergebnis. Ein Workflow ist gut zugeschnitten, wenn Benutzer verstehen, was nach dem Abschluss erreicht ist und welche Nachweise dafür vorliegen müssen.
„Ein bestehender Shop-Artikel ist mit geprüften Channel-Daten veröffentlicht und besitzt eine externe Angebots-ID.“
Daraus lassen sich Auswahl, Bereitschaftsprüfung, Datenpflege, bewusster Export und Statuskontrolle ableiten.
2. Neue Definition anlegen
Öffnen Sie Workflow → Definitionen und wählen Sie Neuer Workflow. Füllen Sie die Kopfdaten zuerst vollständig aus.
| Feld | Bedeutung | Beispiel |
|---|---|---|
| Workflow Key | Stabiler technischer Schlüssel, später nicht leichtfertig ändern | shop_ebay_publish |
| Name | Verständlicher Titel für Benutzer | Artikel bei eBay veröffentlichen |
| Ziel | Fachlich erreichtes Endergebnis | eBay-Angebot ist veröffentlicht |
| Beschreibung | Grenzen und Nutzen des Ablaufs | Prüft Daten, bestätigt Export und kontrolliert Rückmeldung |
| Aktiv | Nur aktive Definitionen können neu gestartet werden | Erst nach erfolgreichem Test aktivieren |
3. Bausteine auswählen
Der visuelle Designer bietet vier Bausteintypen:
| Baustein | Geeignet für | Beispiel |
|---|---|---|
| Eingabe | Wert oder Datensatz erfassen/auswählen | Artikel auswählen |
| Aktion | Bewusste fachliche Tätigkeit oder externen Vorgang | Export durchführen |
| Prüfung | Vollständigkeit oder Status kontrollieren | Channel-Bereitschaft prüfen |
| Entscheidung | Ergebnis erzeugen, das den weiteren Zweig bestimmt | Freigabe erteilt? |
Klicken Sie einen Baustein an oder ziehen Sie ihn in den Ablauf. Ändern Sie die Reihenfolge am Griff. Nach jeder Änderung werden Verbindungslinien und Schrittpositionen neu berechnet.
4. Jeden Schritt eindeutig beschreiben
Öffnen Sie die Details des Bausteins und pflegen Sie mindestens Bezeichnung, internen Schlüssel, Ergebnis und Bearbeitungsweg.
- Bezeichnung: beschreibt die aktuelle Aufgabe als Handlung.
- Interner Schlüssel: innerhalb des Workflows eindeutig, z. B.
approval_result. - Ergebnis / Status danach: verständlicher Zwischenstand.
- Bearbeitung: Formular, Auswahl, Neuanlage oder Modulformular.
- Werte: ein Wert oder mehrere Werte.
- Pflicht: notwendig oder optional.
- Hinweis: konkrete Arbeitsanweisung ohne technische Interna.
5. Auswahlen und Entscheidungen definieren
Optionen werden zeilenweise erfasst. Mit wert=Beschriftung trennen Sie gespeicherten Wert und sichtbaren Text:
approved=Freigegeben
changes=Änderung notwendig
rejected=Abgelehnt
Eine Entscheidung benötigt mindestens zwei Ergebnisse. Verwenden Sie in späteren Abhängigkeiten den gespeicherten Wert, nicht die sichtbare Beschriftung.
6. Verzweigungen aufbauen
Ein abhängiger Schritt verweist immer auf einen vorherigen Schritt und optional auf dessen Ergebnis.
Freigabe prüfen├─
approved → Auftrag ausführen└─
changes → Rückfrage bearbeiten- Entscheidung vor den Zweigschritten platzieren.
- Bei „Voraussetzung / Linie von“ den Schlüssel der Entscheidung wählen.
- Bei „Nur bei Ergebnis“ den erwarteten gespeicherten Wert eintragen.
- Für jeden erlaubten Entscheidungswert mindestens einen nachvollziehbaren Weg prüfen.
7. Automatische Prüfungen bewusst einsetzen
Für Prüfungen kann Automatisch prüfen, sonst manuell gewählt werden. Automatisiert werden nur sichere Beobachtungen, für die das Fachmodul zuverlässig einen Wert liefern kann.
- Geeignet: Pflichtdaten vollständig, Mapping vorhanden, gespeicherter Status, interne Regel.
- Nicht unsichtbar automatisieren: Zahlung, Versand, Veröffentlichung, Mailversand oder andere schwer rückgängig zu machende Aktionen.
- Wenn kein sicherer Wert ermittelt wird, muss der Schritt verständlich manuell bearbeitbar bleiben.
8. Bearbeitungsweg festlegen
| Weg | Verwendung |
|---|---|
| Formular | Kurzen Wert oder Bestätigung direkt im Workflow erfassen. |
| Auswahl | Statische Optionen oder über Binding geladene Datensätze wählen. |
| Neuanlage | Einfache Neuanlage innerhalb des Schritts anbieten. |
| Modulformular | Vorhandene Fachoberfläche öffnen und Speicherung anschließend bestätigen. |
9. Modul-Binding ergänzen
Ein Binding verbindet die allgemeine Workflow-Engine mit einer Fach-DD. Öffnen Sie Modul-Bindings und wählen Sie Neues Binding. Der Generator kann DD-Felder und vorhandene Summary-Templates eines Moduls auslesen.
- Modul auswählen, z. B.
dbxContactoderdbxShop. - Passende Datadic/DD wählen und Binding generieren.
- Bind-Key eindeutig und fachlich benennen.
- Auswahlquelle, Vorbelegung und erlaubte Modul-Links prüfen.
- Finish-Logik nur auf den vorgesehenen Datensatz begrenzen.
- Binding speichern und im Workflow-Schritt über die Bind-Referenz auswählen.
10. Validieren und speichern
Der Designer prüft den Ablauf bereits beim Bearbeiten; beim Speichern folgt die verbindliche serverseitige Validierung. Typische Prüfungen:
- mindestens ein aktiver Schritt
- Bezeichnung und eindeutiger Schlüssel je Schritt
- mindestens zwei Ergebnisse für Entscheidungen
- Abhängigkeiten existieren und zeigen nur auf frühere Schritte
- Ziel und Abschlussbezeichnung sind verständlich
Speichern Sie erst, wenn keine Validierungsfehler mehr angezeigt werden. Kehren Sie anschließend zur Liste zurück und starten Sie den Workflow über die Start-Aktion.
11. Änderungen richtig testen
- Definition speichern.
- Neue Instanz starten – nicht eine alte Instanz weiterverwenden.
- Pflicht-, Optional- und Fehlerwege testen.
- Jeden Entscheidungszweig separat durchlaufen.
- Automatik bei vorhandenem und fehlendem Fachwert prüfen.
- Finish mit gültigen und ungültigen Fachdaten testen.
Abschlusscheck für Definitionen
- Workflow-Key stabil, eindeutig und fachlich benannt
- Name, Ziel und Beschreibung für Benutzer verständlich
- Schritte in sinnvoller Reihenfolge mit eindeutigen Keys
- Entscheidungswerte und Abhängigkeiten vollständig
- Externe Aktionen bleiben sichtbar und bewusst bestätigt
- Bindings, Modul-Links und Finish-Logik geprüft
- Alle Zweige mit jeweils neuer Instanz getestet
- Definition erst nach erfolgreichem Test aktiviert