Compartir a través de

Esquema de descripción del conector de búsqueda

  • Artículo

Presenta el esquema de descripción del conector de búsqueda que usan las bibliotecas del Explorador de Windows y los proveedores de búsqueda federados. El esquema especifica la estructura y los requisitos de los archivos de descripción del conector de búsqueda (*.searchConnector-ms) y para los elementos searchConnectorDescriptionType de los archivos Descripción de la biblioteca de Shell (*.library-ms).

En este tema se describe el esquema en relación con los conectores de búsqueda federados. Para obtener más información sobre las bibliotecas y el esquema de descripción de la biblioteca, vea Esquema de descripción de biblioteca.

Este tema incluye las siguientes secciones:

¿Qué son los conectores de búsqueda?

Los conectores de búsqueda conectan a los usuarios con datos almacenados en servicios web o ubicaciones de almacenamiento remoto. Con Windows 7, los usuarios pueden instalar conectores de búsqueda para ubicaciones, como servicios web, para que busquen esas ubicaciones directamente desde el Explorador de Windows. Los conectores de búsqueda son archivos de descripción del conector de búsqueda (*.searchConnector-ms) que especifican cómo conectarse, enviar consultas a y recibir resultados de la ubicación.

Además de los servicios web, los conectores de búsqueda se pueden usar para buscar ámbitos de índice locales creados por controladores de protocolo. Por ejemplo, los usuarios pueden buscar el correo electrónico indexado localmente con el controlador de protocolo MAPI mediante un conector de búsqueda para ese almacén de correo electrónico.

¿Cómo funcionan los archivos de descripción del conector de búsqueda?

Cuando los archivos search connector Description están instalados en los sistemas de los usuarios, los usuarios pueden abrir el Explorador de Windows, hacer clic en el conector de búsqueda en el panel de navegación y escribir una consulta de búsqueda. El Explorador de Windows envía la consulta mediante información del archivo de descripción del conector de búsqueda, como el proveedor que se va a usar y el ámbito de la búsqueda. Los resultados se devuelven como elementos de fuente RSS o Atom y se muestran a los usuarios como si fueran elementos de Shell normales.

La implementación del archivo de descripción del conector de búsqueda depende del tipo de ubicación que admite el conector de búsqueda:

  • En un archivo de configuración de OpenSearch (*.osdx) para el servicio web
  • Como parte de la instalación del controlador de protocolos

Debe asegurarse de que sucede lo siguiente cuando un usuario abre el archivo .osdx o instala el controlador de protocolo:

  • El archivo .searchconnector-ms se crea en la carpeta Búsquedas de Windows de los usuarios (%userprofile%/Search).
  • Se crea un acceso directo al archivo .searchconnector-ms en la carpeta Vínculos de los usuarios (%userprofile%/Links).

¿Qué es el esquema de descripción del conector de búsqueda?

El esquema de descripción del conector de búsqueda es un esquema XML que define la estructura de los archivos de descripción del conector de búsqueda (*.searchConnector-ms). Cada conector de búsqueda debe tener un archivo de descripción del conector de búsqueda que especifique cómo conectarse, enviar consultas a y recibir resultados de la ubicación.

¿Cuáles son las partes principales del esquema?

En la tabla siguiente se enumeran las partes principales del esquema.

Elementos secundarios Descripción
isSearchOnlyItem Identifica si las ubicaciones admitidas por el conector de búsqueda son de solo búsqueda o de búsqueda y exploración.
isDefaultSaveLocation Solo para uso de biblioteca.
isDefaultNonOwnerSaveLocation Solo para uso de biblioteca.
description Describe el conector de búsqueda.
iconReference Identifica la ubicación de un icono personalizado para el conector de búsqueda.
Imagelink Identifica la ubicación de una miniatura personalizada para el conector de búsqueda.
author Identifica al autor del conector de búsqueda.
dateCreated Identifica la fecha en que se creó el conector de búsqueda.
templateInfo Especifica un tipo de carpeta para el conector de búsqueda.
locationProvider Especifica el proveedor de búsqueda que va a usar este conector de búsqueda.
scope Especifica las ubicaciones que se van a incluir y excluir del ámbito de búsqueda.
propertyStore Especifica la ubicación de un IPropertyStore basado en XML para este conector de búsqueda. IPropertyStore admite los metadatos abiertos del conector de búsqueda.
includeInStartMenuScope Especifica si la ubicación representada por el conector de búsqueda debe incluirse en el ámbito de búsqueda del menú Inicio.
dominio Identifica el dominio de nivel superior del conector de búsqueda.
supportsAdvancedQuerySyntax Especifica si el conector de búsqueda admite la sintaxis de consulta avanzada (AQS).
isIndexed Especifica si la ubicación representada por el conector de búsqueda está indizada.

 

Ejemplos de archivos de descripción del conector de búsqueda

A continuación se muestra un ejemplo de un archivo de descripción del conector de búsqueda para un servicio web de búsqueda federado.

<?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>

A continuación se muestra un ejemplo de un archivo de descripción del conector de búsqueda para un controlador de protocolo 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>

Recursos adicionales

Referencia

Elemento searchConnectorDescriptionType (esquema del conector de búsqueda)

Otros recursos

OpenSearch

Centro de descarga de Microsoft