Suchconnectorbeschreibungsschema

Führt das Schema für die Beschreibung des Suchconnectors ein, das von Windows Explorer-Bibliotheken und Verbundsuchanbietern verwendet wird. Das Schema gibt die Struktur und die Anforderungen für Search Connector Description Files ( * .searchConnector-ms) und für searchConnectorDescriptionType-Elemente der Shell Library Description * (.library-ms)-Dateien an.

In diesem Thema wird das Schema im Zusammenhang mit Connectors für die Verbundsuche beschrieben. Weitere Informationen zu Bibliotheken und zum Bibliotheksbeschreibungsschema finden Sie unter Bibliotheksbeschreibungsschema.

Dieses Thema enthält die folgenden Abschnitte:

Was sind Suchconnectors?

Suchconnectors verbinden Benutzer mit Daten, die in Webdiensten oder Remotespeicherorten gespeichert sind. Mit Windows 7 können Benutzer Suchconnectors für Standorte wie Webdienste installieren, sodass sie diese Standorte direkt über Windows Explorer durchsuchen. Suchconnectors sind Search Connector Description-Dateien ( * .searchConnector-ms), die angeben, wie eine Verbindung hergestellt, Abfragen an gesendet und Ergebnisse vom Speicherort empfangen werden sollen.

Zusätzlich zu Webdiensten können Suchconnectors verwendet werden, um lokale Indexbereiche zu durchsuchen, die von Protokollhandlern erstellt wurden. Beispielsweise können Benutzer lokal mit dem MAPI-Protokollhandler indizierte E-Mails durchsuchen, indem sie einen Suchconnector für diesen E-Mail-Speicher verwenden.

Wie funktionieren Suchconnectorbeschreibungsdateien?

Wenn Search Connector Description-Dateien auf den Systemen der Benutzer installiert sind, können Benutzer Windows Explorer öffnen, im Navigationsbereich auf den Suchconnector klicken und eine Suchabfrage eingeben. Windows Explorer sendet die Abfrage mithilfe von Informationen aus der Beschreibungsdatei des Suchconnectors, z. B. welchen Anbieter sie verwenden soll, und den Umfang der Suche. Die Ergebnisse werden als RSS- oder Atom-Feedelemente zurückgegeben und Benutzern so angezeigt, als wären sie reguläre Shell-Elemente.

Wie Sie die Beschreibungsdatei des Suchconnectors bereitstellen, hängt vom Typ des Speicherorts ab, den der Suchconnector unterstützt:

  • In einer OpenSearch-Konfigurationsdatei * (OSDX) für Ihren Webdienst
  • Im Rahmen der Installation des Protokollhandlers

Sie sollten sicherstellen, dass folgendes geschieht, wenn ein Benutzer die OSDX-Datei öffnet oder den Protokollhandler installiert:

  • Die Datei .searchconnector-ms wird im Ordner Windows Searches (%userprofile%/Searches) des Benutzers erstellt.
  • Eine Verknüpfung zur Datei .searchconnector-ms wird im Ordner Links des Benutzers (%userprofile%/Links) erstellt.

Was ist das Beschreibungsschema des Suchconnectors?

Das Search Connector Description-Schema ist ein XML-Schema, das die Struktur von Search Connector Description-Dateien * (.searchConnector-ms) definiert. Jeder Suchconnector muss über eine Beschreibungsdatei für den Suchconnector verfügen, die angibt, wie eine Verbindung hergestellt, Abfragen gesendet und Ergebnisse vom Speicherort empfangen werden.

Was sind die Hauptkomponenten des Schemas?

In der folgenden Tabelle sind die Hauptkomponenten des Schemas aufgeführt.

Untergeordnete Elemente BESCHREIBUNG
isSearchOnlyItem Gibt an, ob die vom Suchconnector unterstützten Speicherorte nur für die Suche oder suchen und durchsuchen sind.
isDefaultSaveLocation Nur zur Bibliotheksverwendung.
isDefaultNonOwnerSaveLocation Nur zur Bibliotheksverwendung.
description Beschreibt den Suchconnector.
iconReference Identifiziert den Speicherort eines benutzerdefinierten Symbols für den Suchconnector.
imageLink Identifiziert den Speicherort einer benutzerdefinierten Miniaturansicht für den Suchconnector.
Autor Identifiziert den Autor des Suchconnectors.
Datecreated Gibt das Datum an, an dem der Suchconnector erstellt wurde.
templateInfo Gibt einen Ordnertyp für den Suchconnector an.
locationProvider Gibt den Suchanbieter an, der von diesem Suchconnector verwendet werden soll.
scope Gibt die Speicherorte an, die in den Suchbereich eingeschlossen und aus diesem ausgeschlossen werden sollen.
propertyStore Gibt den Speicherort eines XML-basierten IPropertyStore für diesen Suchconnector an. IPropertyStore unterstützt die offenen Metadaten des Suchconnectors.
includeInStartMenuScope Gibt an, ob der durch den Suchconnector dargestellte Speicherort im Suchbereich des Startmenü enthalten sein soll.
Domäne Identifiziert die Domäne der obersten Ebene des Suchconnectors.
supportsAdvancedQuerySyntax Gibt an, ob der Suchconnector die erweiterte Abfragesyntax (Advanced Query Syntax, AQS) unterstützt.
isIndexed Gibt an, ob der vom Suchconnector dargestellte Speicherort indiziert wird.

Beispiele für Suchconnectorbeschreibungsdateien

Im Folgenden finden Sie ein Beispiel für eine Suchconnectorbeschreibungsdatei für einen Verbundsuchwebdienst.

<?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>

Im Folgenden finden Sie ein Beispiel für eine Beschreibungsdatei des Suchconnectors für einen MAPI-Protokollhandler.

<?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>

Weitere Ressourcen

Referenz

searchConnectorDescriptionType-Element (Search Connector Schema)

Andere Ressourcen

OpenSearch

Microsoft Download Center