Automation Engine Script-Leitfaden > Funktionelle Gliederung > Fehlerbehandlung und Meldungen > SEND_MAIL

SEND_MAIL

Script-Funktion: Sendet E-Mail an einen Benutzer.

Syntax

SEND_MAIL(Receiver, [Cc], Subject, Text, [Attachment],[Agent, Login Object] | [_SERVER, _DEFAULT])

Syntax	Beschreibung/Format
Empfänger	Nachrichtenempfänger. Format: Script-Literal oder Script-Variable
Cc	Empfänger, die eine Kopie dieser Nachricht erhalten sollen. Format: Script-Literal oder Script-Variable Standardwert: ""
Betreff	Kurzbeschreibung der Meldung. Format: Script-Literal oder Script-Variable
Text	Text der Meldung Format: Script-Literal oder Script-Variable
Anlage	Pfad und Namen der Dateien, die als Anlage geschickt werden soll. Format: Script-Literal oder Script-Variable Standardwert: "" Trennen Sie die einzelnen Pfade mit einem Komma (,), wenn Sie mehrere Dateien senden möchten.
Agent	Gibt den Agenten an, der für den Versand der E-Mail-Meldung(en) verwendet werden soll (optional). Wert: Name des Agenten-Objekts oder Fester String "SERVER" oder Fester String "DEFAULT" (= Standardwert) Wenn Sie keinen Agenten angeben, wird das E-Mail von AE/Server gesendet. Mit dem Wert "SERVER" kann der Versand der E-Mail über AE/Server erzwungen werden (selbst wenn Sie einen zentralen Agenten/Login festlegen). Beim Wert "DEFAULT", werden die UC_CLIENT_SETTINGS Werte verwendet. Die Version des angegebenen Agenten und des Automation Engine-Systems müssen übereinstimmen.
Login	Dieser optionale Parameter gibt an, welches Login-Objekt für den Versand der E-Mail-Meldung(en) verwendet wird. Um Dateien als Anhang versenden zu können, müssen Sie Zugriff darauf haben. Wert: Name des Login-Objektes Dieser Parameter wird ignoriert, wenn der Parameter Agent auf "SERVER" eingestellt ist (kein Login-Objekt erforderlich). Er ist zwingend erforderlich, wenn Sie den Agenten*-Parameter spezifiziert haben.

Rückgabewerte
"0" - Die E-Mail wurde erfolgreich versendet. "10034" - Es ist kein Host mit E-Mail-Kopplung aktiv. "50006" - Der SMTP-Server antwortet mit einem Fehlercode. "50012" - Zeitablauf - SMTP-Server '&02' hat nicht in '&01' Sekunden geantwortet. "50014" - Die Anlage existiert nicht. "50027" - Authentifizierung am STMP-Server fehlgeschlagen. "50028" - Die Empfänger-Adresse ist nicht gültig und wurde daher vom SMTP-Server abgelehnt. "50029" - Der SMTP-Client kann sich nicht mit dem SMTP-Server verbinden. "50030" - Fehler bei der Socket-Erstellung. "50031" - Die Hostinformationen des SMTP-Servers konnten nicht ermittelt werden. "50032" - Kommunikation mit dem SMTP-Server ist nicht mehr möglich. "50033" - Es können keine Daten vom SMTP-Server empfangen werden. "50034" - Es können keine Daten zum SMTP-Server gesendet werden. "50035" - Initialisierung der Windows-Sockets nicht möglich. "50036" - Hostname des lokalen Rechners kann nicht ermittelt werden.

Rückgabewerte

"0" - Die E-Mail wurde erfolgreich versendet.
"10034" - Es ist kein Host mit E-Mail-Kopplung aktiv.
"50006" - Der SMTP-Server antwortet mit einem Fehlercode.
"50012" - Zeitablauf - SMTP-Server '&02' hat nicht in '&01' Sekunden geantwortet.
"50014" - Die Anlage existiert nicht.
"50027" - Authentifizierung am STMP-Server fehlgeschlagen.
"50028" - Die Empfänger-Adresse ist nicht gültig und wurde daher vom SMTP-Server abgelehnt.
"50029" - Der SMTP-Client kann sich nicht mit dem SMTP-Server verbinden.
"50030" - Fehler bei der Socket-Erstellung.
"50031" - Die Hostinformationen des SMTP-Servers konnten nicht ermittelt werden.
"50032" - Kommunikation mit dem SMTP-Server ist nicht mehr möglich.
"50033" - Es können keine Daten vom SMTP-Server empfangen werden.
"50034" - Es können keine Daten zum SMTP-Server gesendet werden.
"50035" - Initialisierung der Windows-Sockets nicht möglich.
"50036" - Hostname des lokalen Rechners kann nicht ermittelt werden.

Anmerkungen

Das Senden einer E-Mail hängt von den Möglichkeiten ab, welche die PC-Konfiguration eines Benutzers bietet.

Die Script-Funktion prüft nicht, ob der angegebene Empfänger tatsächlich existiert. Die Nachricht wird auch an einen falschen Empfänger geschickt.

Kann die E-Mail nicht gesendet werden, da beispielsweise die Anlage nicht gefunden werden kann oder Mail-Kopplung nicht aktiv ist, wird das Script standardmäßig weiter prozessiert.
Die Script-Funktion liefert in diesem Fall einen entsprechenden Rückgabewert. Mit der Script-Anweisung :ON_ERROR haben Sie die Möglichkeit die Prozessierung des Scripts im Fehlerfall abzubrechen. Den Fehler können Sie mit den Script-Funktionen zur Fehlerbehandlung analysieren.

Das Script-Sprachmittel sendet E-Mails immer über Automation Engine. Dateien, die mitgeschickt werden soll, müssen sich daher auf dem Rechner der Automation Engine befinden oder von dort erreichbar sein (UNC-Pfad).

Die Anzahl der Zeichen ist auf 1024 Zeichen pro Zeile beschränkt.

Die Script-Funktion, dass die offenen Transaktionen des Scripts in die AE-Datenbank geschrieben werden.

Das Versenden von E-Mails setzt die Konfiguration der E-Mail Kopplung voraus.

Die Parameter Agent und Login können auch mandantenweit in der Variable UC_CLIENT_SETTINGS festgelegt werden, mithilfe des Keys SEND_MAIL_DEFAULT. Einstellungen in individuellen SEND_MAIL Script-Funktionen werden überall im entsprechenden Mandanten durch den Key in UC_CLIENT_SETTINGS überschrieben.

Beispiele

Im ersten Beispiel wird ein E-Mail an nur einen Empfänger (keine Kopien) verschickt. Dieses E-Mail hat eine Datei als Anlage.

:SET &OUT# = SEND_MAIL('brown@automic.at',,'Meeting','Meeting today at 5pm', '/AE/agenda')

Hier wird ein E-Mail, das zwei Anlagen enthält, an mehrere Personen gesendet.

:SET &OUT# = SEND_MAIL("brown@automic.at;smith@automic.us",,"Meeting","Meeting canceled","c:\AUTOMIC\agenda.doc;c:\AUTOMIC\dates.txt")

Siehe auch:

Script-Sprachmittel	Beschreibung
:SEND_MSG	Schickt Nachrichten an Benutzer, die am UserInterface angemeldet sind.
:ON_ERROR	Legt die Reaktion auf bestimmte Fehler bzw. Meldungen von Script-Sprachmitteln fest.

Script-Sprachmittel - Fehlerbehandlung und Meldungen

E-Mail-Kopplung

Beispielsammlung:
Ermittlung der Fehlermeldung und -nummer

Allgemeines zum Script
Script-Sprachmittel - Alphabetische Auflistung
Script-Sprachmittel - Funktionelle Gliederung

Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support