Connector-Domänenmetadaten

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 1 Minute Lesedauer
  • Überschreiben Sie die mit Ereignismanagement installierten Standarddomänenmetadatenwerte des Push-Connectors mit den Werten in der Event-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 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 abgeglichen werden soll. Beispielsweise möchten Sie möglicherweise einen Datensatz in der Tabelle „Domäneninformationen“ identifizieren, der einen übereinstimmenden Wert im Feld company_name aufweist. 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

    Rangfolge 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-Kopfzeilen
    4. Anforderungstext (Nutzlast)
    5. Standardsystemeigenschaften

    URL-Abfrageparameter

    Push-Connectors haben die folgende URL-Syntax:

    • 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 ServiceNow Push-Connectors 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. Überprüfen Sie die Dokumentation Ihres Drittanbieter-Überwachungstools auf Informationen darüber, wie Anforderungsheader festgelegt werden.

    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 Anforderungstexts übergeben werden können:
    {
    „source“: „Azure Monitor“,
    „host“: „127.0.0.1“,
    „company“: „ServiceNow“,
    „connectorDomainInfoTableName“: „sys_user“,
    „connectorDomainInfoColumnName“: „first_name“
    }