Dokumentation › Produkte › ConnectWORKFLOW › ConnectWORKFLOW - Technische Referenz › Aufgabeaktionen
Zuletzt geändert am 22.10.2026
Auf dieser Seite
Dieses Kapitel beschreibt die operativen Aktionen innerhalb einer Aufgabe: die Übernahme durch einen Bearbeiter (Claiming), das Abgeben einer Aufgabe (Unclaiming), das Stellen von Rückfragen, die reguläre Bearbeitung sowie die Rückmeldung an den trade-Vorgang.
Besitzen und Übernahme
Um zu verhindern, dass mehrere Benutzer gleichzeitig widersprüchliche Änderungen an derselben Aufgabe vornehmen, nutzt das System einen Mechanismus namens Claiming. Dieser stellt sicher, dass eine Aufgabe immer nur von einer Person zur Zeit bearbeitet werden kann.
Exklusive Sperrung für Gruppen
Wenn eine Aufgabe einer Gruppe zugewiesen ist, können zunächst alle Mitglieder dieser Gruppe die Aufgabe sehen. Sobald jedoch ein Mitglied die Bearbeitung startet, wird dieses als Besitzer (claimedBy) eingetragen.
Die Folge für das Team:
- Die Aufgabe ist für alle anderen Mitglieder der Gruppe sichtbar aber nicht bearbeitbar.
- Dieser Zustand bleibt bestehen, bis der Aufgabenschritt entweder abgeschlossen, aktiv zurückgegeben oder von einem anderen Gruppenmitglied via „Force Pull“ übernommen wird.
graph LR
Frei[Gruppe: Frei für alle] -->|Claim User A| Claimed[User A: Gesperrt für Rest]
Claimed -->|User A fertig| Abschluss[Nächster Schritt]
Claimed -->|User A gibt ab| Frei
Dauer des Besitzes
Um sicherzustellen, dass Aufgaben nicht unbeabsichtigt blockiert bleiben (z. B. wenn ein Bearbeiter vergisst, eine Aufgabe vor dem Urlaub freizugeben), verfügt das System über eine automatische Aufhebung der Übernahme.
- Frist: 24 Stunden.
- Ablauf: Wenn eine Aufgabe länger als 24 Stunden geclaimt bleibt, ohne abgeschlossen oder manuell zurückgegeben zu werden, hebt der Hintergrunddienst (
SYSTEM) die Übernahme automatisch auf. - Auswirkung: Die Aufgabe wird in den Gruppen-Pool zurückgelegt und steht allen Gruppenmitgliedern wieder zur Verfügung.
- Dokumentation: Die Aktion wird in der Historie als
Aufgaben-Übernahme Zeitüberschreitungdurch den BenutzerSYSTEMvermerkt.
Aufgabe abgeben
Falls ein Bearbeiter eine Aufgabe übernommen hat, diese aber doch nicht bearbeiten kann (z. B. wegen fehlender Informationen, Arbeitszeitende, Urlaub oder Krankheit), kann er die Aufgabe aktiv wieder abgeben. Durch die Aktion Aufgabe abgeben (Unclaiming) wird die exklusive Sperre aufgehoben und die Aufgabe wieder in den „Pool“ der Gruppe zurückgelegt.
Der Unclaim-Prozess
Technisch passieren dabei folgende Schritte:
- Das Feld
claimedBywird geleert. - Der Zeitstempel
claimedAtwird entfernt. - In der Historie wird der Eintrag
UNCLAIMEDmit dem Namen des Bearbeiters vermerkt.
Nach der Abgabe steht die Aufgabe sofort wieder allen Mitgliedern der ursprünglich zugewiesenen Gruppe zur Verfügung.
Force Pull zurück in die Gruppe
Falls eine Aufgabe von einem anderen Benutzer geclaimed wurde und aber diese dringend bearbeitet werden muss (z. B. weil der Kollege nicht verfügbar ist), kann die Aktion Force Pull zurück in die Gruppe verwendet werden.
- Auswirkung: Der aktuelle Claim wird forciert aufgehoben und die Aufgabe in den Pool der Gruppe zurückgelegt.
- Berechtigung: Diese Aktion kann nur von Mitgliedern der Gruppe durchgeführt werden, der die Aufgabe zugewiesen ist.
- Dokumentation: Die Aktion wird in der Historie als
FORCE_PULLEDvermerkt, inklusive des Namens des Benutzers, der den Pull durchgeführt hat.
Sobald die Aufgabe wieder im Pool liegt, kann jedes andere Gruppenmitglied sie wie gewohnt claimen.
Rückfragen
In vielen Workflows ist es notwendig, Informationen von Personen oder Gruppen einzuholen, die nicht direkt am aktuellen Prozessschritt beteiligt sind. Hierfür steht die Funktion der Rückfrage zur Verfügung.
Fachlicher Zweck
Rückfragen dienen primär dazu, fehlende Informationen oder Klärungen einzuholen, die zwingend benötigt werden, um eine Workflowinstanz im aktuellen Schritt final freigeben oder ablehnen zu können.
Der Rückfrage-Prozess
Eine Rückfrage kann gestellt werden, wenn der aktuelle Workflow-Schritt dies explizit im Blueprint erlaubt (allowInquiry = true). Diese Einstellung muss für jeden einzelnen Schritt individuell hinterlegt werden, in dem die Funktion zur Verfügung stehen soll.
Dabei wird die Aufgabe temporär an eine Zielperson (inquiry_to) delegiert.
Auswahl der Zielpersonen
Angeboten werden alle aktiven Mitarbeiter des Mandanten aus HR – unabhängig davon, ob sie einer in den Blueprints genannten Gruppe angehören:
- Eine Person pro E-Mail-Adresse: Mitarbeiter ohne E-Mail-Adresse werden nicht angeboten, doppelte Adressen nur einmal.
- Anzeige: Im Auswahldialog des Portals werden die Personen mit Namen und E-Mail-Adresse dargestellt, nach Namen sortiert und durchsuchbar.
- Obergrenze: HR liefert höchstens 1000 Personen; bei größeren Mandanten werden die ersten 1000 nach Namen angeboten.
Benachrichtigungen bei Rückfragen
Wird eine Rückfrage gestellt oder beantwortet, löst das System automatisch Benachrichtigungen aus:
- Per E-Mail: Die Zielperson erhält eine E-Mail mit der Belegnummer, dem Text der Rückfrage und einem direkten Link zur Aufgabe. Die Empfängeradresse ist die E-Mail-Adresse der gewählten Person aus HR.
- Per Microsoft Teams (Webhook): Sofern im Blueprint eine
inquiryWebhookUrlkonfiguriert ist, wird ein Webhook aufgerufen, der z. B. über einen Power-Automate-Flow eine direkte Chat-Nachricht an den Empfänger sendet (unter Verwendung der E-Mail-Adresse als Empfängerkennung/UPN).Details zur Einrichtung finden Sie im Kapitel Notifikationen & Webhooks.
Verhalten während einer Rückfrage
Sobald eine Rückfrage gestellt wurde, wird der ursprüngliche Bearbeitungskontext gesperrt. Das bedeutet, dass die ursprüngliche Gruppe oder der ursprüngliche Bearbeiter keine regulären Aktionen mehr ausführen kann, bis die Rückfrage geklärt ist.
Dokumentation und Sichtbarkeit
Ein entscheidender Punkt ist die Art der Datenspeicherung:
- Keine Synchronisation: Die Informationen, die innerhalb einer Rückfrageschleife ausgetauscht werden (Fragen und Antworten), werden nicht an den trade-Vorgang zurückgeschrieben.
- Historie und Protokoll: Der gesamte Austausch wird ausschließlich in der internen Workflow-Historie (Verlauf/Protokoll) festgehalten.
- Langfristige Sichtbarkeit: Diese Einträge bleiben dauerhaft gespeichert. Sie sind für alle Mitglieder der beteiligten Bearbeitergruppen in allen nachfolgenden Schritten des Workflows sichtbar. Dies stellt sicher, dass spätere Entscheider den vollen Kontext der Klärung nachvollziehen können.
Das System speichert hierbei wichtige Metadaten:
- Zeitpunkt: Wann wurde die Rückfrage gestellt (
inquiry_at)? - Absender: Welcher Benutzer und welche Gruppe haben die Frage initiiert?
- Inhalt: Die konkrete Fragestellung (
inquiry_text).
Auflösung von Rückfragen
Es gibt drei Wege, wie eine Rückfrage beendet werden kann:
- Beantwortung: Der Empfänger gibt eine Antwort ein. Die Metadaten werden bereinigt und die Aufgabe kehrt zum Absender zurück.
- Rückholung (Force Pull): Der Absender oder ein Mitglied der Ursprungsgruppe kann die Rückfrage aktiv zurückziehen, falls sich die Klärung erübrigt hat.
- Automatischer Timeout: Um Blockaden zu vermeiden, verfügt das System über einen Hintergrundprozess, der Rückfragen nach 24 Stunden automatisch auflöst. In diesem Fall wird die Historie entsprechend markiert.
graph TD
Start[Aufgabe in Bearbeitung] --> Inquiry[Rückfrage stellen]
Inquiry --> Locked[Sender-Kontext gesperrt]
Locked --> Answer[Empfänger antwortet]
Locked --> Pull[Sender holt Rückfrage zurück]
Locked --> Timeout[Automatischer Timeout 24h]
Answer --> Active[Aufgabe wieder aktiv beim Sender]
Pull --> Active
Timeout --> Active
Aufgabenbearbeitung und regulärer Abschluss
Der Kern der täglichen Arbeit ist die reguläre Bearbeitung einer Aufgabe. Hierbei wählt der Benutzer eine definierte Aktion (action), die den weiteren Weg der Workflowinstanz bestimmt.
Jeder Abschluss eines Schrittes wird lückenlos in der Historie dokumentiert. Dabei werden nicht nur der gewählte Folgeschritt, sondern auch alle eingegebenen Kommentare und getroffenen Entscheidungen revisionssicher gespeichert. Führt ein Schritt zu keinem weiteren Folgeschritt, wechselt die Instanz in einen der Endzustände wie APPROVED (Genehmigt), REJECTED (Abgelehnt) oder COMPLETED (Abgeschlossen).
Administrative Workflow-Beendigung (Cancellation)
Neben dem regulären Abschluss durch Prozessschritte bietet das System eine administrative Notfallfunktion zur vorzeitigen Beendigung laufender Vorgänge (CancelTask).
Anwendungsbereich & Abgrenzung
Diese Funktion ist für betriebliche Ausnahmesituationen reserviert – beispielsweise wenn:
- ein Workflow einer gelöschten, umbenannten oder aktuell unbesetzten HR-Gruppe zugewiesen ist und kein regulärer Bearbeiter existiert,
- ein Konfigurationskonflikt im Blueprint vorliegt,
- ein Vorgang in trade dringend für die manuelle Bearbeitung freigegeben werden muss.
Vorgang wieder freigeben
Wird ein Workflow administrativ beendet, setzt der Orchestrator den Zustand CANCELLED und schreibt ihn an den trade-Vorgang (metadata.workflow, siehe trade-Integration). Damit endet die Sperre: Der Vorgang und seine Positionen sind in trade sofort wieder uneingeschränkt änderbar. Die angegebene Begründung wird als Notiz am Vorgang gespeichert. Ist trade gerade nicht erreichbar, wird der Abbruch im Zustand RETRYING_SYNC nachgeliefert; ein noch nicht gestarteter Workflow wird durch den Abbruch nicht mehr gestartet.
Zustandsübergang & Auditierung
- Die Workflow-Instanz wechselt in den Zustand
CANCELLED. EndTimewird mit dem aktuellen Zeitstempel belegt.CurrentStep,ClaimedByundClaimedAtwerden vollständig bereinigt.- Ein revisionssicherer Eintrag wird an die Historie angehängt:
json
{ "stepName": "<aktueller Schrittname>", "action": "CANCELLED", "actor": "<E-Mail des Administrators>", "comment": "<Begründung>", "timestamp": "<ISO-8601 Zeitstempel>" }
Status erneut an trade senden (Resync)
Bleibt ein trade-Vorgang gesperrt, obwohl sein Workflow beendet ist (z. B. weil das Rückschreiben des Endzustands verloren ging), können Mandanten-Administratoren (workflow:admin) den Status der Instanz erneut an trade senden: POST /api/workflow/v1/tasks/:instanceId/resync.
- Gesendet wird der wirksame Zustand der Instanz: ein noch ausstehender Zielzustand (
RETRYING_SYNC) oder der gespeicherte Zustand, also auch der Endzustand eines beendeten Workflows. Die Notiz entspricht der des regulären Rückschreibens (Kommentare bzw. Abbruchbegründung). - Die Aktion nimmt die Sperre der Instanz, ist mandantenbezogen (eine Instanz eines anderen Mandanten ergibt
404) und wird in der Historie alsWorkflow status resent to trademit dem Administrator vermerkt. - Ist trade weiterhin nicht erreichbar, bleibt die Instanz in
RETRYING_SYNCund wird wie gewohnt automatisch erneut versucht. - Abgelehnt (
409) werden Instanzen, die nie gelaufen sind (TRIGGER_NOT_MATCHED,TECHNICALLY_FAILED, ausstehender Start), Instanzen ohne trade-Vorgang sowie beendete Instanzen, während für denselben Vorgang ein anderer Workflow läuft – dessen Sperre würde sonst aufgehoben.
Notizen und Kommentare
Kommentare der Bearbeiter bleiben in der Workflow-Historie. Beim Abschluss wird zusätzlich eine Zusammenfassung an den trade-Vorgang übergeben.
Start
Der Start durch das Polling bringt keinen Hinweistext mit. Wird ein Workflow manuell über den Start-Aufruf (POST /trigger, Berechtigung settings:write) ausgelöst, kann ein initialer Kommentar (initialNote) mitgegeben werden; er erscheint als erster Eintrag in der Workflow-Historie.
Abschluss: Rückmeldung der Ergebnisse
Nachdem ein Workflow abgeschlossen wurde, steht im Feld note von metadata.workflow des Vorgangs eine Zusammenfassung der Kommentare:
- Inhalt: Alle während des Workflows erfassten Kommentare. Interne Rückfrageschleifen werden zur Wahrung der Übersichtlichkeit ausgelassen. Der Text wird auf 1000 Zeichen gekürzt.
- Format: Jede Aktion steht in einer eigenen Zeile nach dem Schema
Datum Uhrzeit, Name des Arbeitsschritts, Name des Bearbeiters: Kommentar.
Sperre des Vorgangs
Der Vorgang in trade ist nur gesperrt, solange der Workflow aktiv ist (
OPENoderRETRYING_SYNC). Mit Freigabe, Ablehnung, Abschluss oder Abbruch wird er wieder freigegeben; auch nach einer Ablehnung oder nach erfassten Kommentaren bleibt keine dauerhafte Sperre bestehen. Jeder Zustandswechsel wird zuerst zusammen mit dem ausstehenden trade-Status gespeichert und erst dann an trade gesendet; bricht der Dienst dazwischen ab, liefert die Wiederholung (RETRYING_SYNC) den Status nach – auch für Mandanten, deren Workflow-Konfiguration inzwischen deaktiviert ist. Das Wiederherstellen einer früheren Version schreibt deren Zustand ebenfalls an trade.
Berechtigungsmodell im Überblick
Das Berechtigungssystem steuert dynamisch, wer zu welchem Zeitpunkt Lese- oder Schreibrechte hat:
- Normalzustand: Die Aufgabe ist für den zugewiesenen Benutzer oder die Mitglieder der zugewiesenen Gruppe sichtbar und bearbeitbar.
- Rückfrage: Die Schreibrechte liegen primär bei der Person, an die die Rückfrage gerichtet wurde (
inquiry_to). - Administration/Eskalation: Mitglieder der Ursprungsgruppe können „Force Pull“ nutzen, um entweder aktive Rückfragen zurückzuholen oder geclaimte Aufgaben forciert in den Gruppen-Pool zurückzugeben.
- Mandanten-Administration (
workflow:admin): Benutzer mit der RolleTENANT_ADMINkönnen mandantenweit alle Workflow-Instanzen unabhängig von Gruppenzuweisungen einsehen sowie blockierte Vorgänge administrativ abbrechen oder ihren Status erneut an trade senden (Resync). Diese Rechte sind Portal-Administratoren ohne Tenant-Admin-Rolle strikt verwehrt.
Hat das geholfen?
https://app.mbcom.cloud/knowledge/docs/products/workflow/technical/task-actions