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

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 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 des tables de recherche de données contiennent à la fois des données de champs de correspondance et des données de champs de création.

    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 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 – En préparation

    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 Now Platform.

    3. À partir de la liste de la table, cliquez sur Nouveau et saisissez les valeurs de champ de correspondance et de création appropriées.

      Par exemple :

      Tableau 4. Nouvelles valeurs de champ de correspondance et de création
      Champ de correspondance Champs de régleur
      Appelant Priorité Groupe d'affectation
      Beth Anglin 2 Problèmes VIP
      Fred Luddy 1 Problèmes VIP
      Valeurs de recherche personnalisées
      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 Tout > Politique système > Règles > Définitions de recherche de données.
    2. Sélectionnez Nouveau.
    3. Sélectionnez la règle de recherche de données.
    4. Remplissez le formulaire Règle de recherche de données à l’aide de 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 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 périmètre actuel contenant les valeurs de recherche.
      Remarque :
      la liste affiche uniquement les tables et les vues de base de données qui se trouvent dans le même champ d'application que la définition de recherche de données de catalogue.
      Actif 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 les 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 apportées automatiquement par d’autres règles de recherche de données, telles que les règles de recherche de priorités.
      Exécuter sur une insertion Cochez cette case pour rechercher automatiquement les valeurs chaque fois qu’un utilisateur crée un nouvel enregistrement.
      Exécuter sur une mise à jour Cochez cette case pour rechercher automatiquement les valeurs chaque fois qu’un utilisateur enregistre ou met à jour un enregistrement.
    5. Cliquez avec le bouton droit sur 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. Renseignez les définitions de champs de correspondance à l’aide de la table suivante.

      Une recherche de données s’effectue uniquement sur les champs avec des définitions de champ correspondantes. La recherche de données utilise les valeurs des champs de la table source pour rechercher une ou plusieurs valeurs 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 périmètre actuel contenant les valeurs de recherche.
      Concordance de recherche exacte

      Cochez cette case pour exiger que la table de correspondance contienne une ligne correspondante pour chaque combinaison de valeurs possible (y compris les valeurs vides). Si vous décochez cette case, toutes les valeurs vides dans la table de correspondance correspondent à n’importe quelle valeur. Par exemple, supposons que le champ Priorité soit vide dans la table de correspondance. Lorsque cette case est cochée, il y a une correspondance uniquement lorsque la valeur Priorité est vide dans la ligne de la table source. Lorsque cette case n’est pas cochée, 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 Soumettre.
    9. Dans la liste connexe Définitions de champ de réglage , 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 de définitions de recherche de données parent.
      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 à partir de la table de correspondance qui fournit la nouvelle valeur pour la mise à jour.
      Toujours remplacer Case à cocher pour remplacer toute valeur existante par une valeur provenant de la recherche de données. Décochez la case pour ignorer la mise à jour si le champ a une valeur existante.
    11. Sélectionnez Soumettre.
    12. Sélectionnez Mettre à jour.

      Par exemple, la définition de recherche de données suivante affecte les incidents au groupe de problèmes VIP en fonction du champ Appelant . En outre, les incidents sont définis sur Critique ou Priorité élevée en fonction de l’appelant.

      Définition de la recherche de données

    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 d’instance.

    Procédure

    1. Accédez à la Tout > Définition du système > Menus d'application, puis sélectionnez une application à laquelle ajouter le module.
    2. Dans la liste connexe Modules, cliquez sur 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. Cliquez sur Envoyer.

    Dépannage de la recherche de données

    Si les règles de définition de la recherche de données personnalisée 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 des 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, par exemple :

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