Partilhar via

Esquema de descrição do conector de pesquisa

  • Artigo

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

Este tópico descreve o esquema no que se refere aos conectores de pesquisa federados. 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 seções a seguir:

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 para 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 RSS ou itens 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 com o qual 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 Pesquisas do Windows dos usuários (%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 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 especifica 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.
author 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 esse 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 este conector de pesquisa. O IPropertyStore dá suporte aos metadados abertos do conector de pesquisa.
includeInStartMenuScope 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.
supportsAdvancedQuerySyntax Especifica se o conector de pesquisa dá suporte à Sintaxe de Consulta Avançada (AQS).
isIndexed Especifica se o local representado pelo conector de pesquisa é 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

Referência

Elemento searchConnectorDescriptionType (Esquema do Conector de Pesquisa)

Outros recursos

OpenSearch

Centro de Download da Microsoft