Partager via

Schéma de description du connecteur de recherche

  • Article

Présente le schéma de description du connecteur de recherche utilisé par les bibliothèques de Explorer Windows et les fournisseurs de recherche fédérés. Le schéma spécifie la structure et la configuration requise pour les fichiers de description du connecteur de recherche (*.searchConnector-ms) et pour les éléments searchConnectorDescriptionType des fichiers description de la bibliothèque shell (*.library-ms).

Cette rubrique décrit le schéma en relation avec les connecteurs de recherche fédérée. Pour plus d’informations sur les bibliothèques et le schéma de description de la bibliothèque, consultez Schéma de description de la bibliothèque.

Cette rubrique contient les sections suivantes :

Que sont les connecteurs de recherche ?

Les connecteurs de recherche connectent les utilisateurs avec des données stockées dans des services web ou des emplacements de stockage distants. Avec Windows 7, les utilisateurs peuvent installer des connecteurs de recherche pour les emplacements, tels que les services web, afin qu’ils recherchent ces emplacements directement à partir de Windows Explorer. Les connecteurs de recherche sont des fichiers de description du connecteur de recherche (*.searchConnector-ms) qui spécifient comment se connecter à, envoyer des requêtes et recevoir des résultats à partir de l’emplacement.

En plus des services web, les connecteurs de recherche peuvent être utilisés pour rechercher des étendues d’index locales créées par des gestionnaires de protocole. Par exemple, les utilisateurs peuvent rechercher des e-mails indexés localement avec le gestionnaire de protocole MAPI à l’aide d’un connecteur de recherche pour ce magasin de courrier.

Comment fonctionnent les fichiers de description du connecteur de recherche ?

Lorsque les fichiers de description du connecteur de recherche sont installés sur les systèmes des utilisateurs, les utilisateurs peuvent ouvrir Windows Explorer, cliquer sur le connecteur de recherche dans le volet de navigation et entrer une requête de recherche. Windows Explorer envoie la requête à l’aide des informations du fichier description du connecteur de recherche, telles que le fournisseur à utiliser et l’étendue de la recherche. Les résultats sont retournés en tant qu’éléments de flux RSS ou Atom et affichés aux utilisateurs comme s’il s’agissait d’éléments Shell standard.

La façon dont vous déployez votre fichier de description du connecteur de recherche dépend du type d’emplacement pris en charge par le connecteur de recherche :

  • Dans un fichier de configuration OpenSearch (*.osdx) pour votre service web
  • Dans le cadre de l’installation de votre gestionnaire de protocole

Vous devez vous assurer que les choses suivantes se produisent lorsqu’un utilisateur ouvre le fichier .osdx ou installe le gestionnaire de protocole :

  • Le fichier .searchconnector-ms est créé dans le dossier Recherches Windows des utilisateurs (%userprofile%/Searches).
  • Un raccourci vers le fichier .searchconnector-ms est créé dans le dossier Liens des utilisateurs (%userprofile%/Links).

Qu’est-ce que le schéma de description du connecteur de recherche ?

Le schéma Description du connecteur de recherche est un schéma XML qui définit la structure des fichiers de description du connecteur de recherche (*.searchConnector-ms). Chaque connecteur de recherche doit avoir un fichier de description du connecteur de recherche qui spécifie comment se connecter à, envoyer des requêtes à et recevoir des résultats à partir de l’emplacement.

Quelles sont les principales parties du schéma ?

Le tableau suivant répertorie les principales parties du schéma.

Éléments enfants Description
isSearchOnlyItem Identifie si les emplacements pris en charge par le connecteur de recherche sont la recherche uniquement ou la recherche et la navigation.
isDefaultSaveLocation Pour une utilisation de bibliothèque uniquement.
isDefaultNonOwnerSaveLocation Pour une utilisation de bibliothèque uniquement.
description Décrit le connecteur de recherche.
iconReference Identifie l’emplacement d’une icône personnalisée pour le connecteur de recherche.
Imagelink Identifie l’emplacement d’une miniature personnalisée pour le connecteur de recherche.
author Identifie l’auteur du connecteur de recherche.
dateCreated Identifie la date à laquelle le connecteur de recherche a été créé.
templateInfo Spécifie un type de dossier pour le connecteur de recherche.
locationProvider Spécifie le fournisseur de recherche à utiliser par ce connecteur de recherche.
scope Spécifie les emplacements à inclure dans et à exclure de l’étendue de recherche.
propertyStore Spécifie l’emplacement d’un IPropertyStore xml pour ce connecteur de recherche. L’IPropertyStore prend en charge les métadonnées ouvertes du connecteur de recherche.
includeInStartMenuScope Spécifie si l’emplacement représenté par le connecteur de recherche doit être inclus dans l’étendue de recherche du menu Démarrer.
domaine Identifie le domaine de niveau supérieur du connecteur de recherche.
supportsAdvancedQuerySyntax Spécifie si le connecteur de recherche prend en charge la syntaxe de requête avancée (AQS).
isIndexed Spécifie si l’emplacement représenté par le connecteur de recherche est indexé.

 

Exemples de fichiers de description du connecteur de recherche

Voici un exemple de fichier de description du connecteur de recherche pour un service web de recherche fédéré.

<?xml version="1.0" encoding="UTF-8"?>
<searchConnectorDescription xmlns="http://schemas.microsoft.com/windows/2009/searchConnector">
  <description>Search powered by live.com</description>
  <isSearchOnlyItem>true</isSearchOnlyItem>
  <domain>https://social.msdn.microsoft.com</domain>
  <supportsAdvancedQuerySyntax>false</supportsAdvancedQuerySyntax>
  <templateInfo>
    <folderType>{8FAF9629-1980-46FF-8023-9DCEAB9C3EE3}</folderType>
  </templateInfo>
  <propertyStore>
    <property name="OpenSearchHTMLRolloverTemplate">https://social.msdn.microsoft.com/Search/?Query={searchTerms}</property>
  </propertyStore>
  <locationProvider clsid="{48E277F6-4E74-4cd6-BA6F-FA4F42898223}">
    <propertyBag>
      <property name="OpenSearchShortName">MSDN</property>
      <property name="OpenSearchQueryTemplate">https://social.msdn.microsoft.com/Search/Feed.aspx?locale=en-US&Query={searchTerms}&format=RSS&StartIndex={startIndex}</property>
      <property name="MaximumResultCount" type="uint32">100</property>
    </propertyBag>
  </locationProvider>
</searchConnectorDescription>

Voici un exemple de fichier de description du connecteur de recherche pour un gestionnaire de protocole MAPI.

<?xml version="1.0" encoding="UTF-8"?>
<searchConnectorDescription xmlns="http://schemas.microsoft.com/windows/2009/searchConnector">
    <description>Microsoft Outlook</description>
    <isSearchOnlyItem>true</isSearchOnlyItem>
    <includeInStartMenuScope>true</includeInStartMenuScope>
    <templateInfo>
        <folderType>{91475FE5-586B-4EBA-8D75-D17434B8CDF6}</folderType>
    </templateInfo>
    <simpleLocation>
        <url>mapi://{S-1-5-21-2127521184-1604012920-1887927527-2779359}/</url>
    </simpleLocation>
</searchConnectorDescription>

Ressources supplémentaires

Informations de référence

searchConnectorDescriptionType, élément (schéma du connecteur de recherche)

Autres ressources

OpenSearch

Centre de téléchargement Microsoft