Journal-E-Mails einrichten und betreiben

Journal-E-Mails bündeln Änderungen eines konkreten Einsatzes und versenden eine Zusammenfassung an die dafür vorgesehenen, aktuell zugeteilten AdF.

Unterschied zur Zuteilungs-Mail#

Einsatzzuteilung	Journal-Mail
Wird nach Zuteilung einer Person versucht	Wird nach Änderungen am Einsatzjournal in die Warteschlange gestellt
Empfänger ist die neu zugeteilte Person	Empfänger sind die aktuell diesem Einsatz zugeteilten AdF mit aktivierter Gruppenoption
Versand direkt nach der Buchung	Versand frühestens zwei Minuten nach der letzten Änderung, wenn der Cronjob läuft
Enthält Einsatzinfos und bis zu zehn Journal-Karten	Enthält den gesamten verfügbaren Journal- und Änderungsverlauf

Schritt 1 – Dienstgradgruppe freischalten#

Öffne Stammdaten → Dienstgrade → Dienstgradgruppen.
Bearbeite die gewünschte Dienstgradgruppe.
Aktiviere E-Mail Journal.
Klicke Gruppe speichern.

Die Einstellung E-Mail bei Einsatzzuteilung ist davon unabhängig.

Schritt 2 – Empfänger vorbereiten#

Der Empfänger muss:

ein aktiver AdF sein;
eine gültige E-Mail-Adresse im AdF-Profil besitzen;
über seinen Dienstgrad einer Gruppe mit E-Mail Journal angehören;
beim tatsächlichen Versand aktiv demselben Einsatz zugeteilt sein.

Nur bei der gleichen Schadenlage erfasst zu sein, reicht nicht. Bereits abgerückte AdF sind ebenfalls nicht mehr Teil dieser aktiven Empfängerauswahl.

Schritt 3 – Cronjob einrichten#

Die Verarbeitung erfolgt im serverseitigen Skript bin/send_journal_mail.php. Der Cronjob sollte einmal pro Minute laufen.

Ein Beispielaufruf lautet:

php /ABSOLUTER/PFAD/ZUR/LAGORIS-INSTALLATION/bin/send_journal_mail.php

Ersetze den Platzhalter durch den tatsächlichen absoluten Installationspfad bei Infomaniak. Das Skript ist für CLI vorgesehen und kein öffentlich aufrufbarer URL-Endpunkt.

Eine Statusabfrage kann ohne Versandversuch erfolgen:

php /ABSOLUTER/PFAD/ZUR/LAGORIS-INSTALLATION/bin/send_journal_mail.php --status

Der optionale Aufruf mit --verbose gibt die Anzahl verarbeiteter Aufträge aus.

Schritt 4 – Test im Einsatz durchführen#

Eine Testschadenlage und einen Testeinsatz öffnen.
Einen geeigneten Test-AdF dem Einsatz zuweisen.
Einen Journaleintrag speichern.
Falls gewünscht nach rund einer Minute einen weiteren Journaleintrag speichern.
Prüfen, ob die Warteschlange fällig wird.
Den nächsten Cronlauf abwarten und das Postfach prüfen.

Wie funktioniert das Zwei-Minuten-Fenster?#

Bei jeder neuen relevanten Journaländerung wird der Fälligkeitszeitpunkt dieses Einsatzes auf zwei Minuten nach der letzten Änderung verschoben.

Aktion	Geplanter frühester Zeitpunkt
Änderung 14:00	etwa 14:02
weitere Änderung 14:01	neu etwa 14:03
keine weiteren Änderungen	nächster passender Cronlauf ab 14:03

Das sind Fälligkeitszeiten, keine garantierten Zustellzeiten. Mailserver und Verarbeitung können zusätzliche Zeit benötigen.

Inhalt der Nachricht#

Die Nachricht enthält Einsatzangaben und einen Link zur Anwendung. Ausgegeben werden Journal- und Änderungsprotokolle des betreffenden Einsatzes in umgekehrter zeitlicher Reihenfolge: die neuesten oben.

Sie ist damit keine reine Benachrichtigung über den zuletzt erfassten Satz, sondern eine gesammelte Verlaufsmeldung.

Fehlersuche#

Problem	Kontrolle
Queue bleibt stehen	Cronjob vorhanden, Skriptpfad korrekt, CLI-PHP erreichbar?
Keine Empfänger	AdF aktiv? Richtiger Einsatz? Dienstgradgruppe freigeschaltet?
Nachricht kommt später	Neues Zwei-Minuten-Fenster oder späterer Cronlauf
E-Mail wird mehrfach versucht	Verarbeitung kennt Wiederholungen bei Fehlern; SMTP-/Cron-Logs prüfen
Test-Mail funktioniert, Journal-Mail nicht	Dienstgradgruppen, Zuordnungen und Cron unterscheiden sich vom SMTP-Test

Eine gesicherte E-Mail-Alarmierung wird dadurch nicht ersetzt. Prüfe die Versandfunktion vor operativer Nutzung.

Weiterlesen: E-Mail-Übersicht · SMTP.