Esquema de descrição do conector de pesquisa

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

Este tópico descreve o esquema em relação aos conectores de pesquisa federada. Para obter mais informações sobre bibliotecas e o esquema 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?
• Como funcionam os arquivos de descrição do Search Connector?
• Qual é o esquema de descrição do conector de pesquisa?
• Quais são as principais partes do esquema?
• Exemplos de arquivos de descrição do conector de pesquisa
• Recursos adicionais
• Tópicos relacionados

O que são conectores de pesquisa?

Os conectores de pesquisa conectam os usuários a dados armazenados em serviços Web ou locais de armazenamento remoto. Com o Windows 7, os utilizadores podem instalar conectores de pesquisa para localizações, como serviços Web, para que pesquisem essas localizações diretamente a partir do Explorador do Windows. 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 armazenamento 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, eles 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 feed RSS ou Atom e exibidos aos usuários como se fossem itens regulares do Shell.

A forma como você implanta o arquivo de Descrição do Conector de Pesquisa depende do tipo de local suportado pelo conector de pesquisa:

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

Você deve garantir que as seguintes coisas aconteçam quando um usuário abre o arquivo .osdx ou instala o manipulador de protocolo:

• O ficheiro .searchconnector-ms é criado na pasta Pesquisas do Windows dos utilizadores (%userprofile%/Searches).
• Um atalho para o arquivo .searchconnector-ms é criado na pasta Links dos usuários (%userprofile%/Links).

O que é o esquema de descrição do conector de pesquisa?

O esquema de 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.

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

Segue-se um exemplo de um ficheiro de Descrição do Conector de Pesquisa para um serviço Web de pesquisa federada.

<?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 seguir está 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

• Para obter mais informações sobre o esquema Descrição da Biblioteca, consulte Esquema de Descrição da Biblioteca.
• Para obter mais informações sobre como instalar um conector de pesquisa, consulte Pesquisa federada no Windows.

Tópicos relacionados

de referência

elemento searchConnectorDescriptionType (esquema do conector de pesquisa)

Outros recursos

OpenSearch

Centro de Download da Microsoft