SY_MailSendEx
Versendet eine E-Mail.
Der E-Mail-Versand muss im syslog.ERP entsprechend konfiguriert sein (siehe email.ini).
Prototype
SY_MailSendEx( from, to, cc, bcc, subject, body, attachment )
Parameter
Parameter | Typ | Bedeutung |
---|---|---|
from | string | E-Mail-Adresse des Absenders. Optional kann dahinter noch der Name des Absenders folgen, welcher dann durch das Pipe-Symbol (Verkettungszeichen, '|') von der E-Mail-Adresse getrennt werden muss. Wenn ein leerer String ("") übergeben wird, dann werden die entsprechenden Werte aus MAILSEND_SENDER und MAILSEND_NAME aus der email.ini gezogen. |
to | string | E-Mail-Adresse des Empfängers (mehrere kommagetrennt) |
cc | string | E-Mail-Adresse, an die eine Kopie geschickt werden soll (CC-Adresse; kann auch leer gelassen werden) (mehrere kommagetrennt) |
bcc | string | E-Mail-Adresse, an die eine Blindkopie geschickt werden soll (BCC-Adresse; kann auch leer gelassen werden) (mehrere kommagetrennt) |
subject | string | Betreff |
body | string | Eigentlicher Inhalt der E-Mail |
attachment | string/table (optional) | Anhang / Anhänge. Entweder ein string, der den vollständigen Pfad der anzuhängenden Datei enthält oder ein Lua-Table, der strings mit Pfaden zu anzuhängenden Dateien enthält. Kann auch leer gelassen werden (nil übergeben). |
async | boolean (optional) | Mailversand asynchron ausführen (true/false). Bei asynchroner Ausführung können Fehler, die beim Versand auftreten, nicht abgefangen oder protokolliert werden. |
Rückgabewert
Nummer | Typ | Bedeutung |
---|---|---|
1 | number | 0 (Aufruf erfolgreich) oder < 0 im Fehlerfall |
Hinweise
Der E-Mail-Versand kann nur funktionieren, wenn er in Syslog-PPS entsprechend eingerichtet ist (siehe Email-Versand SMTP und email.ini)
Mehrere E-Mail-Adressen können kommagetrennt angegeben werden
Rückgabewert auf Fehler prüfen!
Beispiel
--[[
E-Mail versenden
--]]
local res = SY_MailSendEx( "mustermann@example.com|Max Mustermann", -- FROM (Absender)
"musterfrau@example.com", -- TO (Empfänger)
"", -- CC (Kopie)
"", -- BCC (Blindkopie)
"Test-Mail aus LUA", -- Betreff
"Dies ist der Inhalt der E-Mail. Viel steht hier nicht drin...", -- Inhalt
nil, -- Anhang/Anhänge
false ) -- Asynchrone Ausführung
if res ~= 0 then
SY_Proto( "SY_MailSendEx hat folgenden Fehler produziert: " .. res )
else
SY_Proto( "E-Mail erfolgreich versandt" )
end