Search Connector Description Schema
Introduces the Search Connector Description schema that is used by Windows Explorer libraries and federated search providers. The schema specifies the structure and requirements for Search Connector Description files (*.searchConnector-ms) and for searchConnectorDescriptionType elements of the Shell Library Description (*.library-ms) files.
This topic describes the schema as it relates to federated search connectors. For more information about libraries and the Library Description schema, see Library Description Schema.
This topic includes the following sections:
- What Are Search Connectors?
- How Do Search Connector Description Files Work?
- What Is the Search Connector Description Schema?
- What Are the Major Parts of the Schema?
- Examples of Search Connector Description Files
- Additional Resources
- Related topics
What Are Search Connectors?
Search connectors connect users with data stored in web services or remote storage locations. With Windows 7, users can install search connectors for locations, like web services, so that they search those locations directly from Windows Explorer. Search connectors are Search Connector Description files (*.searchConnector-ms) that specify how to connect to, send queries to, and receive results from the location.
In addition to web services, search connectors can be used to search local index scopes created by protocol handlers. For example, users can search email indexed locally with the MAPI protocol handler by using a search connector for that email store.
How Do Search Connector Description Files Work?
When Search Connector Description files are installed on users' systems, users can open Windows Explorer, click the search connector in the navigation pane, and enter a search query. Windows Explorer sends the query using information from the Search Connector Description file, such as which provider to use and the scope of the search. The results are returned as RSS or Atom feed items and displayed to users as if they were regular Shell items.
How you deploy your Search Connector Description file depends on the type of location the search connector supports:
- In an OpenSearch configuration (*.osdx) file for your web service
- As part of your protocol handler installation
You should ensure that the following things happen when a user opens the .osdx file or installs the protocol handler:
- The .searchconnector-ms file is created in the users' Windows Searches folder (%userprofile%/Searches).
- A shortcut to the .searchconnector-ms file is created in the users' Links folder (%userprofile%/Links).
What Is the Search Connector Description Schema?
The Search Connector Description schema is an XML schema that defines the structure of Search Connector Description files (*.searchConnector-ms). Each search connector must have a Search Connector Description file that specifies how to connect to, send queries to, and receive results from the location.
What Are the Major Parts of the Schema?
The following table lists the major parts of the schema.
Child elements | Description |
---|---|
isSearchOnlyItem | Identifies whether the locations supported by the search connector are search-only or search and browse. |
isDefaultSaveLocation | For library use only. |
isDefaultNonOwnerSaveLocation | For library use only. |
description | Describes the search connector. |
iconReference | Identifies the location of a custom icon for the search connector. |
imageLink | Identifies the location of a custom thumbnail for the search connector. |
author | Identifies the author of the search connector. |
dateCreated | Identifies the date that the search connector was created. |
templateInfo | Specifies a folder type for the search connector. |
locationProvider | Specifies the search provider to be used by this search connector. |
scope | Specifies the locations to include in and exclude from the search scope. |
propertyStore | Specifies the location of an XML-based IPropertyStore for this search connector. The IPropertyStore supports the search connector's open metadata. |
includeInStartMenuScope | Specifies whether the location represented by the search connector should be included in the Start menu's search scope. |
domain | Identifies the search connector's top-level domain. |
supportsAdvancedQuerySyntax | Specifies whether the search connector supports Advanced Query Syntax (AQS). |
isIndexed | Specifies whether the location represented by the search connector is indexed. |
Examples of Search Connector Description Files
The following is an example of a Search Connector Description file for a federated search web service.
<?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>
The following is an example of a Search Connector Description file for a MAPI protocol handler.
<?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>
Additional Resources
- For more information about the Library Description schema, see Library Description Schema.
- For more information on installing a search connector, see Federated Search in Windows.
Related topics
-
Reference
-
searchConnectorDescriptionType Element (Search Connector Schema)
-
Other Resources