--- sourceDocument: IT Operations Management Zürich sourceDocumentLink: https://www.servicenow.com/docs/r/de-DE/zurich/it-operations-management Release : - zurich ft:locale : - de-DE ft:publication_title : - IT Operations Management Zürich ft:clusterId : - itom bundleId : - itom workflow : - Technology --- # Ereignisse werden an übertragen MID-Server Webservice-API wird verwendet # Ereignisse werden an übertragen MID-Server Webservice-API wird verwendet {#ariaid-title1} * Freigeben Version: Zurich * * Aktualisiert 31. Juli 2025 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 Minuten Lesedauer Konfigurieren Sie den MID WebService-Eventsammler, damit eine URL-Methode Event-Nachrichten an den MID-Server übertragen kann. Der MID WebService-Event-Sammler ermöglicht Ihnen standardmäßig das Herstellen einer Verbindung zu einem Event-Generator und das Senden von Event-Nachrichten über den MID-Server mithilfe einer URL im folgenden Format: `http://{MID_Server_IP}:{MID_Web_Server_Port}/api/mid/em/jsonv2`. Das JSON v2-Format ist mit dem Format identisch, das Clients zum Senden von Event-Nachrichten an die Instanz verwenden. Diese URL bietet eine gute Leistung. Weitere Informationen finden Sie unter [MID-WebService-Event-Sammlerkontext konfigurieren](https://www.servicenow.com/docs/sQ3TbpCBTV0zSsp7ad0K0w "Konfigurieren Sie den MID-WebService-Event-Sammlerkontext, damit eine URL-Methode Event-Nachrichten von einer externen Quelle an den MID-Server übertragen kann."). Hinweis: Ereignismanagement akzeptiert Events in der Zeitzone des MID-Server, über den der Listener die Event-Nachricht gesendet hat. Wenn Sie eine andere Zeitzone benötigen, können Sie das Skript nach Bedarf konfigurieren, siehe [Integration mit Push-Connectors](https://www.servicenow.com/docs/XVYYDzp3BDrMKZuWIGeV0A "Integrieren Sie einen Push-Connector, um eine Verbindung zu einer externen Ereignisquelle herzustellen. Push-Connectors verarbeiten die gesammelten Event-Nachrichten und transformieren sie in das erforderliche Event-Format."). ## URL zum Verschieben von benutzerdefinierten Nutzlasten Der MID-Server kann auch eine benutzerdefinierte Nutzlast im JSON-, XML- oder Nur-Text-Format empfangen. In diesem Fall transformiert der MID-Server die Event-Nachrichten mithilfe der von Ihnen angegebenen Skripteinbindung und sendet die Events dann an die Instanz. Die URL lautet in diesem Fall: `http://{MID_Server_IP}:{MID_Web_Server_Port}/api/mid/em/inbound_event?Transform={Transform_script_name}` Für ein Beispiel für eine Skripteinbindung siehe die Standard-Skripteinbindung `TransformEvents_xmlSample`. Ein Beispiel für die Umwandlung von JSON-formatierten Event-Nachrichten durch den MID WebService-Eventsammler finden Sie unter . Zum Senden von Events im allgemeinen JSON-Format können Sie die URL in folgendem Format verwenden: `http://{MID_Server_IP}:{MID_Web_Server_Port}/api/mid/em/inbound_event?Transform=TransformEvents_MidJsonGeneric` In diesem Fall transformiert die MID-Einbindung `TransformEvents_MidJsonGeneric`, die in der Basisinstanz bereitgestellt wird, die Event-Nachrichten in die Event-Felder. Alle Felder werden als Felder Zusätzliche Informationen dem generierten ServiceNow-Event hinzugefügt. Hinweis: Die URL im Format `http://{MID_Server_IP}:{MID_Web_Server_Port}/api/mid/em/{transform_script_name}` wird ebenfalls unterstützt. Die URL der REST API zum Überprüfen der Konnektivität lautet: `http://{MID_Server_IP}:{MID_Web_Server_Port}/api/mid/em/ping`. ## Skripteinbindung zur Transformation erfasster Events Verwenden Sie die erforderliche Skripteinbindung MID-Server, um erfasste Event-Nachrichten umzuwandeln (zu analysieren) und in das zugeordnete Event-Feld einzufügen. Der Name der Skripteinbindung MID-Server besteht aus einem Präfix und einem Suffix. Das Präfix ist der obligatorische Text `TransformEvents_` und das Suffix ist der Transformationsname in der URL, z. B. `http://{MID_Server_IP}:{MID_Web_Server_Port}/api/mid/em/xmlSample` . Der Name des zusammengesetzten Skripts lautet daher `TransformEvents_xmlSample`. Sie müssen eine Skripteinbindung angeben, die die Event-Nachrichten in einer Textvariablen empfängt. Das Skript muss über eine `transform ()`-Funktion verfügen, die die Transformation durchführt und das Rückgabe-Array von Event-Objekten vorbereitet. Wenn das Ereignismanagement-Plugin aktiviert ist, erhalten Sie das `TransformEvents_xmlSample`-Beispielskript, das Events aus dem XML-Format umwandelt. Hinweis: Event-Felder, die nicht mit Feldern in der Event-Tabelle identisch sind, werden im Feld Zusätzliche Informationen gespeichert. ## Event-Nachrichtenheader Geben Sie den entsprechenden Anforderungsheaderwert für das Feld Inhaltstyp entsprechend dem Format der Event-Nachricht an. {#event-collection-via-MID-using-push__table_uqf_ldy_dy__entry__2} | Nachrichtenformat | Content-Typenwert | |-|-| | JSON | Anwendung/JSON | | XML | application/xml | | text | text/plain | [Tabelle : 1. Header-Werte für den Content-Type anfordern] {#event-collection-via-MID-using-push__table_uqf_ldy_dy} ## Authentifizierungs- und Datensicherheitsoptionen Optionen für Authentifizierung und Datensicherheit: * Authentifizierungstyp , Die auf entweder festgelegt werden kann API-Schlüssel , MTLs , Oder Standard . * Mit Sichere Verbindung können Sie auswählen, ob eingehende und ausgehende Daten bei der Übertragung gesichert werden. Wenn Sie die Option für erweiterte Sicherheit auswählen, müssen Sie ein Zertifikat von einer bekannten Zertifizierungsstelle abrufen und dann den Schlüsselspeicher-Zertifikat-Alias und das Schlüsselspeicher-Passwort angeben. * Einheitlichen MID-Schlüsselspeicher verwenden: Diese Option bietet Verschlüsselungsschutz und ermöglicht es Ihnen, ein benutzerdefiniertes Zertifikat im einheitlichen MID-Server-Schlüsselspeicher zu installieren. Weitere Informationen finden Sie unter [Installieren Sie anwenderdefinierte Zertifikate im zentralen Schlüsselspeicher DES MID-Servers](https://www.servicenow.com/docs/access?context=mid-unified-keystore&version=zurich&pubname=zurich-servicenow-platform&ft:locale=en-US). * Benutzer müssen eine Skripteinbindung angeben, die JSON-, XML- oder Text-formatierte Event-Nachrichten in einer Textvariablen empfängt. Das Skript muss über eine transform ()-Funktion verfügen, die die Transformation durchführt und das Rückgabe-Array von Event-Objekten vorbereitet. Die Skripteinbindung `TransformEvents_xmlSample`, die Events aus dem XML-Format umwandelt, wird als Beispiel angegeben, wenn das Ereignismanagement-Plugin aktiviert ist. {#event-collection-via-MID-using-push__ul_pz5_cgt_2x}Weitere Informationen zu Authentifizierung und Datensicherheit finden Sie unter [MID-Webserver erweiterung konfigurieren](https://www.servicenow.com/docs/eEyxSwQq7VLX13eZyRFvIw "Der MID-Webserver ist eine MID-Server erweiterung, die die Entwicklung von REST APIs zum Senden von Events und Metriken an den MID-Server ermöglicht. Die Erweiterung wird von anderen MID-Server-Erweiterungen genutzt, z. B. Metrikdaten, MID-WebService-Event-Listener und der Agent Client Collector-Websocket-Endpunkterweiterung."). **Zugehörige Tasks** * [Ereignisse werden mithilfe der Webservice-API an die Instanz übertragen](https://www.servicenow.com/docs/~4PDdbttxOcSKLIOlw6LOA "Sie können eine Webservice-Schnittstelle mit ServiceNow verwenden, die auf dem JSON-Objekt als Dateneingabe- und -ausgabeformat aufbaut.")