- OrgaMon kann über das Protokoll SMTP eMail versenden
- Es kann unverschlüsselt, mit explizitem TLS 1.2, oder implizitem TLS 1.2 übertragen werden
Speicherung der Sende-Identität
Neben Personen speichert der OrgaMon auch den aktuell eingeloggten Windows-Benutzer, den aktuellen Benutzernamen kann OrgaMon über ein Windows-API ermitteln. Inerhalb des OrgaMon wird der Begriff "Bearbeiter" verwendet. Findet OrgaMon beim Start den Login-Namen des Bearbeiters nicht wird er stillschweigend angelegt. Du kommt zu diesem Bearbeiter über einen Doppelklick auf den Loginnamen rechts neben der Schaltfläche Bearbeiter.
Im ->Bearbeiter ist die Sende-Identität für den eMail Sendevorgang gespeichert. Bei Bearbeiter müssen folgende Werte definiert sein (im unteren Text-Feld Status Info, Zugriffsrechte angeben:)
# # Host # Host=<smtp-Server> # # Port # # Bestimmt welcher Port des SMTP-Servers angesprochen wird. Über diesen # Wert wird auch die Sicherheits-Technologie festgeleget: # # =25 keine Sicherheit # =587 Explizites TLS 1.2 # =? (jeder andere Port) Implizites TLS 1.2 # Port=<smpt-Port> # # Username # Username=<Konto> # # Password # Password=<Passwort> # # Name # Name=<Name des Senders>
# # Address # Address=<eMail Adresse des Senders>
- Beispiel
Host=mx.orgamon.eu Port=587 Username=mail-konto-01 Password=********* Name=Filsinger, Andreas (IT-Freiberufler) Address=andreas.filsinger@orgamon.org
Über die Schaltfläche eMail im Hauptmenü kann man nun die Einstellungen testen. Im Reiter Verfassen einen kurzen Text zu testen eingeben. 1. Zeile: das wird später der Betreff, weitere Zeilen: das ist später der eMail Text. Nun im Reiter "Test" die Ziel-eMail Adresse eingeben und "Test-EMail senden" drücken.
Empfänger-Adressen
Die eMail Adressen sind im Reiter "Internet Dienste" gespeichert. Die Hauptzieladresse wird im Feld "eMail;eMail;..." angegeben. Alle weiteren eMail - Adressen können bei der Person im Feld "Internet Dienste" im Reiter "Internet Dienste" angegeben werden.
cc=weitere@email.tld cc=weitere2@mail.tld
eMail-Nachricht
1. Zeile ist der Betreff
alle weitere Zeilen werden als Nachrichtentext versendet
Innerhalb der Nachricht kann auf die Datenbankfelder ANSCHRIFT.* und PERSON.* zugegriffen werden. Beispiel für eine Nachricht:
Benutzeranmeldung wieder möglich
Sehr geehrter Kunde,
durch einen Fehler in unserer Benutzerverwaltung war Ihnen bisher der Login in unseren Webshop nicht möglich. Wir konnten den Fehler jetzt lokalisieren und beheben. Unsere Prüfung hat ergeben, dass auch Ihr Zugangskonto betroffen war.
Benutzer: ~PERSON.USER_ID~
Passwort: ~PERSON.USER_PWD~
Wir bitten unseren Fehler zu entschuldigen, und hoffen Sie haben in Zukunft viel Spass mit unserem WebShop.
Ihr Technik - Team
Mailing erstellen
- Definieren Sie eine Versender-Identität: Bei "Bearbeiter" die entsprechenden Informationen eingeben, siehe obiges Kapitel "Sender". Merken Sie sich den RID dieser Versender-Identität.
- Erstellen Sie eine eMail Vorlage: 'neu', Haken, Refresh, SENDER_R aus Bearbeiter ermitteln und eintragen.
- Ein OLAP Statement erstellen, das alle Ziele (PERSON_R in der ersten Spalte) beinhält (kann unter Personen auch eingelesen!).
- Mit dem Cursor auf der Vorlage stehen, und mit dem grünen OLAP Würfel die Zielpersonenliste auswählen.
- 'Alle senden' drücken
Vorlagen
- eMails können aufgrund von Vorlagen versendet werden.
- Vorlagen sind vorgefertigte Texte die wie eMails selbst in der Tabelle EMAIL gespeichert werden
- es gibt Systemereignisse die auf Vorlagen zugreifen
Anlage einer Vorlage
Legen Sie eine Vorlage an, indem Sie bei eMail "+", danach den Haken, danach refresh, danach nach RID sortieren so dass der grösste oben steht - das ist nun ihr "leerer" Datensatz. In "UID" geben Sie den Namen der Vorlage in Grossbuchstaben ein, im Reiter "Verfassen" geben Sie den eMail-Text ein, dabei ist die erste Zeile immer die Betreffszeile.
Variable
- per ~PERSON.Feldname~ kann z.B. auf Personen-Daten zugegriffen werden.
- je nach Kontext sind die Tabellen ARTIKEL, VERSAND, WARENBEWEGUNG oder ANSCHRIFT zugänglich
- Folgende Variable sind immer ansprechbar:
~Copyright~ ~Datum~ ~AktuellesDatum~ ~AktuelleUhrzeit~ ~DatumLog~ ~ZeitLog~
Steuerbefehle
- Bei einer Vorlage wird der eMail Text (Body) im wesentlichen durch den festen Text der Vorlage bestimmt.
- Dennoch kann man in der soeben generierten eMail-Zeile Variablen Werte mitgeben.
- Oder Datei-Anhänge bestimmen.
Anlage:
Baustein:
eml:
Aktion:PasswortNeu
Für den Kunden wird ein neues Passwort bereitgestellt
PST zu "~ARTIKEL.TITEL~" Hallo ~PERSON.VORNAME~ ~PERSON.NACHNAME~! Vielen Dank für Ihr Interesse an unserem Probestimmen-Service. Anbei erhalten Sie die gewünschte Probestimme zu: ~ARTIKEL.NUMERO~ ~ARTIKEL.TITEL~ Mit freundlichen Grüßen x Musikverlag GmbH Str. 22 D-99999 Musterland Telefon 0 7x x0 / 92 x8- 0 Telefax 0 7x x0 / 92 x2 31 mailto:me@my-music.de http://my.me.music.de
LOGIN
Ihre Zugangsdaten für den Webshop Sehr geehrter Kunde, sie können sich ab sofort mit folgenden Daten in den Webshop einloggen: Benutzer: ~PERSON.USER_ID~ Passwort: ~PERSON.USER_PWD~ Ihr Webshop Team ...
TAGESABSCHLUSS
OrgaMon-Server: Tagesabschluss beendet (~DatumLog~ ~ZeitLog~) Hallo zusammen, diese eMail wird nach der Ausführung des Tagesabschlusses automatisch erzeugt. Bitte prüfen Sie den täglichen Eingang! Liegt sie nicht zur gewohnten Zeit vor, so sollte die Störung gemeldet werden. Das OrgaMon-Team ~Copyright~ Bericht:
TAGWACHE
OrgaMon-Server: Tagwache beendet (~DatumLog~ ~ZeitLog~) Hallo zusammen, diese eMail wird nach der Ausführung der Tagwache automatisch erzeugt. Bitte prüfen Sie den täglichen Eingang! Liegt sie nicht zur gewohnten Zeit vor, so sollte die Störung gemeldet werden. Das OrgaMon-Team ~Copyright~ Bericht:
ERGEBNIS
Datenlieferung "~TAN~" wurde soeben bereitgestellt [Dienstleister] ### Diese eMail wurde im Rahmen der Tagwache automatisch erzeugt. "Antworten" auf diese Mail können nicht zugestellt werden. ### ~PERSON.ANSPRACHE~ auf der Internetablage http://~ABLAGE~.orgamon.de/ wurden soeben neue Ergebnisdaten abgelegt. ~ERFOLGREICH~ erfolgreiche Vorgänge. ~VORGEZOGEN~ wurden als "bereits erledigt" zurückgegeben. ~UNMOEGLICH~ haben wir als unmöglich zurückgegeben. Details dazu finden Sie in den Ergebnisdaten selbst.
RECHNUNG
MAHNUNG
Kontoinformation vom ~AktuellesDatum~ ~PERSON.ANSPRACHE~, anbei zu ihrer Information eine Übersicht ausstehender Zahlungen. Anhänge könnten auf ihrem Weg durchs Internet verfälscht werden, der MD5-Hash der Datei im Anhang sollte lauten: ~MD5~ Ort, ~AktuellesDatum~ um ~AktuelleUhrzeit~ Mfg.Bearbeiter ~Copyright~ -- Otto Bearbeiter Unternehmen GmbH Strasse 123 99999 Musterstadt GERMANY Tel. +49(0)ooo/ooooo Mob. +49(0)oo/ooooo http://www.OrgaMon.org
ZUSAGE
Neuer Liefertermin bei ~ARTIKEL.TITEL~ Sehr geehrte(r) ~PERSON.ANREDE~ ~PERSON.NACHNAME~, ~MENGE~x ~ARTIKEL.NUMERO~ ~AUSGABEART~ ~ARTIKEL.TITEL~ leider erhalten Sie den bestellten Artikel erst am ~NEW.ZUSAGE~ da es Lieferschwierigkeiten beim Verlag gibt. Verlag
VERGRIFFEN
bisher ohne Funktion
Versand@
Auflisten aller Vorlagen
-- -- Auflisten aller eMail Vorlagen -- select * from EMAIL where (VORLAGE_R is null) and (UID is not null) and (UID<>'BLACKLISTED') and ((UID not containing '@') or (UID containing 'Versand')) excel open -
select * from EMAIL where (VORLAGE_R is null) and ( (UID='PDF') or (UID='LOGIN') or (UID='TAGESABSCHLUSS') or (UID='TAGWACHE') or (UID='ERGEBNIS') or (UID='RECHNUNG') or (UID='MAHNUNG') or (UID='ZUSAGE') or (UID='VERGRIFFEN') or (UID LIKE 'Versand@%') )
Ausnahmen
BLACKLISTED
- Gibt es Probleme bei der Zustellung wird "BLACKLISTED" in VORGANG gespeichert, dieses Problem muss man manuell lösen
Blacklist.txt
In dieser txt Datei (OrgaMon-Verzeichnis .\SuchIndex\) sind alle Empfänger eingetragen an die keine eMail versendet wird. Pro eMail Adresse eine Zeile. Man Kann auch ganze Domains sperren durch einen "*" vor dem "@"
*@yahoo.de *@yahoo.com *@web.de andreas.filsinger@menlopark.com
Das Editieren ist möglich unter eMail->Symbol "schwarzes Stopp-Schild". Bei der ersten Verwendung wird die Datei neu sortiert und alle Dopellten entfernt.
eml Mailing
Mail-Grundlage erstellen
- eMail->Reiter "Test"
- "me@domin.tld" mit einer Testempfänger Mail füllen
- Anhang-Eingabefeld mit einer *.eml Datei füllen
- "Test" versenden
Massenmailing lostreten =
- mit dem Cursor auf der eMail Grundlage stehen
- Grüner OLAP Würfel
- das passede csv laden
Anbindung an den WebShop
Der Webshop wird versuchen über die XMLRPC Schnittstelle die Anforderungen für das Versenden einer eMail an den OrgaMon weiterzugeben. Dazu wurden die zwei XMLRPC Funktion "Miniscrore" und "LoginInfo" definiert. Intern werden zur textuellen Erstellung der eMail die entsprechenden Vorlagen PDF und LOGIN gesucht! Der Vorlagenname muss in der Spalte UID eingetragen werden.
- PDFVersender=<Host> muss gesetzt sein.
- In den Benutzerdaten des Bearbeiter Host muss ein eMail Account eingetragen sein:
FehlerAbzeichnen=NEIN
Host=smtp.domain.tld
Username=mail-account
Password=smtp-pwd
Name=Dies und das GmbH [WebShop]
Address=webshop@domain.tld
Lastverteilung
durch den SQL-Filter kann eine Lastverteilung erreicht werden. Hierbei kann eine weitere Bedingung zur Mail-Versendung angegeben werden! Wenn sich z.B. 2 Systeme die Arbeit teilen, so macht das eine System z.B. die geraden RIDs, das andere System die ungeraden. Da es MOD bei Firebird nicht gibt wird das MOD selbst gebaut:
# # Lastverteilung durch unterschiedliche Modulo Ergebnisse. # Von den Mathe-Freak wissen wir: x MOD y = x - (x DIV y) * y # Also ist der Filter auf Host "A" # and ((RID - (RID / 2) * 2)=0) # # der Filter auf Host "B" lautet # and ((RID - (RID / 2) * 2)=1)
eMail durch OLAP erzeugen
-- -- Erzeugen einer eMail via OLAP -- -- -- -- RID der Person, die angemailt werden soll ... -- $PERSON_R=1 -- -- RID der eMail-Vorlage "Tagwache" -- $VORLAGE_R=select RID from EMAIL where (VORLAGE_R IS NULL) and (UID='TAGWACHE') -- -- den eMail Request absetzen -- insert into EMAIL (RID,PERSON_R,VORLAGE_R,NACHRICHT) values (0, $PERSON_R, $VORLAGE_R, 'Baustein:$Diagnose?Tagwache-$SEQ_TAGWACHE.log.txt')