Utiliser des déclencheurs et des modèles de requête (Office SharePoint Server)

  • Article

Si un site spécifique n'est pas directement analysé par Microsoft Office SharePoint Server 2007, vous pouvez l'ajouter en tant qu'emplacement fédéré et inclure ses résultats de recherche pour les utilisateurs du site du centre de recherche. Lorsque vous ajoutez un emplacement fédéré, vous devez spécifier le modèle de requête qui doit être utilisé pour l'URL de requête de l'emplacement fédéré. Si vous le souhaitez, vous pouvez également spécifier une ou plusieurs contraintes de requête, appelées déclencheurs, afin de limiter les requêtes qui sont passées à l'emplacement fédéré.

Cette rubrique fournit des informations sur la spécification des déclencheurs et la création du modèle de requête d'un emplacement fédéré.

Déclencheurs

Un déclencheur est une contrainte de requête qui détermine à quel moment une requête est passée. Lorsque vous créez un emplacement fédéré, vous pouvez spécifier des déclencheurs qui déterminent à quel moment une requête lui est passée. Seules les requêtes qui correspondent au modèle spécifié pour les déclencheurs dans la définition d'emplacement sont transférées à l'emplacement fédéré.

Il existe deux types de déclencheurs :

  • Préfixe

    La requête doit être précédée du terme exact qui est spécifié en tant que déclencheur. Par exemple, si "météo" est spécifié en tant que déclencheur préfixe, pour la requête "météo New York, NY", le préfixe est supprimé et seul "New York, NY" est transmis.

    NoteRemarque :

    Seule la partie de la requête qui suit le préfixe est transmise ; dans l'exemple "météo New York, NY", seul "New York, NY" est transféré à l'emplacement fédéré.

  • Regex

    La requête doit correspondre au modèle d'expression régulière spécifié. Pour plus d'informations sur la création d'expressions régulières, voir Expressions régulières .NET Framework (https://go.microsoft.com/fwlink/?linkid=117945&clcid=0x40C).

Modèles de requête

Le modèle de requête contient l'URL paramétrée de l'emplacement fédéré, et les requêtes de recherche sont transmises à cette URL. L'URL paramétrée doit retourner des résultats XML structurés (par exemple, des résultats RSS ou Atom).

Office SharePoint Server 2007 prend en charge deux types d'emplacements fédérés :

  • Index de recherche sur ce serveur

    Le modèle de requête de l'index de recherche sur ce type d'emplacement fédéré de serveur doit contenir le paramètre searchTerms que vous spécifiez comme suit : {searchTerms}

    Il doit également contenir toutes les autres restrictions de requête, telles que les recherches de contenu d'un auteur spécifique, comme l'illustre l'exemple suivant : Author:"{searchTerms}"

    Le modèle de requête de ce type d'emplacement fédéré ne doit pas inclure l'URL des résultats de recherche.

  • OpenSearch

    Tout site Internet qui prend en charge la norme OpenSearch

Le modèle de requête équivaut au modèle d'URL de la spécification OpenSearch (https://go.microsoft.com/fwlink/?linkid=111090&clcid=0x40C). La syntaxe repose sur la syntaxe du modèle d'URL (https://go.microsoft.com/fwlink/?linkid=100718&clcid=0x40C). Voici un exemple de modèle de requête d'emplacement qui contient une URL paramétrée pour se connecter au service Live Search : http://www.live.com/?scope=web&mkt=fr-fr{searchTerms}&format=rss

Dans cet exemple, le modèle de requête contient le paramètre de modèle OpenSearch searchTerms. Le paramètre searchTerms est un emplacement réservé aux termes de recherche qui sont transférés à l'emplacement fédéré. Vous pouvez spécifier des paramètres supplémentaires dans le modèle de requête. Pour plus d'informations sur ces paramètres, voir la section consacrée aux paramètres OpenSearch 1.1 (https://go.microsoft.com/fwlink/?linkid=100720&clcid=0x40C) dans la spécification OpenSearch.

Vous pouvez indiquer qu'un paramètre est facultatif en incluant un point d'interrogation (?) après son nom. Dans l'exemple suivant, le paramètre searchTerms est obligatoire, ce qui n'est pas le cas du paramètre startIndex suivant : http://www.live.com/?scope=web&mkt=fr-fr{searchTerms}&format=rss&first={startIndex?}

NoteRemarque :

Les paramètres que vous spécifiez dans le modèle d'URL doivent être codés en URL. Dans l'exemple précédent, le « et commercial » (&) est remplacé par le codage URL de ce caractère, « & ».