Définir une source de recherche

  • Rversion finale: Australia
  • Mis à jour 17 juin 2026
  • 4 minutes de lecture

    • 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 dans le formulaire Source de recherche .
      Tableau 1. Formulaire Source de recherche
      Champ Description
      Nom La 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 Périmètre de la source de recherche.
      Rôles Si le module d’extension Prise en charge des critères d’utilisateur du Portail de services 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é. 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 de la base de connaissances externe.

      Remarque :
      Si vous définissez un script de génération de facettes, injectez l’objet de 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 la base de connaissances et les sources de recherche du catalogue de services. 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. Permettez à vos utilisateurs finaux de filtrer les résultats de recherche pour obtenir un ensemble de résultats plus significatif. 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 facettes, injectez l’objet de 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 la base de connaissances et les sources de recherche du catalogue de services. 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 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 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 recherche. True par défaut.

      Si Est une source scriptée est sélectionné, 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 source de recherche.

      Définissez le nombre maximal de résultats par requête pour la source de recherche dans les options d’instance de widget Page de recherche ou 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 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 éventuellement 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 le formulaire est configuré, un résultat de suggestion automatique sélectionné s’ouvre dans un formulaire.

      Exemple de paramètres de l’onglet Suggestion automatique. Le champ Page est défini sur 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.