Gestion des mots clés (FAST Search Server 2010 for SharePoint)

Article
09/18/2014

Les fonctionnalités de gestion de mots clés disponibles dans Microsoft FAST Search Server 2010 for SharePoint vous permettent de fournir des résultats de requête plus pertinents à différents groupes d’utilisateurs.

Dernière modification : jeudi 1 septembre 2011

Les termes Mots clés sont définis par un administrateur afin d’améliorer les résultats de la recherche. Lorsqu’une requête comprend un terme Mot clé ou l’un de ses synonymes, tous les résultats recommandés sous la forme de Meilleurs résultats ou de Meilleurs résultats visuels peuvent être renvoyés le résultat de la recherche.

Des Meilleurs résultats, des Meilleurs résultats visuels, des promotions de documents et des rétrogradations de documents peuvent être associés à des contextes utilisateur définis. Ces contextes utilisateur permettent aux administrateurs de recommander des résultats appropriés pour un groupe d’utilisateurs spécifique.

Dans cet article :

S’applique à : SharePoint Server 2010

Utilisation des contextes utilisateur dans les requêtes

Lorsque vous créez une application de recherche personnalisée, vous devez fournir les informations de contexte utilisateur dans la requête. Vous pouvez ajouter une ou plusieurs spécifications de contexte utilisateur à la requête à l’aide de l’UserContext, élément dans le schéma Microsoft.Search.Query. Vous ajoutez la spécification de contexte proprement dite à l’UserContextData, élément.

userContextString est une chaîne qui répond au format suivant :

K:D:v1Dv2Dv3...|K:D:v1Dv2Dv3

Tableau 1. Composantes de syntaxe de contexte utilisateur

Composante de la syntaxe	Description
K	Clé de mot clé (par exemple, « responsabilités »). Si la clé contient l’un des caractères spéciaux symbole deux-points (« : »), barre oblique inverse (« \ ») ou barre verticale (« \| »), ils doivent être inclus dans une séquence d’échappement. Exemple : « \: »
D	Délimiteur permettant de séparer plusieurs valeurs. La première instance du délimiteur est placée entre caractères « : » et spécifie la valeur de délimiteur utilisée dans la chaîne suivante. Si la chaîne de contexte ne contient qu’une seule valeur, D est laissé vide (« :: »), ce qui signifie que la clé ne contient qu’une seule valeur. La valeur de délimiteur peut contenir un ou plusieurs caractères (un seul caractère ou une chaîne telle que « ; », « $ » ou « STOP »). Le délimiteur ne peut pas contenir de caractères spéciaux tels que « : », « \ » ou « \| ».
v1..vx	Valeurs de la clé K. Les valeurs ne peuvent pas contenir le délimiteur. Si la clé contient l’un des caractères spéciaux « : », « \ » ou «\|», ils doivent être inclus dans une séquence d’échappement. Exemple : « \: »
\|	Permet de séparer plusieurs paires clé/valeur.

Un administrateur de site a défini un meilleur résultat visuel Dev Center qui ne s’applique que si l’utilisateur qui exécute la requête détient la responsabilité developer. Dans ce cas, la requête doit inclure la spécification du contexte de l’utilisateur, et une requête pour l’utilisateur détenant cette responsabilité doit inclure une chaîne userContextString, comme suit.

responsibilities:;:developer

Demande de Meilleurs résultats et de Meilleurs résultats visuels dans le résultat de requête

Lors de l’utilisation de la méthode de service Web de requête QueryEx, vous pouvez demander des Meilleurs résultats et des Meilleurs résultats visuels à l’aide de l’élément IncludeSpecialTermResults.

Dans le résultat de requête, vous obtenez les Meilleurs résultats et Meilleurs résultats visuels dans les tables suivantes :

SpecialTermResults : cette table contient une ligne pour chaque Meilleur résultat défini pour le mot clé.
VisualBestBetsResults : cette table contient une ligne pour chaque Meilleur résultat visuel défini pour le mot clé.

Les deux tables contiennent les mêmes colonnes, comme expliqué au Tableau 2.

Notes

L’ensemble de colonnes renvoyé pour les Meilleurs résultats est différent pour Recherche SharePoint Server et pour FAST Search Server 2010 for SharePoint.

Tableau 2. Colonnes de tables de résultats renvoyées pour les Meilleurs résultats et Meilleurs résultats visuels

Colonne	Description
Name	Nom du Meilleur résultat ou Meilleur résultat visuel.
Description	Description facultative.
Keyword	Mot clé associé. Vous devez indiquer ce mot clé sous la forme suivante : KD[<mot_clé>] Où <mot_clé> est le mot clé qui correspond à la requête.
Teaser	Texte indice pouvant être utilisé dans les résultats de requêtes.
TeaserContentType	Type de texte facultatif (par exemple texte/html) pour l’indice.
Uri	URI du Meilleur résultat ou Meilleur résultat visuel. Pour un Meilleur résultat, il s’agit de l’URI que vous pouvez afficher dans la page de résultat de requête. Pour un Meilleur résultat visuel, il s’agit de l’URI de l’élément graphique que vous pouvez afficher dans la page de résultat de requête.
Position	Position souhaité du Meilleur résultat ou du Meilleur résultat visuel dans le résultat de requête. Cette colonne est pertinente uniquement lorsque plusieurs Meilleurs résultats ou du Meilleurs résultats visuels sont définis pour un mot clé.

Notes

Si vous utilisez l’indice ou la position pour les Meilleurs résultats ou Meilleurs résultats visuels, assurez-vous de créer et de gérer les paramètres de mots clé à l’aide de Windows PowerShell et non de l’interface utilisateur de collection de site. Ces paramètres ne sont pas disponibles dans l’interface utilisateur.

Utilisation de Meilleurs résultats et de Meilleurs résultats visuels dans le service Web de requête

Les étapes suivantes sont une extension de Procédure pas à pas : Interrogation de FAST Search Server à partir d’une application cliente. Suivez les étapes décrites dans cet article et étendez le code comme décrit ci-dessous.

Les extensions de code sont les suivantes :

demander des Meilleurs résultats et Meilleurs résultats visuels dans le XML de requête ;
imprimer les données de Meilleurs résultats ou Meilleurs résultats visuels dans le second contrôle DataGridView ;

Pour étendre le code pour l’application cliente Visuel Studio

Remplacez la définition de la chaîne queryXML2, de manière à ajouter des Meilleurs résultats et Meilleurs résultats visuels dans le jeu de résultats :

   // queryXML2 is the part of the XML after the query string.
   string queryXML2 = @"
         </QueryText>
      </Context>
      <ResultProvider>FASTSearch</ResultProvider>
      <Range>
         <Count>10</Count>
      </Range>
      <IncludeSpecialTermResults>true</IncludeSpecialTermResults>
   </Query>
</QueryPacket>";

Pour inclure des Meilleurs résultats dans le résultat de requête, ajoutez la ligne de code suivante à l’événement queryButton_Click :

   // Set the second DataGridView data source to the SpecialTermResults table in the DataSet object:
   secondGrid.DataSource = queryResults.Tables["SpecialTermResults"];

Pour inclure des Meilleurs résultats visuels dans le résultat de requête, ajoutez la ligne de code suivante à l’événement queryButton_Click :

   // Set the second DataGridView data source to the VisualBestBetsResults table in the DataSet object:
   secondGrid.DataSource = queryResults.Tables["VisualBestBetsResults"];

Voir aussi

Référence

UserContext, élément dans le schéma Microsoft.Search.Query

UserContextData, élément

Concepts

Procédure pas à pas : Interrogation de FAST Search Server à partir d’une application cliente

Partager via