Описание хml

Скачать 105.99 Kb.

Название	Описание хml
Дата публикации	23.09.2014
Размер	105.99 Kb.
Тип	Документы

100-bal.ru > Информатика > Документы

http://retail.adlabs.ru

Описание ХML

ХML — это стандарт для принятия и размещения информации в базе данных Retail Adlabs. Единый формат представления данных позволяет быстро и качественно обрабатывать предоставляемую магазинами информацию о товарах.

Настройте экспорт информации о товарах из вашей базы данных в ХML-файл или используйте CMS со встроенными возможностями экспорта данных в формат ХML. Разместите файл на сайте вашего магазина по URL, который указывается при создании магазина в Личном кабинете на http://retail.adlabs.ru. ХML-файл регулярно скачивается роботом и обновленные данные импортируются в базу Retail Adlabs.

Чтобы легко и быстро подготовить ХML-файл и выгрузить данные в сервис по подбору товаров, руководствуйтесь приведенными ниже положениями.

Общие требования к ХML-файлу

Стандарт ХML учитывает порядок следования элементов, поэтому важно соблюдать его в соответствии с примером.
Стандарт ХML не допускает использования в текстовых данных непечатаемых символов с ASCII-кодами в диапазоне значений от 0 до 31 (за исключением символов с кодами 9, 10, 13 — табуляция, перевод строки, возврат каретки). Это требует обязательной замены некоторых символов на эквивалентные им символьные коды:

Символ в тексте	Код для ХML-файла
"	"
&	&
>	>
<	<
'	'

XML header

Это стандартный XML-заголовок со ссылкой на файл описания формата. Заголовок должен начинаться с первой строки, с нулевого символа.

Пример:

windows-1251"?>

Любой XML-документ может содержать только один корневой элемент - . Атрибут date элемента < yml_catalog> должен соответствовать дате и времени генерации YML-файла на стороне магазина. Дата должна иметь формат YYYY-MM-DD hh:mm.

Пример:

<yml_catalog date="2010-04-01 17:00">

<shop>

...

yml_catalog>

Элемент содержит описание магазина и его товарных предложений.

Пример:

<shop>

<name>BestShopname>

<company>Best online seller Inc.company>
<currencies> ... currencies>

<categories> ... categories>

...

shop>

Магазин описывается следующими элементами:

Элемент	Описание
	Короткое название магазина. Оно не должно содержать более 20 символов. Название магазина должно совпадать с фактическим названием магазина, которое публикуется на сайте.
	Полное наименование компании, владеющей магазином. Не публикуется, используется для внутренней идентификации.

Элемент задает список курсов валют магазина. Каждая из валют описывается отдельным элементом .

Данные о ценах принимаются в рублях (RUR, RUB), гривнах (UAH), белорусских рублях (BYR), тенге (KZT), долларах (USD) и евро (EUR). В Шоуруме цены отображаются в рублях. Если в вашем ХML-файле не задан курс для отображаемой валюты, то используется курс Центрального Банка страны, к которой относится регион пользователя. Применяется курс, установленный на текущий день. Курс обновляется ежедневно в 00.00.

Пример:

<currencies>

<currency id="RUR" rate="1"/>
<currency id="USD" rate="23.98"/>

<currency id="EUR" rate="CBRF"/>

<currency id="UAH" rate="NBU"/>

currencies>

Параметр id элемента указывает код одной или нескольких валют, которые могут быть использованы в ХML-файле.

Параметр rate указывает курс валюты к курсу основной валюты, взятой за единицу (валюта, для которой rate="1"). Параметр rate может иметь следующие значения:

Постоянное число — внутренний курс, который вы используете.
CBRF — курс по Центральному банку РФ.
NBU — курс по Национальному банку Украины.
NBK — курс по Национальному банку Казахстана.
СВ — курс по банку той страны, к которой относится магазин по своему региону, указанному в партнерском интерфейсе.

В качестве основной валюты (для которой установлено rate="1") могут быть использованы только рубль (RUR, RUB), белорусский рубль (BYR), гривна (UAH) или тенге (KZT).

Обратите внимание!

В качестве разделителя целой и дробной частей любых чисел в ХML независимо от региональных установок используется точка (не запятая!).

В элементе содержится список категорий магазина. Каждая категория описывается отдельным элементом . Описание категории должно включать ее идентификатор (параметр id) для всех категорий и идентификатор категории более высокого уровня для подкатегорий. Идентификатор категории должен быть уникальным положительным целым числом. Ни у одной категории параметр id не может быть равен «0». Если элемент
не указан, то категория считается корневой.

Параметры:

id — идентификатор вашей категории товаров.
parentId — идентификатор более высокой по иерархии (родительской) категории товаров.

Пример:

<categories>

<category id="1">Женская одеждаcategory>

<category id="2" parentId="1">Платьяcategory>

<category id="3" parentId="1">Юбкиcategory>
<category id="4">Женская обувьcategory>

<category id="5" parentId="4">Балеткиcategory>
<category id="6">Аксессуарыcategory>

Мужские сумки

categories>

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

<offers>

<offer>...offer>

...

offers>

Dolce&Gabbana

Сарафан

1

Описание товара

http://shop.ru/sarafan

2000

3000

http://shop.ru/images/uploads/sarafan.jpg

http://shop.ru/images/uploads/sarafan_2.jpg

1

RUS

40

42

48

green

голубой

orange

жен.

Весна-лето 2012

Элементы, входящие в :

Элементы	Описание
vendor	Название бренда/производителя
model	Наименование товара (этот текст будет выводиться под изображением товара в шоуруме в общем списке товаров)
categoryId	Идентификатор категории товара (целое число не более 18 знаков). Товарное предложение может принадлежать только одной категории. Обязательный элемент. Элемент может содержать несколько элементов .
description	Описание товарного предложения. Необязательный элемент.
url	URL страницы товара. Максимальная длина URL — 255 символов.
price	Цена, по которой данный товар можно приобрести. Цена товарного предложения округляется, формат, в котором она отображается, зависит от настроек пользователя. Обязательный элемент.
oldprice	Цена, по которой данный товар продавался изначально (передается в том случае, если в текущий момент времени товар продается со скидкой)
picture	Ссылка на картинку соответствующего товарного предложения. Недопустимо давать ссылку на «заглушку», т.е. на страницу, где написано «картинка отсутствует», или на логотип магазина. Желательно передавать несколько изображений товара. На первом картинке товар должен быть изображен полностью в ракурсе анфас или ¾.
currencyId	Идентификатор валюты товара (RUR, USD, UAH, KZT). Для корректного отображения цены в национальной валюте необходимо использовать идентификатор (например, UAH) с соответствующим значением цены. Обязательный элемент.
attrs	Элемент предназначен для указания характеристик (атрибутов) товара. Для описания каждого параметра используется отдельный элемент .
sizetype	Идентификатор типа размерной линейки: российской, европейской, американской, литерной
size	Доступные размеры данного товара, каждый размер прописывается в отдельном теге <size>. Обязательный элемент.
color	Доступные цвета данного товара, каждый цвет прописывается в отдельном теге <color>. Обязательный элемент.
comment	Любая полезная информация, относящаяся к товару. Необязательный элемент
gender	Тег, описывающий, кому предназначен товар (мужчинам или женщинам). Обязательный элемент.

Добавить документ в свой блог или на сайт

Похожие:

	Урока: Описание животного. Цели урока Выяснить, как строится описание животных. Сравнить описание в научном и художественном стилях		Урок 2 Тема: Описание помещения в художественном стиле Из ваших описаний можно понять, любите ли вы свою комнату, чем она вам нравится? Нет. И это правильно, потому что вы сделали деловое...
	Описание Субпроекта Краткое описание проекта (выделите цели, направления деятельности, ожидаемые результаты и перспективы их воспроизводимости)		Библиографическое описание Стандарт распространяется на описание документов, которое составляется библиотеками, органами научно-технической информации, центрами...
	«Библиографическое описание литературы в библиотеке» Оборудование: презентация «Библиографическое описание для каталогов и картотек» (автор Омутова Н. С.)		Методический сценарий Цель: научить описывать внешность человека и воспринимать описание его описание, создать условия для проявления творческой активности...
	Тематический план «Разговорные темы» Темы Кол-во часов Форма Семья, родственные отношения, проблема взаимоотношений между поколениями. Описание жилища. Описание типичного жилища в России, Германии,...		Программа по формированию навыков безопасного поведения на дорогах... Вторая книга Гу Люсиня продолжает описание особенностей тайцзи-цюаня, дает более подробное и исправленное описание комплекса "пушечные...
	Урок №28 Тема: Сочинение описание «Мое домашнее животное» Формирование умения строить описание (последовательно и связно описывать). Формирование умения раскрывать тему и основную мысль в...		Отдел научной каталогизации описание документов для библиографических списков Качество списка зависит от тщательности и полноты сбора публикаций, а также от отсутствия случайных, малозначимых источников, не...
	Урок развития речи «Описание внешности» Учитель: сегодня на уроке мы с вами подготовимся к сочинению-описанию человека по вашим личным наблюдениям. До этого вы писали изложение,...		Программа составлена для студентов, обучающихся по направлению «Туризм» «Туризм». Программа включает в себя описание структуры и содержания дисциплины, материалы для проведения текущего контроля и промежуточной...
	Как оформить ссылку на интернет-источник? Информация, размещенная на странице в Интернете, является электронным ресурсом удаленного доступа. Описание электронных ресурсов...		Понятие жизненного цикла и его практик Такое описание требуется для успешного продвижения системы по жизненному циклу. Но стандарт не указывает на методы, с помощью которых...
	Программа по формированию навыков безопасного поведения на дорогах... А учебного предмета, курса; сформулированы цели изучения предмета «Литература»; описание ценностных ориентиров содержания учебного...		Программа по формированию навыков безопасного поведения на дорогах... Истика учебного предмета, курса; сформулированы цели изучения предмета «Музыка»; описание ценностных ориентиров содержания учебного...

Школьные материалы