Métadonnées du domaine du connecteur

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 2 minutes de lecture

    • Remplacez les valeurs de métadonnées de domaine par défaut du connecteur Push installées avec Gestion des événements 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 des métadonnées de domaine du connecteur pull par des paramètres de 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 avec les informations sur le domaine. evt_mgmt.connector_domain_info_table_name
    • Type : chaîne
    • Valeur par défaut : core_company
    connectorDomainInfoColumnName Nom de la colonne dont la valeur doit correspondre à 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 de 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 du 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 push ont la syntaxe d’URL suivante :

    • Type d’instance : https://<nom-instance>.service-now.com/api/sn_em_connector/em/inbound_event?source=<connecteur-source>
    • 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 du ServiceNow webhook du connecteur push. Par exemple, si la source d’informations de domaine est la table sys_user, l’URL pourrait être https://<instance-name>.service-now.com/api/sn_em_connector/em/inbound_event?source=<connector-source>&connectorDomainInfoTableName=sys_user

    En-têtes de demandes

    Toutes les propriétés de métadonnées du 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 connectorDomainInfoTableName paramètres and connectorDomainInfoColumnName peuvent être transmis dans le cadre du corps de la requête :
    {
    « source » : « Azure Monitor »,
    « hôte » : « 127.0.0.1 »,
    « société » : « 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 du connecteur push à utiliser dans la création d’événements.