send mail(a,b,c,d,e,f,g[,h,i,j,k,l,m])


Versendet eine Mail mit Betreff f und Mailtext g. Ist i mit einem Wert belegt, wird dieser unter Nutzung des Zeichensatzes ISO-8859-1 in Binärdaten umgewandelt und als Attachment der Mail angehängt. Hat i den Wert <file> wird - sofern vorhanden - die vom Profil verarbeitete Eingangsdatei als Attachment angehängt. In beiden Fällen hat das Attachment den Dateinamen Attachment.txt. Hat Parameter k einen Wert, wird dieser als Attachment-Namen verwendet - ansonsten bleibt der Name Attachment.txt.

Parameter b wird als Absender in die Mail eingesetzt, e enthält eine kommaseparierte Liste von Empfängeradressen, an die die Mail gesendet werden soll. Alternativ dazu kann im Parameter e die ID eines Kanals vom Typ "Mail" angegeben werden, in diesem Fall werden dessen Einstellungen verwendet, so dass die Parameter a bis d leer bleiben können. Werden sie trotzdem gesetzt, werden sie statt der Werte aus dem Kanal verwendet. Damit der Kanal verwendet werden kann, muss er Einstellungen für die Untertypen SMTP oder ASMTP enthalten. Empfänger können mit cc:xxx bzw. bcc:xxx gekennzeichnet werden (wobei xxx die E-Mail-Adresse ist).

Wenn der Parameter j=true ist, wird als Rückgabewert true für erfolgreiches Senden und false für bei einem Sendefehler geliefert. Mit j=false wird bei einem Sendefehler die Funktion mit einem Fehler abgebrochen.

Parameterbeschreibung


Parameter

Beschreibung

a

Hostname oder IP-Adresse des Mailservers.

b

Absenderadresse.

c

(optional) Benutzername für Anmeldung am Mailserver. Default: leer.

d

(optional) Passwort für Anmeldung am Mailserver. Default: leer. Dieses kann verschleiert übergeben werden.

e

ID des Kanals oder kommaseparierte Liste der Empfängeradressen.

f

Mailbetreff.

g

Mitteilungstext.

h

(optional) Portnummer des Mailservers. Default: 25

i

(optional) Anhangsdaten (als String) oder Platzhalter <file> für das Anhängen der Eingangsdaten des Profils. Hinweis: Um den Inhalt einer Datei aus dem Dateisystem anzufügen, muss die Datei zuerst mit der Funktion read file( path a[, encoding b] ) gelesen werden. Binärdateien bitte im Encoding 8859_1 lesen.

j

(optional) Bei true wird bei Erfolg true zurück geliefert, ansonsten false. Ist j=false, dann wird bei einem Sendefehler die Funktion mit einem Fehler abgebrochen.

k

(optional) Optionaler Name des Attachments, ansonsten wird Attachment.txt verwendet.

l

(optional) Bei true wird eine HTML-Mail erzeugt, d. h. man kann im Mail Body Formatierungen (wie z. B. <b>) einbauen.

m

(optional) Zu verwendendes Protokoll. Erlaubte Werte: smtp, smtps, smtpes. Default: smtp

Beispiele


Parameter a

192.168.212.12

192.168.212.12

192.168.212.12

Parameter b

sender@example.com


newsender@example.org

Parameter c




Parameter d




Parameter e

rec1@example.org,cc:rec2@example.org

1234567890

1234567890

Parameter f

Infomail

Infomail

Infomail

Parameter g

Mailtext

Mailtext

Mailtext

Parameter h




Parameter i



<file>

Parameter j

true

true

true

Parameter k



Order.csv

Parameter l




Parameter m




Ergebnis

Sendet eine Mail an die beiden Empfänger auf example.org mit einem Mailtext, ohne Attachment und unter Nutzung des standardmäßig eingestellten Mailservers.

Sendet eine Mail ohne Attachment an den im Kanal (ID) hinterlegten Empfänger.

Sendet eine Mail mit den Eingangsdaten an den im Kanal (ID) hinterlegten Empfänger, verwendet aber einen anderen Absender als im Kanal hinterlegt. Der Name des Anhangs lautet Order.csv.