NOTIFY-Befehl

Konzept-Informationen

E-Mail-Benachrichtigungen aus Analytics senden

Leitet eine ausgehende E-Mail-Benachrichtigung an einen SMTP-Mail-Server für die Zustellung an Empfänger weiter.

Syntax

Syntax für authentifizierte Befehle

NOTIFY SMTP SMTPUSER SMTP_Kontoname PORT Portnummer <ENABLESSL> USER Absender_Email PASSWORD verschlüsseltes_Kennwort MAILBOX SMTP_Servername ADDRESS Empfänger_Email <CC Cc_Empfänger_Email> <BCC Bcc_Empfänger_Email> SUBJECT Betreffzeile MESSAGE Nachrichtentext <ATTACHMENT Dateipfad>

Syntax für nicht authentifizierte Befehle

Hinweis

Diese ältere Version des NOTIFY-Befehls ist für lokale Mail-Systeme oder SMTP-Mail-Server gedacht, die keine Authentifizierung erfordern. Sie funktioniert nicht mit modernen E-Mail-Systemen, für die in der Regel eine Authentifizierung erforderlich ist.

NOTIFY USER Absender_Email <PASSWORD verschlüsseltes_Kennwort> MAILBOX SMTP_Servername ADDRESS Empfänger_Email <CC Cc_Empfänger_Email> <BCC Bcc_Empfänger_Email> SUBJECT Betreffzeile MESSAGE Nachrichtentext <ATTACHMENT Dateipfad>

Parameter

Name Beschreibung
SMTP

Gibt an, dass eine authentifizierte Übermittlung an einen SMTP-Server (Simple Mail Transfer Protocol) erfolgt.

  • SMTP angeben Ihr SMTP-Server erfordert authentifizierte Verbindungen

  • SMTP nicht angeben Sie verwenden einen offenen SMTP-Server und verbinden sich mit Port 25 oder einem lokalen E-Mail-System, das keine Authentifizierung erfordert

Hinweis

Nahezu alle modernen E-Mail-Systeme, die SMTP verwenden, erfordern eine Authentifizierung.

Sie müssen SMTP angeben, um die folgenden Parameter zu aktivieren:

  • SMTPUSER

  • PORT

  • ENABLESSL

SMTPUSER SMTP_Kontoname

Der Name des Benutzerkontos für die Authentifizierung und den Zugriff auf den SMTP-Server.

Wenn Sie SMTPUSER auslassen, wird die mit USER angegebene Absender-E-Mail-Adresse für den Zugriff auf ein lokales Mail-System oder einen SMTP-Mail-Server, der keine Authentifizierung erfordert, verwendet.
PORT Portnummer

Die Portnummer für den Zugriff auf den SMTP-Server.

Möglicherweise müssen Sie bei Ihrer IT-Abteilung nach dem richtigen Port fragen. Häufige Portnummern für SMTP-Server:

  • 587
  • 2525
  • 465

Sie müssen PORT verwenden, wenn Sie SMTPUSER angeben. Wenn Sie SMTPUSER auslassen, können Sie auch PORT weglassen. Dann wird der Standardport 25 verwendet.

ENABLESSL

Optional

Legt den Zugriff auf den SMTP-Server über eine sichere SMTP/SSL-Verbindung fest.

Ggf. müssen Sie Ihre IT-Abteilung kontaktieren, um herauszufinden, ob Ihr SMTP-Server eine SSL-Verbindung erfordert. Oder senden Sie Test-E-Mails mit und ohne Angabe von ENABLESSL.
USER Absender_Email

Definiert eine Absender-E-Mail-Adresse für die über den SMTP-Server gesendeten E-Mail-Benachrichtigungen.

Hinweis

Je nachdem, wie Ihr SMTP-Server konfiguriert ist, entsprechen USER und SMTPUSER möglicherweise demselben Konto.
PASSWORD verschlüsseltes_Kennwort

Das Kennwort des Benutzerkontos für den SMTP-Server. Das Kennwort muss als verschlüsselte Zeichenfolge angegeben werden.

Weitere Informationen finden Sie unter Verschlüsseltes Kennwort generieren.

Für den Zugriff auf ein lokales Mail-System oder einen SMTP-Mail-Server, der keine Authentifizierung erfordert, ist möglicherweise kein Kennwort erforderlich.
MAILBOX SMTP_Servername

Der Domänenname des SMTP-Servers für das Senden der E-Mail-Nachricht. Beispiel:

MAILBOX "smtp.example.com"
ADDRESS Empfänger_Email

Die E-Mail-Adresse eines oder mehrerer Empfänger.

Trennen Sie mehrere E-Mail-Adressen mit einem Komma. Geben Sie maximal 1020 Zeichen ein.
CC Cc_Empfänger_Email

Optional

Die E-Mail-Adresse eines oder mehrerer Kopienempfänger.

Trennen Sie mehrere E-Mail-Adressen mit einem Komma. Geben Sie maximal 1000 Zeichen ein.
BCC Bcc_Empfänger_Email

Optional

Die E-Mail-Adresse eines oder mehrerer nicht sichtbarer Kopienempfänger (Bcc).

Trennen Sie mehrere E-Mail-Adressen mit einem Komma.
SUBJECT Betreffzeile Die Betreffzeile der E-Mail-Nachricht.
MESSAGE Nachrichtentext

Der Textkörper der E-Mail-Nachricht.

Die Nachricht besteht aus unformatiertem Text und unterstützt kein HTML. Wenn Sie in Ihre Nachricht einen Zeilenumbruch einfügen möchten, verwenden Sie zwei Karatzeichen: ^^.
ATTACHMENT Dateipfad

Optional

Der Pfad und Dateiname eines oder mehrerer E-Mail-Anhänge.

Sie müssen keinen Pfad angeben, wenn die Datei im gleichen Ordner gespeichert ist wie das Analytics-Projekt.

Setzen Sie den Pfad und den Dateinamen in Anführungszeichen. Geben Sie mehrere Anhänge an, indem Sie eine durch Kommas getrennte Dateiliste für Dateipfad eingeben:

ATTACHMENT "result1.csv,result2.csv"

Hinweis

In einer Liste mit durch Kommas getrennten Werten dürfen keine Leerzeichen hinter den Kommas stellen.

Beispiele

E-Mail mit Fehlerbericht senden

Hinweis

Syntax für authentifizierte Befehle.

Sie führen ein Skript aus und möchten eine E-Mail-Benachrichtigung senden, falls das Skript fehlschlägt. Mit NOTIFY definieren Sie die E-Mail-Nachricht und fügen zwei Anhänge hinzu:

  • die Protokolldatei
  • eine .fil-Datei mit den aufgezeichneten Fehlern
NOTIFY SMTP SMTPUSER "mail_admin@example.com" PORT 587 ENABLESSL USER "support@company.com" PASSWORD "9QZC2524830864..." MAILBOX "smtp.company.com" ADDRESS "script_admin@company.com" SUBJECT "Fehlerbericht" MESSAGE "Das Skript konnte nicht ausgeführt werden. Details angehängt." ATTACHMENT "Fehler.fil;ACL_Demo.log"

E-Mail mit Fehlerbericht senden

Hinweis

Syntax für nicht authentifizierte Befehle.

Sie führen ein Skript aus und möchten eine E-Mail-Benachrichtigung senden, falls das Skript fehlschlägt. Mit NOTIFY definieren Sie die E-Mail-Nachricht und fügen zwei Anhänge hinzu:

  • die Protokolldatei
  • eine .fil-Datei mit den aufgezeichneten Fehlern
NOTIFY USER "support@company.com" MAILBOX "mail.company.com" ADDRESS "script_admin@company.com" SUBJECT "Fehlerbericht" MESSAGE "Das Skript konnte nicht ausgeführt werden. Details angehängt." ATTACHMENT "Fehler.fil;ACL_Demo.log"

Bemerkungen

Empfänger und Anhänge

Sie können den Befehl NOTIFY verwenden, um Benachrichtigungen an einen oder mehrere Empfänger zu senden. An die Meldungen können Datendateien und Analytics-Projekte angehängt werden.

Eine häufige Verwendung des NOTIFY-Befehls besteht darin, die entsprechenden Mitarbeiter über das unerwartete Fehlschlagen eines Skripts zu benachrichtigen.

Kompatible SMTP-Server

Der NOTIFY-Befehl kann mit einem beliebigen E-Mail-Server verwendet werden, der SMTP (Simple Mail Transfer Protocol) unterstützt, und sollte mit einer Vielzahl von SMTP-Servern funktionieren, die authentifizierte Verbindungen erfordern. Er funktioniert jedoch nicht mit allen SMTP-Servern oder -Diensten. Beispielsweise funktioniert NOTIFY nicht mit Gmail. Damit sich externe Apps mit einem Google-Konto verbinden können, ist eine Sicherheitskonfiguration erforderlich, die über den von NOTIFY unterstützten Benutzernamen und das Kennwort hinausgeht.

Beachten Sie allgemein, dass eine kompatible Konfiguration auf der Analytics-Seite und auch auf der Seite des SMTP-Servers erforderlich ist, damit Sie NOTIFY erfolgreich dazu verwenden können, ausgehende E-Mails an einen SMTP-Server zu übermitteln. Wenn NOTIFY keine Verbindung herstellen und nicht erfolgreich E-Mails senden kann, stellen Sie gemeinsam mit Ihrer IT-Abteilung sicher, dass eine kompatible Verbindungskonfiguration zwischen Analytics und dem Server existiert.

Verschlüsseltes Kennwort generieren

Hinweis

Analytics unterstützt eine maximale Länge von 30 Zeichen beim Angeben eines Serverprofil-Kennworts, Datenbankprofil-Kennworts oder Mail-Server-Kennworts. Wenn Sie einen längeren Kennwortwert angeben, wird das Kennwort abgeschnitten und die Verbindung kann nicht hergestellt werden.

Sie müssen ein verschlüsseltes Kennwort mit dem PASSWORD-Parameter im NOTIFY-Befehl angeben. Um ein Kennwort für die Verwendung mit NOTIFY zu verschlüsseln, müssen Sie das Kennwort im Dialogfeld Benachrichtigen der Analytics-Benutzeroberfläche eingeben.

  1. Optional. Geben Sie in Analytics in die Befehlszeile SET NOTIFYRETRYATTEMPTS TO 0 ein.

    Durch das temporäre Deaktivieren von erneuten NOTIFY-Versuchen wird die Erzeugung des verschlüsselten Passworts beschleunigt.

  2. Wählen Sie im Analytics-Hauptmenü Extras > Per E-Mail benachrichtigen aus.Analytics

  3. Füllen Sie die Pflichtfelder und die erforderlichen optionalen Felder im Dialogfeld Benachrichtigen aus:

    Absender Absender_Email Erforderlich
    Kennwort

    Das Kennwort des Benutzerkontos für den SMTP-Server in Klartext.

    Hinweis

    Wenn das Kennwort mehr als 30 Zeichen enthält, verläuft der NOTIFY-Befehl nicht erfolgreich.

    		 Erforderlich
    Mailbox-Pfad SMTP_Servername Erforderlich
    Nach Empfänger_Email Erforderlich
    Cc Cc_Empfänger_Email Optional
    Bcc Bcc_Empfänger_Email Optional
    Thema Betreffzeile Erforderlich
    Text Nachrichtentext Erforderlich
    Anhang Dateipfad Optional

  4. Klicken Sie auf OK.

    Wenn Sie eine Verbindung zu einem SMTP-Server herstellen, der eine Authentifizierung erfordert, kann die Verbindung nicht hergestellt werden, selbst wenn der NOTIFY-Befehl erfolgreich erscheint. Das ist aber normal.

  5. Kopieren Sie den NOTIFY-Befehl aus dem Protokoll und fügen Sie ihn in ein Skript ein.

    Der NOTIFY-Befehl enthält jetzt einen verschlüsselten Wert für PASSWORD.

  6. Fügen Sie die folgenden Parameter zum kopierten NOTIFY-Befehl im Skript hinzu und geben Sie geeignete Parameterwerte an.

    Sie können die Parameter direkt nach dem Schlüsselwort NOTIFY einfügen.

    • SMTP

    • SMTPUSER SMTP_Kontoname

    • PORT Portnummer

    • ENABLESSL (falls erforderlich)

  7. Wenn Sie die Anzahl der erneuten NOTIFY-Versuche zuvor auf 0 festlegen, geben Sie SET NOTIFYRETRYATTEMPTS TO 5 in die Befehlszeile ein.

    Wenn Sie ursprünglich eine andere Anzahl von erneuten Versuchen angegeben hatten, geben Sie statt 5 die entsprechende Zahl ein.

  8. Führen Sie das Skript aus, um den NOTIFY-Befehl zu testen.

    Wenn alle erforderlichen Werte korrekt für den SMTP-Mail-Server konfiguriert sind, sollte der NOTIFY-Befehl jetzt erfolgreich verlaufen.

So reagiert Analytics auf fehlgeschlagene Verbindungsversuche

Wenn Analytics nicht in der Lage ist, sich mit dem Mailserver zu verbinden, führt es fünf zusätzliche Verbindungsversuche aus und legt zwischen diesen Versuchen jeweils eine Pause von 10 Sekunden ein. Diese automatische Wiederholungsfunktion behebt das Problem, dass ein E-Mail-Server kurz nicht verfügbar ist.

Wenn alle Verbindungsversuche scheitern, wird der Befehl NOTIFY abgebrochen. Dies wird im Protokoll vermerkt, das Skript mit dem Befehl wird jedoch weiter ausgeführt.

Mithilfe des Befehls SET können Sie die Standardvorgehensweise für erneute Versuche ändern. Sie können Folgendes festlegen:

  • eine andere Anzahl von Verbindungsversuchen

  • keine zusätzlichen Verbindungsversuche

  • eine andere Zeitspanne zwischen Versuchen

  • fehlgeschlagenes Skript, wenn der NOTIFY-Befehl keine Verbindung herstellen kann und abgebrochen wird

Weitere Informationen über den SET-Befehl finden Sie unter SET-Befehl.

SET-Befehlssyntax Beispiele und Anmerkungen

SET NOTIFYRETRYATTEMPTS <TO> Zahl

 
SET NOTIFYRETRYATTEMPTS TO 10

Standardmäßige Einstellung: 5 Versuche

Gibt an, wie oft der NOTIFY-Befehl versucht, eine E-Mail zu versenden, falls der erste Versuch nicht erfolgreich war. Geben Sie eine Zahl von 0 bis 255 ein. Wenn Sie 0 eingeben, werden nach dem ersten Fehlversuch keine zusätzlichen Versuche mehr unternommen.

Ein möglicher Grund, weshalb der Befehl NOTIFY keine E-Mails senden kann, ist eine fehlende Erreichbarkeit des E-Mail-Servers.

SET NOTIFYRETRYINTERVAL <TO> Sekunden

 
SET NOTIFYRETRYINTERVAL TO 30

Standardmäßige Einstellung: 10 Sekunden

Gibt die Zeit in Sekunden an, die zwischen Wiederholungsversuchen (NOTIFYRETRYATTEMPTS) gewartet wird. Geben Sie eine Zahl von 1 bis 255 ein.

SET NOTIFYFAILSTOP {ON | OFF}

 
SET NOTIFYFAILSTOP ON

Standardeinstellung: OFF

  • NOTIFYFAILSTOP ist OFF Analytics erlaubt die weitere Ausführung eines Skripts, wenn ein NOTIFY-Befehl innerhalb des Skripts fehlschlägt.Analytics
  • NOTIFYFAILSTOP ist ON Analytics stoppt ein Skript, wenn ein NOTIFY-Befehl innerhalb des Skripts fehlschlägt, und schreibt eine Meldung in das Protokoll. Das Skript stoppt nach dem ersten Fehlversuch oder nach der angegebenen Anzahl der Wiederholungsversuche (NOTIFYRETRYATTEMPTS), falls keiner der Versuche erfolgreich war.

Hinweis

Ein ungültiger E-Mail-Empfänger wird nicht als ein Fehlschlagen des Befehls NOTIFY betrachtet und wird ein Skript unabhängig von der NOTIFYFAILSTOP-Einstellung nicht stoppen.