SEND_MAIL

Verwenden Sie die Script-Funktion SEND_MAIL, um eine E-Mail an einen Benutzer zu senden. Diese Script-Funktion 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 Script standardmäßig weiter verarbeitet. Die Script-Funktion 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 Script-Funktion 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 Script-Funktion schreibt die Ergebnisse in die AE-Datenbank. Weitere Informationen finden Sie unter Script-Verarbeitung. 

Tipp: Verwenden Sie die Script-Anweisung :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.

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

Parameter

• SEND_MAIL
  Sendet eine E-Mail an einen Benutzer

• Empfänger
  Die Person, die die Meldung erhalten soll.
  Format: Script-Literal oder Script-Variable

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

• 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 Mandanteneinstellungen.
  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.
• Login
  (Optional) gibt das Login-Objekt an, das zum Senden der E-Mail-Meldung(en) 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 Mandanteneinstellungen.
  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

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
• 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")

Siehe auch: