---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Ereignis -- Global

# Ereignis -- Global {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 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 gesendet MID-ServerBis A ServiceNowInstanz. Bevor Sie Ereignisse erfolgreich senden können, die Verbindung zwischen MID-ServerUnd ServiceNowInstanz 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 IEventAbsender API zum Senden des Ereignisses an einen ServiceNowInstanz.

Sie müssen das Ereignismanagement-Plugin (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](https://www.servicenow.com/docs/access?context=c_EM&version=yokohama&pubname=yokohama-it-operations-management&ft:locale=en-US).

## Ereignis -- Ereignis() {#ariaid-title2}

Instanziiert einen Ereigniskonstruktor.
{#Event-Event__table_zk1_mcl_jkb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 1. Parameter]

{#Event-Event__table_zk1_mcl_jkb}  

    var event = new Event();
    var esource = event.getField("source");
    var eseverity = event.getField("severity");       

## Ereignis -- getField (Zeichenfolgenfeld) {#ariaid-title3}

Gibt den aktuellen Wert des Felds „im Ereignismanagement übergeben" zurück.
{#Event-getField_S__table_ky4_4mk_jkb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Ausstehend | Zeichenfolge | Name des zurückzugebenden Ereignismanagement-Feldwerts. |
[Tabelle : 2. Parameter]

{#Event-getField_S__table_ky4_4mk_jkb} {#Event-getField_S__table_ly4_4mk_jkb__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Wert des Felds „angefordertes Ereignismanagement". |
[Tabelle : 3. Rückgaben]

{#Event-getField_S__table_ly4_4mk_jkb}  

    var event = new Event();
    var eventSource = event.getField("source");
    var eventSeverity = event.getField("severity");       

## Ereignis -- setAdditionalInfo(Zeichenfolge additionalInfo) {#ariaid-title4}

Ersetzt das vorhandene additional_infoFeld im zugeordneten Ereignis mit der übergebenen JSON-Zeichenfolge.
Hinweis:  
Sie können verwenden [SetField()](https://servicenow-prod.fluidtopics.net/qAavD4QPSPLMIIN_f3P9bA#Event-setField_S_S "Legt das angegebene Feld im zugeordneten Ereignis fest.")Methode zum Aktualisieren eines bestimmten Felds innerhalb von additional_infoFeld.
{#Event-setAdditionalInfo_S__table_pc2_dbh_kkb__entry__3}

| 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 : 4. Parameter]

{#Event-setAdditionalInfo_S__table_pc2_dbh_kkb} {#Event-setAdditionalInfo_S__table_qc2_dbh_kkb__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 5. Rückgaben]

{#Event-setAdditionalInfo_S__table_qc2_dbh_kkb}  

    event.setAdditionalInfo("{\"evtComponent\":\"Microsoft-Windows- WindowsUpdateClient\",\"evtMessage\":\"Installation Failure: Windows failed. Error 0x80070490\"}");

## Ereignis -- setField (Zeichenfolgenschlüssel, Zeichenfolgenwert) {#ariaid-title5}

Legt das angegebene Feld im zugeordneten Ereignis fest.
Wenn übergeben 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 die übergebene angewendet wird value.

Im Folgenden finden Sie die vordefinierten Ereignisfelder, die Sie mit dieser Methode ändern können:
{#Event-setField_S_S__table_ddd_32g_pkb__entry__2}

| Feld | Beschreibung |
|-|-|
| Zusätzliche_Info | Schlüssel-Wert-Paar, das hinzugefügt werden soll additional_infoFeld des zugeordneten 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"} `. 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 |
| Ereignis_Klasse | 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. Verwenden Sie dieselbe Option, um einen vorhandenen Ereignisschweregrad zu überschreiben 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 | Ereignisauflösungsstatus. Gültige Werte: * Neu: Lösungsstatus für das entsprechende Ereignis ist „Offen". * Schließen: Lösungsstatus für das entsprechende Ereignis ist „Schließen/Geschlossen". {#Event-setField_S_S__ul_szv_dmg_pkb} 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 |
| Schweregrad | Ereignisschweregrad. Gültige Werte: * 0: Löschen -- keine Aktion erforderlich. Aus diesem Ereignis wird keine Warnung erstellt. Vorhandene Warnungen werden geschlossen. * 1: OK -- eine Warnung wird erstellt. Die Ressource funktioniert noch. * 2: Warnung: Aufmerksamkeit ist erforderlich, auch wenn die Ressource noch funktionsfähig ist. * 3: Geringfügig: Teilweiser, nicht kritischer Verlust der Funktionalität oder Leistungsverschlechterung aufgetreten. * 4: Schwerwiegend: Schwerwiegende 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. {#Event-setField_S_S__ul_ol1_d4g_pkb} 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 |
| Typ | 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 |
[ ]

{#Event-setField_S_S__table_ddd_32g_pkb}  
Hinweis:  
Sie können auch verwenden [SetText()](https://servicenow-prod.fluidtopics.net/qAavD4QPSPLMIIN_f3P9bA#Event-setText_S "Legt fest descriptionFeld des dem übergebenen Wert zugeordneten Ereignisses.")Methode zum Aktualisieren von descriptionFeld und [SetTimeOfEvent()](https://servicenow-prod.fluidtopics.net/qAavD4QPSPLMIIN_f3P9bA#Event-setTimeOfEvent_S "Legt fest time_of_eventFeld im zugeordneten Ereignis zum übergebenen Zeitwert in UTC.")Methode zum Aktualisieren der Ereigniszeit.

Weitere Informationen zu Ereignissen finden Sie unter [Ereignismanagement](https://www.servicenow.com/docs/access?context=c_EM&version=yokohama&pubname=yokohama-it-operations-management&ft:locale=en-US).
{#Event-setField_S_S__table_ijd_4ck_jkb__entry__3}

| 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 Ereignissammlung](https://www.servicenow.com/docs/access?context=c_EMIntegrateRequirementEvent&version=yokohama&pubname=yokohama-it-operations-management&ft:locale=en-US). |
| Wert | Zeichenfolge | Informationen, die im zugehörigen Ereignisfeld gespeichert werden sollen. Hinweis: Die valueZeichenfolge wird vor dem Speichern gekürzt, wobei mehrere Bereiche durch einen einzigen Platz ersetzt werden. |
[Tabelle : 6. Parameter]

{#Event-setField_S_S__table_ijd_4ck_jkb} {#Event-setField_S_S__table_jjd_4ck_jkb__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 7. Rückgaben]

{#Event-setField_S_S__table_jjd_4ck_jkb}  

    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) {#ariaid-title6}

Legt fest descriptionFeld des dem übergebenen Wert zugeordneten Ereignisses.
Hinweis:  
Sie können auch verwenden [Ereignis -- setField (Zeichenfolgenschlüssel, Zeichenfolgenwert)](https://servicenow-prod.fluidtopics.net/qAavD4QPSPLMIIN_f3P9bA#Event-setField_S_S "Legt das angegebene Feld im zugeordneten Ereignis fest.")Methode zum Festlegen von textFeld im aktuellen Ereignis. Im Gegensatz zu SetField() Methode, diese Methode schneidet den übergebenen Text nicht ab.
{#Event-setText_S__table_r2j_mgh_kkb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| HTML | Zeichenfolge | Text, der in gespeichert werden soll descriptionFeld des zugeordneten Ereignisses. Max. Länge: 4000 Zeichen |
[Tabelle : 8. Parameter]

{#Event-setText_S__table_r2j_mgh_kkb} {#Event-setText_S__table_s2j_mgh_kkb__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 9. Rückgaben]

{#Event-setText_S__table_s2j_mgh_kkb}  

    var event = new Event();
    event.setText("SAP Solman");       

## Ereignis -- setTimeOfEvent(Zeichenfolge timeOfEvent) {#ariaid-title7}

Legt fest time_of_eventFeld im zugeordneten Ereignis zum übergebenen Zeitwert in UTC.
Hinweis:  
Sie können auch verwenden [Ereignis -- setField (Zeichenfolgenschlüssel, Zeichenfolgenwert)](https://servicenow-prod.fluidtopics.net/qAavD4QPSPLMIIN_f3P9bA#Event-setField_S_S "Legt das angegebene Feld im zugeordneten Ereignis fest.")Methode zum Festlegen von time_of_eventFeld.
{#Event-setTimeOfEvent_S__table_m43_kwg_kkb__entry__3}

| 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 : 10. Parameter]

{#Event-setTimeOfEvent_S__table_m43_kwg_kkb} {#Event-setTimeOfEvent_S__table_n43_kwg_kkb__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 11. Rückgaben]

{#Event-setTimeOfEvent_S__table_n43_kwg_kkb}  

    var event = new Event();
    event.setTimeOfEvent("2019-18-05 13:12:05");


