--- sourceDocument: Xanadu-API-Referenz sourceDocumentLink: https://www.servicenow.com/docs/r/de-DE/xanadu/api-reference Release : - xanadu ft:locale : - de-DE ft:publication_title : - Xanadu-API-Referenz ft:clusterId : - crapiref bundleId : - crapiref workflow : - Creator --- # Ereignis : Global # Ereignis : Global {#ariaid-title1} * Freigeben Version: Xanadu * * Aktualisiert 1. August 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 Minuten Lesedauer Die Ereignis -API stellt Methoden bereit, mit denen Werte in einem Ereignis festgelegt und abgerufen werden können. Diese Ereignisse werden von einer MID-Server - an eine ServiceNow -Instanz gesendet. Bevor Sie erfolgreich Ereignisse senden können, muss die Verbindung zwischen den Instanzen MID-Server und ServiceNow definiert werden. Verwenden Sie die Ereignis -API, um Felder in einem Ereignis hinzuzufügen/zu aktualisieren. Verwenden Sie die SNEventSenderProvider- API, um ein Ereignis-Absenderobjekt zu instanziieren. Verwenden Sie dann die IEventSender- API, um das Ereignis an eine Instanz ServiceNow zu senden. Sie müssen das Plugin „Ereignismanagement" (com.glideapp.itom.snac) aktivieren, bevor Sie versuchen, auf diese API zuzugreifen. Das Plugin „Ereignismanagement" erfordert ein separates Abonnement und muss aktiviert werden. 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=xanadu&pubname=xanadu-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 „Ereignismanagement" zurück, das übergeben wurde. {#Event-getField_S__table_ky4_4mk_jkb__entry__3} | Name | Typ | Beschreibung | |-|-|-| | field | 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 angeforderten Ereignismanagement-Felds. | [Tabelle : 3. Ergebnisse] {#Event-getField_S__table_ly4_4mk_jkb} var event = new Event(); var eventSource = event.getField("source"); var eventSeverity = event.getField("severity"); ## Ereignis -- setAdditionalInfo(String zusätzlicheInfo) {#ariaid-title4} Ersetzt das vorhandene Feld additional_info im zugeordneten Ereignis durch die übergebene JSON-Zeichenfolge. Hinweis: Sie können die Methode [setField()](https://www.servicenow.com/docs/~2g54A3QEfa3y7U~WbFgZg#Event-setField_S_S "Legt das angegebene Feld im zugeordneten Ereignis fest.") verwenden, um ein bestimmtes Feld im Feld additional_info zu aktualisieren. {#Event-setAdditionalInfo_S__table_pc2_dbh_kkb__entry__3} | Name | Typ | Beschreibung | |-|-|-| | additionalInfo | Zeichenfolge | JSON-Zeichenfolge (Schlüssel-Wert-Paare), die im Feld additional_info gespeichert werden sollen. 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 | |-|-| | void | | [Tabelle : 5. Ergebnisse] {#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 der in key übergebene mit einem vordefinierten Ereignisfeld übereinstimmt, aktualisiert die Methode das entsprechende Ereignisfeld. Andernfalls fügt die Methode den Parameter keyadditional_info dem Abschnitt \[\] des Ereignisse hinzu, bevor der übergebene Parameter in \[ value\] angewendet wird. Die folgenden vordefinierten Ereignisfelder können Sie mit dieser Methode ändern: {#Event-setField_S_S__table_ddd_32g_pkb__entry__2} | Feld | Beschreibung | |-|-| | additional_info | Schlüssel-Wert-Paar, das dem Feld additional_info des zugeordneten Ereignisses hinzugefügt werden soll. Wenn der übergebene Schlüssel bereits vorhanden ist, wird sein Wert überschrieben. Maximale Länge: 4.000 Zeichen Zugeordnetes UI-Feld: Zusätzliche Informationen | | ci_identifier | JSON-Zeichenfolge, die ein Configuration Item 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 Zugeordnetes UI-Feld: Beschreibung Standard: Null | | event_class | Enterprise Message Service (EMS), von dem das Ereignis generiert wurde. Beispiel: „SolarWinds" oder „SCOM". Maximale Länge: 100 Zugeordnetes UI-Feld: Quellinstanz Standard: Null | | message_key | Eindeutiger Ereignis-Bezeichner. Um einen vorhandenen Ereignis-Schweregrad zu überschreiben, verwenden Sie denselben message_key -Wert. Maximale Länge: 1024 Zeichen Zugeordnetes UI-Feld: Nachrichtenschlüssel Standard: Kombination aus source, node, type, resourceund metric name. | | resolution_state | Ereignislösungsstatus. Gültige Werte: * Neu: Der Lösungsstatus für das entsprechende Ereignis ist „Offen". * Wird geschlossen: Der Lösungsstatus für das entsprechende Ereignis ist „Geschlossen"/„Geschlossen". {#Event-setField_S_S__ul_szv_dmg_pkb} Zugeordnetes UI-Feld: Lösungsstatus Standard: Neu | | resource | Knotenressource, die dem Ereignis zugeordnet werden soll. Beispiele: „Datenträger C:", „CPI-1" oder der Name eines Prozesses oder Services. Maximale Länge: 100 Zeichen Zugeordnetes UI-Feld: Ressource | | Schweregrad | Ereignisschweregrad. Gültige Werte: * 0: Löschen -- Es ist 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, obwohl die Ressource noch funktionsfähig ist. * 3: Gering -- Ein teilweiser, nicht kritischer Verlust der Funktionalität oder eine Leistungsverschlechterung ist aufgetreten. * 4: Schwerwiegend: Wichtige Funktionalität ist schwer beeinträchtigt, oder die Leistung wurde beeinträchtigt. * 5: Kritisch: Es ist eine sofortige Aktion erforderlich. Die Ressource funktioniert entweder nicht, oder kritische Probleme stehen unmittelbar bevor. {#Event-setField_S_S__ul_ol1_d4g_pkb} Zugeordnetes UI-Feld: Schweregrad Standard: Null | | Quelle | EMS-Instanz, die das Ereignis ausgelöst hat. Normalerweise der Name der Connector-Instanz. Maximale Länge: 200 Zeichen Zugeordnetes 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 Zugeordnetes UI-Feld: Zeit des Ereignisses Standard: Aktuelle(s) Datum/Uhrzeit | | type | Metriktyp, auf den sich das Ereignis bezieht, 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 Zugeordnetes UI-Feld: Typ Standard: Null | [ ] {#Event-setField_S_S__table_ddd_32g_pkb} Hinweis: Sie können auch die Methode [setText()](https://www.servicenow.com/docs/~2g54A3QEfa3y7U~WbFgZg#Event-setText_S "Legt das Feld description des zugeordneten Ereignisses auf den übergebenen Wert fest.") verwenden, um das Feld description zu aktualisieren, und die Methode [setTimeOfEvent()](https://www.servicenow.com/docs/~2g54A3QEfa3y7U~WbFgZg#Event-setTimeOfEvent_S "Legt das Feld time_of_event im zugeordneten Ereignis auf den in UTC-Zeit übergebenen Wert fest."), um die Ereigniszeit zu aktualisieren. Weitere Informationen zu Ereignissen finden Sie unter [Ereignismanagement](https://www.servicenow.com/docs/access?context=c_EM&version=xanadu&pubname=xanadu-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 Ereigniserfassung](https://www.servicenow.com/docs/access?context=c_EMIntegrateRequirementEvent&version=xanadu&pubname=xanadu-it-operations-management&ft:locale=en-US). | | Wert | Zeichenfolge | Informationen, die im zugehörigen Ereignisfeld gespeichert werden sollen. Hinweis: Die Zeichenfolge value wird vor dem Speichern gekürzt, wodurch mehrere Leerzeichen durch ein einziges Leerzeichen 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 | |-|-| | void | | [Tabelle : 7. Ergebnisse] {#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(String text) {#ariaid-title6} Legt das Feld description des zugeordneten Ereignisses auf den übergebenen Wert fest. Hinweis: Sie können auch die Methode [Ereignis -- setField(Zeichenfolgenschlüssel, Zeichenfolgenwert)](https://www.servicenow.com/docs/~2g54A3QEfa3y7U~WbFgZg#Event-setField_S_S "Legt das angegebene Feld im zugeordneten Ereignis fest.") verwenden, um das Feld text im aktuellen Ereignis festzulegen. Im Gegensatz zur Methode setField() kürzt diese Methode den übergebenen Text nicht. {#Event-setText_S__table_r2j_mgh_kkb__entry__3} | Name | Typ | Beschreibung | |-|-|-| | text | Zeichenfolge | Text, der im Feld description des zugeordneten Ereignisses gespeichert werden soll. Maximale 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 | |-|-| | void | | [Tabelle : 9. Ergebnisse] {#Event-setText_S__table_s2j_mgh_kkb} var event = new Event(); event.setText("SAP Solman"); ## Ereignis -- setTimeOfEvent(String timeOfEvent) {#ariaid-title7} Legt das Feld time_of_event im zugeordneten Ereignis auf den in UTC-Zeit übergebenen Wert fest. Hinweis: Sie können auch die Methode [Ereignis -- setField(Zeichenfolgenschlüssel, Zeichenfolgenwert)](https://www.servicenow.com/docs/~2g54A3QEfa3y7U~WbFgZg#Event-setField_S_S "Legt das angegebene Feld im zugeordneten Ereignis fest.") verwenden, um das Feld time_of_event festzulegen. {#Event-setTimeOfEvent_S__table_m43_kwg_kkb__entry__3} | Name | Typ | Beschreibung | |-|-|-| | Ereigniszeit | Zeichenfolge | UTC-Zeitwert, der im Feld time_of_event festgelegt werden soll. 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 | |-|-| | void | | [Tabelle : 11. Ergebnisse] {#Event-setTimeOfEvent_S__table_n43_kwg_kkb} var event = new Event(); event.setTimeOfEvent("2019-18-05 13:12:05");