Partager via

Présentation : Configuration de tables supplémentaires pour la recherche globale

  • Article

Résumé

Vous pouvez activer des tables supplémentaires pour la fonctionnalité de recherche. La configuration de la recherche de tables supplémentaires nécessite des actions supplémentaires, décrites dans cet article. Ces étapes de configuration explicites garantissent qu’aucun enregistrement ne sera accidentellement rendu disponible à l’aide de la recherche globale.

Étapes pour configurer la recherche de tables supplémentaires

Pour configurer la recherche de tables supplémentaires :

  1. Activer la recherche de tables supplémentaires pour la première fois en ajoutant un nouveau paramètre Search/EnableAdditionalEntities et réglez-le sur true. Il s’agit d’une étape unique qui permet de rechercher toutes les tables prêtes à l’emploi et personnalisées supplémentaires.

  2. Créer une vue de recherche de portail pour chaque table supplémentaire avec les filtres et colonnes requis qui doivent faire l’objet d’une recherche.

  3. Configurer les autorisations de table pour chaque table supplémentaire avec un rôle Web d’avoir au moins le privilège de lecture. Ignorez cette étape si vous disposez déjà des autorisations de lecture configurées pour chaque table.

  4. Créer une page de détails d’enregistrement pour chaque tableau pour montrer les détails de l’enregistrement sélectionné à partir de la page des résultats de recherche. Ignorez cette étape si vous avez déjà créé une page de détails d’enregistrement de résultats distincte pour chaque table.

  5. Créer un marqueur de site nommé <entitylogicalname>_SearchResultPage pour chaque table avec la page de détails de l’enregistrement.

  6. Régénérer l’index de recherche.

  7. Vérifier les résultats de la recherche.

Avertissement

Si vous ne créez pas de page de détails d’enregistrement ou si vous ne liez pas la page de détails d’enregistrement avec un marqueur de site pour la recherche, vous ne pourrez pas sélectionner les enregistrements de table supplémentaires à partir de la page de résultats de recherche pour afficher les détails de l’enregistrement.

Paramètre de site pour des tables supplémentaires

Le paramètre du site Search/EnableAdditionalEntities est requis lors de la configuration de tables supplémentaires pour la recherche.

Important

Search/EnableAdditionalEntities est explicitement pour permettre la recherche de tables supplémentaires. Le paramètre principal du site de recherche Recherche/Activé doit être défini sur true lors de l’utilisation de la fonctionnalité de recherche.

Vous pouvez également configurer d’autres paramètres de site associés similaires à la configuration de recherche pour les tables par défaut. Par exemple, vous pouvez utiliser le paramètre Recherche/Filtres pour configurer des tables supplémentaires et ajouter une option de filtre déroulant à la recherche globale. Plus d’informations : Paramètres du site associé

Marqueur de site pour la page des détails de l’enregistrement

La page des détails de l’enregistrement est configurée à l’aide d’un Marqueur de site nommé <entitylogicalname>_SearchResultPage.

Par exemple, si le nom logique de votre table est nwind_products, le marqueur de site sera nwind_products_SearchResultPage. La valeur du marqueur de site est la page de détails de l’enregistrement que vous souhaitez ouvrir lorsque ce résultat de recherche est sélectionné. Par défaut, un ID d’enregistrement est passé dans le paramètre Querystring d’ID sur la page des détails de l’enregistrement. Pour plus d’informations sur l’ajout de formulaires sur une page, accédez à Ajouter un formulaire.

Important

Il existe deux exceptions de nom logique de table dans la configuration des marqueurs de site pour la page des détails de l’enregistrement.

  • Le tableau incident exige que le marqueur de site soit nommé cas.
  • Le tableau knowledgearticle exige que le marqueur de site soit nommé article connaissance.

Important

Assurez-vous que la page des détails de votre enregistrement a un formulaire de base ou une logique écrite pour afficher les détails des résultats de la recherche. Par exemple, Étape 4 – Ajouter la page des détails de l’enregistrement dans la procédure pas à pas suivante.

La procédure pas à pas suivante explique chaque étape en détail avec un exemple de base de données et une solution pour configurer la recherche de tables supplémentaires.

Note

  • Cette procédure pas à pas explique comment activer la recherche pour la table Commander des produits dans la base de données exemple Northwind, disponible avec Microsoft Dataverse. Pour plus d’informations sur les exemples de bases de données, consultez Installer la base de données et les applications de Northwind Traders.
  • Vous pouvez suivre la procédure pas à pas avec une table de votre choix en remplaçant le nom de la table nwind_products avec le nom logique de votre table.

Étape 1 : ajouter ou mettre à jour les paramètres du site de recherche

  1. Assurez-vous que vous êtes dans l’environnement approprié où votre site Power Pages existe.  

  2. Accédez à l’application Gestion des portails.

    Note

    L’application de gestion de portail peut être nommée Portails Dynamics 365 si vous êtes dans un environnement où les applications Dynamics 365 sont installées.

  3. Sélectionnez pour ouvrir l’application Gestion du portail, puis accédez à Paramètres du site dans le volet de navigation de gauche.

  4. Créez un paramètre, Search/EnableAdditionalEntities, et définissez sa valeur sur true.

  5. Créez ou mettez à jour le paramètre Rechercher/filtres et ajoutez la valeur Produits : nwind_products.

Étape 2 : créer ou vérifier la vue de recherche de portail

Note

Les étapes suivantes nécessitent que la Solution Northwind Traders soit installée. Si vous souhaitez utiliser une autre table, utilisez la solution appropriée ou utilisez la solution par défaut.

  1. Accédez à Power Apps et sélectionnez Solutions dans le volet de navigation de gauche.

  2. Sélectionnez Northwind Traders.

  3. Recherchez la table Commander un produit.

  4. Sélectionnez la table Commander un produit, puis sélectionnez Vues.

  5. Assurez-vous de voir Recherche du portail dans la liste des vues.

    Si la vue Recherche du portail n’existe pas déjà, sélectionnez Ajouter une vue, entrez le nom comme Recherche du portail, puis sélectionnez Créer.

  6. Assurez-vous que les colonnes appropriées sont ajoutées à la vue de recherche.

  7. Si vous avez modifié la vue, assurez-vous de sélectionner Enregistrer, puis Publier avant de continuer.

Étape 3 : Créer des autorisations de table

  1. Accédez à l’application Gestion des portails.

  2. Sélectionnez autorisations de table dans le volet de navigation de gauche.

  3. Sélectionnez Nouveau.

  4. Entrez le nom comme Produits Northwind Tout lire, puis sélectionnez le Type d’accès et le privilège Lecture.

    Pour cet exemple, le type d’accès Global est fourni au tableau nwind_products.

  5. Cliquez sur Enregistrer et fermer.

  6. Sélectionnez et ouvrez Lire tous les produits Northwind.

  7. Faites défiler jusqu’à la section Rôles web, puis sélectionnez Ajouter un rôle web existant.

  8. Recherchez Utilisateurs authentifiés, et sélectionnez Ajouter.

Étape 4 : Ajouter la page Web des détails de l’enregistrement

  1. Accédez à Power Apps et sélectionnez Applications dans le volet de navigation de gauche.

  2. Sélectionner Autres commandes (…), puis sélectionnez Modifier pour ouvrir le site dans le studio de conception.

  3. Sélectionnez Nouvelle page dans le menu dans le coin supérieur gauche, puis sélectionnez la disposition Vide de la page.

  4. Entrez le nom de la page web comme Produits de la commande.

    Note

    Cette page s’affiche lorsque les utilisateurs sélectionnent un enregistrement dans la page des résultats de la recherche pour afficher les détails de l’enregistrement sélectionné.

  5. Sélectionnez Composants dans le volet de navigation de gauche, puis ajoutez un composant Formulaire à cette page web.

  6. Sélectionnez l’option Utiliser l’existant sur le côté droit de votre espace de travail, choisissez le formulaire Voir les produits pour la table nwind_products, puis définissez Mode à Lecture seulement.

Étape 5 : Ajouter un marqueur de site pour la page Web des détails de l’enregistrement

  1. Accédez à l’application Gestion des portails. 

  2. Dans le volet de navigation gauche, sélectionnez Marqueur de site.

  3. Sélectionnez Nouveau, puis créez un marqueur de site en utilisant les détails suivants :

    • Nom :nwind_products_SearchResultPage
    • Page :Produits de la commande

Étape 6 : Régénérer l’index de recherche

Note

Reconstruire l’index de recherche est lié à la recherche Lucene .NET et ne s’applique pas à Dataverse la recherche.

  1. Parcourez votre site web à l’aide d’un compte d’utilisateur auquel le rôle web d’administrateur a été attribué.

  2. Ajoutez l’URL dans la barre d’adresse avec /_services/about, puis sélectionnez Entrée.

  3. Sélectionnez Effacer le cache.

  4. Après avoir vidé le cache, sélectionnez Reconstruire l’index de recherche.

Étape 7 : Vérifiez que la recherche globale fonctionne avec la table personnalisée

  1. Accédez au portail avec un utilisateur qui a Authentifiéle Rôle web attribué.

  2. Accédez à la barre d’outils de recherche ou à la page de recherche et recherchez un enregistrement connu.

    Par exemple, utilisez le mot-clé de recherche Chaudrée de palourdes Northwind pour obtenir les résultats associés à la table nwind_products.

Étapes suivantes

Supprimer une table de la recherche globale

Voir aussi

Paramètres de site associés
Recherche progressive