SEND_MAIL
Script-Funktion: Sendet E-Mail an einen Benutzer.
Syntax
SEND_MAIL (Receiver, [Cc], Subject, Text[, Attachment][, Agent][, Login])
|
Syntax
|
Beschreibung/Format
|
|
Receiver
|
Nachrichtenempfänger.
Format: Script-Literal oder Script-Variable
|
|
Cc
|
Empfänger, der eine Kopie dieser Nachricht erhalten soll.
Format: Script-Literal oder Script-Variable
Standardwert: „“
|
|
Subject
|
Kurzbeschreibung der Nachricht.
Format: Script-Literal oder Script-Variable
Maximale Länge: 255 Zeichen
|
|
Text
|
Nachrichtentext.
Format: Script-Literal oder Script-Variable
|
|
Attachment
|
Pfad und Name der Dateien, die als Anhang geschickt werden sollen.
Format: Script-Literal oder Script-Variable
Standardwert: „“
Trennen Sie die einzelnen Pfade durch ein Semikolon (;), wenn Sie mehrere Dateien senden möchten.
|
| Agent
|
Dieser optionale Parameter gibt den Agenten an, der zum Senden der E-Mail-Nachricht(en) verwendet werden soll.
Wert:
-
Name des Agenten-Objekts oder
- Feste Zeichenfolge „*SERVER“ oder
- Feste Zeichenfolge „*DEFAULT“ (= Standardwert)
Wenn Sie hier keinen Agenten angeben, wird der Standardwert übernommen, d. h. das System sucht nach den Einstellungen von SEND_MAIL_DEFAULT in der Variable UC_CLIENT_SETTINGS. Wenn sie keine Agentenangaben enthalten, wird die E-Mail vom AE-Server gesendet
Der Wert „*SERVER“ kann verwendet werden, um das Senden der E-Mail über den AE-Server zu erzwingen (auch wenn Sie einen zentralen Agenten/Login in den UC_CLIENT_SETTINGS eingestellt haben).
Der angegebene Agent und das Automation Engine-System müssen die gleiche Version haben.
|
| Login
|
Dieser optionale Parameter gibt das Login-Objekt an, das zum Senden der E-Mail-Nachricht(en) verwendet wird.
Es ist wichtig, dass Sie Zugriff auf Dateien haben, die Sie als Anhang senden möchten.
Wert:
Dieser Parameter wird ignoriert, wenn der Parameter Agent auf „*SERVER“ gesetzt ist (kein Login-Objekt erforderlich).
Dies ist ein Pflichtfeld, wenn Sie den Parameter Agent angegeben haben.
|
|
Rückgabewerte
|
|
„0“ - E-Mail wurde erfolgreich gesendet.
„10034“ - Es ist kein Host mit E-Mail-Verbindung aktiv.
„50006“ - Der SMTP Server antwortet mit einem Fehlercode.
„50012“ - Timeout - SMTP-Server ‚&02‘ hat nicht innerhalb von ‚&01‘ Sekunden geantwortet.
„50014“ - Der Anhang existiert nicht.
„50027“ - Authentifizierung am STMP-Server fehlgeschlagen.
„50028“ - Die Empfänger-Adresse ist nicht gültig. Daher hat sie der SMTP-Server abgelehnt.
„50029“ - Verbindung mit dem SMTP-Server ist nicht möglich.
„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.
„53202“ - Die gesuchte Einstellung ‚&01‘ wurde nicht gefunden.
|
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 der Anhang nicht gefunden wurde oder E-Mail-Verbindung nicht aktiv ist, wird das Script standardmäßig weiter verarbeitet. Die Script-Funktion liefert in diesem Fall einen entsprechenden Rückgabewert.
Tipp: Verwenden Sie das Script-Statement :ON_ERROR, um Maßnahmen zu definieren für den Fall, dass das Senden der E-Mail fehlschlägt. Weitere Informationen finden Sie unter Script-Sprachmittel zur Fehlerbehandlung.
Diese Script-Funktion sendet E-Mails immer entweder über den angegebenen Agenten oder über die Automation Engine. Beachten Sie daher, dass Dateien, die angehängt werden sollen, über den Agenten oder die Automation Engine entweder direkt oder über einen UNC-Pfad zugänglich sein müssen.
Das Script-Statement bewirkt, dass die aktuelle Transaktion des Scripts in die AE-Datenbank geschrieben wird. Weitere Informationen finden Sie unter Script-Verarbeitung.
Um E-Mails zu senden, müssen Sie die E-Mail-Verbindung konfiguriert haben.
Die Parameter Agent und Login können auch mandanten-weit in der Variablen UC_CLIENT_SETTINGS definiert werden, mittels des Begriffs SEND_MAIL_DEFAULT. Diese Einstellungen werden dann verwendet, wenn die Parameter Agent und Login in der Script-Funktion SEND_MAIL nicht angegeben sind.
Beispiele
Im folgenden Beispiel wird eine E-Mail nur zu einem Benutzer geschickt (keine Kopien). Eine Datei ist an diese E-Mail angehängt.
:SET &OUT# = SEND_MAIL('brown@automic.at',,'Meeting','Meeting today at 5pm', '/AE/agenda')
Eine E-Mail, die zwei Anhänge enthält, wird 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: