Esquema de descrição do conector de pesquisa

Apresenta o esquema Descrição do Conector de Pesquisa que é usado por bibliotecas do Windows Explorer e provedores de pesquisa federados. O esquema especifica a estrutura e os requisitos para arquivos de descrição do Conector de Pesquisa (*.searchConnector-ms) e para searchConnectorDescriptionType elementos dos arquivos de Descrição da Biblioteca do Shell (*.library-ms).

Este tópico descreve o esquema no que diz respeito aos conectores de pesquisa federados. Para obter mais informações sobre bibliotecas e o esquema de Descrição da Biblioteca, consulte esquema de descrição da biblioteca.

Este tópico inclui as seguintes seções:

O que são conectores de pesquisa?

Conectores de pesquisa conectam usuários com dados armazenados em serviços Web ou locais de armazenamento remoto. Com o Windows 7, os usuários podem instalar conectores de pesquisa em busca de locais, como serviços Web, para que pesquisem esses locais diretamente do Windows Explorer. Os conectores de pesquisa são arquivos de descrição do Conector de Pesquisa (*.searchConnector-ms) que especificam como se conectar, enviar consultas e receber resultados do local.

Além dos serviços Web, os conectores de pesquisa podem ser usados para pesquisar escopos de índice locais criados por manipuladores de protocolo. Por exemplo, os usuários podem pesquisar emails indexados localmente com o manipulador de protocolo MAPI usando um conector de pesquisa para esse repositório de email.

Como funcionam os arquivos de descrição do conector de pesquisa?

Quando os arquivos de Descrição do Conector de Pesquisa são instalados nos sistemas dos usuários, os usuários podem abrir o Windows Explorer, clicar no conector de pesquisa no painel de navegação e inserir uma consulta de pesquisa. O Windows Explorer envia a consulta usando informações do arquivo Descrição do Conector de Pesquisa, como qual provedor usar e o escopo da pesquisa. Os resultados são retornados como itens de RSS ou de feed Atom e exibidos aos usuários como se fossem itens do Shell regulares.

A maneira como você implanta o arquivo de descrição do Conector de Pesquisa depende do tipo de local que o conector de pesquisa dá suporte:

  • Em um arquivo de configuração do OpenSearch (*.osdx) para seu serviço Web
  • Como parte da instalação do manipulador de protocolo

Você deve garantir que as seguintes coisas ocorram quando um usuário abrir o arquivo .osdx ou instalar o manipulador de protocolo:

  • O arquivo .searchconnector-ms é criado na pasta windows searches dos usuários (%userprofile%/Searches).
  • Um atalho para o arquivo .searchconnector-ms é criado na pasta Links dos usuários (%userprofile%/Links).

Qual é o esquema de descrição do conector de pesquisa?

O esquema Descrição do Conector de Pesquisa é um esquema XML que define a estrutura dos arquivos de descrição do Conector de Pesquisa (*.searchConnector-ms). Cada conector de pesquisa deve ter um arquivo de Descrição do Conector de Pesquisa que especifique como se conectar, enviar consultas e receber resultados do local.

Quais são as principais partes do esquema?

A tabela a seguir lista as partes principais do esquema.

Elementos filho Descrição
isSearchOnlyItem Identifica se os locais compatíveis com o conector de pesquisa são somente pesquisa ou pesquisa e navegação.
isDefaultSaveLocation Somente para uso de biblioteca.
isDefaultNonOwnerSaveLocation Somente para uso de biblioteca.
descrição Descreve o conector de pesquisa.
iconReference Identifica o local de um ícone personalizado para o conector de pesquisa.
imageLink Identifica o local de uma miniatura personalizada para o conector de pesquisa.
autor Identifica o autor do conector de pesquisa.
dateCreated Identifica a data em que o conector de pesquisa foi criado.
templateInfo Especifica um tipo de pasta para o conector de pesquisa.
locationProvider Especifica o provedor de pesquisa a ser usado por este conector de pesquisa.
escopo Especifica os locais a serem incluídos e excluídos do escopo de pesquisa.
propertyStore Especifica o local de um IPropertyStore baseado em XML para esse conector de pesquisa. O IPropertyStore dá suporte aos metadados abertos do conector de pesquisa.
incluem InStartMenuScope Especifica se o local representado pelo conector de pesquisa deve ser incluído no escopo de pesquisa do menu Iniciar.
domínio Identifica o domínio de nível superior do conector de pesquisa.
dá suporte ao advancedQuerySyntax Especifica se o conector de pesquisa dá suporte à Sintaxe de Consulta Avançada (AQS).
isIndexed Especifica se o local representado pelo conector de pesquisa está indexado.

 

Exemplos de arquivos de descrição do conector de pesquisa

Veja a seguir um exemplo de um arquivo de Descrição do Conector de Pesquisa para um serviço Web de pesquisa 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>

Veja a seguir um exemplo de um arquivo de Descrição do Conector de Pesquisa para um manipulador 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 adicionais

de referência de

elemento searchConnectorDescriptionType (Esquema do Conector de Pesquisa)

outros recursos

OpenSearch

do Centro de Download da Microsoft