inchorus Mail Plugin Dokumentation
1 Einführung #
Das Mail-Plugin bietet Ihnen die wesentlichsten Funktionen zum Versenden von E-Mails aus Ihren inchorus Gadgets.
Folgende Funktionalitäten stehen zur Verfügung:
Versenden von Text- und HTML-E-Mails
Anhängen von einzelnen Attachments
Anhängen von ganzen Attachment-Ordnern
Anfügen von einzelnen Content-Dateien, auf die in der HTML-Mail zugegriffen werden kann
Anfügen von ganzen Content-Ordnern, auf die in der HTML-Mail zugegriffen werden kann
Versenden von E-Mails in unterschiedlichen Sprachen
E-Mail senden mit SMTP-Authentisierung
2 Wie wird das Plugin verwendet? #
Plugin einbinden
Öffnen Sie die Datei pom.xml Ihres inchorus Gadget Projektes und ergänzen Sie folgende Zeilen im Abschnitt "dependencies":
<dependency>
<groupId>de.guh.plugin</groupId>
<artifactId>inchorus-mail-plugin</artifactId>
<version>2.0.1</version>
</dependency>
Initialisieren einer (simplen) Mail-Engine
MailEngine mailengine = new MailEngine(
mailhost,
mailport,
mailresourepath
);
Folgende Parameter werden mindestens benötigt:
mailhost – Benötigt die IP-Adresse oder DNS Namen zu Ihrem SMTP Mailhost.
mailport – Benötigt den Mailport. Standardmäßig ist der Wert auf 25 gesetzt.
mailresourepath – An dieser Stelle wird der Verzeichnis-Pfad für die E-Mail Styles benötigt. Es muss der komplette Pfad angegeben werden. Dieser ist davon abhängig, wo Ihr Projekt liegt.
Weitere Initialisierungsvarianten entnehmen Sie bitte den Beispielen.
Definieren einer E-Mail
XML xmlData = new XML("data");
Mail simpleMail = new Mail(
"sender@domain.com", // from
"empfaenger@domain.com", // to
"", // cc
"", // bcc
"simplemail_subject.xsl", //subjectstylefile
"simplemail_body.xsl", // bodystylefile
"de", // language
xmlData
);
Versenden der Mail
Boolean success = mailengine.sendMail(simpleMail);
3 Weitere Informationen #
Nähere Informationen zu den Klassen und Methoden finden sie in der API Dokumentation.
Beispiele finden Sie im Ordner Beispiele.
Bei Fragen und Anregungen nutzen Sie unser inchorus Forum.
Dieses Dokument erhalten sie hier auch als PDF.
4 Ihr Kontakt #
G+H Systems GmbH
Professionell, effizient und zuverlässig.
Ludwigstraße 8
63067 Offenbach am Main
Deutschland
Telefon: +49 (0) 69 85 00 02 - 0
Fax: +49 (0) 69 85 00 02 - 51
Email: info@guh-systems.de
Web: www.guh-systems.de
5 Rechtliche Hinweise #
Die G+H Systems leistet keinerlei Gewähr bezüglich des Inhaltes oder Gebrauchs dieser Dokumentation. Insbesondere werden keine ausdrücklichen oder stillschweigenden Gewährleistungen hinsichtlich der handelsüblichen Qualität oder Eignung für einen bestimmten Zweck übernommen. Die G+H Systems behält sich weiterhin das Recht vor, diese Dokumentation zu revidieren und ihren Inhalt jederzeit und ohne vorherige Ankündigung zu ändern.
Des Weiteren übernimmt die G+H Systems für Software keinerlei Haftung und schließt insbesondere jegliche ausdrücklichen oder impliziten Gewährleistungsansprüche bezüglich der Marktfähigkeit oder der Eignung für einen bestimmten Zweck aus. Außerdem behält sich die G+H Systems das Recht vor, G+H Software ganz oder teilweise jederzeit inhaltlich zu ändern, ohne dass für die G+H Systems die Verpflichtung entsteht, Personen oder Organisationen von diesen Überarbeitungen oder Änderungen in Kenntnis zu setzen.
Copyright © inchorus ist ein Produkt der G+H Systems GmbH
Ohne ausdrückliche, schriftliche Genehmigung des Herausgebers darf kein Teil dieser Veröffentlichung reproduziert, fotokopiert, übertragen oder in einem Speichersystem verarbeitet werden.