Personnalisation des résultats de recherche dans SharePoint

Article
03/21/2023

Découvrez comment regrouper des éléments similaires ou supprimer des éléments en double dans un ensemble de résultats de recherche dans SharePoint pour que vous puissiez afficher ces résultats de façon concise et lisible.

Dans les résultats de recherche, regroupement réduit deux ou plus similaires éléments d'un résultat de recherche définir pour améliorer la lisibilité de leur affichage pour un utilisateur. Suppression des doublons des résultats de recherche est une partie du regroupement, dans lequel les éléments qui sont identiques ou pratiquement identiques sont supprimés du jeu de résultats. En fonction des paramètres définis par l'administrateur SharePoint, l'utilisateur peut être en mesure de développer le jeu de résultats de recherche plus loin et afficher les résultats individuels qui ont été réduits.

Voici quelques exemples de moyens de résultats de recherche de groupe :

Dupliquez la détection, où les documents pratiquement identiques sont supprimés du jeu de résultats.
Site de réduction, où uniquement l'élément plus pertinents trouvé dans chaque site est indiqué dans le jeu de résultats.
Ensemble de documents réduction, où les correspondances qu'un seul est affiché pour chaque bibliothèque de documents dans SharePoint.

Vous pouvez spécifier les critères de réduction ou de suppression dupliquée par programme à l’aide des propriétés KeywordQuery suivantes dans le modèle objet Query :

Réduire les résultats de recherche similaires à l’aide de la propriété CollapseSpecification

La prend de propriété CollapseSpecification un paramètre Spec qui peut contenir plusieurs champs séparé par une virgule ou un espace, évaluées ensemble spécifier un ensemble de critères utilisés pour la réduction.

SyntaxeCollapseSpecification = Spec

Le tableau suivant répertorie les champs du paramètre Spec .

Tableau 1. Champs de paramètre de spécification

Élément dans le paramètre	Description
Spec	`Subspec(<space>Subspec)*`
Subspec	`Prop(','Prop)*[':'Dups]`
Prop	Une propriété gérée valide ou un alias d'une propriété gérée. Prop respecte la casse. La propriété gérée doit être interrogée et triable ou refineable.
Dups	Nombre entier spécifiant le nombre d'éléments à conserver. La valeur par défaut est 1.
<Espace>	Les propriétés sont combinées à l'aide de l'opérateur OR.
,	Les propriétés sont combinées à l'aide de l'opérateur AND.
*	Indique le nombre d'éléments.
() or []	Indique les éléments facultatifs.

Si les champs dans Spec sont séparés par des virgules, les champs sont combinés à l’aide de l’opérateur AND . Si tous les champs spécifiés sont mis en correspondance, les éléments sont réduits.

En revanche, si les champs dans Spec sont séparés par des espaces, les champs (ou sous-spécifications) sont combinés à l’aide d’une extension qui inclut à la fois l’opérateur AND et l’opérateur OR . Par exemple, une expression telle que Category:3 Product:2 est transformée en interne à l' expression suivante (Category AND Product) OR (Category) avec un compteur pour chaque ; Par conséquent, un maximum de deux de la première et trois de ces derniers. Les éléments sont réduits si certains champs spécifiés sont mis en correspondance.

Exemples d’utilisation de CollapseSpecification

Le tableau suivant illustre un catalogue de produits à partir de la société Contoso. L'ensemble suivant d'exemples utilisent ce catalogue pour montrer le fonctionne de la propriété CollapseSpecification.

Catégorie	Produit	Variant	Titre
Ordinateurs portables	WWI	19W X 0196 noir	Ordinateur 1
Ordinateurs portables	Adventure Works	12 M1201 rouge	Ordinateur 2
Ordinateurs portables	Adventure Works	15, 4W M1548 blanc	Ordinateur 3
Ordinateurs portables	Proseware	19 x 910 noir	Ordinateur 4
Ordinateurs portables	Proseware	Laptop19 X 910 noir	Ordinateur 5
Ordinateurs de bureau	Adventure Works	2,33 XD233 argentée	Ordinateur 6
Ordinateurs de bureau	WWI	2,33 x 2330 noir	Ordinateur 7
Ordinateurs de bureau	Adventure Works	1.60 ED160 livre	Ordinateur 8
Ordinateurs de bureau	WWI	3.0 M0300 argentée	Ordinateur 9

Exemple : regrouper par catégorie

Tout d'abord, regrouper les éléments en fonction de Category et affiche les deux premiers (d'où "Category:2") pour chaque groupe. Ensuite, pour chaque Category, afficher un nombre correspondant d'unique (d'où « Produit: 1 ») Products.

SyntaxeCollapseSpecification="Category:2 Product:1"

Il doit renvoyer les résultats suivants.

Catégorie	Produit	Variant	Titre
Ordinateurs portables	WWI	19W X 0196 noir	Ordinateur 1
Ordinateurs portables	Adventure	12 M1201 rouge	Ordinateur 2
Ordinateurs de bureau	Adventure Works	2,33 XD233 argentée	Ordinateur 6
Ordinateurs de bureau	WWI	2,33 x 2330 noir	Ordinateur 7

Le code suivant permet de réduire les résultats de recherche à l'aide de la propriété CollapseSpecification.

using (var context = new ClientContext("http://localhost"))
{
    var query = new KeywordQuery(context)
        {
            QueryText = "Title:Computer",
            CollapseSpecification = "Category:3 Product:1",
        };

    var executor = new SearchExecutor(context);
    var results = executor.ExecuteQuery(query);

    context.ExecuteQuery();

    foreach (var result in results.Value[0].ResultRows)
    {
        Console.WriteLine(result["Title"]);
    }
}

Exemple : regrouper par catégorie et produit

Tout d'abord, regrouper les éléments en fonction de Category et Product. Ensuite, afficher chaque combinaison unique.

SyntaxeCollapseSpecification="Category,Product:1"

Il doit renvoyer les résultats suivants.

Catégorie	Produit	Variant	Titre
Ordinateurs portables	WWI	19W X 0196 noir	Ordinateur 1
Ordinateurs portables	Adventure Works	12 M1201 rouge	Ordinateur 2
Ordinateurs portables	Proseware	19 x 910 noir	Ordinateur 4
Ordinateurs de bureau	Adventure Works	2,33 XD233 argentée	Ordinateur 6
Ordinateurs de bureau	WWI	2,33 x 2330 noir	Ordinateur 7

Découper les résultats de la recherche en double à l’aide de la propriété TrimDuplicates

TrimDuplicates permet de spécifier si pour supprimer la recherche de doublons des résultats à partir du résultat défini. TrimDuplicates est true par défaut.

Si vous utilisez TrimDuplicates avec TrimDuplicatesOnProperty ou, de préférence, CollapseSpecification, TrimDuplicates est définie sur false.

SyntaxeTrimDuplicates = <$true | $false>

Découper les résultats de la recherche en double à l’aide de la propriété TrimDuplicatesOnProperty

TrimDuplicatesOnProperty permet de spécifier si utiliser un par défaut propriété gérée comme base de filtrage des doublons. La valeur par défaut est la propriété DocumentSignature gérés. La propriété gérée doit être de type Integer ou String. En utilisant une propriété gérée qui représente un groupement d'éléments, vous pouvez utiliser cette fonctionnalité pour la réduction de champ.

SyntaxeTrimDuplicatesOnProperty = <managed property>

Remarque

Dans SharePoint, utilisez CollapseSpecification lorsque c’est possible. TrimDuplicatesOnProperty est disponible uniquement à des fins de compatibilité descendante.

Découper les résultats de la recherche en double à l’aide de la propriété TrimDuplicatesKeepCount

TrimDuplicatesKeepCount permet de spécifier le nombre de documents à conserver lorsque TrimDuplicates est true. Si TrimDuplicates est basée sur une propriété gérée qui peut être utilisée comme un identificateur de groupe, par exemple un ID de site, vous pouvez contrôler le nombre de résultats est renvoyé pour chaque groupe. Les éléments retournés sont ceux dont le classement dynamique plus élevé au sein de chaque groupe.

SyntaxeTrimDuplicatesKeepCount = <number>

Récupérer les résultats de la recherche en double à l’aide de la propriété TrimDuplicatesIncluded

Utiliser TrimDuplicatesIncludeId pour extraire les doublons d'un document lorsque TrimDuplicates est true et TrimDuplicatesOnProperty ou CollapseSpecification est définie sur false.

L’ID de document, docid, est utilisé pour récupérer les doublons d’un document particulier.

SyntaxeTrimDuplicatesIncludeId = <docid>