Renseigner les suggestions de recherche dans Portail de services

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 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 : administrateur

    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

    Now 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 provenant 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 du portail de services comprend uniquement des données de recherche provenant de 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é Now Platform. Pour plus d’informations, reportez-vous à la section 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 Tout > 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 remplit 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 les données de la table Recherches de texte [text_search], mais vous pouvez remplacer la table source par la table Entrées de journal [sp_log]. Les entrées de journal du Service Portal enregistrent uniquement les enregistrements des 90 derniers jours.
        var searchLogTable = "text_search";
      3. Envoyez les données par push à toutes les sources de recherche personnalisées de votre instance.

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

        Par exemple, transférez les recherches de texte de la table Incident vers votre source de recherche d’incident personnalisée. Pour en savoir plus 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 textuelles des tables Catalogue et 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 ne transmet 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.