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 dans 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	Champ d’application de la source de recherche.
   Rôles	Si le module d’extension Service Portal User Criteria Support n’est pas activé, définissez les 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 de la base de connaissances externe.

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

   Champ	Description
   Est une source scriptée	Ajoute un script d’extraction de données avancée. 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 vous sélectionnez Est une source scriptée . Pour obtenir un exemple de script d’extraction de données, reportez-vous à Didacticiel : configurer une source de recherche de 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 vous sélectionnez Est une source scriptée . 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 dans la liste une table à partir de laquelle vous souhaitez extraire vos résultats. Vous pouvez sélectionner n’importe quelle table dans 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 de conditions définies. Par exemple, Actif est défini sur 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 recherche. Vrai par défaut. Si Est une source scriptée est sélectionnée, la valeur est mise à jour sur false. Pour activer la pagination d’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 de recherche à facettes.

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

   Champ	Description
   Activer la suggestion automatique	Autorise la fonctionnalité de suggestion automatique. Si vous ne souhaitez pas intégrer la suggestion automatique à votre source de recherche, décochez la case.
   Configuration avancée de la suggestion automatique	Vous pouvez également ajouter un script de suggestion automatique avancé pour configurer la façon dont les résultats de recherche s’affichent. 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ée 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 la suggestion automatique s’affichent avec un modèle avancé.
• Didacticiel : configurer une source de recherche de la base de connaissances externe
  Définissez une source de recherche avancée pour renvoyer des données à partir de n’importe quelle source sur Internet. Pour comprendre la puissance des sources de recherche, suivez ce didacticiel pour configurer une source de recherche externe de la base de connaissances.
• Exemple : configurer une source de recherche GitHub
  Configurez une source de recherche avancée qui interroge les données d’un site Web externe.