Connector domain metadata
Override push connector default domain metadata values installed with Event Management with the values in the event HTTP request, including the URL, headers, request body (payload), and connector parameters. Override pull connector domain metadata values with connector parameters only.
Domain metadata parameters
| Name | Description | Overrides System Property |
|---|---|---|
| connectorDomainInfoTableName | Name of the table containing the records with the domain information. | evt_mgmt.connector_domain_info_table_name- Type: string - Default value: core_company |
| connectorDomainInfoColumnName | Name of the column that has a value that should be matched with the domain identifier. For example, you might want to identify a record in the Domain Info table that has a matching value in the company_name field. | evt_mgmt.connector_domain_info_column_name- Type: string - Default value: name |
| connectorDomainIdColumnName | Name of the table column that stores the domain ID. | evt_mgmt.connector_domain_id_column_name- Type: string - Default value: sys_domain |
| connectorDomainPathColumnName | Name of the table column that stores the domain path. | evt_mgmt.connector_domain_path_column_name- Type: string - Default value: sys_domain_path |
Order of preference for accessing domain metadata
You must provide domain metadata to configure personalized push connector domains. The metadata in preferred accessing order are:
- Push connector parameters
- URL query parameters
- HTTP headers
- Request body (payload)
- Default system properties
URL query parameters
Push connectors have the following URL syntax:
- Instance Type:
https://<instance-name>.service-now.com/api/sn_em_connector/em/inbound_event?source=<connector-source> - MID Server type:
http://<MID_Server_IP>:<MID_Web_Server_Port>/api/mid/em/inbound_event?Transform=<connector-transform-script-name>
You can include domain metadata as additional query parameters in the ServiceNow push connector webhook URL. For example, if the domain information source is the sys_user table, the URL could be https://<instance-name>.service-now.com/api/sn_em_connector/em/inbound_event?source=<connector-source>&connectorDomainInfoTableName=sys_user
Request headers
Any of the domain metadata properties can be passed as part of HTTP request headers. Check the documentation from your third-party monitoring tool for information about how request headers are set.
Request body (payload)
You can reference domain metadata from the request body (JSON payload) by setting the metadata parameters as root-level keys in the payload. The following example shows how the connectorDomainInfoTableName and connectorDomainInfoColumnName parameters might be passed as part of the request body:
{
“source”: “Azure Monitor”,
“host”: “127.0.0.1”,
“company”: “ServiceNow”,
“connectorDomainInfoTableName”: “sys_user”,
“connectorDomainInfoColumnName”: “first_name”
}
Note: For information on connector parameters, see Configure domain separation for push connector events.
Parent Topic:Event Management reference