コネクタドメインメタデータ
インストールされている イベント管理 プッシュコネクタのデフォルトドメインメタデータ値を、URL、ヘッダー、要求本文 (ペイロード)、コネクタパラメーターなどのイベント HTTP 要求の値で上書きします。プルコネクタドメインのメタデータ値をコネクタパラメーターのみで上書きします。
ドメインメタデータパラメーター
| 名前 | 説明 | システムプロパティの上書き |
|---|---|---|
| connectorDomainInfoTableName | ドメイン情報を含むレコードを含むテーブルの名前。 | evt_mgmt.connector_domain_info_table_name
|
| connectorDomainInfoColumnName | ドメイン識別子と一致する必要がある値を持つ列の名前。たとえば、[ドメイン情報] テーブルで [company_name ] フィールドに一致する値があるレコードを特定したい場合があります。 | evt_mgmt.connector_domain_info_column_name
|
| connectorDomainIdColumnName | ドメイン ID を格納するテーブル列の名前。 | evt_mgmt.connector_domain_id_column_name
|
| connectorDomainPathColumnName | ドメインパスを格納するテーブル列の名前。 | evt_mgmt.connector_domain_path_column_name
|
ドメインメタデータにアクセスするための優先順位
カスタマイズされたプッシュコネクタドメインを構成するには、ドメインメタデータを提供する必要があります。メタデータの優先アクセス順序は次のとおりです。
- プッシュコネクタパラメーター
- URL クエリーパラメーター
- HTTP ヘッダー
- 要求本文 (ペイロード)
- デフォルトのシステムプロパティ
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>
プッシュコネクタ Webhook URL に追加の ServiceNow クエリパラメーターとしてドメインメタデータを含めることができます。たとえば、ドメイン情報ソースがsys_userテーブルの場合、URL は https://<instance-name>.service-now.com/api/sn_em_connector/em/inbound_event?source=<connector-source>&connectorDomainInfoTableName=sys_user になります
要求ヘッダー
任意のドメインメタデータプロパティを HTTP 要求ヘッダーの一部として渡すことができます。要求ヘッダーの設定方法については、サードパーティのモニタリングツールのドキュメントを参照してください。
要求本文 (ペイロード)
メタデータパラメーターをペイロードのルートレベルのキーとして設定することで、要求本文 (JSON ペイロード) からドメインメタデータを参照できます。次の例は、and connectorDomainInfoColumnName パラメーターを要求connectorDomainInfoTableName本文の一部として渡す方法を示しています。
- {
- “source”: “Azure Monitor”,
注:
コネクタパラメーターの詳細については、「イベント作成に使用するプッシュコネクタイベントのドメインをカスタマイズする」を参照してください。