Renseigner les suggestions de recherche dans Portail de services

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 3 minutes de lecture
  • Si vous effectuez une mise à niveau à partir d'une version précédente, exécutez un script pour remplir les suggestions de recherche avec les données d'une table de recherche de plateforme et ainsi fournir des suggestions de recherche aux utilisateurs. Vous pouvez également attendre que les utilisateurs recherchent des mots clés plutôt que 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, consultez Activer les suggestions de recherche.

    Pourquoi et quand exécuter cette tâche

    ServiceNow AI Platform collecte des analyses et des données de recherche qui génèrent des suggestions de recherche. Si vous effectuez une mise à niveau à partir d'une version précédente, l'analyse de recherche ne contient pas encore de données. Pour fournir immédiatement des suggestions aux utilisateurs, vous pouvez remplir 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 [sp_log] de Portail de services. La table Entrées de journal du 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. La table Recherche de texte inclut 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. Les suggestions de recherche sont une fonctionnalité ServiceNow AI Platform. Pour plus d’informations, voir Suggestions de recherche.

    Avertissement :
    Remplir les suggestions de recherche peut s'avérer être une tâche gourmande en ressources et en temps. N'exécutez pas ce script pendant les heures de pointe. Remplir les suggestions de recherche n'est pas pris en charge dans des 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 Remplir les suggestions pour éviter le démarrage à froid - portails .
    3. Modifiez le script pour 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. Modifier 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 [sp_log] de Portail de services. Les entrées de journal de Portail de services enregistrent uniquement les enregistrements des 90 derniers jours.
        var searchLogTable = "text_search";
      3. Transférez les données vers 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, transmettez par push les 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 Catalogue et Connaissances aux 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 de 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 à saisir dans un widget de Portail de services recherche.