--- sourceDocument: Yokohama IT Operations Management sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/it-operations-management Release : - yokohama ft:locale : - de-DE ft:publication_title : - Yokohama IT Operations Management ft:clusterId : - itom bundleId : - itom workflow : - Technology --- # Ereignisse werden an übertragen MID-ServerWebservice-API wird verwendet # Ereignisse werden an übertragen MID-ServerWebservice-API wird verwendet {#ariaid-title1} * Freigeben Version: Yokohama * * Aktualisiert 30. Januar 2025 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 Minuten Lesedauer Konfigurieren Sie den MID-Webservice-Ereignissammler, um eine URL-Methode zum Verschieben von Ereignisnachrichten an bereitzustellen MID-Server. Mit dem MID-Webservice-Ereignissammler können Sie standardmäßig eine Verbindung zu einem Ereignisgenerator herstellen und Ereignisnachrichten über senden MID-Server, Mit einer URL im folgenden Format: `http://{MID_Server_IP}:{MID_Web_Server_Port}/api/Mid/em/jsonv2 ` Das JSON v2-Format entspricht dem Format, das Clients zum Senden von Ereignisnachrichten an die Instanz verwenden. Diese URL bietet eine gute Leistung. Weitere Informationen finden Sie unter [Konfigurieren des MID-WebService-Ereignissammlerkontexts](https://servicenow-prod.fluidtopics.net/GouDKBmVnYSexjkq2OnZNw "Konfigurieren Sie den Kontext des MID-Webservice-Ereignissammlers, um eine URL-Methode zum Verschieben von Ereignisnachrichten aus einer externen Quelle an bereitzustellen MID-Server."). Hinweis: EreignismanagementAkzeptiert Ereignisse in der Zeitzone von MID-ServerÜber die der Listener die Ereignisnachricht gesendet hat. Wenn Sie eine andere Zeitzone benötigen, können Sie das Skript nach Bedarf konfigurieren, siehe [Integration mit Push-Connectors](https://servicenow-prod.fluidtopics.net/~47pQ_zC5hVRaJvFZEpPGQ "Integrieren Sie sie in einen Push-Connector, um eine Verbindung zu einer externen Ereignisquelle herzustellen. Push-Connectors verarbeiten die gesammelten Ereignisnachrichten und wandeln sie in das erforderliche Ereignisformat um."). ## URL zum Verschieben anwenderdefinierter Nutzlasten Die MID-ServerKann auch eine anwenderdefinierte Nutzlast im JSON-, XML- oder nur-Text-Format empfangen. In diesem Fall wird MID-ServerTransformiert die Ereignisnachrichten mithilfe der von Ihnen angegebenen Skripteinbindung und sendet die Ereignisse dann an die Instanz. Die URL in diesem Fall lautet: `http://{MID_Server_IP}:{MID_Web_Server_Port}/api/MID/em/inbound_event?Transform={Transform_script_Name} `Ein Beispiel für eine Skripteinbindung finden Sie im Standard `TransformEvents_xmlSample `Skripteinbindung. Ein Beispiel dafür, wie der MID-Webservice-Ereignissammler JSON-formatierte Ereignisnachrichten umwandelt, finden Sie unter . Um Ereignisse im generischen JSON-Format zu senden, können Sie die URL in diesem Format verwenden: `http://{MID_Server_IP}:{MID_Web_Server_Port}/api/MID/em/inbound_event?Transform=TransformEvents_MidJsonGeneric` In diesem Fall wird `TransformEvents_MidJsonGenerisch `Die in der Basisinstanz bereitgestellte MID-Skripteinbindung wandelt die Ereignisnachrichten in Ereignisfelder um. Alle Felder werden als hinzugefügt Zusätzliche Informationen Felder im generierten ServiceNow-Ereignis. Hinweis: Die URL im Format `http://{MID_Server_IP}:{MID_Web_Server_Port}/api/MID/em/{transform_script_Name} `Wird auch unterstützt. Die REST-API-URL zum Validieren der Konnektivität ist: `http://{MID_Server_IP}:{MID_Web_Server_Port}/api/Mid/em/ping ` ## Skripteinbindung zum Transformieren gesammelter Ereignisse Verwenden Sie die erforderliche MID-ServerSkripteinbindung zum Transformieren (Analysieren) gesammelter Ereignisnachrichten und Ausfüllen in das zugeordnete Ereignisfeld. Die MID-ServerDer Name der Skripteinbindung besteht aus einem Präfix und einem Suffix. Das Präfix ist der obligatorische Text `Transformationsereignisse_ `Und das Suffix ist der Transformationsname auf der URL, z. B. `http://{MID_Server_IP}:{MID_Web_Server_Port}/api/Mid/em/xmlSample ` . Der Name des verfassten Skripts lautet daher `TransformEvents_xmlSample `. Sie müssen eine Skripteinbindung angeben, die die Ereignisnachrichten in einer Textvariable empfängt. Das Skript muss einen haben `Transformieren() `Funktion, die die Transformation durchführt und das Rückgabe-Array von Ereignisobjekten vorbereitet. Wenn EreignismanagementPlugin ist aktiviert, Sie erhalten `TransformEvents_xmlSample `Beispiel für ein Include-Skript, das Ereignisse aus dem XML-Format umwandelt. Hinweis: Ereignisfelder, die nicht mit Feldern in der Ereignistabelle identisch sind, werden in gespeichert Zusätzliche Informationen Feld. ## Ereignisnachrichten-Header Geben Sie den relevanten Anforderungsheader-Wert für an Inhaltstyp Feld gemäß dem Format der Ereignisnachricht. {#event-collection-via-MID-using-push__table_uqf_ldy_dy__entry__2} | Nachrichtenformat | Inhaltstyp-Wert | |-|-| | JSON | application/json | | XML | Anwendung/XML | | HTML | Text/nur | [Tabelle : 1. Anforderungsheader-Werte für den Inhaltstyp] {#event-collection-via-MID-using-push__table_uqf_ldy_dy} ## Authentifizierungs- und Datensicherheitsoptionen Optionen für Authentifizierung und Datensicherheit: * Authentifizierungstyp , Die auf einen oder mehrere festgelegt werden kann API-Schlüssel Oder Standard . * Sichere Verbindung , Mit dem Sie auswählen können, ob eingehende und ausgehende Daten bei der Übertragung gesichert werden. Wenn Sie die erweiterte gesicherte Option auswählen, müssen Sie ein Zertifikat von einer bekannten Zertifizierungsstelle erhalten und dann angeben Schlüsselspeicher-Zertifikatalias Und Schlüsselspeicher-Passwort . * Verwenden Sie den einheitlichen MID-Schlüsselspeicher , Der Verschlüsselungsschutz bietet und Ihnen die Installation eines anwenderdefinierten Zertifikats in ermöglicht MID-ServerEinheitlicher Schlüsselspeicher. Weitere Informationen finden Sie unter Installieren Sie anwenderdefinierte Zertifikate im zentralen Schlüsselspeicher des MID-Servers . * Anwender müssen ein Skript bereitstellen, das die JSON-, XML- oder textformatierten Ereignisnachrichten in einer Textvariablen empfängt. Das Skript muss über eine Transformationsfunktion () verfügen, die die Transformation durchführt und das Rückgabe-Array von Ereignisobjekten vorbereitet. Die `TransformEvents_xmlSample `Das Include-Skript, das Ereignisse aus dem XML-Format umwandelt, wird als Beispiel bereitgestellt, wenn EreignismanagementPlugin ist aktiviert. {#event-collection-via-MID-using-push__ul_pz5_cgt_2x}Weitere Informationen zu Authentifizierung und Datensicherheit finden Sie unter [Konfigurieren Sie MID-WebserverErweiterung](https://servicenow-prod.fluidtopics.net/xOsCzTl6S_iFh0Af_kH50Q "Die MID-WebserverIst ein MID-ServerErweiterung, mit der die Entwicklung von REST-APIs Ereignisse und Metriken an senden können MID-Server. Die Erweiterung wird von anderen genutzt MID-ServerErweiterungen, z. B. Metrikdaten, MID-Webservice-Ereignis-Listener und Agent Client Collectorwebsocket-Endpunkterweiterung."). **Zugehörige Tasks** * [Ereignisse werden mithilfe der Webservice-API an die Instanz übertragen](https://servicenow-prod.fluidtopics.net/YjQRamKSdDtR51JbsMrB3Q "Sie können eine Webservice-Schnittstelle verwenden, die von unterstützt wird ServiceNow, Das für das JSON-Objekt als Dateneingabe- und Ausgabeformat verwendet wird.")