Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- server:ansteuerungen:mail [2021/07/09 16:43] – Dokumentation zum bedingten Versand ergänzt Benjamin Raabe
+++ server:ansteuerungen:mail [2021/09/22 12:32] (aktuell) – Dominik Dylla
@@ Zeile 3: / Zeile 3: @@
-Mit dieser Schnittstelle kann der EDP-Server E-Mails mit Einsatzinformationen an beliebige E-Mail-Adressen senden.
+Mit dieser Schnittstelle kann der EDP-Server E-Mails mit Einsatzinformationen an beliebige E-Mail-Adressen senden. Mit der Schnittstelle ist es nicht möglich, E-Mails zu empfangen, auszuwerten und zur Erstellung eines Einsatzes zu nutzen. Nutzen Sie für diese Funktion bitte den [[einsatzserver:e-mail| Einsatzserver]].
+^ Funktion ^ Daten senden ^ Daten empfangen |
+| E-Mails| ✔| ✘ |
+✔ = Die Schnittstelle unterstützt diese Funktion. ✘ = die Schnittstelle unterstützt diese Funktion nicht. (Leer) = Entfällt.
 Die Konfiguration der Ansteuerung geschieht mit dem Programm EDPServerKonfig.exe unter dem Punkt Ansteuerungen. Nach dem Klicken auf den Bearbeiten-Knopf erscheint folgendes Fenster, in dem alle Einstellungen der Ansteuerung vorgenommen werden:
@@ Zeile 77: / Zeile 81: @@
 Ab der EDP-Version 4.9 kann in der Aufgabe eine Bedingung für den Mailversand hinterlegt werden. \\
-Die Bedingung wird in Form einer SQL-Abfrage hinterlegt, die Mail wird nur dann versendet, wenn die Hinterlegte SQL-Abfrage ein Ergebnis zurückgibt (>0 Ergebniszeilen).
+Die Bedingung wird in Form einer SQL-Abfrage hinterlegt, die Mail wird nur dann versendet, wenn die Hinterlegte SQL-Abfrage ein Ergebnis zurückgibt (>0 Ergebniszeilen). Dabei kann der Platzhalter <%EINSATZNUMMER%> in die SQL-Abfrage integriert werden.
 Die bedingte Abfrage betrifft nur die Aufgaben, die in der Form "mail@adresse|SQL-ABFRAGE" hinterlegt sind; Wird keine Abfrage gefunden, wird die Aufgabe normal ausgeführt.
@@ Zeile 83: / Zeile 87: @@
  \\
-Um den bedingten Mailversand zu aktivieren muss in der .ini-Datei der Ansteuerung folgender Text hinterlegt werden.
+Um den bedingten Mailversand zu aktivieren, muss in der Konfig-Datei der Schnittstelle der folgende Text hinterlegt werden. Klicken Sie dazu bitte in der EDP-Konfiguration mit Rechts auf die Schnittstelle, wählen im Menü "Definition" und klicken dann im sich öffnenden Dialog auf den Button "Konfig-Datei anzeigen":
-  [Advanced]
+<code>
-  ConditionalMailSend=1
+[Advanced]
-Diese Einstellung hat kein Feld in der Konfigurations-Maske.
+ConditionalMailSend=1
+</code>
+Diese Einstellung ist in der normalen Konfigmaske nicht vorhanden und kann nur wie oben beschrieben manuell in der Grundkonfiguration ergänzt werden.
  \\
-Eine beispielhaft konfigurierte Aufgabe sähe z.B. so aus:
+Nachfolgend wird ein Beispiel für das Feld "Wert" einer Aufgabe genannt. Dort ist die SQL-Abfrage so gestaltet, dass der Mailversand nur dann erfolgt, wenn die Einsatzart ungleich "T" (z.B. Test) ist:
-  email@adresse.de|SELECT * FROM OPTIONEN
+<code>
+email@adresse.de|SELECT EINSATZNUMMER FROM EINSAETZE WHERE EINSATZART<>'T' AND EINSATZNUMMER='<%EINSATZNUMMER%>'
+</code>
+Bitte beachten Sie, dass das Auslösen der Aufgabe trotzdem in EDP dokumentiert wird und nur im Logfile erkenntlich ist, ob auf Grund der Bedingung der Versand unterdrückt wurde.