Renseigner les suggestions de recherche dans Portail de services

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 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 : 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

    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 de la table Recherches de texte [text_search] ou de la table Entrées de journal du Service Portal [sp_log]. La table Entrées de journal de Service Portal inclut uniquement les données de recherche provenant de suggestions de recherche et peut prendre moins de temps pour renseigner les suggestions de Portail de services recherche. La table 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. Les suggestions de recherche sont une fonctionnalité Now Platform. Pour plus d’informations, consultez 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 remplit les suggestions dans le Service Portal 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 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 du Service Portal [sp_log]. Les entrées de journal de Service Portal enregistrent uniquement les enregistrements des 90 derniers jours.
        var searchLogTable = "text_search";
      3. Transmettez des données par push vers n’importe quelle source de recherche personnalisée dans votre instance.

        Les suggestions ne sont pas activées pour les sources de recherche externes. Vous devez transmettre les données par push à 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 à Définir une source de recherche. Par défaut, le système transmet 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 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 du texte dans un Portail de services widget de recherche.