E-Mail

datasqill versendet E-Mails über Jakarta Mail. Dieselbe Empfängersyntax und dieselben SMTP-Einstellungen gelten für:

SMTP

Jakarta Mail liest die üblichen Java-Systemproperties mail.smtp.* (mail.smtp.host, mail.smtp.port, mail.smtp.auth, Timeouts). Der datasqill-Serverprozess muss einen SMTP-Relay erreichen, den die Empfängerdomänen akzeptieren. Direktversand ohne Relay scheitert bei großen Anbietern oft an Reverse-DNS-Prüfungen.

Empfänger

Eine Empfängerliste ist eine kommaseparierte Zeichenkette. Adressen ohne Präfix sind TO. Eine einfache Adresse wie info@datasqill.de funktioniert daher unverändert. Optionale Präfixe TO:, CC: und BCC: dürfen vor einer einzelnen Adresse stehen (Groß-/Kleinschreibung egal, Leerzeichen nach dem Doppelpunkt optional). Ein Präfix gilt nur für diese eine Adresse, nicht für die folgenden.

Beispiel TO CC BCC
a@x.com, CC: b@x.com, BCC: c@x.com a@x.com b@x.com c@x.com
CC: a@x.com, b@x.com b@x.com a@x.com
TO: a@x.com, CC:b@x.com a@x.com b@x.com

Jede CC- oder BCC-Adresse braucht ein eigenes Präfix. Kommas innerhalb von doppelten Anführungszeichen gehören zur Adresse ("Smith, John" <john@x.com>). Leere Einträge durch ein abschließendes Komma werden übersprungen.

Mindestens eine TO-Adresse ist erforderlich. Eine leere Liste, der Dialog-Default - oder eine Liste nur aus CC/BCC wird abgelehnt. Unbekannte Präfixe wie BC: oder Kopie: werden nicht als Teil der Adresse gelesen, sondern abgelehnt.

Das Modul Send E-Mail wertet die Liste erst nach der Ersetzung von ${Spalte} und Freemarker aus. Batch-Benachrichtigungen fügen die Adressen der Mailingliste eines Ereignisses zusammen und werten diese Zeichenkette mit denselben Regeln aus.

Fehler

Schlägt der Versand fehl, meldet datasqill einen Mail-Fehlercode. Der Meldungstext kann den abgelehnten Empfänger-Token oder die SMTP-Antwort des Servers anhängen.

Code Bedeutung
6101 Unbekanntes Empfängerpräfix in der Adressliste (zum Beispiel BC: statt BCC:)
6102 Empfängerliste ohne TO-Adresse
6103 Ein Präfix TO:, CC: oder BCC: ohne Adresse
6104 E-Mail-Versand fehlgeschlagen (Jakarta Mail / SMTP; die Meldung enthält den Servertext)
6105 Send-Mail-Operation fehlgeschlagen (jeder andere Fehler beim Vorbereiten oder Versenden)