Für den Testbetrieb kann die Email E-Mail Umleitung aktiviert werden. Dabei werden alle ausgehenden Emails E-Mails auf eine festgelegte Adresse umgeleitet.

In der Email E-Mail steht zusätzlich, an wen diese eigentlich gegangen wäre.

Für den EmailE-Mail-Versand gibt es zwei verschiedene Möglichkeiten:

Sofort versenden

Die Email E-Mail wird sofort versendet. Ist der Versand von einem Benutzer angestoßen (z.B. durch einen Statuswechsel, der einen EmailE-Mail-Versand auslöst), so muss er warten, bis dieser Vorgang abgeschlossen ist, bevor er weiter arbeiten kann. Kommt es beim EmailE-Mail-Versand zu einem Fehler, so wird die gesamte Aktion (z.B. Statuswechsel) des Benutzers rückgängig gemacht.

Versand über Email Queue

Die Email E-Mail wird erst im EmailE-Mail-Protokoll als nicht versendete Email E-Mail gespeichert und erst durch einen regelmäßig laufenden Job versendet (Administration > Jobsteuerung > Versende Emails). Dieser muss natürlich aktiviert sein. Der Benutzer wird dadurch bei seiner Bearbeitung nicht unnötig lange aufgehalten und ein fehlerhafter EmailE-Mail-Versand führt nicht zum Abbruch seiner Aktion.

Der Job EMailEmpfang erzeugt für neue E-Mails auf dem in den IMAP-Systemparametern angegebenen Server einen Eintrag im E-Mail-Protokoll mit den Flags Versendet = false, Empfangen = true, Verarbeitet = false.
Das Flag Verarbeitet kann nach der erfolgreichen Weiterverarbeitung der Mail auf true gesetzt werden.

static void sendMail(EMailContext context)

static void sendMailNow(EMailContext context)

void addRecipient(String address, int type)

void addRecipient(String address)

void addRecipients(List<String> lRecipients, int type) 

void addRecipients(List<String> lRecipients)

void addAttachment(NuclosFile file) 

void addAttachments(List<NuclosFile> lAttachments)

void setReplyTo(String replyTo)

void setMessage(String message)

void setSubject(String subject)

void setReference(String reference)

void resetAttachments()

void resetRecipients()

EMailContext context = new EMailContext();
context.addRecipient(auftrag.getKundeBO.getEmailadresse());
context.addRecipient("chef@firma.de", EMailContext.BCC);
context.addAttachment(auftrag.getRechnung());
context.setSubject("Rechnung für Auftrag " + auftrag.getAuftragsnr());
context.setMessage("...");
context.setReplyTo("kundenservice@firma.de");
context.setReference(auftrag.getKundeBO().getKundennr());
EMailVersand.sendMail(context);

Query<EMailProtokoll> query = QueryProvider.create(EMailProtokoll.class);
query.where(EMailProtokoll.Empfangen.eq(Boolean.TRUE));
query.where(EMailProtokoll.Empfangeneemailverarbeitet.eq(Boolean.FALSE));
for (EMailProtokoll email : QueryProvider.execute(query)) {
    process(email, context);
    email.setEmpfangeneemailverarbeitet(Boolean.TRUE);
    email.save();
}