Ereignis – Global

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 4 Minuten Lesedauer

    • Die Ereignis Die API stellt Methoden bereit, die das Festlegen und Abrufen von Werten in einem Ereignis ermöglichen.

    Diese Ereignisse werden von einem gesendet MID-Server Bis A ServiceNow Instanz. Bevor Sie Ereignisse erfolgreich senden können, die Verbindung zwischen MID-Server Und ServiceNow Instanz muss definiert werden.

    Verwenden Sie Ereignis API zum Hinzufügen/Aktualisieren von Feldern innerhalb eines Ereignisses. Verwenden Sie SNEventSenderProvider API zum Instanziieren eines Ereignisabsenderobjekts. Verwenden Sie dann IEventSender API zum Senden des Ereignisses an einen ServiceNow Instanz.

    Sie müssen das Plugin „Ereignismanagement“ (com.glideapp.itom.snac) aktivieren, bevor Sie versuchen, auf diese API zuzugreifen. Das Ereignismanagement-Plugin erfordert ein separates Abonnement und muss aktiviert sein. Dieses Plugin enthält Demodaten und aktiviert zugehörige Plugins, wenn sie nicht bereits aktiv sind.

    Weitere Informationen zum Ereignismanagement finden Sie unter Ereignismanagement .

    Ereignis – Ereignis()

    Instanziiert einen Ereigniskonstruktor.

    Tabelle : 1. Parameter
    Name Typ Beschreibung
    Keine 
    var event = new Event();
var esource = event.getField("source");
var eseverity = event.getField("severity");

    Ereignis – getField(Zeichenfolgenfeld)

    Gibt den aktuellen Wert des Felds „im Ereignismanagement übergeben“ zurück.

    Tabelle : 2. Parameter
    Name Typ Beschreibung
    field Zeichenfolge Name des zurückzugebenden Ereignismanagement-Feldwerts.
    Tabelle : 3. Rückgaben
    Typ Beschreibung
    Zeichenfolge Wert des Felds „angefordertes Ereignismanagement“. 
    var event = new Event();
var eventSource = event.getField("source");
var eventSeverity = event.getField("severity");

    Ereignis – setAdditionalInfo(Zeichenfolge additionalInfo)

    Ersetzt die vorhandene additional_infoFeld im zugeordneten Ereignis mit der übergebenen JSON-Zeichenfolge.

    Hinweis:
    Sie können verwenden SetField() Methode zum Aktualisieren eines bestimmten Felds in additional_infoFeld.
    Tabelle : 4. Parameter
    Name Typ Beschreibung
    additionalInfo Zeichenfolge JSON-Zeichenfolge (Schlüssel-/Wert-Paare), die in gespeichert werden soll additional_infoFeld.
    Hinweis:
    Dieser Parameter ersetzt die vorhandenen Informationen. Die vorhandenen Felder werden nicht aktualisiert.
    Tabelle : 5. Rückgaben
    Typ Beschreibung
    void 
    event.setAdditionalInfo("{\"evtComponent\":\"Microsoft-Windows- WindowsUpdateClient\",\"evtMessage\":\"Installation Failure: Windows failed. Error 0x80070490\"}");

    Ereignis – setField (Zeichenfolgenschlüssel, Zeichenfolgenwert)

    Legt das angegebene Feld im zugehörigen Ereignis fest.

    Wenn übergeben wurde keyStimmt mit einem vordefinierten Ereignisfeld überein. Die Methode aktualisiert das entsprechende Ereignisfeld. Andernfalls fügt die Methode hinzu keyParameter für additional_infoAbschnitt des Ereignisses, bevor übergeben wird value.

    Im Folgenden finden Sie die vordefinierten Ereignisfelder, die Sie mit dieser Methode ändern können:

    Feld Beschreibung
    additional_info Schlüssel-Wert-Paar, das dem hinzugefügt werden soll additional_infoFeld des zugehörigen Ereignisses. Wenn der übergebene Schlüssel bereits vorhanden ist, wird sein Wert überschrieben.

    Maximale Länge: 4.000 Zeichen

    Zugehöriges UI-Feld: Zusätzliche Informationen
    ci_Identifier JSON-Zeichenfolge, die ein Konfigurationselement eindeutig identifiziert. Beispiel: {"name":"SAP ORA01","type":"Oracle"} ({"Name": "SAP ORA01", "Typ": "Oracle"}).

    Maximale Länge: 1.000 Zeichen
    cmdb_ci SYS_ID des Konfigurationselement-Datensatzes [cmdb_ci], an den das Ereignis gebunden werden soll.

    Standard: Null
    Beschreibung Freiform-Beschreibung des Ereignisses.

    Maximale Länge: 4.000 Zeichen

    Zugehöriges UI-Feld: Beschreibung

    Standard: Null
    event_class Enterprise Message Service (EMS), der das Ereignis generiert hat. Beispiel: „SolarWinds“ oder „SCOM“.

    Maximale Länge: 100

    Zugehöriges UI-Feld: Quellinstanz

    Standard: Null
    message_key Eindeutiger Ereignisbezeichner. Um einen vorhandenen Ereignisschweregrad zu überschreiben, verwenden Sie denselben message_keyWert.

    Maximale Länge: 1024 Zeichen

    Zugehöriges UI-Feld: Nachrichtenschlüssel

    Standard: Kombination von source, node, type, resource, Und metric name.
    resolution_state Ereignislösungsstatus.
    Gültige Werte:
    • Neu: Der Lösungsstatus für das entsprechende Ereignis ist „Offen“.
    • Schließen: Lösungsstatus für das entsprechende Ereignis ist „Schließen/Geschlossen“.

    Zugehöriges UI-Feld: Lösungsstatus

    Standard: Neu
    Ressource Knotenressource, die dem Ereignis zugeordnet werden soll. Beispiel: „Datenträger C:“, „CPI-1“ oder der Name eines Prozesses oder Service.

    Maximale Länge: 100 Zeichen

    Zugehöriges UI-Feld: Ressource
    severity Ereignisschweregrad.
    Gültige Werte:
    • 0: Löschen – keine Aktion erforderlich. Aus diesem Event wird keine Warnung erstellt. Vorhandene Warnungen werden geschlossen.
    • 1: OK – eine Warnung wird erstellt. Die Ressource ist weiterhin funktionsfähig.
    • 2: Warnung: Aufmerksamkeit ist erforderlich, auch wenn die Ressource noch funktionsfähig ist.
    • 3: Geringfügig: Ein teilweiser, nicht kritischer Verlust der Funktionalität oder Leistungsverschlechterung ist aufgetreten.
    • 4: Schwerwiegend: Wichtige Funktionalität ist stark beeinträchtigt oder die Leistung hat sich verschlechtert.
    • 5: Kritisch – sofortige Aktion erforderlich. Die Ressource funktioniert entweder nicht, oder kritische Probleme stehen unmittelbar bevor.

    Zugehöriges UI-Feld: Schweregrad

    Standard: Null
    Quelle Instanz der EMS, die das Ereignis ausgelöst hat. Normalerweise der Name der Connector-Instanz.

    Maximale Länge: 200 Zeichen

    Zugehöriges UI-Feld: Quelle

    Standard: Null
    time_of_event UTC-Zeit, zu der das Ereignis im Quellsystem aufgetreten ist.

    Format: „jjjj-MM-TT HH:mm:ss“

    Maximale Länge: 40 Zeichen

    Zugehöriges UI-Feld: Zeit des Ereignisses

    Standard: Aktuelles Datum/aktuelle Uhrzeit
    type Metriktyp, zu dem das Ereignis gehört, z. B. Datenträger oder CPU. Dieser Wert wird verwendet, um einen Ereignisdatensatz zu identifizieren, aus dem Warnungen erstellt werden.

    Maximale Länge: 100 Zeichen

    Zugehöriges UI-Feld: Typ

    Standard: Null
    Hinweis:
    Sie können auch verwenden SetText() Methode zum Aktualisieren von descriptionFeld und SetTimeOfEvent() Methode zum Aktualisieren der Ereigniszeit.

    Weitere Informationen zu Ereignissen finden Sie unter Ereignismanagement .

    Tabelle : 6. Parameter
    Name Typ Beschreibung
    key Zeichenfolge Name des Schlüssels, der im Ereignis hinzugefügt oder aktualisiert werden soll. Weitere Informationen zu den vordefinierten Ereignisfeldern finden Sie unter Ereignisfeldformat für die Ereignissammlung .
    Wert Zeichenfolge Informationen, die im Feld „zugehöriges Ereignis“ gespeichert werden sollen.
    Hinweis:
    Die valueZeichenfolge wird vor dem Speichern gekürzt, wobei mehrere Bereiche durch einen einzigen Platz ersetzt werden.
    Tabelle : 7. Rückgaben
    Typ Beschreibung
    void 
    var event = new Event();
event.setField("source","SAP Solman");
event.setField("severity","3");
event.setField("time_of_event", "2019-18-05 13:12:05");
event.setField("type", "SAP object");
event.setField("user", "admin"); // parameter will be added to additional_info section

    Ereignis – setText(Zeichenfolgentext)

    Legt fest descriptionFeld des dem übergebenen Wert zugeordneten Ereignisses.

    Hinweis:
    Sie können auch verwenden Ereignis – setField (Zeichenfolgenschlüssel, Zeichenfolgenwert) Methode zum Festlegen von textFeld im aktuellen Ereignis. Im Gegensatz zu SetField() Methode, diese Methode schneidet den übergebenen Text nicht ab.
    Tabelle : 8. Parameter
    Name Typ Beschreibung
    text Zeichenfolge Text, der in gespeichert werden soll descriptionFeld des zugehörigen Ereignisses.

    Max. Länge: 4000 Zeichen
    Tabelle : 9. Rückgaben
    Typ Beschreibung
    void 
    var event = new Event();
event.setText("SAP Solman");

    Ereignis – setTimeOfEvent(Zeichenfolge timeOfEvent)

    Legt fest time_of_eventFeld im zugeordneten Ereignis zum übergebenen Zeitwert in UTC.

    Hinweis:
    Sie können auch verwenden Ereignis – setField (Zeichenfolgenschlüssel, Zeichenfolgenwert) Methode zum Festlegen von time_of_eventFeld.
    Tabelle : 10. Parameter
    Name Typ Beschreibung
    TimeOfEvent Zeichenfolge UTC-Zeitwert, der in festgelegt werden soll time_of_eventFeld.

    Format: „jjjj-MM-TT HH:mm:ss“

    Max. Länge: 40 Zeichen
    Tabelle : 11. Rückgaben
    Typ Beschreibung
    void 
    var event = new Event();
event.setTimeOfEvent("2019-18-05 13:12:05");