EMail

• 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.

Aktion:PasswortNeu

Für den Kunden wird ein neues Passwort bereitgestellt

PDF

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.

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

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')