send mail(a,b,c,d,e,f,g[,h,i,j,k,l,m])
Gruppe |
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 |