Схема описания соединителя поиска

В этой статье представлена схема описания соединителя поиска, которая используется библиотеками Windows Обозреватель и федеративными поставщиками поиска. Схема определяет структуру и требования для файлов описания соединителя поиска (*.searchConnector-ms) и элементов searchConnectorDescriptionType в файлах описания библиотеки оболочки (*.library-ms).

В этом разделе описывается схема, связанная с соединителями федеративного поиска. Дополнительные сведения о библиотеках и схеме описания библиотек см. в разделе Схема описания библиотеки.

Этот раздел включает следующие подразделы:

Что такое соединители поиска?

Соединители поиска связывают пользователей с данными, хранящимися в веб-службах или удаленных хранилищах. В Windows 7 пользователи могут устанавливать соединители поиска для расположений, таких как веб-службы, чтобы выполнять поиск в этих расположениях непосредственно из Windows Обозреватель. Соединители поиска — это файлы описания соединителя поиска (*.searchConnector-ms), которые указывают способ подключения, отправки запросов и получения результатов из расположения.

Помимо веб-служб, соединители поиска можно использовать для поиска областей локального индекса, созданных обработчиками протоколов. Например, пользователи могут выполнять поиск электронной почты, индексированных локально, с помощью обработчика протокола MAPI с помощью соединителя поиска для этого хранилища электронной почты.

Как работают файлы описания соединителя поиска?

Когда файлы описания соединителя поиска устанавливаются в системах пользователей, пользователи могут открыть windows Обозреватель, щелкнуть соединитель поиска в области навигации и ввести поисковый запрос. Windows Обозреватель отправляет запрос, используя сведения из файла описания соединителя поиска, например используемый поставщик и область поиска. Результаты возвращаются в виде rss или atom-каналов и отображаются пользователям, как если бы они были обычными элементами оболочки.

Способ развертывания файла описания соединителя поиска зависит от типа расположения, который поддерживает соединитель поиска:

  • В файле конфигурации OpenSearch (*.osdx) для веб-службы
  • В рамках установки обработчика протокола

Убедитесь, что при открытии OSDX-файла или установке обработчика протокола пользователь должен выполнять следующие действия:

  • Файл searchconnector-ms создается в папке "Поиск Windows " пользователей (%userprofile%/Search).
  • Ярлык для файла .searchconnector-ms создается в папке ссылок пользователей (%userprofile%/Links).

Что такое схема описания соединителя поиска?

Схема описания соединителя поиска — это XML-схема, которая определяет структуру файлов описания соединителя поиска (*.searchConnector-ms). Каждый соединитель поиска должен иметь файл описания соединителя поиска, который указывает, как подключаться к расположению, отправлять запросы и получать результаты из расположения.

Каковы основные части схемы?

В следующей таблице перечислены основные части схемы.

Дочерние элементы Описание
isSearchOnlyItem Определяет, являются ли расположения, поддерживаемые соединителем поиска, только для поиска или поиска и просмотра.
isDefaultSaveLocation Используйте только для библиотеки.
isDefaultNonOwnerSaveLocation Используйте только для библиотеки.
description Описывает соединитель поиска.
iconReference Определяет расположение настраиваемого значка для соединителя поиска.
imageLink Определяет расположение настраиваемого эскиза для соединителя поиска.
author Определяет автора соединителя поиска.
Datecreated Определяет дату создания соединителя поиска.
templateInfo Указывает тип папки для соединителя поиска.
locationProvider Указывает службу поиска, используемую этим соединителем поиска.
область Указывает расположения для включения и исключения из область поиска.
propertyStore Указывает расположение IPropertyStore на основе XML для этого соединителя поиска. IPropertyStore поддерживает открытые метаданные соединителя поиска.
includeInStartMenuScope Указывает, следует ли включать расположение, представленное соединителем поиска, в область поиска меню "Пуск".
Домена Определяет домен верхнего уровня соединителя поиска.
supportsAdvancedQuerySyntax Указывает, поддерживает ли соединитель поиска расширенный синтаксис запросов (AQS).
isIndexed Указывает, индексируется ли расположение, представленное соединителем поиска.

 

Примеры файлов описания соединителя поиска

Ниже приведен пример файла описания соединителя поиска для федеративной веб-службы поиска.

<?xml version="1.0" encoding="UTF-8"?>
<searchConnectorDescription xmlns="http://schemas.microsoft.com/windows/2009/searchConnector">
  <description>Search MSDN. 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>

Ниже приведен пример файла описания соединителя поиска для обработчика протокола 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>

Дополнительные ресурсы

Reference

Элемент searchConnectorDescriptionType (схема соединителя поиска)

Другие ресурсы

OpenSearch

Центре загрузки Майкрософт