Métadonnées du domaine du connecteur

Remplacez les valeurs de métadonnées de domaine par défaut du connecteur push installées Gestion des événements avec les valeurs de la demande HTTP d’événement, y compris l’URL, les en-têtes, le corps de la demande (charge utile) et les paramètres du connecteur. Remplacez les valeurs de métadonnées du domaine du connecteur d’extraction par les paramètres du connecteur uniquement.

Paramètres de métadonnées de domaine

Nom	Description	Remplace la propriété système
connectorDomainInfoTableName	Nom de la table contenant les enregistrements contenant les informations de domaine.	evt_mgmt.nom_table_connecteur_domaine_info Type : chaîne Valeur par défaut : core_company
connectorDomainInfoColumnName	Nom de la colonne dont la valeur doit correspondre avec l’identificateur de domaine. Par exemple, vous pouvez identifier un enregistrement dans la table Informations sur le domaine qui a une valeur correspondante dans le champ company_name .	evt_mgmt.connector_domain_info_column_name Type : chaîne Valeur par défaut : name
connectorDomainIdColumnName	Nom de la colonne de table qui stocke l’ID du domaine.	evt_mgmt.connector_domain_id_column_name Type : chaîne Valeur par défaut : sys_domain
connectorDomainPathColumnName	Nom de la colonne de table qui stocke le chemin de domaine.	evt_mgmt.connector_domain_path_column_name Type : chaîne Valeur par défaut : sys_domain_path

Ordre de préférence pour l’accès aux métadonnées de domaine

Vous devez fournir des métadonnées de domaine pour configurer des domaines de connecteur push personnalisés. Les métadonnées dans l’ordre d’accès préféré sont les suivantes :

1. Paramètres du connecteur Push
2. Paramètres de requêtes d’URL
3. En-têtes HTTP
4. Corps de la demande (charge utile)
5. Propriétés système par défaut

Paramètres de requêtes d’URL

Les connecteurs par push ont la syntaxe d’URL suivante :

• Type d’instance : https://<nom-instance>.service-now.com/api/sn_em_connector/em/inbound_event?source=<source-connecteur>
• Serveur MID Type : http://<MID_Server_IP> :<MID_Web_Server_Port>/api/mid/em/inbound_event ? Transform=<connector-transform-script-name>

Vous pouvez inclure les métadonnées de domaine en tant que paramètres de requête supplémentaires dans l’URL Webhook du ServiceNow connecteur Push. Par exemple, si la source d’informations sur le domaine est la table sys_user, l’URL peut être https://<nom-instance>.service-now.com/api/sn_em_connector/em/inbound_event?source=<source-connecteur>&connectorDomainInfoTableName=sys_user

En-têtes de demandes

Toutes les propriétés de métadonnées de domaine peuvent être transmises dans le cadre des en-têtes de requête HTTP. Consultez la documentation de votre outil de surveillance tiers pour en savoir plus sur la façon dont les en-têtes de demande sont définis.

Corps de la demande (charge utile)

Vous pouvez référencer les métadonnées de domaine à partir du corps de la demande (charge utile JSON) en définissant les paramètres de métadonnées en tant que clés de niveau racine dans la charge utile. L’exemple suivant montre comment les paramètres et connectorDomainInfoColumnName peuvent être transmis dans le connectorDomainInfoTableName cadre du corps de la demande :

{

« source » : « Azure Monitor »,

« host » : « 127.0.0.1 »,

« company » : « ServiceNow »,

« connectorDomainInfoTableName » : « sys_user »,

« connectorDomainInfoColumnName » : « first_name »

}

Remarque :

Pour en savoir plus sur les paramètres du connecteur, reportez-vous à la section Personnaliser les domaines pour les événements de connecteur push à utiliser dans la création d’événements.