Спецификация формата предложений для XML-поиска

Предложения поиска Windows Internet Explorer 8 — это услуга, которую служба поиска может поддерживать, чтобы пользователь получал предложения для поискового запроса. XML-предложения службы поиска могут поддерживать текстовые предложения или визуальные предложения.

В этом документе рассматриваются минимальные свойства, необходимые, чтобы позволить клиенту использовать XML-предложения. Дополнительные сведения о расширяемости службы поиска можно найти в следующей статье: Расширяемость службы поиска в Internet Explorer. В этой статье обсуждаются следующие вопросы:

  • Формат предложений поиска 
  • Элемент SearchSuggestion 
  • Элемент Query 
  • Элемент Section 
    • Атрибут title 
  • Элемент Item 
  • Элемент Text 
  • Элемент Url 
  • Элемент Description 
  • Элемент Image 
    • Атрибут source 
    • Атрибут alt 
    • Атрибут width 
    • Атрибут height 
    • Атрибут align 
  • Элемент Separator 
    • Атрибут title 
  • Расширяемость 
  • Сведения о лицензировании 
  • Редакции 
  • Связанные темы

Формат предложений поиска

Форма предложений поиска описывают базовый набор свойств, нужных в приложении поиска. В приведенном ниже фрагменте кода показано, как элементы и атрибуты могут использоваться для отправки XML-предложений.

<?xml version="1.0"?>

<SearchSuggestion xmlns ="http://schemas.microsoft.com/Search/2008/suggestions">

    <Query>xbox</Query>

    <Section>

         <Separator title="Мои визуальные предложения"/>

         <Item>

                 <Text>Xbox 360 Live Games</Text>

                 <Image source="http://www.example.com/live.jpg" alt="Xbox 360 Live Games" width="75" height="75"/>

    <Item>

         <Item>

                 <Description>Системы и комплекты игровых консолей по отличной цене.</Description>

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

         <Separator title="Мои текстовые предложения"/>

         <Item>

                 <Text>Xbox 360</Text>

         <Item>

         <Item>

                 <Text>Уловки Xbox</Text>

                 <Description>Коды и обзоры</Description>

         <Item>

         <Item>

                 <Text>Игры Xbox 360</Text>

                 <Description>Игры и принадлежности</Description>

                 <Url>http://www.example.com/games</Url>

         </Item>

         <Separator />

         <Item>

                 <Text>Наименьшая цена xbox 360</Text>

         </Item>

         <Item>

                 <Text>Новости Xbox 360</Text>

         </Item>

    </Section>

</SearchSuggestion>

Элемент SearchSuggestion

Корневой узел документа предложений поиска.

Родитель: отсутствует

Требования: этот элемент должен появиться один раз в качестве корневого узла документа.

Элемент Query

Содержит запрос, отправленный клиентом.

Родитель: SearchSuggestion

Требования: должен быть только один экземпляр этого элемента

Элемент Section

Содержит набор элементов предложений поиска для данного запроса.

Родитель: SearchSuggestion

Требования: может быть только один экземпляр этого элемента

Атрибут title

Содержит заголовок, который должен использоваться с этими предложениями поиска.

Требования: может быть только один экземпляр этого атрибута.

Элемент Item

Содержит данные, необходимые для одного запроса поиска.

Родитель: Section

Требования:

  • Может быть один или несколько экземпляров этого элемента.
  • Все элементы списка должны содержать либо элемент Text, либо элемент Url, либо оба элемента.

Элемент Text

Текстовое предложение для данной строки запроса. Это значение используется, чтобы определить выдаваемый поиск, если выбрано это предложение, за исключением случая, когда элемент списка также содержит элемент Url.

Родитель: Item

Требования: может быть только один экземпляр этого элемента

Элемент Url

Содержит конечный URL-адрес, когда выбран предложенный элемент.

Родитель: Item

Требования: может быть только один экземпляр этого элемента.

Элемент Description

Содержит дополнительное описание этого элемента.

Родитель: Item

Требования: может быть только один экземпляр этого элемента

Элемент Image

Содержит изображение, связанное с предложенным элементом.

Родитель: Item

Требования: может быть только один экземпляр этого элемента.

<Item>

         <Description>Официальный веб-сайт Xbox корпорации Майкрософт</Description>

         <Url>http://www.xbox.com/search.aspx?q="Xbox 360"</Url>

         <Image source="http://www.example.com/xboxconsole.jpg" alt="Консоли Xbox 360" width="75" height="75" align="middle"/>

</Item>

Атрибут source

Содержит исходный URL-адрес изображения.

Требования: должен быть только один экземпляр этого атрибута

Атрибут alt

Содержит альтернативный текст для этого изображения.

Требования: может быть только один экземпляр этого атрибута.

Атрибут width

Содержит ширину изображения в пикселях.

Требования: может быть только один экземпляр этого атрибута.

Атрибут height

Содержит высоту изображения в пикселях.

Требования: может быть только один экземпляр этого атрибута.

Атрибут align

Содержит предпочтения издателя, определяющие выравнивание изображения относительно текста.

Требования:

  • Может быть только один экземпляр этого атрибута.
  • Значение должно быть равно "top" (вверху), "middle" (по середине) или "bottom" (внизу)

Элемент Separator

Показывает новый раздел предложений.

Родитель: Section

Требования: может быть один или несколько экземпляров этого элемента.

Атрибут title

Содержит заголовок, который должен использоваться для этого элемента Separator.

Требования: может быть только один экземпляр этого атрибута.

Расширяемость

Формат XML SearchSuggestion, который может расширяться с помощью соглашения Спецификации пространства имен XML W3C. Пространство имен XML должно быть уникальным пространством имен.

Сведения о лицензировании

Авторские права корпорации Майкрософт в этой спецификации лицензируются в соответствии с лицензией Creative Commons Attribution-Share Alike License (версия 3.0). Копию этой лицензии можно просмотреть по адресу http://creativecommons.org/licenses/by-sa/3.0. Существует отдельное патентное обязательство, называемое Microsoft Open Specification Promise и доступное сторонам, заинтересованным в реализации программного обеспечения, соответствующего этой спецификации. Это патентное обязательство доступно по следующему адресу: http://www.microsoft.com/interop/osp/default.mspx.

Редакции

На текущий момент редакции отсутствуют.

Связанные темы