Définir une source de recherche

Configurez une source de recherche de base pour interroger les données d’une table d’instance, ou configurez un script d’extraction de données avancé pour interroger les données sur plusieurs tables et sources de données, ou pour extraire des données de n’importe où sur le Web.

Avant de commencer

Rôle requis : admin

Procédure

1. Dans l’interface utilisateur de la plateforme, accédez à Portail de services > Portails et sélectionnez le portail auquel vous souhaitez ajouter des sources de recherche.
2. Dans la liste connexe Sources de recherche, cliquez sur Nouveau pour ajouter une source de recherche.
3. Définissez les champs sur le formulaire Source de recherche .

   Tableau 1. Formulaire Source de recherche

   Champ	Description
   Nom	Valeur d’affichage de la catégorie de recherche.
   ID	ID de l’enregistrement. La valeur doit être unique et ne doit pas inclure d’espaces ou de caractères spéciaux.
   Application	Le périmètre de la source de recherche.
   Rôles	Si le module d’extension Support des critères d’utilisateur du portail de services n’est pas activé, définissez des rôles d’utilisateur pour accéder à cette source de recherche.
   Modèle de page de recherche	Modèle HTML qui affiche les résultats de la recherche. Si vous définissez une source de recherche de base, vous n’avez pas besoin de modifier le modèle par défaut. Pour obtenir un exemple de modèle modifié, reportez-vous à la section Didacticiel : configurer une source de recherche dans la base de connaissances externe.

4. Renseignez les champs dans l’onglet Source de données .

   Champ	Description
   Est une source scriptée	Ajoute un script d’extraction de données avancé. Si vous configurez une table d’instance comme source de données, ne cochez pas cette option.
   Script d'extraction de données	Script définissant le point de terminaison et les appels d’API pour extraire les données. Ce champ n’est visible que lorsque Est une source scriptée est sélectionné. Pour obtenir un exemple de script d’extraction de données, reportez-vous à la section Didacticiel : configurer une source de recherche dans la base de connaissances externe. Remarque : Si vous définissez un script de génération de facette, injectez l'objet des facettes dans le script d'extraction de données et mettez à jour le script pour générer des données pour chaque élément de facette. Pour obtenir un exemple, consultez les sources de recherche de la Base de connaissances et de Service Catalog. Les facettes de recherche peuvent ne pas se comporter comme prévu si elles sont intégrées dans une source de recherche avancée qui interroge les données d’un non-site ServiceNow .
   Script de génération de facette	Script définissant les facettes de recherche pour une source de recherche scriptée. Offrez aux utilisateurs finaux la possibilité de filtrer des résultats de recherche pour obtenir un ensemble de résultats plus pertinent. Ce champ n’est visible que lorsque Est une source scriptée est sélectionné. Remarque : Si vous définissez un script de génération de facette, injectez l'objet des facettes dans le script d'extraction de données et mettez à jour le script pour générer des données pour chaque élément de facette. Pour obtenir un exemple, consultez les sources de recherche de la Base de connaissances et de Service Catalog. Les facettes de recherche peuvent ne pas se comporter comme prévu si elles sont intégrées dans une source de recherche avancée qui interroge les données d’un non-site ServiceNow .
   Table	Sélectionnez une table dans la liste à partir de laquelle vous souhaitez extraire vos résultats. Vous pouvez sélectionner n’importe quelle table de la plateforme. Par exemple, Utilisateur [sys_user] ou Connaissances [kb_knowledge]. Remarque : Seules les tables indexées renvoient des résultats de recherche. Pour en savoir plus : Configure a table for indexing and searching.
   Conditions	Filtre les résultats en fonction des conditions définies. Par exemple, Actif a la valeur Vrai.
   Champ d'affichage primaire	Sélectionnez le champ que vous souhaitez afficher sur la page des résultats de recherche. Par exemple, Nom.
   Champs d'affichage	Sélectionnez des champs supplémentaires à afficher sur la page des résultats de recherche. Par exemple, ID d’utilisateur, e-mail et ville.
   Paginer les résultats	Pagine les résultats de la recherche. True par défaut. Si Est une source scriptée est sélectionnée, la valeur est mise à jour sur faux. Pour activer la pagination pour une source de recherche scriptée, reportez-vous à la section Paginer les résultats de la source de recherche. Définissez le nombre maximal de résultats par requête pour la source de recherche dans les options d’instance du widget Page de recherche ou du widget Recherche à facettes.

5. Configurez les paramètres de suggestion automatique pour permettre aux résultats de recherche de renseigner le champ de recherche en fonction de l’entrée de l’utilisateur.

   Champ	Description
   Activer la suggestion automatique	Permet la fonctionnalité de suggestion automatique. Si vous ne souhaitez pas intégrer la suggestion automatique dans votre source de recherche, désactivez la case à cocher.
   Configuration avancée de la suggestion automatique	Vous pouvez également ajouter un script de suggestion automatique avancé pour configurer l’affichage des résultats de recherche. Pour plus d'informations, consultez Créer un modèle de suggestion automatique avancé.
   Glyphe de suggestion automatique	Ajoute une icône à côté de chaque résultat de suggestion automatique.
   Page	Définit une page du portail de services pour afficher le résultat sélectionné. Par exemple, si un formulaire est configuré, un résultat de suggestion automatique sélectionné s’ouvre dans un formulaire.

   

6. Cliquez sur Envoyer.

Que faire ensuite

Pour permettre aux utilisateurs finaux d’affiner les résultats de recherche, Ajouter des facettes à une source de recherche simple.

• Paginer les résultats de la source de recherche
  Limitez le nombre de résultats qu'une source de recherche affiche simultanément pour améliorer les performances. Les utilisateurs finaux peuvent charger plus de résultats au besoin.
• Créer un modèle de suggestion automatique avancé
  Configurez la façon dont les résultats de suggestion automatique s’affichent avec un modèle avancé.
• Didacticiel : configurer une source de recherche dans la base de connaissances externe
  Définissez une source de recherche avancée pour renvoyer des données provenant de n’importe quelle source sur Internet. Pour comprendre la puissance des sources de recherche, suivez ce didacticiel pour configurer une source de recherche de base de connaissances externe.
• Exemple : configurer une source de recherche GitHub
  Configurez une source de recherche avancée qui interroge les données d’un site web externe.