Kostenlos testen
Handbuch

Rezept: Monatlicher Prozess mit Freigaben und Erinnerungen

Ein Ablauf, der jeden Monat von selbst startet, eine Person um Freigabe bittet, freundlich erinnert, erst nach dem Klick handelt und das Ergebnis mit den offenen Fällen zurückmeldet.

Manche Arbeit soll automatisch laufen, aber nicht ohne einen Menschen: Gutschriften buchen, nachdem jemand die Liste geprüft hat. Offene Posten durchgehen, bevor der Monat abgeschlossen wird. Dieses Rezept zeigt, wie TaskMonkey so einen Ablauf führt: Er fragt die richtige Person, erinnert, wartet auf die Freigabe und meldet danach, was passiert ist und was noch zu tun bleibt.

Ziel

  • Jeden Monat startet der Ablauf von selbst, zum Beispiel am 1. um 8 Uhr.
  • Eine bestimmte Person (oder jedes Admin-/Manager-Mitglied) bekommt eine Mail mit Link auf die Liste und einem Freigabe-Button.
  • Ohne Reaktion: tägliche Erinnerung, ab der Frist mit Kopie an eine zweite Person, danach ein letzter Hinweis.
  • Nichts passiert ohne Freigabe. Nach dem Klick handelt TaskMonkey genau einmal, frühestens ab einem festen Tag.
  • Danach eine Ergebnis-Mail mit Zahlen und den Fällen, die jemand ansehen muss, verständlich formuliert („Betrag in Spalte F fehlt“).
  • Sind Fälle offen: ein zweiter Button „Korrigiert – nachbuchen“. Beliebig oft wiederholbar.

So sieht der Ablauf aus

01. 08:00   Karte im Chat der Prüfenden: „Bitte bis 04. freigeben“ (Buttons Freigeben/Ablehnen);
            Mail nur, wenn die Karte nach 2 Arbeitsstunden ungelesen ist
02.–03.     Erinnerung je Tag um 08:00
04. 10:00   Frist: Erinnerung mit Kopie an die Geschäftsführung, weiter täglich bis 10.
11.         letzter Hinweis an die Geschäftsführung, keine Erinnerungen mehr
Freigabe    frühestens ab 04. 08:00: Buchung in Paketen, bis nichts mehr offen ist
danach      Ergebnis im Chat (Vorgangs-Block); bei offenen Fällen neue Karte „Korrigiert – nachbuchen“
Nachbuchen  wieder Buchung nur für diesen Monat, wieder Ergebnis im Chat
ungelesen   nach 1 Arbeitstag Zusammenfassung „Ungelesen bei TaskMonkey“ per Mail (höchstens 1×/Tag)
Ablehnung   Hinweis, der Monat ruht

Bausteine

Baustein Was er tut
Prozess-Beschreibung processes.<name> Schritte, Adressat, Texte, Fristen, Erinnerungsplan, Testmodus – lesbar in einer Config-Datei des Workspaces
Tool runProcess führt die Beschreibung aus; jeder Aufruf macht die nächsten Schritte bis zum ersten Warten
Geplante Aufgabe ruft runProcess alle 15 Minuten auf; ohne offenen Schritt kostet das nichts
Freigaben (/manage/approvals) dort klickt die Person „Freigeben“ oder „Ablehnen“; die erste Entscheidung gilt, wer entschieden hat, steht dabei
Hauptchat jede Anfrage erscheint als Karte mit denselben Buttons, jeder Schritt als Zeile im Vorgangs-Block („Freigegeben von Iskra“, „Paket 1 – 20 gebucht“, Ergebnis). Die Karte zeigt den Stand live
Benachrichtigungen (Profil → Benachrichtigungen, /users/notifications) Mail nur als Fallback: ungelesene Karte nach 2 (mit Frist) bzw. 4 Arbeitsstunden, ungelesene Meldungen nach 1 Arbeitstag als Zusammenfassung. Je Person abschaltbar; fristgebundene Freigaben an eine einzelne Person kommen immer

Die Schritte eines Prozesses sind von drei Arten:

Art Bedeutung
tool ein Werkzeug aufrufen, z. B. eine Liste bauen oder buchen. Mit repeat in Paketen über mehrere Läufe
approval Freigabe-Anfrage als Karte im Chat, mit Erinnerungen, Frist und frühestem Start; nach der Freigabe genau einmal weiter (oder mit loop_to zurück, z. B. zum Nachbuchen)
mail Bescheid geben, z. B. das Ergebnis: steht im Chat der Empfänger, per Mail nur an Empfänger ohne TaskMonkey-Konto bzw. als Fallback

Jeder Schritt kann eine Bedingung when haben, etwa „nur wenn es Prüffälle gibt“.

Beispiel (gekürzt)

'processes' => [
    'reklamationen' => [
        'label' => 'Reklamationen buchen',
        'start' => ['day' => 1, 'at' => '08:00'],
        'audience' => ['user' => 'pruefung@example.de'],
        'escalate_to' => ['chef@example.de'],
        'steps' => [
            ['id' => 'freigabe', 'type' => 'approval',
             'title' => 'Reklamationen {period_label} buchen',
             'deadline' => ['day' => 4, 'at' => '10:00'],
             'remind' => ['every' => '1 day', 'at' => '08:00', 'until' => ['day' => 10, 'at' => '23:59']],
             'not_before' => ['day' => 4, 'at' => '08:00']],
            ['id' => 'buchen', 'type' => 'tool', 'tool' => 'processOpenReklamationen',
             'args' => ['tabs' => ['{period_label}'], 'dryRun' => false],
             'repeat' => ['until' => ['processed', '==', 0], 'collect' => ['bookings', 'results']]],
            ['id' => 'auswertung', 'type' => 'tool', 'tool' => 'summarizeReklamationRun', 'args' => ['run' => '{steps.buchen}']],
            ['id' => 'nachbuchen', 'type' => 'approval', 'when' => ['steps.auswertung.review_count', '>', 0],
             'title' => 'Korrigierte Fälle nachbuchen', 'text' => ['{steps.auswertung.lines}'], 'loop_to' => 'buchen'],
        ],
    ],
],

Zeitangaben: ['day' => 4, 'at' => '10:00'] ist der 4. des Monats nach dem Zeitraum (Oktober-Reklamationen: 04.11.). '+6 minutes' zählt ab der Anfrage. 'end_of_month' ist das Monatsende.

Ausprobieren im Testmodus

Jeder Prozess kann einen Abschnitt test haben: fester Monat, Frist und Erinnerungen in Minuten statt Tagen, und für heikle Schritte eigene Argumente (zum Beispiel nur Vorschau statt Buchen). Gestartet wird per Kommandozeile:

bin/cake test_tool -t <workspace> --tool runProcess --args '{"process":"<name>","test":true}'

Test-Mails tragen [Test] im Betreff. Ein beendeter Testlauf startet mit "restart":true neu.

Sicherheit

  • Gebucht oder versendet wird nur nach einer Freigabe in TaskMonkey (mit Anmeldung). Jede Freigabe wird genau einmal umgesetzt, auch wenn zwei Läufe gleichzeitig kommen.
  • Ist die Anfrage an eine Person adressiert, kann nur diese Person entscheiden. Empfänger müssen aktive Admins oder Manager des Workspaces sein.
  • Welche Prozesse Freigaben anfragen dürfen, legt der Workspace fest (approvals.tools). Der Prozess läuft nur als geplante Aufgabe oder per Kommandozeile, nie aus einem Chat oder einer Kunden-Nachricht.
  • Prozess-Texte stehen in der Config, nicht im Code. Kommentare aus Listen landen nicht in Mails.

Grenzen

  • Erinnerungen und Frist-Eskalation führt TaskMonkey zentral aus, wenn der Prozess 'reminders' => 'central' hat (Reklamationen, OPOS): an Arbeitstagen ohne Feiertage, am Fristtag erst zur Frist, Mail nur an Personen, die die Karte im Chat nicht gelesen haben. Ohne den Eintrag erinnert der Prozess wie bisher selbst. Entscheiden geht über die Buttons der Karte, die Seite oder /manage/approvals – nicht per Chat-Nachricht.
  • Wer alle Mails sofort will wie früher: Workspace-Config approvals.mail = 'immediate'.
  • Klicklisten (TaskMonkey-Seiten) legt ein Prozess heute nur im Testmodus per Kommandozeile an; gelesen werden ihre Antworten auch im geplanten Lauf.

Verwandt: Freigaben & Rückfragen, Kreditkarten-Abrechnung als DATEV-Stapel (Versand nur nach Freigabe), Fehlende Belege.

Zuletzt aktualisiert: 2026-11-04