Benachrichtigung (CALL)

Benachrichtigungsobjekte sind angepasste Meldungen und Anfragen, die anderen ausführbaren Objekten zugewiesen werden können. Wenn die Ausführung eines Objekts eine Benachrichtigung auslöst, wird entweder eine E-Mail oder eine Online-Meldung gesendet. Die Benachrichtigung liefert Informationen oder erfordert eine Benutzerinteraktion als Reaktion auf die Ausführung des Objekts.

Als Administrator oder als Entwickler und Objektdesigner erstellen Sie Benachrichtigungen und weisen sie ausführbaren Objekten zu. Es gibt vier verschiedene Vorlagen zum Erstellen von Benachrichtigungen, je nach Art des benötigten Inhalts. Für jede Vorlage können Sie den Meldungstyp auswählen.

Als Operator erhalten Sie Benachrichtigungen und reagieren dementsprechend auf sie. Dabei handelt es sich um E-Mails oder Online-Meldungen. Sie greifen auf die Online-Meldungen zu, indem Sie entweder auf das Glockensymbol in der Menüleiste oder auf den Link in der Web-Benachrichtigung klicken, die von Ihrem Browser gesendet wird.

Beispiel: Ein Job benötigt in der Regel einige Minuten, um erfolgreich abzuschließen. Wenn die Ausführung des Jobs länger dauert, könnte ein Fehler aufgetreten sein. Sie möchten so bald wie möglich über diese Situation informiert werden. Zu diesem Zweck erstellen Sie ein Benachrichtigungsobjekt und weisen es dem Job zu. Sie weisen es im Abschnitt Aktionen bei Laufzeitabweichungen auf der Seite Laufzeit der Jobdefinition zu.

Weitere Informationen finden Sie hier:

• Eingabeaufforderungen (Anfragen)
• Seite "Laufzeit"

Objektklasse: Ausführbares Objekt

Objekttyp/Kurzform: CALL

Standard-Objektvorlagen: ALARM, MAIL, STANDARD, SLM

Benachrichtigungsvorlagen

Wenn Sie ein Benachrichtigungsobjekt erstellen, müssen Sie eine Vorlage auswählen. Die folgenden Vorlagen stehen zur Verfügung:

• ALARM
• MAIL
• SLM
• STANDARD

Alle Vorlagen mit Ausnahme von STANDARD enthalten einige vordefinierte Einstellungen und ein für die Vorlage spezifisches Script auf der Seite Prozess. Sie können die vordefinierten Einstellungen ändern.

Inhalt

Das Script bestimmt den Inhalt der Meldung, die gesendet wird. Das Script verwendet Script-Variablen, die Daten (Aufgabenname, RunID usw.) aus den Objekten, auf die sie verweisen, lesen und die Daten in den Meldungstext schreiben. Der Meldungstext wird in der Sprache geliefert, die Sie bei der Anmeldung ausgewählt haben.

Meldungstyp

Wenn Sie die Einstellungen für das Benachrichtigungsobjekt definieren, wählen Sie den Typ der Meldung aus, die gesendet werden soll. Dies kann Anfrage, Meldung, Alarm oder E-Mail sein.

• Anfrage

  Anfragen können Online-Meldungen oder E-Mails sein. Die Empfänger können sie akzeptieren oder ablehnen. Anfragen können eskaliert werden.

• Meldung

  Meldungen können Online-Meldungen oder E-Mails sein. Sie können nur von den Empfängern bestätigt werden. Meldungen können nicht eskaliert werden.

• Alarm

  Anfragen können Online-Meldungen oder E-Mails sein. Die Empfänger können sie akzeptieren oder ablehnen. Alarme können eskaliert werden.

  • Mit der Annahme der Anforderung übernimmt der Empfänger die Verantwortung für die Lösung des Problems.

  • Wenn der Empfänger oder der letzte von mehreren Empfängern die Anfrage ablehnt oder wenn er nicht innerhalb des angegebenen Zeitraums reagiert, kann folgendes passieren:

    • Wenn Sie das Objekt zum Senden eines Eskalations-Benachrichtigungsobjekts konfiguriert haben, wird es gesendet.
    • Wenn Sie keine Eskalation konfiguriert haben, wird die ursprüngliche Benachrichtigung erneut gesendet.

• E-Mail

  E-Mail-Benachrichtigungen können nicht eskaliert werden.

Eskalation

Sie können Alarme und Anfragen konfigurieren, um eine Eskalation auszulösen. Unter bestimmten Bedingungen (die Anfrage, die Sie senden, bleibt unbemerkt oder wird abgelehnt) wird ein anderes Benachrichtigungsobjekt gesendet.

ALARM-Benachrichtigungen

Die ALARM-Vorlage wurde entwickelt, um Anfragen in Situationen zu erstellen, in denen Sie eine Alarmmeldung senden möchten. Der Benutzer, der das Objekt ausführt, dem der Alarm zugewiesen wird, wird automatisch als Empfänger der Meldung angegeben.

Beispiele für Scripting finden Sie unter Beispiele für Scripting von Benachrichtigungsobjekten.

MAIL-Benachrichtigungen

MAIL-Benachrichtigungen sind Vorlagen für den Versand von E-Mail-Meldungen.

Voraussetzungen

Damit Ihr System E-Mails versenden kann, muss der Systemadministrator die E-Mail-Verbindung in der Variablen UC_CLIENT_SETTINGS konfigurieren. Die Schlüssel SMTP_SERVER und SMTP_FROM_ADDR in der Variablen müssen die Details Ihres SMTP-Servers, den Servernamen und die Absenderadresse für Ihre E-Mails enthalten.

Weitere Informationen finden Sie unter UC_CLIENT_SETTINGS - Verschiedene Client-Einstellungen.

SLM-Benachrichtigungen

SLM-Benachrichtigungen unterscheiden sich etwas. Sie werden von der Service Level Agreement (SLA)-Funktion verwendet. SLO-Objekte geben Aktionen an, die das System ausführen soll, wenn ein Dienst (ausführbare Objekte) erfüllt/nicht erfüllt wird. Benachrichtigungen zu senden ist eine der Möglichkeiten.

Folgende SLM-Benachrichtigungsvorlagen stehen zur Verfügung:

• FULFILLMENT_MAIL-Benachrichtigung

  Diese Vorlage erstellt eine E-Mail

• FULFILLMENT-Benachrichtigung

  Dieses Vorlage erstellt eine Anfrage.

SLO-spezifische Script-Variablen

Die Automation Engine stellt die folgenden Script-Variablen in Bezug auf SLO-Objekte zur Verfügung. Diese rufen Daten über die überwachten Dienste ab. Sie zeigen auch die Gründe an, warum die geforderten Kriterien nicht erfüllt wurden:

• &uc_slm_slo_name#
• &uc_slm_service_name#
• &uc_slm_service_runid#
• &uc_slm_service_time#
• &uc_slm_violation_msg_number#
• &uc_slm_violation_msg_insert#

Weitere Informationen finden Sie unter Service Level Objective (SLO).

STANDARD-Benachrichtigungen

STANDARD-Benachrichtigungen sind hilfreich, wenn Sie Ihre eigenen Meldungen definieren möchten.

Vordefinierte Einstellungen

Die folgende Tabelle gibt an, welche Parameter in jeder Benachrichtigungsvorlage standardmäßig festgelegt werden. Sie können diese Einstellungen ändern:

Vordefinierte Einstellungen	ALARM	MAIL	STANDARD	SLM
Meldungstyp	Alarm	E-Mail	Anfrage	E-Mail
Priorität	Hoch	Hoch	Hoch	Normal
Script	Ja	Ja Das Script enthält Variablen, die Werte aus dem Read-Buffer abrufen.	Nein	Ja
Reports mitsenden	&UC_CAUSE_NR	&UC_CAUSE_NR	Nein	&uc_slm_service_runid#
Text der Meldung	Nein	Im HTML-Format mit Layout-Anweisungen. Sie verwendet Variablen, die die wichtigsten Daten der Aufgabe abrufen, wie z. B. Name, RunID, Mandant, auf dem sie ausgeführt wird, Status, Startzeit und Informationen über das Parent-Element (falls vorhanden).	Nein	Im HTML-Format mit Layout-Anweisungen. Verwendet die SLO-spezifischen Script-Variablen

Benachrichtigungsobjekte definieren

Die Definition eines Benachrichtigungsobjekts besteht aus den folgenden Seiten:

• Standardseiten, die unabhängig von dem von Ihnen definierten Objekttyp zu jeder Zeit verfügbar sind:
• Seite "Allgemein"
• Seite "Versionsmanagement"
• Seite "Dokumentation"
• Für ausführbare Objekte sind immer die folgenden Seiten verfügbar:
• Prozess-Seiten
• Seite "Attribute"
• Seite "Variablen"
• Seite "PromptSets"
• Seite "Rollback"
• Die hier beschriebene, objektspezifische Seite.

Definieren von benachrichtigungsspezifischen Einstellungen

1. Definieren Sie auf der Seite Benachrichtigung die Empfänger der Benachrichtigungen.

   Für ALARM-Benachrichtigungen ist dieser Abschnitt so konfiguriert, dass der Anwender, der das Objekt ausführt, als Empfänger der Meldungen festgelegt wird. Sie können zusätzliche angeben.

   Zulässige Eingabe: Benutzer, E-Mail oder Variable.

   1. Wählen Sie unter Empfänger eine Variable, einen Benutzer oder eine Benutzergruppe aus. Geben Sie den Namen des Benutzers ein oder wählen Sie ihn in der Liste aus. Sie können auch eine E-Mail-Adresse eingeben.
   2. Wählen Sie optional einen Kalender und eines der Kalenderereignisse, die ihm zugewiesen sind. Die Benachrichtigung wird gesendet, wenn diese Kalenderbedingung zutrifft.
   3. Klicken Sie auf Hinzufügen, um diese Kombination von Empfängern und Daten zuzuordnen. Sie können beliebig viele Kombinationen hinzufügen.

2. Wenn Sie eine andere Vorlage als STANDARD auswählen, sind Betreff und Textkörper im Abschnitt Meldung vordefiniert.

   Gehen Sie wie folgt vor, um sie zu ändern:

   1. Geben Sie den Betreff ein oder klicken Sie auf das Variablensymbol, um einen einzufügen. Wenn Sie das Feld leer lassen, wird automatisch ein E-Mail-Betreff erstellt. Dieser Betreff lautet wie folgt:

      Name des Benachrichtigungsobjekts + RunID + Mandant.

   2. Geben Sie den Text der Meldung ein. Sie können Variablen verwenden. Die Anzahl der Zeichen, die eingegeben werden können, ist unbegrenzt.

   Wichtig! Wenn Sie Ihre Texte mithilfe der Automation Engine-Scriptsprache auf der Seite Prozess eingeben, werden diese Einstellungen ignoriert.

3. Die Einstellungen variieren je nach gewählter Vorlage.

   1. Die Priorität dient nur zu Informationszwecken. Sie wird in den E-Mails und in den Online-Meldungen angezeigt.
   2. Der Typ bestimmt die Art des Versands und ob eine Eskalation möglich ist.

   3. Optional können Sie die SNMP-Verbindung aktivieren, um beim Start einer Benachrichtigung eine SNMP-Trap zu erstellen.

      Voraussetzungen:

      • SNMP muss auf dem Rechner installiert sein und als Dienst laufen.
      • Der AE SNMP-Sub-Agent muss installiert sein.
      • Die SNMP-Verbindung muss in der Automation Engine INI-Datei (ucsrv.ini) aktiviert werden, indem der SNMP-Parameter auf snmp=2 gesetzt wird.

      Diese Option ist für E-Mail-Benachrichtigungen nicht verfügbar.

      Tipp: Verwenden Sie die neueste JMX-Lösung statt die SNMP-Technologie. SNMP nutzt das weniger sichere UPD-Netzwerkprotokoll und unterstützt nicht den gesamten AE-Funktionsumfang.

4. Aktivieren Sie Zusätzlich E-Mail senden, um die Benutzer (Empfänger der Meldung) darüber zu informieren, dass die Benachrichtigung ausgelöst wurde. Die Adressen in den Benutzerobjektdefinitionen werden angewendet. Wurden dem verantwortlichen Benutzer zwei Adressen zugeordnet, wird die E-Mail an beide gesendet.

   Es kann auch festgelegt werden, dass Reports an die E-Mail angehängt werden sollen:

   1. (Nur Jobobjekte) Geben Sie unter Reports mitsenden die RunID der Aufgabe ein, die die Benachrichtigungs-E-Mail ausgelöst hat.

      Für jeden Reporttyp wird eine Datei gesendet. Der Name der Datei lautet wie folgt:

      RunID.report type.txt.

      Beispiel:002523059.LOG.txt.

      Die Optionen für die Quelle werden angezeigt. Dort können Sie angeben, wo die Reports abgerufen werden sollen.

      • Datenbank

        Es werden nur die Standard-Job-Reports mitgesendet, die sich in der Automation Engine-Datenbank befinden.

      • Externe Dateien

        Dateien, die sich auf dem Rechner des Agenten befinden, werden angehängt. Dies gilt auch für den Job-Report, wenn er als Datei gespeichert wurde. Dies gilt auch für registrierte Ausgabedateien, sofern verfügbar.

        Hinweis: Wenn die Automation Engine nicht auf dem gleichen Computer ausgeführt wird, auf dem sich die Datei befindet, die angehängt werden soll, können Sie die Datei an einen Speicherort kopieren, auf den die AE zugreifen kann, oder eine Netzwerkfreigabe für Ihren Ordner erstellen und diesen für die AE zugänglich machen.

        Der Empfänger muss bei externen Reports (EXTREP) und Jobs über das Recht Zugriff auf Reports verfügen. Ansonsten werden die Dateien nicht mitgesendet und eine Fehlermeldung in den Benachrichtigungsreport geschrieben.

        Außerdem muss der Agent aktiv sein, auf dem der Job durchgeführt wurde, und die Dateien müssenexistieren.

      • Alle

        Reports aus der Datenbank und vom Agenten-Rechner werden angehängt. Existiert derselbe Report in beiden, so wird dieser trotzdem nur einmal versendet.

        Sind Daten auf dem Agenten vorhanden, so werden zwei Mails gesendet (eine von der Automation Engine und eine vom Agenten).

   2. Tragen Sie unter AE-Anhang den Pfad und den Namen der anzuhängenden Datei ein. Die Datei muss sich in einem Verzeichnis befinden, auf das die E-Mail-Verbindung zugreifen darf.

      Maximale Länge: 255 Zeichen Wenn Sie Variablen verwenden, darf die Länge des Pfades bei der Auflösung der Variablen nicht länger als 255 Zeichen sein.

5. Die Eskalationsoption ist für E-Mail-Benachrichtigungen nicht verfügbar. Für alle anderen können Sie die Zeit festlegen, nach der eine zweite Benachrichtigung gesendet wird, wenn keine Antwort erfolgt.

6. Wenn Sie Beende aktuelle Benachrichtigung aktivieren, wird die ursprüngliche Benachrichtigung durch das Versenden der Folgebenachrichtigung automatisch mit dem Status ENDED_ESCALATED geschlossen.

Informationen aus dem Read-Buffer

Benachrichtigungen, die aufgrund der Bedingungen starten, die für Aufgaben in Workflows oder Schedules definiert sind, enthalten detaillierte Systeminformationen. Diese Informationen können im Script der Benachrichtigung aus dem Read-Buffer gelesen werden. Verwenden Sie zu diesem Zweck die Script-Anweisung :READ

• UC_CAUSE_NAME - Der Name der verursachenden Aufgabe.
• UC_CAUSE_NR - Die RunID der verursachenden Aufgabe.
• UC_CAUSE_STATE - Der Status der verursachenden Aufgabe.
• UC_CAUSE_RETCODE - Der Rückgabewert der verursachenden Aufgabe.

Beispiele

:READ &UC_CAUSE_NAME,,
:READ &UC_CAUSE_NR,,
:READ &UC_CAUSE_STATE,,
:READ &UC_CAUSE_RETCODE,,

Benachrichtigungen auslösen

Sie können Objekte zum Versenden von Benachrichtigungen wie folgt konfigurieren:

• Seite "Laufzeit"

  Wenn Sie die allgemeinen Einstellungen eines ausführbaren Objektes definieren, können Sie ihm eine maximale und eine minimale Laufzeit zuweisen. Wenn die für die Ausführung des Objekts benötigte Zeit von diesen Werten abweicht, können Sie eine Aufgabe vom System ausführen lassen. Bei dieser Aufgabe kann es sich um ein Benachrichtigungsobjekt handeln. Gleiches gilt für die Laufzeiten von Aufgaben, die in Workflows oder Schedules eingefügt werden.

• Seiten "Ausgabe" in Jobs

  Bei der Definition der Ausgabe können Sie einen Status angeben und das System anweisen, eine Benachrichtigung zu senden, wenn dieser erreicht ist.

• Seite "Attribute"

  Für Workflows (JOBP), Schedules (JSCH) und Remote Task Monitor (JOBQ). Sie können ein Benachrichtigungsobjekt vom System ausführen lassen, wenn eine Aufgabe einen bestimmten Status hat. 

• Prozess-Seiten

  Auf diesen Seiten können Sie mit der Automation Engine-Scriptsprache individuelle Benachrichtigungen erstellen. Klicken Sie hier für Beispiele für Scripting von Benachrichtigungsobjekten.

• Ergebniseigenschaften von Aufgaben in Schedules

  Auf der Registerkarte Ergebnis der Aufgabeneigenschaften definieren Sie, was mit der Aufgabe geschehen soll, je nach Status nach der Ausführung. Sie können auch festlegen, dass ein Benachrichtigungsobjekt je nach Status der Aufgabe ausgeführt wird. Weitere Informationen finden Sie unter Schedule-Objekte definieren.

• Zeit und Abhängigkeiten-Eigenschaften von Aufgaben in Workflows

  In der Regel beginnen Aufgaben in Workflows, sobald ihre Vorgänger beendet sind. Sie können jedoch mehrere Parameter in ihren Eigenschaften definieren, die sich auf die Aufgabensequenz im Workflow auswirken. Auf der Registerkarte Zeit & Abhängigkeiten definieren Sie Zeit- und Statusparameter, die sich auf den tatsächlichen Start einer Aufgabe auswirken. Sie können auch festlegen, dass ein anderes Objekt (z. B. eine Benachrichtigung) ausgeführt wird, wenn diese Parameter nicht erfüllt sind. Weitere Informationen finden Sie unter Zeit und Abhängigkeiten.

• Laufzeiteigenschaften von Aufgaben in Schedules und in Workflows

  Auf der Seite Laufzeit von ausführbaren Objekten definieren Sie die Parameter zur Berechnung der maximalen und minimalen Laufzeit von Aufgaben. Bei Abweichungen legen Sie fest, was geschehen soll. Sie können diese Definitionen ändern, wenn die Aufgabe innerhalb einer Schedule oder eines Workflows ausgeführt wird. Sie können auch festlegen, dass ein Benachrichtigungsobjekt ausgeführt wird, wenn Abweichungen vorliegen. Weitere Informationen finden Sie unter Schedule-Objekte definieren and Laufzeit-Eigenschaften (für Workflows).

Siehe auch:

• Beispiele für Scripting von Benachrichtigungsobjekten
• Sehen Sie sich das Video an: Einführung in Benachrichtigungen
• Sehen Sie sich das Video an: E-Mail-Benachrichtigungen einrichten
• Benachrichtigungsattribute
• UC_CLIENT_SETTINGS - Verschiedene Client-Einstellungen
• Web-Benachrichtigungen aktivieren.
• AWI-Kombinationsfelder verwenden
• Variablen/VARA-Objekte in Objekte und Scripts einfügen

Auf Benachrichtigungen reagieren:

• Eingabeaufforderungen (Anfragen)
• Möglichkeiten zum Auslösen von Anfragen
• Auf Anfragen reagieren