EDP-Server: Ansteuerung Mailserver

Mit dieser Schnittstelle sendet der EDP-Server E-Mails mit Einsatzinformationen an beliebige E-Mail-Adressen. Diese Seite beschreibt die Einstellungen der Ansteuerung, die Parameter in Aufgaben, den bedingten Mailversand und die Anmeldung per OAuth2.

Mit der Schnittstelle können Sie keine E-Mails empfangen, auswerten und zur Erstellung eines Einsatzes nutzen. Verwenden Sie für diese Funktion den Einsatzserver.

✔ = Die Schnittstelle unterstützt diese Funktion. ✘ = Die Schnittstelle unterstützt diese Funktion nicht. (Leer) = Entfällt.

Die Ansteuerung konfigurieren Sie mit dem Programm EDPServerKonfig.exe unter dem Punkt „Ansteuerungen“. Nach einem Klick auf den Button „Bearbeiten“ erscheint das folgende Fenster, in dem Sie alle Einstellungen der Ansteuerung vornehmen:

DNS-Name oder IP-Adresse und Port (Standard: 25) des SMTP-Servers.

Benutzername und Passwort für die Anmeldung am SMTP-Server.

Absender der E-Mail (E-Mail-Adresse).

Hinweis: Die meisten E-Mail-Provider erwarten hier die Angabe der E-Mail-Adresse. Tragen Sie diese deshalb unbedingt in diesem Feld ein, sonst erscheint in der Regel eine Fehlermeldung.

Antwortadresse, an die Antworten auf die E-Mail gesendet werden. Wird die Absenderadresse nicht auf eingehende E-Mails überprüft, tragen Sie hier ein, an welche alternative Adresse die Antworten gehen sollen.

Gibt an, an welche E-Mail-Adresse die Nachricht als Kopie (CC) bzw. als Blindkopie (BCC) gesendet wird.

Betreff der E-Mail. Sie können die in den Reports definierten Platzhalter verwenden. Über den Button „Datenfeld hinzufügen“ fügen Sie die gängigsten Platzhalter automatisch ein.

Inhalt der E-Mail. Sie können die in den Reports definierten Platzhalter verwenden. Über den Button „Datenfeld hinzufügen“ fügen Sie die gängigsten Platzhalter automatisch ein.

Hier legen Sie fest, welche Reports an die E-Mail angehängt werden. Geben Sie dazu den Namen des Reports ein. Es können maximal zwei Reports als Anhang versendet werden.

Wenn Sie die Ansteuerung in einem Alarmvorschlag verwenden, müssen Sie der Aufgabe je nach Schnittstelle unter Umständen spezifische Parameter zuweisen. Siehe dazu auch die Dokumentation des EDP4-Einsatzleitplatzes.

Bei dieser Ansteuerung tragen Sie die E-Mail-Adresse des Empfängers als spezifischen Parameter ein.

Hinweis: Die folgenden Ausführungen gelten erst ab EDP 2024.01.03.

Zusätzlich können Sie weitere Parameter in der Aufgabe hinterlegen, um mit einer Schnittstelle verschiedene Szenarien abzudecken. Diese Parameter geben Sie in einer bestimmten Syntax an, die URL-Parametern ähnelt. Ein Beispiel:

&empfänger=info@einsatzleitsoftware.de&anhang1=DEPESCHE.pdf&betreff=Testmail zu Einsatz <%EINSATZNUMMER%>&fdsdatei=0

Alle Parameter, die Sie in der Aufgabe nicht angeben, werden aus der Grundkonfiguration der Schnittstelle übernommen. Folgende Parameter können Sie im Wert der Aufgabe übergeben:

• empfänger
• absender
• replyto
• copycc
• copybcc
• betreff
• inhalt
• fdsdatei
• anhang1
• anhang2

<note important> Diese Option ist nur für erfahrene Benutzer empfohlen.</note>

Ab der EDP-Version 4.9 können Sie in der Aufgabe eine Bedingung für den Mailversand hinterlegen. Die Bedingung ist eine SQL-Abfrage. Die Mail wird nur versendet, wenn die hinterlegte SQL-Abfrage ein Ergebnis zurückgibt (mehr als 0 Ergebniszeilen). In der SQL-Abfrage können Sie den Platzhalter <%EINSATZNUMMER%> verwenden.

Die Bedingung betrifft nur Aufgaben, die in der Form mail@adresse|SQL-ABFRAGE hinterlegt sind. Wird keine Abfrage gefunden, wird die Aufgabe normal ausgeführt.

Um den bedingten Mailversand zu aktivieren, hinterlegen Sie in der Konfig-Datei der Schnittstelle den folgenden Text. Klicken Sie dazu in der EDP-Konfiguration mit der rechten Maustaste auf die Schnittstelle, wählen Sie im Menü „Definition“ und klicken Sie im folgenden Dialog auf den Button „Konfig-Datei anzeigen“:

[Advanced]
ConditionalMailSend=1

Diese Einstellung ist in der normalen Konfigurationsmaske nicht vorhanden. Sie kann nur wie beschrieben manuell in der Grundkonfiguration ergänzt werden.

Das folgende Beispiel für das Feld „Wert“ einer Aufgabe enthält eine SQL-Abfrage, mit der die Mail nur versendet wird, wenn die Einsatzart ungleich „T“ (z.B. Test) ist:

email@adresse.de|SELECT EINSATZNUMMER FROM EINSAETZE WHERE EINSATZART<>'T' AND EINSATZNUMMER='<%EINSATZNUMMER%>'

Beachten Sie, dass das Auslösen der Aufgabe trotzdem in EDP dokumentiert wird. Ob der Versand wegen der Bedingung unterdrückt wurde, ist nur im Logfile erkennbar.

Ab der Version 2024.01.03 kann die Authentifizierung auch per OAuth2 erfolgen. Das ist unter anderem für Nutzer von Microsoft 365 vorgesehen.

Die Authentifizierung und die erste Abfrage eines Tokens starten Sie über die Schnittstellen-Konfiguration:

1. Aktivieren Sie OAuth2.
2. Führen Sie über den Button „Token anfordern“ die eigentliche Authentifizierung durch. Die benötigten Tokens werden dabei im Server-Ordner als .txt-Datei abgelegt.
3. Geben Sie die Verbindungsdaten für den eigentlichen SMTP-Server an. Die Standarddaten für Microsoft 365 können Sie per Knopfdruck einsetzen.
4. Hinterlegen Sie den im Browser angegebenen Account als Benutzernamen.