Créer des recherches de données personnalisées

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 7 minutes de lecture

    • La création de recherches de données personnalisées implique l’ajout d’une valeur de recherche, la création de la définition et l’activation de la recherche de données.

    Créer une table de recherche de données personnalisée

    Créez une table personnalisée pour stocker les données de recherche.

    La table personnalisée doit étendre la table Règles de correspondance de recherche de données [dl_matcher]. Par exemple, cette table de recherche personnalisée stocke des informations sur les appelants VIP et les affectations d’incidents.

    Tableau 1. Table de recherche de données personnalisée
    Champ Exemple de valeur
    Étiquette Recherche d’appelant VIP
    Nom de la table u_vip_caller_lookup
    Étend la table de base dl_matcher
    Créer un module Vrai
    Ajouter un module au menu Politique système

    Ajouter une valeur de recherche de données à la table de recherche de données

    Les colonnes d’une table de recherche de données contiennent à la fois des données de champ de correspondance et de champ de création.

    Avant de commencer

    Rôle requis : admin

    Pourquoi et quand exécuter cette tâche

    Chaque recherche de données est une requête qui recherche une ligne contenant des valeurs qui correspondent aux champs de correspondance. La recherche de données renvoie ensuite la valeur indiquée dans les champs de création. Par exemple, cette table de recherche de données prioritaires [dl_u_priority] répertorie les combinaisons d’impact et d’urgence (champs de correspondance) qui produisent une valeur de priorité particulière (champ de création).

    Tableau 2. Table de recherche
    Champs de correspondance Champ de régleur
    Impact Urgence Priorité
    1 - Élevé 1 - Élevé 1 - Critique
    1 - Élevé 2 - Moyen 2 - Élevé
    1 - Élevé 3 - Bas 3 - Modéré
    2 - Moyen 1 - Élevé 2 - Élevé
    2 - Moyen 2 - Moyen 3 - Modéré
    2 - Moyen 3 - Bas 4 - Faible
    3 - Bas 1 - Élevé 3 - Modéré
    3 - Bas 2 - Moyen 4 - Faible
    3 - Bas 3 - Bas 5 - Planification

    Procédure

    1. Dans le filtre de navigation, saisissez le nom de la nouvelle table de recherche personnalisée.
      Par exemple, u_vip_caller_lookup.list.
    2. Configurez la liste et créez des champs.

      Pour cet exemple, créez les nouveaux champs dans la table suivante.

      Tableau 3. Nouveaux champs
      Nom Type Longueur du champ ou table à référencer
      Appelant Référence Utilisateur [sys_user]
      Priorité Entier
      Groupe d'affectation Référence Groupe [sys_user_group]

      Pour plus d'informations, consultez Configurer des listes sur le ServiceNow AI Platform.

    3. Dans la liste des tables, sélectionnez Nouveau et saisissez les valeurs de champ de correspondance et de définition appropriées.

      Par exemple :

      Tableau 4. Nouvelles valeurs de champ de correspondance et de création
      Champ de correspondance Champs de création
      Appelant Priorité Groupe d'affectation
      Beth Anglin 2 Problèmes VIP
      Fred Luddy 1 Problèmes VIP
      Remarque :
      Chaque ligne d’une table de recherche de données doit être unique.

    Créer un enregistrement de définition de recherche de données

    La recherche de données nécessite un enregistrement de définition qui spécifie comment définir une ou plusieurs valeurs de champ lorsque les conditions spécifiées sont remplies.

    Avant de commencer

    Rôle requis : admin

    Procédure

    1. Accédez à la Tous > Politique système > Règles > Définitions de recherche de données.
    2. Sélectionnez Nouveau.
    3. Sélectionnez Règle de recherche de données.
    4. Remplissez le formulaire Règle de recherche de données en utilisant la table suivante.
      Tableau 5. Champs de définitions de recherche de données
      Champ Description
      Nom Saisissez un nom unique pour identifier l’enregistrement de définition.
      Table source Sélectionnez la table contenant les champs que vous souhaitez mettre à jour automatiquement avec des valeurs de recherche. Les définitions de recherche de données ne sont pas héritées par les tables d’extension. Par exemple, une définition de recherche de données sur la table Tâche ne peut pas correspondre aux valeurs de la table Incident.
      Table de correspondance Sélectionnez la table contenant les valeurs de recherche. Cette table doit toujours commencer par un préfixe u_. Cette table peut être n’importe quelle table dans le champ d’application actuel contenant les valeurs de recherche.
      Remarque :
      La liste affiche uniquement les tables et les vues de base de données qui sont dans le même champ d’application que la définition de recherche de données de catalogue.
      Actives Cochez cette case pour exécuter cette règle de recherche de données. Décochez la case pour ignorer cette règle de recherche de données.
      Exécuter sur un changement de formulaire

      Cochez cette case pour rechercher automatiquement des valeurs chaque fois qu’un utilisateur ou un script client onChange modifie une valeur de champ sur un formulaire de table source.

      Remarque :
      Cela n’inclut pas les modifications effectuées automatiquement par d’autres règles de recherche de données, telles que les règles de recherche de priorité.
      Exécuter sur insertion Cochez cette case pour rechercher automatiquement des valeurs chaque fois qu’un utilisateur crée un nouvel enregistrement.
      Exécuter sur mise à jour Cochez cette case pour rechercher automatiquement les valeurs chaque fois qu’un utilisateur enregistre ou met à jour un enregistrement.
    5. Sélectionnez et maintenez enfoncé (ou cliquez avec le bouton droit de la souris) l'en-tête du formulaire, puis sélectionnez Enregistrer.
    6. Dans la liste connexe Définitions de champs de correspondance , cliquez sur Nouveau.
    7. Complétez les définitions de champs de correspondance à l’aide de la table suivante.

      Une recherche de données se produit uniquement sur les champs avec des définitions de champ de correspondance. La recherche de données utilise les valeurs des champs de la table source pour rechercher une ou plusieurs valeurs à partir de la table de correspondance. Notez que la recherche de données ne fonctionne pas avec les champs de type journal .

      Tableau 6. Champs de définitions des champs de correspondance
      Champ Description
      Recherche de données Affiche le nom de l’enregistrement de définition de recherche de données parent.
      Champ de table source Sélectionnez le champ de la table source qui contient les données à faire correspondre.
      Champ de table de correspondance Sélectionnez le champ de la table de correspondance qui contient les données à faire correspondre. Cette table peut être n’importe quelle table dans le champ d’application actuel contenant les valeurs de recherche.
      Concordance de recherche exacte

      Activez cette case à cocher pour exiger que la table de correspondance contienne une ligne correspondante pour chaque combinaison possible de valeurs (y compris les valeurs vides). Décocher cette case signifie que toutes les valeurs vides dans la table de correspondance correspondent à n’importe quelle valeur. Par exemple, supposons que le champ Priorité est vide dans la table de correspondance. Lorsque cette case est cochée, il y a correspondance uniquement lorsque la valeur Priorité est vide dans la ligne de table source. Lorsque vous désactivez cette case à cocher, la valeur du champ de correspondance vide correspond à n’importe quelle valeur du champ de table source.

      Remarque :
      Si la recherche ne nécessite pas de correspondance exacte, les lignes de table de correspondance contenant des valeurs vides sont traitées comme des caractères génériques, correspondant à toutes les valeurs.
    8. Sélectionnez Envoyer.
    9. Dans la liste connexe Définitions de champ de régleur , cliquez sur Nouveau.
    10. Remplissez le formulaire Définitions de champs de régleur à l’aide de la table suivante.
      Tableau 7. Champs de définitions des champs de régleur
      Champ Description
      Recherche de données Affiche le nom de l’enregistrement parent de définitions de recherche de données.
      Champ de table source Sélectionnez le champ de la table source que la recherche de données met à jour.
      Champ de table de correspondance Sélectionnez le champ dans la table de correspondance qui fournit la nouvelle valeur pour la mise à jour.
      Toujours remplacer Cochez cette case pour remplacer une valeur existante par une valeur de la recherche de données. Décochez cette case pour ignorer la mise à jour si le champ a une valeur existante.
    11. Sélectionnez Envoyer.
    12. Sélectionnez Mettre à jour.

    Créer un module de recherche de données

    Vous pouvez créer un module de recherche de données afin qu’il apparaisse dans le navigateur d’application de l’instance.

    Avant de commencer

    Rôle requis : admin

    Procédure

    1. Accédez à la Tous > Définition du système > Menus d’application, puis sélectionnez une application à laquelle ajouter le module.
    2. Dans la liste connexe Modules, sélectionnez Nouveau.
    3. Configurez un module pour la table de recherche de données que vous avez créée à l’aide des propriétés suivantes.
      Tableau 8. Propriétés des modules
      Propriété Valeur requise
      Table Sélectionnez la table de recherche de données que vous avez créée à l’étape 2. Par exemple, u_vip_caller_lookup.
      Type de lien Liste des enregistrements
    4. Sélectionnez Envoyer.

    Dépannage de la recherche de données

    Si les règles de définition de recherche de données personnalisées ne se comportent pas comme prévu, vérifiez certaines conditions.

    • Vérifiez que la définition de recherche de données est définie pour s’exécuter sur les événements appropriés.
    • Vérifiez que le champ de correspondance n’est pas en lecture seule. Étant donné que les utilisateurs ne peuvent pas modifier les champs en lecture seule, les interactions de l’utilisateur ne peuvent pas déclencher d’événement de changement dans le formulaire pour les champs en lecture seule.
    • Vérifiez qu’un script client ne modifie pas une valeur de champ. Les scripts clients peuvent déclencher Run on form change des événements même sur des champs en lecture seule.
    • Vérifiez que les données de la table de correspondance sont correctes.
    • Si la recherche nécessite une correspondance exacte, vérifiez qu’il existe une ligne de table de correspondance pour chaque combinaison possible (y compris les valeurs vides). La recherche échoue si aucune valeur correspondante n’est trouvée.
    • Vérifiez que vous n’avez pas créé de règle récursive, telle que :

      Si le champ A = 1, alors le champ B = 2. Si le champ B = 2, alors le champ A = 2.