SEND_MAIL

Verwenden Sie die Skriptfunktion SEND_MAIL, um eine E-Mail an einen Benutzer zu senden. Diese Skriptfunktion prüft nicht, ob der angegebene Empfänger tatsächlich existiert. Die Nachricht wird auch an einen falsch angegebenen 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 Skript standardmäßig weiter verarbeitet. Diese Skriptfunktion liefert in diesem Fall einen entsprechenden Rückgabewert.

Wichtig!

• Um E-Mails zu senden, müssen Sie die E-Mail-Verbindung konfiguriert haben. Weitere Informationen finden Sie unter Benachrichtigung (CALL).
• Diese Skriptfunktion sendet E-Mails immer entweder über den angegebenen Agenten oder über die Automation Engine. Dateien, die angehängt werden sollen, müssen deshalb über den Agenten oder die Automation Engine entweder direkt oder über einen UNC-Pfad zugänglich sein.
• Diese Skriptanweisung bewirkt, dass alle offenen Transaktionen des Skripts in die AE-Datenbank geschrieben werden. Weitere Informationen finden Sie unter Script-Verarbeitung.

Tipp: Verwenden Sie die Skriptanweisung :ON_ERROR, um Aktionen zu definieren, die ausgeführt werden sollen, wenn die E-Mail nicht erfolgreich gesendet werden kann. Weitere Informationen finden Sie unter Script-Elemente zur Fehlerbehandlung.

Syntax

SEND_MAIL (Empfänger, [Cc], Betreff, Text[, Anhang][, Agent][, Login]) [MYSERVER] )

Parameter

• SEND_MAIL
  Sendet eine E-Mail an einen Benutzer

• Empfänger
  Die Adresse(n), an die die Meldung gesendet werden soll
  Format: Script-Literal oder Script-Variable
  Maximale Länge: 255 Zeichen

• Cc
  (Optional) Die Person, die eine Kopie dieser Meldung erhalten soll
  Format: Script-Literal oder Script-Variable
  Standardwert: ""
  Maximale Länge: 255 Zeichen

• Betreff
  Kurzbeschreibung der Meldung
  Format: Script-Literal oder Script-Variable
  Maximale Länge: 255 Zeichen

• Text
  Meldungstext
  Format: Script-Literal oder Script-Variable

• Anhang
  (Optional) Pfad und Name der Dateien, die als Anhang geschickt werden sollen. Trennen Sie die einzelnen Pfade durch ein Semikolon (;), wenn Sie mehrere Dateien senden möchten.
  Format:Script-Literal oder Script-Variable
  Standardwert: ""

• Agent
  (Optional) Gibt den Agenten an, der zum Senden der E-Mail-Meldung(en) verwendet werden soll. Wenn Sie diesen Parameter nicht angeben, wird der Standardwert verwendet. Das System sucht nach mandantenweiten Einstellungen, die im Schlüssel SEND_MAIL_DEFAULT der Variablen UC_CLIENT_SETTINGS definiert sind. Wenn dieser Schlüssel nicht definiert ist, wird die E-Mail über die Automation Engine gesendet. Weitere Informationen finden Sie unter UC_CLIENT_SETTINGS - Verschiedene Mandanten-Einstellungen.
  Verwenden Sie einen der folgenden Werte:

  • Fester String *DEFAULT (Standardwert)
  • Festes String *SERVER. Verwenden Sie diesen String, um zu erzwingen, dass die E-Mail von derAE/vom Server gesendet wird, selbst wenn Sie einen zentralen Agenten/Login in der Variablen UC_CLIENT_SETTINGS festgelegt haben.
  • Name des Agenten-Objekts.
    Wichtig!
    • Der angegebene Agent und das Automation Engine-System müssen die gleiche Version haben.
    • Dieser Parameter funktioniert nur mit Java-basierten BS-Agenten.
      
• Login
  (Optional) gibt das Login-Objekt an, das zum Zugreifen auf die E-Mail-Anhänge verwendet wird. Wenn Sie diesen Parameter nicht angeben, wird der Standardwert verwendet. Das System sucht nach mandantenweiten Einstellungen, die im Schlüssel SEND_MAIL_DEFAULT der Variablen UC_CLIENT_SETTINGS definiert sind. Wenn dieser Schlüssel nicht definiert ist, wird die E-Mail über die Automation Engine gesendet. Weitere Informationen finden Sie unter UC_CLIENT_SETTINGS - Verschiedene Mandanten-Einstellungen.
  Wichtig!
  • Das Login-Objekt muss einen Eintrag mit dem Typ MAIL haben.
  • Dieser Parameter muss in Kombination mit dem Agent-Parameter zwingend angegeben werden.
  • Sie müssen über Zugriffsrechte für die Dateien verfügen, die Sie als Anhänge senden möchten.
  • Dieser Parameter wird ignoriert, wenn der Agent-Parameter *SERVER verwendet wird. In diesem Fall ist kein Login-Objekt erforderlich.

  Wert: Name des Login-Objekts

• MYSERVER
  (Optional) Ermöglicht es Ihnen, einen Servernamen zu definieren, an den Sie eine E-Mail senden möchten. Wenn Sie diesen Parameter definieren, stellen Sie sicher, dass Sie eine separate statische UC_SMTP_MYSERVER-Variable erstellen, die alle erforderlichen SMTP-Parameter enthält und den Namen des Servers, den Sie hier definieren, in ihrem Namen enthält. Weitere Informationen finden Sie unter UC_SMTP_MYSERVER - SMTP-Variable.

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
• 50007
  SMTP-Server '&02' hat E-Mail-Empfänger '&01' zurückgewiesen
• 50012
  Timeout - SMTP-Server ‚&02‘ hat nicht innerhalb von ‚&01‘ Sekunden geantwortet
• 50013
  Fehler beim Lesen der Anhangsdatei '&01' Fehlercode: canRead()==false, Fehlerbeschreibung: Datei kann nicht gelesen werden.
• 50014
  Der Anhang existiert nicht
• 50027
  Authentifizierung am SMTP-Server fehlgeschlagen
• 50028
  Die Empfänger-Adresse ist nicht gültig. Daher hat sie der SMTP-Server abgelehnt.
• 50029
  Der SMTP-Client kann keine Verbindung mit dem SMTP-Server einrichten
• 50030
  Fehler bei der Socket-Erstellung
• 50031
  Die Hostinformationen des SMTP-Servers konnten nicht ermittelt werden#
• 50032
  Der SMTP-Client kann nicht mehr mit dem SMTP-Server kommunizieren
• 50033
  Der SMTP-Client kann keine Daten vom SMTP-Server empfangen
• 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
• 50037
  SMTP-Server '&02' hat mit dem Fehler '&01' geantwortet
• 53202
  Die gesuchte Einstellung ‚&01‘ wurde nicht gefunden

Beispiele

Das folgende Beispiel sendet eine E-Mail an genau einen Benutzer. Der cc-Parameter wird nicht verwendet. Eine Datei ist an diese E-Mail angehängt.

: SET  &OUT# = SEND_MAIL ( 'brown@automic.at' ,, 'Meeting' , 'Meeting heute um 17:00 Uhr' , '/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 abgesagt" , "c:\AUTOMIC\agenda.doc;c:\AUTOMIC\dates.txt" )

Das folgende Beispiel enthält eine SMTP-E-Mail-Serverdefinition, an die Sie Ihre E-Mail senden.Der Agentenparameter ist auf "&AGENT#" gesetzt und bezieht sich auf einen Agenten mit dem Namen JAVAOSAGENT. Deshalb wird das SEND_MAIL-Kommando über JAVAOSAGENT gesendet, wenn verfügbar. Der letzte Parameter ist auf "&SMTP_SERVER#" gesetzt und verweist auf LOCALHOST. Daher verwendet das System die Variable UC_SMTP_LOCALHOST, um Informationen zu E-Mail-Einstellungen wie SMTP_TIMEOUT, SMTPS_CERT usw. zu erhalten. Wenn diese Variable nicht die erforderlichen Einstellungen enthält, werden diejenigen der Variablen UC_CLIENT_SETTINGS verwendet.

: SET  &RECEIVERS# = "firstuser@broadcom.com;seconduser@broadcom.com"
:SET &CC# = "thirduser@broadcom.com"
:SET &SUBJECT# = "Update on meeting"
:SET &MAILBODY# = "Hallo an alle, das heutige Meeting ist abgesagt. Kind regards"
:SET &ATTACHMENT# = "C:\Demo\Broadcom_Ltd_Logo.svg"
:SET &AGENT# = "JAVAOSAGENT"
:SET &AGENT_MAIL_AUTH# = "LOGIN.MAIL.WINDOWS"
:SET &SMTP_SERVER# = "LOCALHOST"
:SET &MAIL_RETURN_CODE# = SEND_MAIL (&RECEIVERS#,&CC#,&SUBJECT#,&MAILBODY#,&ATTACHMENT#,,,&SMTP_SERVER#)

Siehe auch: