Metadaten der Connector-Domäne

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 1 Minute Lesedauer
  • Überschreiben Sie die mit Ereignismanagement installierten Standardmetadatenwerte des Push-Connectors mit den Werten in der Ereignis-HTTP-Anforderung, einschließlich URL, Header, Anforderungstext (Nutzlast) und Connector-Parameter. Überschreiben Sie die Metadatenwerte der Pull-Connector-Domäne nur mit Connector-Parametern.

    Domänenmetadatenparameter

    Name Beschreibung Überschreibt die Systemeigenschaft
    connectorDomainInfoTableName Name der Tabelle, die die Datensätze mit den Domäneninformationen enthält. evt_mgmt.connector_domain_info_table_name
    • Typ: Zeichenfolge
    • Standardwert: core_company
    connectorDomainInfoColumnName Name der Spalte, die einen Wert enthält, der mit dem Domänenbezeichner übereinstimmen muss. Beispielsweise möchten Sie möglicherweise einen Datensatz in der Tabelle „Domäneninformationen“ identifizieren, der einen übereinstimmenden Wert im Feld „company_name“ enthält. evt_mgmt.connector_domain_info_column_name
    • Typ: Zeichenfolge
    • Standardwert: Name
    connectorDomainIdColumnName Name der Tabellenspalte, in der die Domänen-ID gespeichert wird. evt_mgmt.connector_domain_id_column_name
    • Typ: Zeichenfolge
    • Standardwert: sys_domain
    connectorDomainPathColumnName Name der Tabellenspalte, in der der Domänenpfad gespeichert wird. evt_mgmt.connector_domain_path_column_name
    • Typ: Zeichenfolge
    • Standardwert: sys_domain_path

    Präferenzreihenfolge für den Zugriff auf Domänenmetadaten

    Sie müssen Domänenmetadaten angeben, um personalisierte Push-Connector-Domänen zu konfigurieren. Die Metadaten in der bevorzugten Zugriffsreihenfolge sind:
    1. Push-Connector-Parameter
    2. URL-Abfrageparameter
    3. HTTP-Header
    4. Anforderungstext (Nutzlast)
    5. Standardsystemeigenschaften

    URL-Abfrageparameter

    Push-Connectors weisen die folgende URL-Syntax auf:

    • Instanztyp: https://<instance-name> .service-now.com/api/sn_em_connector/em/inbound_event?source=<connector-source>
    • MID-Server Typ: http://<MID_Server_IP> :<MID_Web_Server_Port> /api/mid/em/inbound_event?Transform=<connector-transform-script-name>

    Sie können Domänenmetadaten als zusätzliche Abfrageparameter in die Webhook-URL des Push-Connectors ServiceNow aufnehmen. Wenn die Domäneninformationsquelle beispielsweise die Tabelle „sys_user“ ist, könnte die URL „https://“lauten.<instance-name> .service-now.com/api/sn_em_connector/em/inbound_event?source=<connector-source> &connectorDomainInfoTableName=sys_user

    Anforderungskopfzeilen.

    Alle Domänenmetadateneigenschaften können als Teil von HTTP-Anforderungsheadern übergeben werden. Informationen zum Festlegen von Anforderungsheadern finden Sie in der Dokumentation Ihres Drittanbieter-Überwachungstools.

    Anforderungstext (Nutzlast)

    Sie können Domänenmetadaten aus dem Anforderungstext (JSON-Nutzlast) referenzieren, indem Sie die Metadatenparameter als Schlüssel auf Stammebene in der Nutzlast festlegen. Das folgende Beispiel zeigt, wie die Parameter connectorDomainInfoTableName und connectorDomainInfoColumnName als Teil des Anforderungstextes übergeben werden können:
    {
    „source“: „Azure Monitor“,
    „Host“: „127.0.0.1“,
    „company“: „ServiceNow“,
    „connectorDomainInfoTableName“: „sys_user“,
    „connectorDomainInfoColumnName“: „first_name“
    }