Compartir a través de

Utilización del Protocolo de búsqueda

  • Artículo

La búsqueda: protocolo de aplicación es una convención extensible para llamar a la aplicación de búsqueda del escritorio en Windows Vista con Service Pack 1 (SP1) y versiones posteriores. El protocolo se creó en Windows Vista con SP1 para ofrecer a Windows una forma de determinar y llamar a la aplicación de búsqueda predeterminada del escritorio.

La sintaxis del protocolo proporciona una serie de parámetros útiles para realizar búsquedas habituales en el escritorio, como los términos de búsqueda introducidos por el usuario o la ubicación en la que se inició la búsqueda. Cuando los usuarios realizan una búsqueda desde uno de los dos puntos de entrada de búsqueda disponibles (el punto de entrada Empezar menú o Windows Explorer), el sistema operativo utiliza el protocolo de búsqueda para iniciar la aplicación de búsqueda predeterminada del escritorio. Para ello, añada los términos de búsqueda introducidos por el usuario a la sintaxis estándar del protocolo de búsqueda y pasa esa información a la aplicación registrada como aplicación de búsqueda por defecto.

Si no hay instaladas otras aplicaciones de búsqueda en el escritorio, una búsqueda introducida en estos puntos de entrada inicia el Windows Search Explorer. Sin embargo, los desarrolladores externos pueden crear, instalar y registrar sus aplicaciones para gestionar el protocolo de búsqueda y ser la aplicación de búsqueda predeterminada. Dichas aplicaciones deben ser compatibles con la sintaxis del protocolo de búsqueda y registrarse en la aplicación programas por defecto característica para garantizar una experiencia fluida con Windows.

Si desarrolla una aplicación destinada a utilizar o basarse en una aplicación de búsqueda de escritorio específica, no debe depender exclusivamente de la aplicación búsqueda: protocolo. Porque muchas aplicaciones podrían poseer el búsqueda: protocolo, no hay garantía de que la aplicación de búsqueda de escritorio a la que se dirige la posea en un momento dado. En su lugar, debe utilizar un protocolo de búsqueda privado definido por esa aplicación de búsqueda de escritorio específica. Esto significa que las aplicaciones de búsqueda de escritorio destinadas a ser una plataforma para aplicaciones de terceros deben soportar tanto la búsqueda: protocolo y su propio protoloco de búsqueda del propietario.

Nota:

La búsqueda: protocolo no reemplaza al propietario search-ms: protocolo. Laas aplicaciones todavía pueden usar el search-ms: protocolo para iniciar Window Search Explorer para consultar silenciosamente el indexador de Windows Search

 

En este tema se trata lo siguiente:

Sintaxis

El protocolo de búsqueda utiliza la siguiente sintaxis estándar codificada en URL:

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

La sintaxis comienza identificando el propio protocolo (búsqueda:). Los pares parámetro/valor son argumentos que se pasan al motor de búsqueda, tal y como se describe en la siguiente tabla, que muestra todos los parámetros posibles para la sintaxis del protocolo de búsqueda.

Parámetro Valor Descripción
query texto codificado URL El texto de la consulta introducido por el usuario.
inputlocale Cualquier identificador de código de lengua (LCID) válido El LCID que identifica el idioma de entrada para la consulta.
keywordlocale Cualquier LCID válido El LCID que identifica el idioma de la versión internacional del Indexador. El valor predeterminado es 1033 (en-us).
migas Instrucción AQS Este argumento restringe el ámbito de búsqueda. En Windows Vista, el protocolo de búsqueda admite AQS completo, así como una implementación especial para un location argumento. En Windows XP, el protocolo de búsqueda también admite AQS completo, salvo una implementación especial de kind y store.
sintaxis NQS, AQS (casos no sensitivos) La sintaxis de consulta que se utilizará para buscar en el índice: Sintaxis de consulta natural o Sintaxis de consulta avanzada (AQS). AQS es la opción por defecto y siempre se asume que está analizada y es compatible.
stackedby Cualquier propiedad válida del sistema de propiedades Una propiedad que especifica la columna por la que apilar los resultados.
subquery Una ruta completamente especificada para un archivo de búsqueda guardada (*.search-ms) Los resultados de la subconsulta se utilizan como fuente para la consulta. Es decir, los términos de la consulta se buscan en los resultados de la subconsulta.
displayname Cadena codificada en URL El nombre de la búsqueda actual.

 

Windows Vista con SP1 uso de la búsqueda: protocolo

Windows Vista con SP1 tiene varios puntos de entrada desde los que llama al búsqueda: protocolo. Estos puntos de entrada se describen a continuación, así como la sintaxis común asociada a cada uno de ellos.

Punto de entrada del protocolo de búsqueda Location Consulta llamada
Buscar en cualquier lado Menú Inicio buscar:consulta=<Search Term>
Buscar en cualquier lado Explorador de Windows buscar:consulta=<Término de búsqueda>&migas=localización:<LOCALIZACIÓN>
Tecla del logotipo de Windows+F En cualquier lugar Buscar:
CTRL+F Explorador de Windows buscar:consulta=<Término de búsqueda>&migas=localización:<LOCALIZACIÓN>
F3 Menú Inicio Buscar:
F3 Explorador de Windows buscar:consulta=<Término de búsqueda>&migas=localización:<LOCALIZACIÓN>

 

Los puntos de entrada del protocolo de búsqueda de Windows Vista con SP1 no aprovechan todos los parámetros posibles del protocolo de búsqueda. Las aplicaciones que solo se ocupen de gestionar las llamadas al protocolo de búsqueda desde Windows Vista con SP1 pueden utilizar la siguiente tabla como guía de lo mínimo que necesitan implementar.

Parámetro Usado por Windows? Cómo lo utiliza Windows Vista con SP1 al llamar a la búsqueda:
query Sí El texto de la consulta introducido por el usuario.
migas Sí migas usa el location argumento para especificar de donde venía la consulta.
subquery Sí El resultado de la Sub-búsqueda argumento es usado como el objetivo de los elementos de búsqueda. Esto se utilizaría normalmente si un usuario utilizara un archivo .search-ms para realizar una búsqueda y, a continuación, llamara a la aplicación de búsqueda predeterminada del escritorio desde esa búsqueda.
inputlocale No No se usa actualmente.
keywordlocale No No se usa actualmente.
sintaxis No No se usa actualmente.
stackedby No No se usa actualmente.
displayname No No se usa actualmente.

 

Ejemplos

Si un usuario introduce "Microsoft" en el Empezar menú y hace clic buscar en cualquier lugar, el resultado de la llamada de protocolo de la búsqueda es hecho:

search:query=microsoft&

Si un usuario introduce "Seattle" en el Windows Explorer dentro de C:\MyFolder y luego hace clic en buscar en cualquier lugar, se realiza la siguiente llamaada usando carácteres de escape para ':' y '\':

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

Registro de la aplicación que gestiona el protocolo

Dado que varias aplicaciones pueden competir por el protocolo de búsqueda, debe registrar su aplicación en la base de datos Programas por defecto durante la instalación para que el usuario pueda configurarlo más fácilmente. Además de los procedimientos de instalación que se practican normalmente en Windows XP, una aplicación basada en Windows Vista debe registrarse en la función Programas predeterminados para que la aplicación y los usuarios puedan configurar sin problemas los valores predeterminados.

Después de instalar los archivos binarios necesarios en el ordenador del usuario, su rutina de instalación debe completar estas tareas generales:

  1. Escriba ProgIDs a HKEY_LOCAL_MACHINE, tal y como se describe abajo. Tenga en cuenta que las aplicaciones deben crear ProgID específicos de la aplicación para el protocolo de búsqueda.
  2. Reclamar la asociación de protocolos de búsqueda a nivel de máquina.
  3. Registrar la aplicación con Programas por defecto, como se explica en Registrando una aplicación para su uso con programas por defecto, como contendiente para el protocolo de búsqueda.

Entradas del Registro

A continuación se muestran ejemplos de las entradas de registro necesarias para una aplicación ficticia de búsqueda en el escritorio, 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"

Sintaxis de consulta avanzada

Programas predeterminados