UC_SMTP_MYSERVER - SMTP-Variable

Diese statische Variable ist hilfreich, wenn Sie mehrere SMTP-Server verwenden, da sie die Spezifikationen für die E-Mail-Verbindung eines bestimmten Servers zur Automation Engine enthält. Sie müssen sie definieren, um den neuen MYSERVER-Parameter in der Skriptfunktion SEND_MAIL verwenden zu können. Stellen Sie für jede von Ihnen erstellte Variable sicher, dass Sie den MYSERVER-Teil in ihrem Namen durch den Servernamen ersetzen, den Sie in SEND_MAIL definieren (z. B. UC_SMTP_LOCALHOST).

Wichtig! Die Schlüssel SMTP_SERVER und SMTP_FROM_ADDR sind obligatorisch. Alle anderen Einstellungen sind optional.

Diese Variable deckt die folgenden SMTP-Parameter ab:

SMTP_FROM_ADDR

  • Beschreibung: E-Mail-Adresse des Absenders.

  • Neustart erforderlich: Nein

SMTP_LOGIN

  • Beschreibung: (Optional) Der Name des Login-Objekts, das zur Anmeldung am SMTP-Server verwendet wird.

  • Neustart erforderlich: Nein

SMTP_MAX_ATTACHMENT_SIZE

  • Beschreibung: (Optional) Maximale Größe in Byte der Berichtsdatei, die per E-Mail gesendet wird. Dies gilt nur für Berichte, die per E-Mail gesendet werden, aber nicht für andere Typen von Anhängen.

    Geben Sie auf der Seite Benachrichtigung eines Benachrichtigungsobjekts die RunID der relevanten Aufgabe an, damit die entsprechenden Berichte an die Nachricht angehängt werden können. Weitere Informationen finden Sie unter Benachrichtigung (CALL).

  • Zulässige Werte: 400–50000

    Wenn die Reportdatei den Maximalwert überschreitet, wird nur die zulässige Größe gelesen und gesendet. Das Dateiende enthält den folgenden Hinweis: Truncated through SMTP_MAX_ATTACHMENT_SIZE limit.

  • Standardwert: 8000

  • Neustart erforderlich: Nein

SMTP_PORT

  • Beschreibung: (Optional) Port des SMTP-Servers, der verwendet wird, um eine Verbindung zum E-Mail-Server herzustellen.

  • Standardwert: SMTP-Server verwenden für gewöhnlich das Transmission Control Protocol auf Port-Nummer 25 für Klartext und 587 für verschlüsselte Kommunikation. Abhängig davon, wie der E-Mail-Server, der kontaktiert werden soll, konfiguriert ist, können Sie einen beliebigen Port definieren. Siehe auch https://en.wikipedia.org/wiki/List_of_TCP_and_UDP_port_numbers.

    Wichtig! Definitionen, die in einer UC_SMTP_MYSERVER-Variablen vorgenommen werden, überschreiben die Definitionen, die in der UC_CLIENT_SETTINGS-Variablen vorgenommen werden.

  • Neustart erforderlich: Nein

SMTP_PROTOCOL

  • Beschreibung: (Optional) Das Protokoll, das Sie verwenden möchten, um die Kommunikation zu herstellen.

  • Zulässige Werte: Großbuchstaben, Kleinbuchstaben und eine Mischung aus Groß- und Kleinbuchstaben

    • PLAIN (Standard)

      Sendet E-Mails in Klartext über eine unverschlüsselte Verbindung.

    • STARTTLS

      Sendet E-Mails über eine opportunistische TLS-Verbindung, die sich auf Erweiterungen in Klartext-Kommunikationsprotokollen bezieht, die eine Möglichkeit bieten, eine Klartext-Verbindung in eine verschlüsselte (TLS oder SSL) Verbindung umzuwandeln, statt einen separaten Port für verschlüsselte Kommunikation zu verwenden. Abhängig davon, wie Ihr SMTP-Server konfiguriert ist, müssen Sie möglicherweise auch SMTP_PORT ändern, um sein Standardverhalten zu ändern.

      Zusätzliche Aktionen, die in diesem Fall erforderlich sind:

      1. Laden Sie das Zertifikat des SMTP-Servers in das UC_TRUSTEDCERTS-Speicherobjekt auf Mandant 0 hoch. Die erste Spalte in diesem Speicherobjekt muss einen Namen enthalten, den Sie auswählen können, und die zweite Spalte muss die Zertifikatsdatei enthalten.

      2. Setzen Sie SMTPS_CERT in den SMTP-Einstellungen auf den Namen, den Sie ausgewählt haben, um auf die richtige Zertifikatsdatei von UC_TRUSTEDCERTS zu verweisen.

    • TLS

      Sendet E-Mails über eine erzwungene TLS-Verbindung. In diesem Fall ist ein Port erforderlich, der nur TLS unterstützt . Befolgen Sie darüber hinaus die Schritte im obigen Abschnitt STARTTLS.

    Wichtig!

    • Wenn Sie STARTTLS oder TLS verwenden, müssen Sie den Namen des Zertifikats, das Sie für die Authentifizierung verwenden möchten, in den SMTPS_CERT-Schlüssel eingeben.
    • Wenden Sie sich an Ihren Administrator, wenn Sie wissen müssen, ob Sie STARTTLS oder TLS verwenden sollten.
    • Dieser Parameter ist nur verfügbar, wenn die Skriptfunktion SEND_MAIL in der Automation Engine ausgeführt wird.

  • Neustart erforderlich: Nein

SMTP_REPLY_TO

  • Beschreibung: (Optional) E-Mail-Adresse für die Antwort.

  • Neustart erforderlich: Nein

SMTP_SERVER

  • Beschreibung: Host-Name des SMTP- Servers.

  • Neustart erforderlich: Nein

SMTP_TIMEOUT

  • Beschreibung: (Optional) Maximale Zeit in Sekunden, die das System auf die Antwort eines SMTP-Servers wartet.

  • Zulässige Werte: 0–999

  • Standardwert: 20

  • Neustart erforderlich: Nein

SMTPS_CERT

  • Beschreibung: (Optional) Name des Zertifikats, das im Speicherobjekt UC_TRUSTEDCERTS in Mandant 0 gespeichert ist.

    • Wichtig!

    • Dieser Parameter ist obligatorisch, wenn Sie die Parameter STARTTLS oder TLS im Schlüssel SMTP_PROTOCOL festlegen. Das Speicherobjekt UC_TRUSTEDCERTS wird mit Mandant 0 geliefert und ermöglicht Ihnen das Hochladen der relevanten Zertifikatsdateien. Weitere Informationen finden Sie unter .
    • Dieser Parameter ist nur verfügbar, wenn die Skriptfunktion SEND_MAIL in der Automation Engine ausgeführt wird.
    • Zwischenspeichern von Agenten-Zertifikaten:
      Wenn ein Agent verwendet wird, um E-Mails zu senden und TLS aktiviert ist, stellt die Automation Engine dem Agenten das erforderliche Zertifikat unter Verwendung des Namens in SMTPS_CERT und der Suche nach dem Zertifikat in UC_TRUSTEDSTORE bereit. Die dort gefundene Datei wird an den Agenten gesendet und vom Agenten zum Senden einer E-Mail an den SMTP-Server verwendet. Das Zertifikat wird jedoch nur bei einigen Versandversuchen verschickt. Der Agent speichert das Zertifikat im Cache und lädt nur dann ein neues herunter, wenn Änderungen am Objekt UC_TRUSTEDSTORE vorgenommen werden. Das Ändern dieses Speicherobjekts löst eine Cache-Bereinigung aus, die im JWP stattfindet.
    • Verhalten älterer Agenten:
      Systemeigene BS-Agenten und ältere Java-Agenten unterstützen weder benutzerdefinierte SMTP-Objekte mit SMTP-Einstellungen, um die in UC_CLIENT_SETTINGS (UC_SMTP_MYSERVER) festgelegten SMTP-Einstellungen zu überschreiben, noch unterstützen sie die Einstellungen SMTP_PORT, SMTP_PROTOCOL und SMTPS_CERT. Außerdem wird keine Form von TLS unterstützt. Da die oben genannten drei Einstellungen von systemeigenen BS-Agenten oder Java-Agenten nicht unterstützt werden, werden sie ignoriert, wenn E-Mails über sie gesendet werden. Selbst wenn Sie SMTP_PORT, SMTP_PROTOCOL oder SMTPS_CERT konfigurieren, ignorieren die Agenten ihren Inhalt, und E-Mails werden von ihnen unter Verwendung des Standardverhaltens gesendet, mit Verwendung von SMTP_SERVER aber mit einer unverschlüsselten Verbindung und über den Standard-Port 25. Dieses Verhalten unterstützt die weitere Abwärtskompatibilität von Agenten, die SMTP unterstützen und vermutlich in Zukunft keine SMTP-bezogenen Änderungen erhalten werden.

  • Neustart erforderlich: Nein

Siehe auch: