Extensibilidad de proveedores de búsquedas en Internet Explorer

Artículo
02/01/2010

Novedad para Windows Internet Explorer 8

A partir de Internet Explorer 7, el cuadro Búsqueda instantánea incluye la característica Autocompletar, que permite a los usuarios realizar búsquedas con términos similares a los empleados en búsquedas anteriores. Internet Explorer 7 también les permite agregar varios proveedores de búsquedas. Las mejoras en la funcionalidad de búsqueda de Internet Explorer 8 se centran en ayudar a los usuarios en la búsqueda, ya que mejora significativamente el menú desplegable del cuadro Búsqueda instantánea y admite sugerencias de búsqueda.

Este tema está dirigido a dos audiencias: usuarios finales y desarrolladores de sitios web. La primera parte de este tema se centra en ayudar a los usuarios finales en la instalación de proveedores de búsquedas, en la administración de los proveedores de búsquedas y en el uso de un proveedor de búsquedas para encontrar lo que desean. La segunda parte de este tema está dirigida a los desarrolladores de sitios web y en ella se explica cómo promover un proveedor de búsquedas y cómo usar las sugerencias de búsqueda para mejorar la experiencia de un usuario con el proveedor de búsquedas elegido.

En este tema se tratan los siguientes asuntos:

Características de búsqueda para el usuario final
- Agregar proveedores de búsquedas
- Administrar proveedores de búsquedas
- Buscar con los proveedores de búsquedas favoritos
- Sugerencias y trucos
Características de búsqueda del desarrollador web
- Crear un archivo de descripción OpenSearch
- Promover proveedores de búsquedas
- Ofrecer sugerencias de búsqueda
- Obtener las dimensiones del menú Sugerencias de búsqueda
- Identificar referencias de búsqueda
- Localizar sugerencias de búsqueda
- Notas
Temas relacionados

Características de búsqueda para el usuario final

La característica Búsqueda instantánea de Internet Explorer 8 permite al usuario final agregar proveedores de búsquedas favoritos y cambiar rápidamente de proveedor durante una búsqueda. Internet Explorer 8 admite sugerencias de búsqueda para ayudar a los usuarios a iniciar consultas de búsqueda más correctamente. Los proveedores de búsquedas también pueden proporcionar respuestas instantáneas a las consultas. Además de usar el cuadro Búsqueda instantánea, los usuarios pueden tener acceso a todos sus proveedores de búsquedas a través del menú Aceleradores. Estas características están diseñadas para mejorar la experiencia de búsqueda y aumentar la productividad de los usuarios finales.

En esta sección se tratan los siguientes temas:

Agregar proveedores de búsquedas
Administrar proveedores de búsquedas
Buscar con los proveedores de búsquedas favoritos
Sugerencias y trucos

Agregar proveedores de búsquedas

El cuadro Búsqueda instantánea, situado en la esquina superior derecha de la ventana del explorador Internet Explorer 7 e Internet Explorer 8, reemplaza el asistente de Windows Search (o el panel de búsqueda). Para poder usar un proveedor de búsquedas concreto, es necesario agregarlo a la lista. Para agregar un proveedor de búsquedas, vaya al sitio web del proveedor. Hay dos maneras de instalar un proveedor de búsquedas.

En primer lugar, el sitio web del proveedor podría incluir un vínculo o un botón en el que hacer clic para agregarlo como proveedor de búsquedas a la lista. Al hacer clic en el vínculo o botón, se muestra el cuadro de diálogo Agregar proveedor de búsquedas para confirmar la selección.

Figura 1. Cuadro de diálogo Agregar proveedor de búsquedas.

Si ya está instalado un proveedor de búsquedas en concreto, aparecerá un cuadro de diálogo para informarle de ello o un cuadro de diálogo con opciones para actualizar el proveedor. Por ejemplo, ahora el proveedor de búsquedas puede proporcionar sugerencias de búsqueda que no ofrecía antes.

La segunda manera de agregar un proveedor de búsquedas es por detección. Después de que se carga la página web del proveedor, la flecha desplegable del cuadro Búsqueda instantánea se pone naranja, lo que indica que se puede instalar un proveedor de búsquedas.

Figura 2. Flecha desplegable naranja en el cuadro Búsqueda instantánea

Al hacer clic en la flecha desplegable naranja, aparece una lista de los proveedores de búsquedas instalados y otras opciones disponibles. Un icono dorado aparece a la izquierda del nombre del proveedor de búsquedas que Internet Explorer 8 detectó. Al hacer clic en la opción Agregar proveedores de búsquedas, se muestra una lista de los proveedores disponibles. La siguiente ilustración muestra las opciones de Live Search: Productos, Imágenes y Vídeos

Figura 3. Menú Agregar proveedor de búsquedas con los proveedores de búsquedas y las opciones de búsqueda

Nota: para empezar, dispone de una lista de proveedores inicial en la galería de Internet Explorer. Se puede tener acceso a la galería en cualquier momento al seleccionar Buscar más proveedores en la flecha desplegable del cuadro Búsqueda instantánea, como se muestra en la figura 3.

Agregar un proveedor de búsquedas propio

Si un proveedor de búsquedas no incluye un método directo para agregarlo como proveedor de búsquedas, se puede agregar manualmente. Siga las instrucciones de la página Agregar proveedores de búsqueda a Internet Explorer para crear su propio proveedor de búsquedas. Observe que este widget sólo agrega el proveedor como un proveedor de búsquedas, sin sugerencias de búsqueda. Si sabe que el proveedor proporciona sugerencias de búsqueda, use el sitio web del proveedor de búsquedas para agregarlo.

Administrar proveedores de búsquedas

Como máximo se puede instalar 200 proveedores de búsquedas, pero este número puede ser difícil de administrar. Para administrar los proveedores de búsquedas en Internet Explorer 8, haga clic en la flecha desplegable del cuadro Búsqueda instantánea y, a continuación, haga clic en Administrar proveedores de búsqueda. Es posible reordenar y quitar proveedores, o cambiar su estado predeterminado, como se muestra en la siguiente imagen.

Figura 4. Cuadro de diálogo para administrar complementos de Internet Explorer.

Para cambiar los atributos de un proveedor de búsquedas, haga clic en el nombre del proveedor, realice sus cambios y haga clic en Cerrar.

Nota: no puede quitar el proveedor predeterminado actual. Para quitar el proveedor predeterminado, debe establecer otro proveedor como predeterminado. Para ello, abra el cuadro de diálogo Administrar proveedores de búsqueda, seleccione otro proveedor y haga clic en el botón Predeterminado. A continuación, seleccione el proveedor que desee quitar y haga clic en Quitar.

Buscar con los proveedores de búsquedas favoritos

Para realizar una búsqueda, escriba el término en el cuadro Búsqueda instantánea. Aunque es posible que esté familiarizado con este cuadro en Internet Explorer 7, observará mejoras importantes en cómo se busca en Internet Explorer 8.

Después de hacer clic en el cuadro Búsqueda instantánea, aparecerá un menú de selección rápida. El menú de selección rápida muestra todos los iconos de proveedores de búsquedas que admita el ancho del cuadro Búsqueda instantánea, lo que facilita la alternancia entre proveedores. Para ver más proveedores de búsquedas en el menú de selección rápida, cambie el tamaño del cuadro Búsqueda instantánea. Puede usar el mismo término para buscar en todos estos proveedores sin tener que desplazarse hasta el sitio web de cada proveedor.

Figura 5. Menú de selección rápida

Después de escribir el término de búsqueda, presione ENTRAR para usar el proveedor de búsquedas actual o seleccione un proveedor en el menú de selección rápida para realizar la búsqueda. Si el proveedor de búsquedas que usa admite sugerencias de búsqueda, estas aparecerán a medida que escriba. Por ejemplo, si busca "Xbox" con Live Search, puede ver la siguiente lista de sugerencias.

Figura 6. Menú desplegable de sugerencias de Live Search.

En la parte superior del menú de sugerencias se encuentra la sección Autocompletar, que muestra las búsquedas recientes que coinciden con el término de búsqueda actual. La segunda parte del menú de sugerencias la ocupa la sección Sugerencias, que enumera las sugerencias de búsqueda que ofrece el proveedor de búsquedas actual. La tercera parte del menú de sugerencias la ocupa la sección Historial, que enumera los sitios web visitados con anterioridad cuyos títulos y direcciones URL coincidan con el término de búsqueda actual. Los términos coincidentes se resaltan. Puede seleccionar el término coincidente que desee buscar. El menú de selección rápida se muestra en la parte inferior del menú para un rápido acceso a los principales proveedores de búsquedas.

Internet Explorer 8 permite que los proveedores de búsquedas muestren sugerencias visuales. Los proveedores de búsquedas pueden proporcionar una imagen pequeña y texto, o simplemente una imagen que se puede mezclar con las sugerencias de texto normales. En la ilustración siguiente se muestran sugerencias visuales y de texto para el término "Xbox".

Figura 7. Sugerencias de búsqueda visuales y textuales para Xbox.

Además, un proveedor de búsquedas puede ofrecer respuestas instantáneas a un término de búsqueda. Con las respuestas instantáneas, el proveedor puede llevarle directamente a la información que está buscando en lugar de a una página de resultados de búsqueda. Esto puede hacer que la búsqueda sea más eficaz.

Búsqueda mediante aceleradores

El concepto de los aceleradores es una novedad de Internet Explorer 8. Los aceleradores proporcionan acceso a proveedores de servicios en cualquier lugar de la página. Cada vez que se agrega un proveedor de búsquedas a una lista, Internet Explorer 8 lo convierte automáticamente en un acelerador. Para usar esta característica, resalte el texto que desea buscar y haga clic en el icono Aceleradores Cc848862.ie8_accelerators_icon(en-us,VS.85).gif que aparece. Se mostrará una lista resumida con los servicios Web instalados. Entre ellos estará su proveedor de búsquedas predeterminado. Para usar un proveedor de búsquedas diferente, haga clic en Buscar más aceleradores. La siguiente ilustración muestra el menú Buscar más aceleradores expandido.

Figura 8. Menú Buscar más aceleradores con los servicios Web disponibles.

Otra ventaja de los aceleradores es la capacidad de obtener una vista previa de los resultados de búsqueda. Si su proveedor de búsquedas admite la vista previa de la búsqueda, simplemente puede seleccionar texto de una página web, hacer clic en el icono del acelerador, pasar el mouse sobre el nombre de su proveedor de búsquedas (puede que necesite abrir la lista Buscar más aceleradores para encontrarlo) y aparecerá una ventana de vista previa con los resultados de búsqueda correspondientes a las palabras seleccionadas. Esto agiliza y simplifica las búsquedas con los proveedores de búsquedas instalados. Para obtener más información sobre los aceleradores, vea el artículo Guía del desarrollador de aceleradores de OpenService.

Buscar en la página

La característica Buscar en la página es otra mejora de la experiencia del usuario presente en Internet Explorer 8. Para iniciar una búsqueda, haga clic en la opción Buscar, que se encuentra a la derecha del menú de selección rápida, o use la combinación de teclas CTRL+F. La característica Buscar en la página busca en la página actual con los términos del cuadro Búsqueda instantánea. Como se observa en la captura de pantalla siguiente, se resaltan todas las coincidencias de la página y el primer término coincidente aparece seleccionado. También se muestra el número de coincidencias en la página.

Figura 9: Característica Buscar en la página

Sugerencias y trucos

Presentamos a continuación otras características y sugerencias no mencionadas anteriormente.

Se puede eliminar el historial de búsqueda. Puede eliminar los términos de búsqueda y las páginas de historial anteriores de la lista Historial. Esto es útil cuando no se desea que los términos mal escritos aparezcan en la sección Autocompletar. Cuando escribe en la barra de direcciones o en el cuadro Búsqueda instantánea, las sugerencias de búsqueda se muestran junto con las sugerencias de Autocompletar e Historial. Pase el mouse sobre el elemento que desea eliminar de la lista Autocompletar o Historial y aparecerá una X al lado del elemento, como se muestra en la siguiente ilustración. Haga clic en la X para eliminar el elemento de la lista.

Figura 10. Eliminar un elemento de la lista Historial
Puede iniciar una búsqueda desde la barra de direcciones. Al usar la barra de direcciones, se usará el proveedor de búsquedas actual para ofrecer las sugerencias de búsqueda, pero la búsqueda realmente la realizará el proveedor de búsquedas predeterminado. Para ejecutar una búsqueda desde la barra de direcciones, inicie la búsqueda con ? seguido del término de búsqueda. Por ejemplo, para buscar xbox, escriba ? xbox. Si el proveedor de búsquedas actual ofrece sugerencias de búsqueda para xbox, aparecerán en una lista. Si selecciona un término o presiona ENTRAR, se ejecutará la búsqueda con el proveedor de búsquedas predeterminado.
Se puede cambiar el tamaño del cuadro Búsqueda instantánea. Para cambiar el tamaño del cuadro Búsqueda instantánea, mueva el puntero al borde izquierdo del cuadro Búsqueda instantánea. Cuando aparezca el puntero horizontal, arrástrelo para cambiar el tamaño del cuadro Búsqueda instantánea.

Características de búsqueda del desarrollador web

Ahora, los sitios pueden anunciar proveedores de búsquedas para que los usuarios puedan realizar las búsquedas directamente desde el cromo de Internet Explorer sin tener que navegar antes a un sitio determinado. El proveedor de búsquedas predeterminado también se usa para realizar búsquedas desde la barra de direcciones. El primer paso para promover su proveedor de búsquedas en Internet Explorer 8 es permitir a los usuarios instalar el sitio web como proveedor de búsquedas en el cuadro de búsquedas. Para ello, debe realizar dos pasos. El primer paso es crear un archivo de descripción OpenSearch vínculo World Wide Web para el proveedor de búsquedas y el segundo es exponer el archivo de descripción en el sitio web de modo que los usuarios puedan instalarlo.

Esta sección se centra en ayudar a los desarrolladores a entender y aprovechar las características de búsqueda de Internet Explorer 8 para mejorar la experiencia de búsqueda de los usuarios. En esta sección se tratan los siguientes temas:

Crear un archivo de descripción OpenSearch
Promover proveedores de búsquedas
Ofrecer sugerencias de búsqueda
Obtener las dimensiones del menú Sugerencias de búsqueda
Identificar referencias de búsqueda
Localizar sugerencias de búsqueda
Notas

Crear un archivo de descripción OpenSearch

Antes de promover sus servicios y proporcionar a los usuarios opciones para instalar su proveedor de búsquedas, debe crear un archivo de descripción OpenSearch vínculo World Wide Web . Los archivos de descripción OpenSearch son pequeños archivos XML que describen su proveedor de búsquedas en Internet Explorer 8. En la siguiente tabla se describen los valores del archivo de descripción OpenSearch.

Valor	Descripción
ShortName (necesario)	Es el nombre del proveedor de búsquedas que se muestra en el cuadro Búsqueda instantánea cuando se selecciona el proveedor.
URL (necesario)	Dirección URL para realizar consultas de búsqueda básicas a su proveedor de búsquedas. Tiene que ser una dirección URL absoluta.
Image (opcional)	Puntero a un archivo de icono de página del proveedor de búsquedas en el sitio web. Este icono se muestra al lado del nombre del proveedor en el cuadro Búsqueda instantánea. El icono debe ser un archivo de icono de acceso directo válido; de lo contrario, se usará un icono genérico. Para obtener más información sobre cómo crear un icono de página, vea la sección relativa a la creación de iconos en el formato correcto del artículo Agregar un icono de acceso directo a una página web (la página puede estar en inglés).
Sugerencias URL(JSON) (opcional)	Es la dirección URL donde se pueden recuperar sugerencias en notación de objetos JavaScript (JSON).
Sugerencias URL(XML) (opcional)	Es la dirección URL donde se pueden recuperar sugerencias basadas en XML.
PreviewUrl (opcional)	Dirección URL para mostrar los resultados en una ventana Vista previa de acelerador.

En el siguiente ejemplo de archivo de descripción OpenSearch se define el tipo de servicios de búsqueda que se prevé ofrecer.

<?xml version="1.0" encoding="UTF-8"?>
<OpenSearchDescription xmlns="http://a9.com/-/spec/opensearch/1.1/" xmlns:ie="https://schemas.microsoft.com/Search/2008/">
	<ShortName>My Custom Search</ShortName>
	<Image height="16" width="16" type="image/icon">http://example.com/example.ico</Image>
	<Url type="text/html" template="http://example.com/search.aspx?q={searchTerms}&amp;source=IE"/>   
	<Url type="application/x-suggestions+json" template="http://suggestions.example.com/search.aspx?q={searchTerms}"/>
	<Url type="application/x-suggestions+xml" template="http://suggestions.example.com/search.aspx?q={searchTerms}"/>
	<ie:PreviewUrl type="text/html" template="http://suggestions.example.com/search.aspx?q={searchTerms}"/>
</OpenSearchDescription>

Todos los archivos de descripción OpenSearch deben incluir el nombre del proveedor de búsquedas y la dirección URL de búsqueda. Sin estos elementos, Internet Explorer 8 no puede instalar un proveedor de búsquedas. Todas las direcciones URL de búsqueda deben contener "{searchTerms}" en alguna parte de la cadena de consulta. Cuando Internet Explorer 8 navega a este proveedor para obtener los resultados de la búsqueda, "{searchTerms}" se reemplaza con la cadena de consulta que el usuario escribió en el cuadro Búsqueda instantánea. Debería incluir un icono dentro del archivo de descripción OpenSearch. Si Internet Explorer 8 no encuentra ningún icono especificado en el atributo "Image", usará un icono genérico icono de proveedor de búsquedas genérico para representar el proveedor de búsquedas en el menú de selección rápida.

Una manera rápida de generar un archivo de descripción OpenSearch es usar un widget de Agregar proveedores de búsqueda a Internet Explorer para crear un archivo XML propio. Siga las instrucciones del widget y, a continuación, haga clic en el vínculo Ver XML del paso 5. El widget crea sintaxis XML similar al fragmento de código anterior. Guarde la salida en un archivo XML y, a continuación, cargue el archivo en su servidor web. Asegúrese de que tiene un archivo XML válido y de que los caracteres "&" están codificados en la dirección URL.

Nota: el widget sólo genera un archivo XML básico que se puede usar y personalizar. Sin embargo, no genera iconos o direcciones URL de sugerencias. Debe agregarlos usted mismo.

Agregar sugerencias de búsqueda a los archivos de descripción OpenSearch

En Internet Explorer 8, los proveedores de búsquedas pueden ofrecer sugerencias a los usuarios. Con ayuda de las sugerencias de búsqueda, los usuarios pueden crear mejores términos de búsqueda y encontrar lo que buscan más rápidamente. Para ofrecer sugerencias de búsqueda en formato JSON y XML, agregue los siguientes elementos al archivo de descripción.

<Url type="application/x-suggestions+json" template="http://suggestions.example.com/search.aspx?q={searchTerms}"/>
<Url type="application/x-suggestions+xml" template="http://suggestions.example.com/search.aspx?q={searchTerms}"/>

Para agregar otros elementos de dirección URL, asegúrese de que primero aparece "text/html". Esto es para que exista compatibilidad con versiones anteriores. Los demás tipos pueden aparecer a continuación en cualquier orden. De forma predeterminada, Internet Explorer usa la dirección URL "text/html" como dirección URL de búsqueda genérica cuando no hay sugerencias de búsqueda disponibles o no se admiten en versiones anteriores. Sin embargo, cuando exista la dirección URL para XML y JSON, Internet Explorer 8 usará la dirección URL de sugerencias XML.

Nota: en caso de que los usuarios hayan agregado el proveedor de búsquedas antes de que admitiese sugerencias, deben volver a agregarlo. Internet Explorer 8 detectará que el proveedor de búsquedas ya se había instalado pero ahora ofrece sugerencias. El cuadro de diálogo Agregar proveedor de búsquedas mostrará un botón para actualizar el proveedor y habilitará la casilla para sugerencias de búsqueda.

Compatibilidad con las vistas previas de búsquedas

Todos los proveedores de búsquedas instalados se convierten automáticamente en aceleradores. Dado que los aceleradores admiten las vistas previas, se pueden ofrecer también vistas previas de las búsquedas si se agrega un elemento PreviewUrl al archivo de descripción OpenSearch, como se muestra a continuación.

<ie:PreviewUrl type="text/html" template="http://suggestions.example.com/search.aspx?q={searchTerms}/>

Si se agrega este elemento al archivo de descripción OpenSearch, se puede ofrecer una vista ligera de la página de resultados de búsqueda. La vista previa se presenta en una ventana de 320 x 240 cuando el usuario selecciona texto en una página web, hace clic en el icono Aceleradores y pasa el mouse por encima del nombre del proveedor de búsquedas. Para obtener más información sobre la característica de vista previa y los aceleradores, vea el artículo Guía del desarrollador de aceleradores de OpenService.

Nota: ie:PreviewUrl usa el espacio de nombres que proporcionan las declaraciones de espacio de nombres de Internet Explorer. Cuando use esta característica, asegúrese de que esta declaración está definida en la etiqueta OpenSearchDescription: xmlns:ie="https://schemas.microsoft.com/Search/2008/".

Promover proveedores de búsquedas

Después de crear el archivo de descripción OpenSearch, puede promover sus servicios a los usuarios. Sobre todo, hay dos maneras de promover los proveedores de búsquedas. La primera opción es proporcionar a los usuarios un vínculo o botón que señale al archivo de descripción. Los usuarios deberán realizar alguna acción para instalar el proveedor. La segunda opción es hacer que el proveedor sea detectable. Esto requiere que se incluya una línea de código en la parte superior de la página web, que permite que Internet Explorer 8 detecte el proveedor cuando los usuarios examinan el sitio.

El siguiente código agrega un proveedor de búsquedas cuando un usuario hace clic en un vínculo.

<a href="#"
   onclick="window.external.AddSearchProvider('http://www.example.com/provider.xml')"
   >Add Search Provider Example</a>

El código realiza una llamada al método AddSearchProvider. El método AddSearchProvider está disponible en el objeto external de window. Al ejecutar este código desde una página HTML en Internet Explorer 8, se muestra el cuadro de diálogo Agregar proveedor de búsquedas.

Hacer que el proveedor de búsquedas sea detectable

La segunda manera de promover un proveedor de búsquedas es hacer que este sea detectable. La especificación de OpenSearch describe cómo anunciar proveedores de búsquedas al agregar un elemento de vínculo al encabezado de la página web. El siguiente código permite a Internet Explorer 8 detectar el proveedor de búsquedas.

<link title="My Provider" rel="search"
   type="application/opensearchdescription+xml"
   href="http://www.example.com/provider.xml">

El atributo rel debe ser "search" y type debe ser "application/opensearchdescription+xml". El valor de title se muestra en el menú desplegable del cuadro Búsqueda instantánea. El atributo href contiene una dirección URL absoluta o relativa que especifica la ubicación del archivo de descripción OpenSearch.

Cuando la página se carga en Internet Explorer 8, la flecha desplegable del cuadro Búsqueda instantánea se pone naranja para indicar que se han agregado nuevos proveedores de búsquedas al menú desplegable. Se mostrarán los tres proveedores de búsquedas detectables más recientes, que se deberán instalar para poder incluir más proveedores en la lista. Cuando el usuario se desplaza a otro dominio, se quitan los proveedores de búsquedas detectados previamente. Los usuarios pueden probar los nuevos proveedores antes de agregarlos a su lista. Cuando un usuario decide instalar un proveedor de búsquedas, se muestra el cuadro de diálogo Agregar proveedor de búsquedas.

Ofrecer sugerencias de búsqueda

Con el formato de sugerencias JSON
Con el formato de sugerencias XML
Ofrecer sugerencias visuales
Administrar las respuestas con errores

A partir de Internet Explorer 8, el cuadro Búsqueda instantánea admite sugerencias de búsqueda. Con las sugerencias de búsqueda, cuando el usuario está escribiendo en el cuadro de búsqueda, Internet Explorer 8 puede enviar solicitudes al proveedor de búsquedas con la cadena de consulta actual y se pueden ofrecer sugerencias que podrían permitir al usuario crear un término de búsqueda más apropiado. Internet Explorer 8 admite dos formatos de sugerencias de búsqueda: el formato JSON y el formato XML. El formato JSON permite sugerencias de búsqueda de texto que se pueden mejorar con descripciones y direcciones URL. El formato XML habilita todo el contenido que está disponible con las sugerencias JSON y, además, admite sugerencias visuales y títulos de sección. Encontrará más detalles sobre el formato XML para sugerencias de búsqueda en este artículo: Especificación del formato XML para sugerencias de búsqueda (la página puede estar en inglés).

Nota: en esta sección solo se trata el formato de las respuestas de sugerencias individuales. Para admitir totalmente las sugerencias de búsqueda, debe generarlas y ofrecer las correctas con cada solicitud. Puesto que este tipo de sugerencias es exclusivo de cada proveedor, no se describe aquí.

Con el formato de sugerencias JSON

Las sugerencias de búsqueda JSON se devuelven como una matriz de matrices Microsoft JScript. La matriz contiene cuatro valores:

Valor	Descripción
Cadena de consulta (necesaria)	Término de búsqueda que se solicitó. Si el explorador solicita sugerencias para "xbox", la cadena de consulta es "xbox". Al devolver la cadena de consulta en la matriz se garantiza que las sugerencias devueltas hacen referencia al término de búsqueda solicitado.
Matriz de búsquedas completadas (necesaria)	Sugerencias de la cadena de consulta en cuestión.
Matriz de descripciones (opcional)	Cadenas alternativas que proporcionan más información o contexto sobre una búsqueda completada determinada.
Matriz de direcciones URL de consulta (opcional)	Lista de direcciones URL que se deberían emplear si el usuario selecciona una sugerencia determinada. Esto actúa como una respuesta instantánea para el término de búsqueda, ya que se dirige al usuario a la dirección URL en lugar de a una página de resultados de búsqueda.

Una respuesta JSON debe devolver la cadena de consulta y las sugerencias de búsqueda en la matriz de búsquedas completadas. A continuación se ofrece un ejemplo de respuesta JSON simple donde se omiten las descripciones y las direcciones URL de consulta.

["xbox",
	["Xbox 360", "Xbox cheats", "Xbox 360 games"]]

Nota: se muestran como máximo diez sugerencias de búsqueda al mismo tiempo. Al agregar descripciones, elementos visuales y secciones, se limita el número de sugerencias que se pueden ofrecer. Es importante enviar las sugerencias más pertinentes al principio de la matriz de búsquedas completadas.

Para ayudar a los usuarios a crear mejores términos de búsqueda, es posible ofrecer descripciones junto con las sugerencias. Se pueden ofrecer direcciones URL de consulta como una forma de respuesta instantánea. Cuando se ofrece una dirección URL de consulta y el usuario hace clic en esa sugerencia, Internet Explorer 8 le lleva directamente a esa dirección URL de consulta en lugar de a una página de resultados de búsqueda. A continuación se ofrece un ejemplo de respuesta JSON detallada.

["xbox",
	["Xbox 360", "Xbox cheats", "Xbox 360 games"], 
	["The official Xbox website from Microsoft", "Codes and walkthroughs", "Games and accessories"],	
	["https://www.xbox.com","http://www.example.com/xboxcheatcodes.aspx", "http://www.example.com/games"]]

En esta respuesta JSON, la primera sugerencia de búsqueda se compone de los siguientes elementos:

Primer elemento de la primera matriz ("Xbox 360")
Primer elemento de la segunda matriz ("The official Xbox website from Microsoft")
Primer elemento de la tercera matriz ("https://www.xbox.com").

La respuesta anterior genera los siguientes resultados:

Figura 11. Sugerencias de búsqueda JSON

Con el formato de sugerencias XML

La respuesta JSON anterior se puede representar en formato de sugerencias XML, como se muestra en el siguiente ejemplo. Este ejemplo contiene la misma respuesta de sugerencias que el ejemplo anterior para JSON y genera exactamente el mismo resultado.

<?xml version="1.0"?>
<SearchSuggestion xmlns="https://schemas.microsoft.com/Search/2008/suggestions">
    <Query>xbox</Query>
    <Section>
	<Item>
		<Text>Xbox 360</Text>
		<Description>The official Xbox website from Microsoft</Description>
		<Url>http://www.xbox.com</Url>
	</Item>
	<Item>
		<Text>Xbox cheats</Text>
		<Description>Codes and walkthroughs</Description>
		<Url>http://www.example.com/xboxcheatcodes.aspx</Url>
	</Item>
	<Item>
		<Text>Xbox 360 games</Text>
		<Description>Games and accessories</Description>
		<Url>http://www.example.com/games</Url>
	</Item>
    </Section>
</SearchSuggestion>

El formato de sugerencia JSON no permite especificar títulos de sección en el menú de sugerencias. En Internet Explorer 8, el título de sección estará formado por el nombre del proveedor de búsquedas más las palabra "Sugerencias". Por ejemplo, si su proveedor de búsquedas se llamase "Búsqueda de Juan", las sugerencias se titularían "Sugerencias de búsqueda de Juan". En el siguiente ejemplo, el proveedor de búsquedas se llama "My Custom Search" y el título se muestra como "My Custom Search Suggestions". Si desea organizar las sugerencias en varias secciones, use el formato de sugerencias XML. Además de los títulos de sección, el formato de sugerencias XML admite las sugerencias visuales. Encontrará más detalles sobre el formato XML para sugerencias de búsqueda en este artículo: Especificación del formato XML para sugerencias de búsqueda (la página puede estar en inglés).

Las sugerencias de búsqueda XML admiten las mismas características que las sugerencias de búsqueda JSON y características adicionales que no están disponibles en JSON. Estas características adicionales son:

Personalizar el título de la sección de sugerencias.
Dividir las sugerencias en varios separadores de sección.
Incluir sugerencias visuales.

Para personalizar los títulos de sección, puede agregar un atributo "title" al elemento Section o puede agregar un separador. Los separadores pueden tener o no un título. En el siguiente ejemplo se agrega un separador para "My Text Suggestions" y otro separador sin título.

<?xml version="1.0"?>
<SearchSuggestion xmlns="https://schemas.microsoft.com/Search/2008/suggestions">
    <Query>xbox</Query>
    <Section>
	<Separator title="My Text Suggestions"/>
	<Item>
		<Text>Xbox 360</Text>
		<Description>The official Xbox website from Microsoft</Description>
 		<Url>http://www.xbox.com</Url>
	</Item>
	<Item>
		<Text>Xbox cheats</Text>
		<Description>Codes and walkthroughs</Description>
		<Url>http://www.example.com/xboxcheatcodes.aspx</Url>
	</Item>
	<Item>
		<Text>Xbox 360 games</Text>
		<Description>Games and accessories</Description>
		<Url>http://www.example.com/games</Url>
	</Item>
	<Separator />
	<Item>
		<Text>xbox 360 lowest price</Text>
	</Item>
	<Item>
		<Text>xbox 360 news</Text>
	</Item>
    </Section>
</SearchSuggestion>

El código anterior genera el siguiente resultado.

Figura 12. Sugerencias de búsqueda XML con título personalizado y separadores de sección

Ofrecer sugerencias visuales

Las sugerencias de búsqueda generalmente están compuestas de sugerencias de texto o términos relacionados que los usuarios pueden desear buscar. En Internet Explorer 8, el concepto de sugerencia de búsqueda es más amplio y ahora abarca cadenas de consulta, vínculos o sugerencias visuales. Una sugerencia visual incluye una imagen. Un proveedor de búsquedas puede proporcionar una imagen con texto, o simplemente una imagen, como sugerencia de búsqueda para el término de búsqueda del usuario. Para agregar una sugerencia visual a una respuesta, agregue un elemento Image al elemento Item de esa sugerencia. Asegúrese también de especificar el ancho y alto de la imagen. Por ejemplo, para ofrecer una sugerencia visual para el término "Xbox", podría devolver lo siguiente:

 <Separator title="My Visual Suggestions" />
  <Item>
  	<Text>Xbox 360 Game Consoles</Text>
  	<Description>Game console systems and packages at a great deal.</Description>
  	<Image source="http://www.example.com/xboxconsole.jpg" alt="Xbox 360 Consoles" width="75" height="75"/> 
  	<Url>http://www.example.com/</Url>
  </Item>
  <Item>
  	<Text>Xbox 360 Wireless Controller</Text> 
  	<Image source="http://www.example.com/xboxcontroller.jpg" alt="Xbox 360 Wireless Controller" width="75" height="75"/> 
  </Item>
  <Item>
  	<Text>Xbox 360 Live Games</Text> 
  	<Image source="http://www.example.com/live.jpg" alt="Xbox 360 Live Games" width="75" height="75"/> 
  	<Url>http://www.example.com/games.aspx?q="Xbox 360"</Url> 
  </Item>

El código anterior genera los siguientes resultados.

Figura 13. Sugerencias visuales para Xbox

En este ejemplo se ofrece una dirección URL con dos de las sugerencias. Internet Explorer 8 lleva directamente al usuario a la página especificada por la dirección URL. Si no se proporciona la dirección URL, el valor del elemento Text ("Xbox 360 Wireless Controller") se usa como término de búsqueda. Si desea ofrecer una sugerencia visual sin texto o descripción, debe proporcionar una dirección URL, de modo que Internet Explorer 8 sepa a dónde dirigir al usuario.

De forma predeterminada, si incluye el texto con una imagen, el texto se centra verticalmente al lado de la imagen. Al establecer el valor del atributo de alineación en "top", "middle" o "bottom", se puede especificar la alineación del texto del elemento Text y Description con respecto a la imagen.

Para alinear el texto, agregue el atributo de alineación al elemento image. En el siguiente ejemplo se establece el atributo align en "top".

<Image source="http://www.example.com/xboxconsole.jpg" alt="Xbox 360 Consoles" width="75" height="75" align="top"/>

Administrar las respuestas con errores

Al ofrecer sugerencias de búsqueda, existe la posibilidad de que haya términos para los que no tenga sugerencias o que no se reconozca el término de búsqueda. Aún en ese caso, debe devolver una respuesta XML válida para que los usuarios no reciban un mensaje de error. Para evitar este mensaje, devuelva una respuesta XML válida cuando no tenga ninguna sugerencia para el término de búsqueda. El siguiente fragmento de código envía una respuesta sin sugerencias para el término de búsqueda xbox. Esta respuesta mostrará el mensaje "No results".

<?xml version="1.0"?>
<SearchSuggestion xmlns="https://schemas.microsoft.com/Search/2008/suggestions">
    <Query>xbox</Query>
</SearchSuggestion>

Para una respuesta JSON, devuelva:

 ["xbox"]

Aparte de que no tenga ninguna sugerencia para un término de búsqueda, es posible que sepa que hay una sugerencia pero sigue apareciendo el mensaje de error. En ese caso, compruebe la codificación de la solicitud. De forma predeterminada, los términos de búsqueda se codifican en UTF-8 a través del método de solicitud HTTP GET. Esto significa que, si el usuario escribe caracteres con tilde, estos se codifican en su equivalente en ASCII (texto). Por ejemplo, si el término de búsqueda es "café", el término que recibe el proveedor de búsquedas es q=caf%c3%a9, donde la é con tilde se codifica en su equivalente ASCII %c3%a9.

Nota: los proveedores de búsquedas deben usar el método de solicitud HTTP GET; no se admite el método de solicitud POST.

Obtener las dimensiones del menú Sugerencias de búsqueda

Cuando se ofrecen sugerencias visuales, se debería incluir el alto y ancho de la imagen. Si no se incluyen estos valores, Internet Explorer 8 asigna un espacio predeterminado para la imagen y le aplica una escala de modo que se ajuste dentro de ese espacio. La cantidad de espacio predeterminado, en este caso, es el equivalente vertical de una línea de texto.

Se puede cambiar el tamaño del cuadro Búsqueda instantánea, de modo que las dimensiones del menú desplegable de sugerencias de búsqueda puedan variar. Para averiguar las dimensiones del menú de sugerencias de búsqueda, puede agregar a la dirección URL de la descripción OpenSearch parámetros que devuelvan el tamaño del menú desplegable de sugerencias de búsqueda. A continuación se muestran los parámetros disponibles.

Parámetro	Descripción
{maxWidth}	Ancho del menú desplegable, en píxeles.
{sectionHeight}	Alto de la sección de sugerencias completa.
{rowHeight}	Alto de una sola línea de texto, que es equivalente a una línea de texto.

En el siguiente ejemplo se muestran estos parámetros agregados a la dirección URL del archivo de descripción OpenSearch.

<Url type="application/x-suggestions+xml" 
	template="http://suggestions.example.com/search.aspx?q={searchTerms}&amp;
	maxwidth={maxWidth}&amp;rowheight={rowHeight}&amp;sectionHeight={sectionHeight}" 
/>

La imagen siguiente identifica el área de cada parámetro.

Figura 14. Parámetros del menú de sugerencias de búsqueda

Identificar referencias de búsqueda

A partir de Internet Explorer 7, se admite la extensión de referencia de OpenSearch vínculo de World Wide Web . Cuando el usuario inicia una búsqueda, Internet Explorer agrega un atributo referrer a la consulta de búsqueda que indica si la búsqueda se inició a través del cuadro Búsqueda instantánea o la barra de direcciones. Si la búsqueda se inició desde el cuadro Búsqueda instantánea, el atributo referrer se establece en IE-SearchBox. Si la búsqueda se inició desde la barra de direcciones, ya sea a través de un favorito o escribiendo directamente, el atributo referrer se establece en IE-Address.

Localizar sugerencias de búsqueda

Si ofrece sus servicios en varios idiomas, puede determinar qué sugerencias deben enviarse localizadas si agrega el atributo "{Language}" a la cadena de consulta. En el siguiente ejemplo se muestra cómo recibir la información del idioma del usuario para atender solicitudes localizadas:

<Url type="application/x-suggestions+xml" 
	template="http://suggestions.example.com/search.aspx?
	q={searchTerms}&amp;language={Language}" 
/>

Cuando Internet Explorer solicite sugerencias, reemplazará "{Language}" con el idioma aceptado de Internet Explorer que se encuentre definido en la configuración regional del sistema del usuario. La configuración regional del sistema del usuario se puede establecer desde el Panel de control y desde la configuración de idioma de Internet Explorer en el cuadro de diálogo Opciones de Internet.

Nota: vea la anterior sección "Administrar las respuestas con errores" para obtener información relativa a la codificación de caracteres que puede afectar a sus respuestas localizadas.

Notas

Tenga presente lo siguiente.

Un sitio web no puede iniciar automáticamente el cuadro de diálogo Agregar proveedor de búsquedas. Se bloquea del mismo modo que se bloquean los elementos emergentes en los sitios web, y se puede iniciar únicamente como resultado de una acción directa del usuario.
Los títulos deberían ser cortos; lo ideal son, como máximo, 16 caracteres. El cuadro Búsqueda instantánea usa esta cadena. Si el título es más largo, el cuadro de búsqueda podría mostrarse recortado.
El título de la etiqueta del vínculo debería ser el mismo que usa el archivo de descripción XML. Estas cadenas deben coincidir para que la detección de búsqueda reconozca que un proveedor está instalado y la flecha desplegable de cuadro Búsqueda instantánea no se ponga naranja o el proveedor instalado se agregue automáticamente a la lista de proveedores detectados.
Cuando un usuario restaura la configuración predeterminada de Internet Explorer, se quitan todos los proveedores de búsquedas personalizados.
Si usa scripts para agregar un proveedor, quizás le interese llamar al método auxiliar IsSearchProviderInstalled para comprobar si ya se ha instalado.
Al crear los archivos de descripción, asegúrese de que el archivo tiene sintaxis XML válida, que todos los caracteres de las cadenas de consulta están codificados y que todos los caracteres "&" incluyen la secuencia de escape "&".
Dado que los usuarios pueden cambiar el tamaño del cuadro Búsqueda instantánea, puede ejecutar una consulta a Internet Explorer 8 para que devuelva las dimensiones del cuadro desplegable de sugerencias de búsqueda agregando parámetros a la dirección URL del archivo de descripción XML.

Temas relacionados

Especificación del formato XML para sugerencias de búsqueda (la página puede estar en inglés)
AddSearchProvider
IsSearchProviderInstalled
Agregar proveedores de búsqueda a Internet Explorer
Descripción OpenSearch (en inglés)