Udostępnij przez

Korzystanie z protokołu wyszukiwania

Protokół aplikacji : jest rozszerzalną konwencją wywoływania aplikacji wyszukiwania pulpitu w systemie Windows Vista z dodatkiem Service Pack 1 (SP1) i nowszymi wersjami. Protokół został utworzony w systemie Windows Vista z dodatkiem SP1, aby umożliwić systemowi Windows określenie i wywołanie domyślnej aplikacji wyszukiwania pulpitu.

Składnia protokołu udostępnia wiele parametrów przydatnych do przeprowadzania typowych wyszukiwań pulpitu, takich jak terminy wyszukiwania wprowadzone przez użytkownika lub lokalizacja, w której rozpoczęto wyszukiwanie. Gdy użytkownicy wyszukują jeden z dwóch dostępnych punktów wejścia wyszukiwania (menu Start lub Eksploratora Windows), system operacyjny używa protokołu wyszukiwania do uruchamiania domyślnej aplikacji wyszukiwania pulpitu. Robi to przez dodanie wprowadzonych przez użytkownika terminów wyszukiwania do standardowej składni protokołu wyszukiwania i przekazanie tych informacji do aplikacji zarejestrowanej jako domyślna aplikacja wyszukiwania.

Jeśli nie są zainstalowane żadne inne aplikacje do wyszukiwania pulpitu, wyszukiwanie wprowadzone w tych punktach wejścia uruchamia Eksploratora wyszukiwania Windows. Jednak deweloperzy innych firm mogą tworzyć, instalować i rejestrować swoje aplikacje, aby obsługiwać protokół wyszukiwania i być domyślną aplikacją wyszukiwania. Takie aplikacje muszą obsługiwać składnię protokołu wyszukiwania i rejestrować się za pomocą funkcji Domyślne programy, aby zapewnić bezproblemowe środowisko pracy z systemem Windows.

Jeśli tworzysz aplikację, która ma być używana lub oparta na określonej aplikacji wyszukiwania pulpitu, nie powinieneś polegać wyłącznie na protokole wyszukiwania :. Ponieważ wiele aplikacji może mieć przypisany protokół wyszukiwania :, nie ma gwarancji, że docelowa aplikacja wyszukiwania pulpitu będzie jego właścicielem w danym momencie. Zamiast tego należy użyć protokołu wyszukiwania prywatnego zdefiniowanego przez docelową aplikację wyszukiwania pulpitu. Oznacza to, że aplikacje do wyszukiwania na komputerach, które mają służyć jako platformy dla aplikacji innych firm, powinny obsługiwać zarówno protokół wyszukiwania :, jak i własny zastrzeżony protokół wyszukiwania.

Notatka

Protokół wyszukiwania: nie zastępuje zastrzeżonego protokołu search-ms:. Aplikacje mogą nadal używać protokołu search-ms:, aby uruchomić Eksploratora wyszukiwania okien lub dyskretnie wysłać zapytanie do indeksatora usługi Windows Search.

 

W tym temacie omówiono następujące zagadnienia:

Składnia

Protokół wyszukiwania używa następującej standardowej składni zakodowanej pod adresem URL:

search:parameter=value[&parameter=value]&

Składnia rozpoczyna się od zidentyfikowania samego protokołu (search:). Pary parametrów/wartości są argumentami przekazywanymi do wyszukiwarki, zgodnie z opisem w poniższej tabeli, w której przedstawiono wszystkie możliwe parametry składni protokołu wyszukiwania.

Parametr Wartość Opis
zapytanie Tekst zakodowany w adresie URL Tekst zapytania wprowadzony przez użytkownika.
inputlocale Dowolny prawidłowy identyfikator kodu języka (LCID) Identyfikator LCID identyfikujący język wejściowy zapytania.
słowo kluczowe lokalizacja Dowolny prawidłowy identyfikator LCID Identyfikator LCID, który identyfikuje język międzynarodowej wersji indeksatora. Wartość domyślna to 1033 (en-us).
crumb Oświadczenie AQS Ten argument ogranicza przeszukiwany zakres. W systemie Windows Vista protokół wyszukiwania obsługuje pełne AQS, a także specjalną implementację argumentu location. W systemie Windows XP protokół wyszukiwania obsługuje również pełne AQS, z wyjątkiem specjalnej implementacji kind i store.
składnia NQS, AQS (nie uwzględnia wielkości liter) Składnia zapytania używana do przeszukiwania indeksu: naturalna składnia zapytania lub zaawansowana składnia zapytań (AQS). AQS jest wartością domyślną i zawsze przyjmuje się, że jest analizowana i obsługiwana.
zestawiony przez Dowolna prawidłowa właściwość z systemu właściwości Właściwość określająca kolumnę, według której grupowane są wyniki.
podzapytania Pełna ścieżka dla zapisanego pliku wyszukiwania (*.search-ms) Wyniki podzapytania są używane jako źródło zapytania. Oznacza to, że terminy zapytania są wyszukiwane względem wyników podzapytania.
nazwa wyświetlana Ciąg zakodowany w adresie URL Nazwa bieżącego wyszukiwania.

 

System Windows Vista z dodatkiem SP1 używa protokołu wyszukiwania.

System Windows Vista z dodatkiem SP1 ma kilka punktów wejścia, z których wywołuje protokół wyszukiwania :. Te punkty wejścia są opisane poniżej, a także typowa składnia skojarzona z każdym z nich.

Punkt wejścia protokołu wyszukiwania Lokalizacja Zapytanie o nazwie
Wyszukiwanie wszędzie Menu Start search:query=<Termin Wyszukiwania>
Wyszukuj wszędzie Eksplorator Windows search:query=<Wyszukiwany termin>&crumb=location:<LOCATION>
logo systemu Windows+F Gdziekolwiek szukaj
CTRL+F Eksplorator Windows search:query=<Termin wyszukiwania>&crumb=location:<LOCATION>
F3 menu Start szukaj:
F3 Eksplorator Windows search:query=<Wyrażenie wyszukiwania>&crumb=location:<LOCATION>

 

Punkty wejścia protokołu wyszukiwania systemu Windows Vista z dodatkiem SP1 nie korzystają ze wszystkich możliwych parametrów w protokole wyszukiwania. Aplikacje, które dotyczą tylko obsługi wywołań protokołu wyszukiwania z systemu Windows Vista z dodatkiem SP1, mogą użyć poniższej tabeli jako przewodnika do minimum, które muszą zaimplementować.

Parametr Używane przez system Windows? Jak system Windows Vista z dodatkiem SP1 używa go podczas wywoływania wyszukiwania:
zapytanie Tak Tekst zapytania wprowadzony przez użytkownika.
okruszek Tak crumb używa argumentu location, aby określić, skąd pochodzi zapytanie.
podzapytania Tak Wyniki argumentu podzapytania są używane jako zakres elementów do wyszukiwania. Zwykle używa się tego, gdy użytkownik korzysta z pliku .search-ms do wyszukiwania, a następnie uruchamia domyślną aplikację wyszukiwania pulpitu w trakcie tego wyszukiwania.
inputlocale Nie Obecnie nie jest używany.
słowo kluczowe locale Nie Obecnie nie jest używany.
składni Nie Obecnie nie jest używany.
ułożony przez Nie Obecnie nie jest używany.
nazwa wyświetlana Nie Obecnie nie jest używany.

 

Przykłady

Jeśli użytkownik wprowadzi ciąg "Microsoft" w menu Start i kliknie opcję Szukaj wszędzie, zostanie wykonane odpowiednie wywołanie protokołu wyszukiwania.

search:query=microsoft&

Jeśli użytkownik wprowadzi ciąg "Seattle" w Eksploratorze Windows w folderze C:\MyFolder, a następnie kliknie Wyszukaj wszędzie, zostanie wykonane następujące wywołanie, używając znaków ucieczki dla ":" i "\":

search:query=seattle&crumb=location:C%3A%5CMyFolder

Rejestrowanie aplikacji obsługującej protokół

Podczas instalacji należy zarejestrować aplikację w funkcji Domyślne Programy, ponieważ wiele aplikacji może rywalizować o protokół wyszukiwania, co umożliwi użytkownikowi łatwiejsze skonfigurowanie ustawień domyślnych. Oprócz procedur instalacji zwykle praktykowanych w systemie Windows XP aplikacja oparta na systemie Windows Vista musi zarejestrować się za pomocą funkcji Programy domyślne, aby aplikacja i użytkownicy mogli bezproblemowo skonfigurować ustawienia domyślne.

Po zainstalowaniu niezbędnych plików binarnych na komputerze użytkownika procedura instalacji powinna wykonać następujące ogólne zadania:

  1. Zapisz ProgID-y w HKEY_LOCAL_MACHINE, zgodnie z poniższym opisem. Należy pamiętać, że aplikacje muszą tworzyć identyfikatory ProgID specyficzne dla aplikacji dla protokołu wyszukiwania.
  2. Żądanie skojarzenia z protokołem wyszukiwania na poziomie maszyny.
  3. Zarejestruj aplikację w Programach domyślnych, zgodnie z opisem w Rejestrowanie aplikacji do użycia z Programami domyślnymi, jako kandydat do protokołu wyszukiwania.

Wpisy rejestru

Poniżej przedstawiono przykłady wymaganych wpisów rejestru dla fikcyjnej aplikacji do wyszukiwania na pulpicie, Contoso Search.

HKEY_LOCAL_MACHINE
   SOFTWARE
      Classes
         contoso-search
            URL Protocol = ""

HKEY_LOCAL_MACHINE
   SOFTWARE
      Classes
         contoso-search
            DefaultIcon
               (Default) = %ProgramFiles%\Contoso\Search\contososearch.exe,-7

HKEY_LOCAL_MACHINE
   SOFTWARE
      Classes
         contoso-search
            shell
               open
                  command
                     (Default) = %ProgramFiles%\Contoso\Search\contososearch.exe %1

HKEY_LOCAL_MACHINE
   SOFTWARE
      RegisteredApplications
         Contoso Search = "Software\\Contoso\\Search\\Capabilities"

HKEY_LOCAL_MACHINE
   SOFTWARE
      Contoso
         Search
            Capabilities
               ApplicationName = "Contoso Search Test App"
               ApplicationDescription = "Contoso search is a great new desktop search application"

HKEY_LOCAL_MACHINE
   SOFTWARE
      Contoso
         Search
            Capabilities
               UrlAssociations
                  search = "contoso-search"

Zaawansowana składnia zapytań

Programy domyślne

 

 

  • Last updated on