Métadonnées du domaine du connecteur

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 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 de l’é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 du 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_info_domaine_connecteur
    • Type : chaîne
    • Valeur par défaut : core_company
    connectorDomainInfoColumnName Nom de la colonne dont la valeur doit correspondre à l’identificateur du 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 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

    La syntaxe d’URL des connecteurs push est la 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 plus d’informations 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 et connectorDomainInfoColumnName peuvent être transmis dans le cadre du corps de la demande :
    {
    « source » : « Azure Monitor »,
    « host » : « 127.0.0.1 »,
    « company » : « ServiceNow »,
    « connectorDomainInfoTableName » : « sys_user »,
    « connectorDomainInfoColumnName » : « first_name »
    }
    Remarque :
    Pour plus d’informations 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.