Requêtes de mots clés de restrictions de propriétés
Dernière modification : mardi 20 juillet 2010
S’applique à : SharePoint Server 2010
Avec la syntaxe de mot clé Recherche de contenu d’entreprise SharePoint dans SharePoint Server 2010, vous pouvez construire des requêtes qui utilisent des restrictions de propriétés pour affiner la requête de sorte qu’elle renvoie uniquement les résultats répondant à une condition spécifiée.
Spécification de restrictions de propriétés
Une restriction de propriété de base se présente comme suit :
<Property Name><Property Operator><Property Value>
Voici quelques exemples de restrictions de propriétés à syntaxe de mot clé valides :
author :"John Smith"
Renvoie les éléments de contenu créés par John Smith.
filetype:docx
Renvoie des documents Microsoft Word.
filename:budget.xlsx
Renvoie des éléments de contenu avec le nom de fichier budget.xlsx.
La restriction de propriété ne doit pas contenir d’espace entre le nom de propriété, l’opérateur de propriété et la valeur de propriété, sinon elle est traitée comme requête de texte libre. La longueur d’une restriction de propriété est limitée à 2048 caractères.
Dans les exemples suivants, la présence de l’espace fait en sorte que la requête renvoie les éléments de contenu contenant les termes « author » et « John Smith » au lieu des éléments de contenu créés par John Smith :
author: "John Smith"
author :"John Smith"
author : "John Smith"
Ceci équivaut à l’exemple suivant :
author "John Smith"
Noms de propriétés
Vous devez spécifier un nom de propriété gérée valide pour la restriction de propriété. Par défaut, Recherche de contenu d’entreprise SharePoint inclut plusieurs propriétés gérées pour les documents.
Pour spécifier une restriction de propriété pour une valeur de propriété analysée, vous devez d’abord mapper la propriété analysée à une propriété gérée. Pour plus d’informations, voir la section « Propriétés gérées et analysées » de l’article Planifier les conditions d’utilisation de la recherche pour l’utilisateur final.
L’un des paramètres de propriétés gérées suivants doit être true :
Retrievable, qui stocke la valeur de propriété dans la base de données Banque de propriétés.
FullTextQueriable, qui stocke la valeur de propriété dans l’index de texte intégral.
Opérateurs de propriétés
Recherche de contenu d’entreprise SharePoint prend en charge plusieurs nouveaux opérateurs de propriétés. Le Tableau 1 répertorie les opérateurs de propriétés valides utilisables dans les restrictions de propriétés.
Tableau 1. Opérateurs de propriétés valides pour les restrictions de propriétés
Opérateur |
Description |
Type de propriété géré pris en charge |
|---|---|---|
: |
Renvoie les résultats où la valeur spécifiée dans la restriction de propriété est égale à la valeur de propriété stockée dans la base de données Banque de propriétés ou correspond à des termes individuels dans la valeur de propriété stockée dans l’index de texte intégral. |
|
= |
Renvoie les résultats de recherche où la valeur de propriété est égale à la valeur spécifiée dans la restriction de propriété. |
|
< |
Renvoie les résultats de recherche où la valeur de propriété est inférieure à la valeur spécifiée dans la restriction de propriété. |
|
> |
Renvoie les résultats de recherche où la valeur de propriété est supérieure à la valeur spécifiée dans la restriction de propriété. |
|
<= |
Renvoie les résultats de recherche où la valeur de propriété est inférieure ou égale à la valeur spécifiée dans la restriction de propriété. |
|
>= |
Renvoie les résultats de recherche où la valeur de propriété est supérieure ou égale à la valeur spécifiée dans la restriction de propriété. |
|
<> |
Renvoie les résultats de recherche où la valeur de propriété n’est pas égale à la valeur spécifiée dans la restriction de propriété. |
|
.. |
Renvoie les résultats de recherche où la valeur de propriété est comprise dans la plage spécifiée dans la restriction de propriété. |
|
Valeurs de propriétés
Vous devez spécifier une valeur de propriété qui est un type de données valide comme type de la propriété gérée. Le tableau suivant répertorie ces mappages de types.
Tableau 2. Mappages de types de données valides
Type géré |
Type de données |
|---|---|
Valeurs de texte
Pour les valeurs de propriétés de texte, le comportement de mise en correspondance varie selon que la propriété est stockée dans l’index de texte intégral ou dans la base de données Banque de propriétés.
Valeurs de propriétés dans l’index de texte intégral
Les valeurs de propriétés sont stockées dans l’index de texte intégral lorsque la propriété FullTextQueriable a la valeur true pour une propriété gérée. Ceci est configurable uniquement pour les propriétés de type chaîne. Les valeurs de propriétés spécifiées dans la requête sont mises en correspondance avec des termes individuels dans la valeur de propriété stockée dans l’index de texte intégral.
Par exemple, si vous recherchez un élément de contenu créé par Paul Shakespear, la requête de mot clé suivante renvoie les résultats correspondants :
author:Shakespear
author:Paul
La mise en correspondance de préfixe est également prise en charge. Vous pouvez utiliser l’opérateur générique (*), mais il n’est pas obligatoire lorsque vous spécifiez des mots individuels. Si l’on poursuit avec l’exemple précédent, les requêtes de mot clé suivantes renvoient comme correspondances les éléments de contenu créés par Paul Shakespear.
author:Shakesp
author:Shakesp*
Lorsque vous spécifiez une expression pour la valeur de propriété, les résultats correspondants doivent contenir l’expression spécifiée dans la valeur de propriété stockée dans l’index de texte intégral. L’exemple de requête suivant renvoie les éléments de contenu dont le texte contient « Advanced Search », par exemple « Advanced Search XML », « Learning About the Advanced Search Web Part », et ainsi de suite.
title:"Advanced Search"
La mise en correspondance de préfixe est également prise en charge avec des expressions spécifiées dans des valeurs de propriétés, mais vous devez utiliser l’opérateur générique (*) dans la requête et cette mise en correspondance de préfixe est prise en charge uniquement à la fin d’une expression, comme suit :
title:"Advanced Sear*"
Les requêtes suivantes ne renvoient pas les résultats attendus :
title:"Advan* Search"
title:"Advanced Sear"
Valeurs de propriétés dans la base de données Banque de propriétés
Les valeurs de propriétés sont stockées dans la base de données Banque de propriétés lorsque la propriété Retrievable a la valeur true pour une propriété gérée. Vous pouvez configurer ce paramètre pour tout type de propriété gérée. Les valeurs de propriétés spécifiées dans la requête sont mises en correspondance avec la valeur entière de la propriété. Par exemple, avec une propriété gérée nommée company, configurée avec la propriété Retrievable ayant la valeur true et la propriété FullTextQueriable ayant la valeur false, la requête de mot clé suivante établit une mise en correspondance avec les éléments de contenu pour lesquels la société est Adventure Works :
company:"Adventure Works"
Les requêtes suivantes ne renverraient pas ces éléments de contenu dans les résultats :
company:Adventure
company:Works
company:"Adventure W*"
Valeurs numériques
Pour les valeurs de propriétés numériques, qui comprennent les types managés Integer, Decimal, Binary et YesNo, la restriction de propriété est mise en correspondance avec la valeur entière de la propriété. L’exemple suivant établit une correspondance avec les éléments de contenu dont la taille est 100 Ko :
size:100KB
Les exemples de requête de mot clé suivants n’établiraient pas de correspondance avec ces éléments de contenu :
size:10
size:10*
Restrictions de propriétés multiples
Recherche de contenu d’entreprise SharePoint prend en charge l’utilisation de plusieurs restrictions de propriétés dans la même requête de mot clé. Vous pouvez utiliser la même propriété pour plusieurs restrictions de propriétés ou une propriété différente pour chaque restriction de propriété.
Lorsque vous utilisez plusieurs instances de la même restriction de propriété, les mises en correspondance sont basées sur l’union des restrictions de propriétés dans la requête de mot clé. Les correspondances incluraient les éléments de contenu créés par John Smith ou Jane Smith, comme suit :
author:"John Smith" author:"Jane Smith"
Du point de vue fonctionnel, cela équivaut à utiliser un opérateur booléen OR, comme suit :
author:"John Smith" OR author:"Jane Smith"
Lorsque vous utilisez différentes restrictions de propriétés, les mises en correspondances sont basées sur une intersection des restrictions de propriétés dans la requête de mot clé, comme suit :
author:"John Smith" filetype:docx
Les correspondances incluraient les documents Microsoft Word 2010 créés par John Smith. Du point de vue fonctionnel, cela équivaut à utiliser un opérateur booléen AND, comme suit :
author:"John Smith" AND filetype:docx
Voir aussi
Concepts
Référence de syntaxe de requête par mots clés