E-Mail

datasqill sends e-mail through Jakarta Mail. The same recipient syntax and SMTP settings apply to:

SMTP

Jakarta Mail reads the usual mail.smtp.* Java system properties (mail.smtp.host, mail.smtp.port, mail.smtp.auth, timeouts). The datasqill server process must be able to reach an SMTP relay that the receiving domains accept. Direct delivery without a relay often fails reverse-DNS checks at large providers.

Recipients

A recipient list is a comma-separated string. Addresses without a prefix are TO, so a plain address such as info@datasqill.de keeps working. Optional prefixes TO:, CC: and BCC: may stand in front of a single address (case-insensitive, optional space after the colon). A prefix applies only to that address, not to the following ones.

Example 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

Each CC or BCC address needs its own prefix. Commas inside double quotes belong to the address ("Smith, John" <john@x.com>). Empty tokens from a trailing comma are skipped.

At least one TO address is required. An empty list, the object-dialog default -, or a list with only CC/BCC is rejected. Unknown prefixes such as BC: or Kopie: are rejected; they are not treated as part of the address.

The Send E-Mail module parses the list after ${column} and Freemarker substitution. Batch notifications join the mailing-list addresses for an event and parse that combined string with the same rules.

Errors

If sending fails, datasqill reports a mail error code. The message text may append the rejected recipient token or the SMTP server response.

Code Meaning
6101 Unknown recipient prefix in the address list (for example BC: instead of BCC:)
6102 Recipient list has no TO address
6103 A TO:, CC: or BCC: prefix has no address
6104 Email messaging failed (Jakarta Mail / SMTP; the message includes the server text)
6105 Send mail operation failed (any other error while preparing or sending)