Udostępnij za pośrednictwem

Schemat opisu łącznika wyszukiwania

  • Artykuł

Wprowadza schemat opisu łącznika wyszukiwania używany przez biblioteki Eksploratora Windows i dostawców wyszukiwania federacyjnego. Schemat określa strukturę i wymagania dotyczące plików opisu łącznika wyszukiwania (*.searchConnector-ms) oraz dla searchConnectorDescriptionType elementów opisu biblioteki powłoki (*.library-ms).

W tym temacie opisano schemat związany z łącznikami wyszukiwania federacyjnego. Aby uzyskać więcej informacji o bibliotekach i schemacie Opis biblioteki, zobacz Library Description Schema.

Ten temat zawiera następujące sekcje:

Co to są łączniki wyszukiwania?

Łączniki wyszukiwania łączą użytkowników z danymi przechowywanymi w usługach internetowych lub zdalnych lokalizacjach przechowywania. W systemie Windows 7 użytkownicy mogą instalować łączniki wyszukiwania lokalizacji, takich jak usługi internetowe, aby wyszukiwać te lokalizacje bezpośrednio z Eksploratora Windows. Łączniki wyszukiwania to pliki opisu łącznika wyszukiwania (*.searchConnector-ms), które określają sposób nawiązywania połączenia, wysyłania zapytań i odbierania wyników z lokalizacji.

Oprócz usług sieci Web łączniki wyszukiwania mogą służyć do wyszukiwania lokalnych zakresów indeksów utworzonych przez programy obsługi protokołów. Na przykład użytkownicy mogą wyszukiwać wiadomości e-mail indeksowane lokalnie za pomocą programu obsługi protokołu MAPI przy użyciu łącznika wyszukiwania dla tego magazynu poczty e-mail.

Jak działają pliki opisu łącznika wyszukiwania?

Gdy pliki opisu łącznika wyszukiwania są instalowane w systemach użytkowników, użytkownicy mogą otwierać Eksploratora Windows, kliknąć łącznik wyszukiwania w okienku nawigacji i wprowadzić zapytanie wyszukiwania. Eksplorator Windows wysyła zapytanie przy użyciu informacji z pliku Opis łącznika wyszukiwania, takiego jak dostawca do użycia i zakres wyszukiwania. Wyniki są zwracane jako elementy kanału informacyjnego RSS lub Atom i wyświetlane użytkownikom tak, jakby były zwykłymi elementami powłoki.

Sposób wdrażania pliku opisu łącznika wyszukiwania zależy od typu lokalizacji obsługiwanej przez łącznik wyszukiwania:

  • W pliku konfiguracji opensearch (*.osdx) dla usługi internetowej
  • W ramach instalacji programu obsługi protokołu

Podczas otwierania pliku osdx przez użytkownika lub instalacji programu obsługi protokołu należy upewnić się, że występują następujące elementy:

  • Plik .searchconnector-ms jest tworzony w folderze wyszukiwania systemu Windows użytkownika (%userprofile%/Searches).
  • Skrót do pliku .searchconnector-ms jest tworzony w folderze Links użytkowników (%userprofile%/Links).

Jaki jest schemat opisu łącznika wyszukiwania?

Schemat opisu łącznika wyszukiwania to schemat XML, który definiuje strukturę plików opisu łącznika wyszukiwania (*.searchConnector-ms). Każdy łącznik wyszukiwania musi mieć plik opisu łącznika wyszukiwania, który określa sposób nawiązywania połączenia, wysyłania zapytań i odbierania wyników z lokalizacji.

Jakie są główne części schematu?

W poniższej tabeli wymieniono główne części schematu.

Elementy podrzędne Opis
isSearchOnlyItem Określa, czy lokalizacje obsługiwane przez łącznik wyszukiwania to wyszukiwanie tylko, czy wyszukiwanie i przeglądanie.
isDefaultSaveLocation Tylko w przypadku biblioteki.
isDefaultNonOwnerSaveLocation Tylko w przypadku biblioteki.
opis Opisuje łącznik wyszukiwania.
ikona wnioskowania Identyfikuje lokalizację niestandardowej ikony łącznika wyszukiwania.
imageLink Identyfikuje lokalizację niestandardowej miniatury łącznika wyszukiwania.
autora Identyfikuje autora łącznika wyszukiwania.
data Tworzenie Określa datę utworzenia łącznika wyszukiwania.
templateInfo Określa typ folderu dla łącznika wyszukiwania.
locationProvider Określa dostawcę wyszukiwania, który ma być używany przez ten łącznik wyszukiwania.
zakresu Określa lokalizacje do uwzględnienia i wykluczenia z zakresu wyszukiwania.
propertyStore Określa lokalizację IPropertyStore opartego na języku XML dla tego łącznika wyszukiwania. IPropertyStore obsługuje otwarte metadane łącznika wyszukiwania.
includeInStartMenuScope Określa, czy lokalizacja reprezentowana przez łącznik wyszukiwania powinna być uwzględniona w zakresie wyszukiwania menu Start.
domeny Identyfikuje domenę najwyższego poziomu łącznika wyszukiwania.
obsługuje AdvancedQuerySyntax Określa, czy łącznik wyszukiwania obsługuje zaawansowaną składnię zapytań (AQS).
isIndexed Określa, czy lokalizacja reprezentowana przez łącznik wyszukiwania jest indeksowana.

 

Przykłady plików opisu łącznika wyszukiwania

Poniżej przedstawiono przykład pliku opisu łącznika wyszukiwania dla usługi sieci Web wyszukiwania federacyjnego.

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

Poniżej przedstawiono przykład pliku opisu łącznika wyszukiwania dla programu obsługi protokołu 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>

Dodatkowe zasoby

referencyjne

searchConnectorDescriptionType, element (schemat łącznika wyszukiwania)

innych zasobów

OpenSearch

Centrum pobierania Microsoft