Войти    Регистрация
ChipFind

Подключение типа «онлайн-склад»

Каждая компания поставщик, имеющая на своем сервере базу с данными о складе, может разместить поисковый скрипт, который будет доступен в интернете. Формат базы данных, язык программирования и ОС полностью определяются вами, поэтому Вы можете разместить этот скрипт даже на обычном корпоративном сервере, постоянно подключенном к интернету. Для удобства администрирования и повышения безопасности сервера Вы можете указать при регистрации склада любой нестандартный порт.

Как это работает?
Когда пользователь запрашивает компонент на сайте ChipFind, наш поисковый робот создает параллельные запросы сразу ко всем участникам системы. Дождавшись от них ответа — выводит результаты поиска. Получение данных от складов происходит по протоколу HTTP 1.1, сервер ChipFind отправляет GET или POST запрос вашему веб-серверу со строкой поиска.

В ответ скрипт на вашем сайте должен совершить следующую комбинацию действий:

  1. На всякий случай проверить корректность передаваемых данных: длину строки не менее 4 символов, удалить опасные для базы данных символы (*, ’, «, |, &, \, /, ?, %), убрать начальные и конечные пробелы и знаки табуляций. Все эти действия также выполняет и ChipFind, от него строка присылается чистой и проверенной, но для повышения безопасности скрипта их стоит выполнять и на стороне вашего сайта.
  2. Сделать запрос к Вашей локальной базе данных с переданными параметрами.
  3. Вывести в поток (обычно функциями print или echo) данные, оформленные в формате XML, как описано ниже.
Это все. Обратите внимание, ChipFind принимает не более 20 первых строк от выведенных Вами данных, поэтому рекомендуется не выводить лишние данные для экономии ресурсов вашего сервера.

Формат пакета XML
XML-файл, создаваемый Вашим онлайн-магазином, в общем виде должен выглядеть примерно так:

<?xml version="1.0" encoding="Windows-1251"?>
<data>  обязательный элемент
    <line>
        <mfr>XILINX</mfr>
        <part>XC1736ESO8I</part>  обязательный элемент
        <note>Микросхема XILINX 8SO</note>
        <pack>1</pack>
        <min>3</min>
        <img>http://картинка.gif</img>
        <pdf>http://документация.pdf</pdf>
        <dc>2001</dc>
        <cur>euro</cur>
        <p1>12.25</p1>
        <p2>12.05</p2>
        <p3>11.65</p3>
        <stock>2-3 недели</stock>
        <instock>0</instock>
    </line>
    <line>
        <part>XC1701LPD8I0718</part>  обязательный элемент
    </line>
    <line>
        <part>XC170222</part>  обязательный элемент
        <mfr>XILINX</mfr>
        <note/>
    </line>
    ...
</data>
Тег <data> является корневым элементом и может встречаться в xml-документе не более одного раза. В случае отсутствия запрашиваемого компонента на складе, должен выводится блок <data></data> (или <data />) либо пустой документ.

Тег <line> обрамляет информацию о каждом найденном компоненте и может встречаться в документе не более 20 раз. Внутри тега </line> элементы могут располагаться в любой последовательности. Наличие пробелов и переносов строк не играет роли. В целях уменьшения объемов передаваемой информации желательно не вставлять в документ пустые теги.

Информация о компоненте содержится в следующих тегах:
  • <part> - обязательный тег, содержит наименование компонента. Остальные теги являются опциональными.
  • <mfr> - наименование компании-производителя.
  • <note> - описание компонента, дополнительная информация (например, минимальный объем заказа).
  • <pack> - количество компонентов в упаковке (положительное число).
  • <min> - минимальный заказ (положительное число).
  • <img> - ссылка на изображение, либо на страницу с подробным описанием компонента. Также Вы можете оставлять прямую ссылку на заказ компонента в Вашем интернет магазине.
  • <pdf> - ссылка на техническую документацию.
  • <cur> - валюта, возможны следующие значения:
    «$» - доллар США
    «euro» - евро (€)
    «gbp» - фунт стерлингов (£)
    «руб» или «RUB» - рубли

    По умолчанию (если не указано другое значение) подставляется значение «$».
  • <p1> - розничная цена. Положительное число, содержащее не больше 4х знаков в дробной части, разделитель для дробной части - точка.
  • <p2> - мелкооптовая цена (см. требования для <p1>).
  • <p3> - оптовая цена (см. требования для <p1>).
  • <stock> - наличие на складе, возможны следующие значения:
    - целое положительное число - количество компонентов на складе (шт.);
    - 0, если компонент отсутствует на складе;
    - любой текст касательно количества или времени поступления компонента на склад компании (напр., "1-2 недели", ">100").
  • <dc> - год выпуска компонента. Дата, год, любой текст.
  • <instock> - флаг наличия на складе. Возможные значения: 0 и 1. Может использоваться в случае, если в теге <stock> указан текст и, следовательно, поисковый робот ChipFind при обработке документа не может определить, есть ли компонент на складе. Имеет смысл указывать значение этого тега, если в теге <stock> указан текст, а запрашиваемый компонент на складе присутствует.
В остальном нужно придерживаться всех правил формирования XML-документов. Например не забывайте символы < и > кодировать в последовательности &lt; и &gt;.

Наши программисты подготовили несколько заготовок на языке PHP, Perl и ASP. Для проверки на корректность вывода данных от вашего склада можно воспользоваться специальной страницей.
Скачайте буклет с подробным описанием услуги


© 2006 — 2024 Капитал Плюс
Телефон, e-mail, ICQ для связи
РегистрацияРеклама на сайте