コネクタのドメインメタデータ

イベント管理 と一緒にインストールされたプッシュコネクタのデフォルトドメインメタデータ値を、URL、ヘッダー、要求本文 (ペイロード)、コネクタパラメーターなどのイベント HTTP 要求の値で上書きします。プルコネクタのドメインメタデータ値をコネクタパラメーターのみで上書きします。

ドメインメタデータパラメーター

名前	説明	システムプロパティの上書き
connectorDomainInfoTableName	ドメイン情報を含むレコードを格納するテーブルの名前。	evt_mgmt.connector_domain_info_table_name タイプ：文字列 デフォルト値：core_company
connectorDomainInfoColumnName	ドメイン識別子と一致する必要がある値を持つ列の名前。例えば、[ドメイン情報] テーブルで [company_name] フィールドに一致する値があるレコードを特定できます。	evt_mgmt.connector_domain_info_column_name タイプ：文字列 デフォルト値：名前
connectorDomainIdColumnName	ドメイン ID を格納するテーブル列の名前。	evt_mgmt.connector_domain_id_column_name タイプ：文字列 デフォルト値：sys_domain
connectorDomainPathColumnName	ドメインパスを格納するテーブル列の名前。	evt_mgmt.connector_domain_path_column_name タイプ：文字列 デフォルト値：sys_domain_path

ドメインメタデータにアクセスするための優先順位

カスタマイズされたプッシュコネクタドメインを構成するには、ドメインメタデータを提供する必要があります。メタデータの優先アクセス順序は次のとおりです。

1. プッシュコネクタパラメーター
2. URL クエリーパラメーター
3. HTTP ヘッダー
4. 要求本文 (ペイロード)
5. デフォルトのシステムプロパティ

URL クエリーパラメーター

プッシュコネクタの URL 構文は次のとおりです。

• インスタンスタイプ：https://<instance-name>.service-now.com/api/sn_em_connector/em/inbound_event?source=<connector-source>
• MID サーバー タイプ：http://<MID_Server_IP>:<MID_Web_Server_Port>/api/mid/em/inbound_event?Transform=<connector-transform-script-name>

ServiceNow プッシュコネクタ Webhook URL に、追加のクエリパラメーターとしてドメインメタデータを含めることができます。例えば、ドメイン情報ソースが sys_user テーブルの場合、URL は https://<instance-name>.service-now.com/api/sn_em_connector/em/inbound_event?source=<connector-source>&connectorDomainInfoTableName=sys_user になります。

要求ヘッダー

任意のドメインメタデータプロパティを HTTP 要求ヘッダーの一部として渡すことができます。要求ヘッダーの設定方法については、お使いのサードパーティ製監視ツールのドキュメントを参照してください。

要求本文 (ペイロード)

ドメインメタデータは、メタデータパラメーターをペイロードのルートレベルキーとして設定することで、要求本文 (JSON ペイロード) から参照できます。次の例は、connectorDomainInfoTableName および connectorDomainInfoColumnName パラメーターを要求本文の一部として渡す方法を示しています。

{

“source”: “Azure Monitor”,

“host”: “127.0.0.1”,

“company”: “ServiceNow”,

“connectorDomainInfoTableName”: “sys_user”,

“connectorDomainInfoColumnName”: “first_name”

}

注:

コネクタパラメーターの詳細については、「イベント作成に使用するプッシュコネクタイベントのドメインのカスタマイズ」を参照してください。