SY_MailSendEx

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