Renseigner les suggestions de recherche dans Portail de services

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

    • Si vous effectuez une mise à niveau à partir d’une version précédente, exécutez un script pour renseigner les suggestions de recherche avec des données provenant d’une table de recherche de plateforme afin de fournir des suggestions de recherche à vos utilisateurs. Sinon, vous pouvez attendre que les utilisateurs recherchent des mots clés au lieu d’exécuter ce script.

    Avant de commencer

    Rôle requis : admin

    Dans les nouvelles instances, les suggestions de recherche sont activées par défaut. Dans les instances mises à niveau, vous devez activer les suggestions de recherche. Pour plus d’informations, voir Activer les suggestions de recherche.

    Pourquoi et quand exécuter cette tâche

    La ServiceNow AI Platform collecte des données de recherche et des analyses qui génèrent des suggestions de recherche. Si vous effectuez une mise à niveau à partir d’une version précédente, les analyses de recherche ne contiennent pas encore de données. Pour fournir immédiatement des suggestions à vos utilisateurs, vous pouvez renseigner les suggestions de recherche à l’aide de données de la table Recherches de texte [text_search] ou de la table Entrées de journal du portail de services [sp_log]. La table Entrées de journal de Portail de services inclut uniquement les données de recherche et peut prendre moins de temps pour renseigner les suggestions de Portail de services recherche. Le tableau Recherche de texte comprend des données de recherche provenant de l’ensemble de la plateforme.

    Les suggestions de recherche s’améliorent au fil du temps à mesure que de plus en plus de personnes utilisent Portail de services. Suggestions de recherche est une ServiceNow AI Platform fonctionnalité. Pour plus d’informations, voir Suggestions de recherche.

    Avertissement :
    Le remplissage des suggestions de recherche peut être une tâche gourmande en ressources qui peut prendre du temps. N’exécutez pas ce script pendant les heures de pointe. Le remplissage des suggestions de recherche n’est pas pris en charge sur les instances séparées par domaine.

    Procédure

    1. Accédez à la Tous > Définition du système > Travaux planifiés.
    2. Ouvrez la tâche planifiée Renseigner les suggestions pour éviter le démarrage à froid : portails .
    3. Modifiez le script de votre implémentation de recherche.
      1. Définissez les portails auxquels les suggestions s’appliquent.
        Par défaut, le script renseigne les suggestions dans le portail de services du système de base, mais vous pouvez en ajouter autant que vous le souhaitez au tableau.
        var portals = ["Service Portal"];
      2. Changer l’origine des données
        Par défaut, le script importe des données à partir de la table Recherches de texte [text_search], mais vous pouvez remplacer la table source par la table Entrées de journal du portail de services [sp_log]. Les entrées de journal de Portail de services enregistrent uniquement les enregistrements des 90 derniers jours.
        var searchLogTable = "text_search";
      3. Envoyez les données à toutes les sources de recherche personnalisées dans votre instance.

        Les suggestions ne sont pas activées pour les sources de recherche externes. Vous devez transmettre les données par push au nom de la source de recherche et à l’ID système.

        Par exemple, effectuez des recherches textuelles de la table Incident vers votre source de recherche d’incident personnalisée. Pour plus d’informations sur les sources de recherche personnalisées, reportez-vous à la section Définir une source de recherche. Par défaut, le système envoie les recherches de texte des tables de catalogue et de connaissances vers les sources de recherche respectives.

        Ajoutez le code suivant après la ligne 11 dans le script pour chacune de vos sources de recherche personnalisées.

        searchSources.push("<search-source-table-name>");
searchSourceIds.push("<search-source-sys-id>");

        Si la table de source de recherche n’existe pas, le système n’envoie pas les suggestions à cette source de recherche.

      4. Enregistrez l'enregistrement.
        Assurez-vous que le script inclut la configuration dont vous avez besoin. Vous ne pouvez exécuter le script qu’une seule fois.
    4. Activez l’enregistrement et sélectionnez Exécuter maintenant.
      L’exécution de cette tâche planifiée remplit les tables Événements de recherche [sys_search_event], Événements de source de recherche [sys_search_source_event] et Suggestions de recherche [sys_search_suggestion].

    Résultats

    Les utilisateurs voient des suggestions lorsqu’ils commencent à taper dans un widget de Portail de services recherche.