Как импортировать данные о товарах из XML

27.01.2022

Варианты реализации XML-выгрузки

  1. Возможно передавать данные о товарах и их категориях, как в одном общем файле, так и в двух отдельных (рекомендуется): один - для категорий, второй - для товаров
  2. Возможна, как выгрузка только XML-данных, так и XML-данных вместе с изображениями товаров (рекомендуется). XML-файлы могут загружаться, как в ту же папку, что и изображения, так и в другие доступные для загрузки папки
  3. Если планируется онлайн-продажа товаров на сайте, то в XML-данных о товарах должна быть хотя бы одна свойство, которое можно использовать в качестве цены. Могут быть переданы данные и о других свойствах
  4. Данные можно загружать, как вручную, так и автоматически (рекомендуется) через FTP
  5. При использовании FTP рекомендуется использовать шифрование

Если используются два отдельных XML-файла для категорий и товаров

Имена файлов могут быть любыми, но желательно избегать русских букв и пробелов. С латиницей проблем нет. Также важно, чтобы с каждой новой выгрузкой названия файлов не менялись.


<?xml version="1.0" encoding="windows-1251"?>
<Элементы>
  <Элемент ID="12325" Имя="Аксессуары" РодительID="---"/>
  <Элемент ID="12343" Имя="Аккумуляторы" РодительID="12325"/>
  <Элемент ID="12341" Имя="Зеркала" РодительID="12325"/>
  <Элемент ID="12345" Имя="Наклейки" РодительID="12325"/>
  <Элемент ID="12344" Имя="Сигнализации, магнитолы, подсветка и др." РодительID="12325"/>
  <Элемент ID="12326" Имя="Тюнинг" РодительID="12325"/>
  <Элемент ID="12346" Имя="Фильтра" РодительID="12325"/>
  <Элемент ID="12368" Имя="Бензопилы" РодительID="---"/>
...
  <Элемент ID="12333" Имя="Ремни вариатора генератора" РодительID="12330"/>
  <Элемент ID="12335" Имя="Свечи" РодительID="12330"/>
  <Элемент ID="12337" Имя="Удаленное" РодительID="12330"/>
  <Элемент ID="01111" Имя="Удаленное" РодительID="---"/>
  <Элемент ID="12367" Имя="Удаленное" РодительID="01111"/>
</Элементы>


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

  • ID (нечто уникальное, можно латинские буквы, цифры и дефисы)
  • Имя (здесь ограничений нет)
  • ID родительской категории (для категорий верхнего уровня указываем --- - три дефиса)
  • Могут быть и другие свойства

Названия тегов и их свойств Вы можете использовать любые. Главное следовать следущим правилам:

  • XML-заголовок может быть любым, но корректным.
  • Какая бы кодировка ни была указана в XML-заголовке, 1С всегда использует windows-1251. Если в Вашем случае используется другая кодировка, об этом нужно сообщить отдельно
  • В именах тегов и их свойств допускаются буквы (в том числе кириллица), цифры, подчёркивания. Первый символ должен быть буквой. Других ограничений нет.
  • Если через выгрузку нужно удалить с сайта категорию или товар, то для неё/него нужно указать имя Удаленное

<?xml version="1.0" encoding="windows-1251"?>
<Элементы>
  <Элемент ID="00002702" Имя="Автомат сцепления Юпитер" БазоваяЕИ="шт" Категория="12318" АдресФото="DSC03810.JPG" Цена="156" Остаток="37"/>
  <Элемент ID="00003535" Имя="Удаленное" БазоваяЕИ="пара" Категория="12318" АдресФото="DSC03808.JPG" Цена="4190" Остаток="0"/>
  <Элемент ID="00900631" Имя="Амортизатор задний Иж реставрация" БазоваяЕИ="пара" Категория="12318" АдресФото="DSC038082.JPG" Цена="1350" Остаток="1"/>
  <Элемент ID="00004115" Имя="Удаленное" БазоваяЕИ="пара" Категория="12318" АдресФото="DSC038081.JPG" Цена="1578" Остаток="0"/>
  <Элемент ID="00003119" Имя="Барабан задний Юнкер" БазоваяЕИ="шт" Категория="12318" АдресФото="IMG_20160325_162751.jpg" Цена="1990" Остаток="6"/>
  <Элемент ID="00002159" Имя="Барабан передний в сборе ИЖ" БазоваяЕИ="шт" Категория="12318" АдресФото="DSC03798.JPG" Цена="1950" Остаток="4"/>
  <Элемент ID="00004042" Имя="Барабан сцепления Планета широкий Иж П5-01сб.1-41г.Ижевск" БазоваяЕИ="шт" Категория="12318" АдресФото="20171130_175731.jpg" Цена="1350" Остаток="0"/>
  <Элемент ID="00002315" Имя="Барабан сцепления внутрений Иж Планета" БазоваяЕИ="шт" Категория="12318" АдресФото="DSC03805.JPG" Цена="300" Остаток="0"/>
...
  <Элемент ID="00003578" Имя="Барабан сцепления внутрений Иж Юпитер" БазоваяЕИ="шт" Категория="12318" АдресФото="DSC03806.JPG" Цена="300" Остаток="2"/>
  <Элемент ID="00000016" Имя="Удаленное" БазоваяЕИ="шт" Категория="12318" АдресФото="DSC03859.JPG" Цена="2800" Остаток="0"/>
  <Элемент ID="00000015" Имя="Барабан сцепления ИЖ Юпитер 4 узкий в сборе 1-31" БазоваяЕИ="шт" Категория="12318" АдресФото="DSC03858.JPG" Цена="2800" Остаток="7"/>
</Элементы>


В примере приведены данные о товарах. У каждого из них есть:

  • ID (также нечто уникальное, можно латинские буквы, цифры и дефисы)
  • Имя (здесь тоже ограничений нет)
  • Категория (ID одной из категорий - про них написано в описании примера с категориями)
  • Адрес файла с изображением (желательно просто указывать имя файла - при этом нежелательно дублирование имён нескольких файлов)
  • Цена (в рублях)
  • Могут быть и другие свойства, например, единица измерения, остаток на складе
  • Если организация работает с СДЭК и нужен расчёт стоимости и срок доставки также нужны:
    • вес в килограммах
    • габариты в сантиметрах

Если используется один общий XML-файл для категорий и товаров


<?xml version="1.0" encoding="windows-1251"?>
<Элементы>
  <Элемент ID="00013813" Имя="Автомат сцепления ЗАЗ" БазоваяЕИ="шт" КатегорияID="12318" КатегорияНазвание="Сцепление"/>
  <Элемент ID="00092424" Имя="Удаленное" БазоваяЕИ="пара" КатегорияID="12318" КатегорияНазвание="Газ"/>
  <Элемент ID="00100369" Имя="Амортизатор задний ВАЗ" БазоваяЕИ="пара" КатегорияID="12318" КатегорияНазвание="Тормоз"/>
...
</Элементы>


В этом случае в свойствах товара указывается не только ID категории, но и её название.

Частичный или полный импорт данных

Импортировать можно, как все товары/категории, так и только необходимые. Новые добавятся, уже имеющиеся обновятся (сравнение идёт по ID).

О загрузке файлов

Вам будет предоставлен FTP-доступ к одной из папок на сайте. Желательно использовать шифрование - SFTP или FTPS. Часто бывает, что 1С шифрование не поддерживает. Если так, то можно и обычный FTP, но это не безопасно.

У Вас будет доступ на создание подпапок.

В ту же папку (или в подпапку) можно загружать изображения - каждое в отдельном файле (имена указываются в файле с товарами). После обработки сайт будет перемещать эти картинки в другую папку (по FTP она будет недоступна).

Файлы с данными о товарах/категориях также будут автоматически удаляться при успешном импорте.


CMS Zion WebEngine является бесплатной системой. Развивается за счёт рекламы, помощи веб-студии #webZion и других спонсоров.

 

Будем рады, если Вы поддержите нас любой суммой, а также поделитесь идеями на счёт каких-либо улучшений и доработок для CMS...

 

Заранее, большое, спасибо

 

Блог обновлений

Zion WebEngine 21.06.16
  • Доработан класс для управления типами (спасибо Цифрал Сервис):
    • Устранена проблема, из-за которой при правке типов не сохраналась опция Скрывать записи этого типа при выборе места в структуре
    • При правке типов устранена проблема с отображением элементов, которые могут быть доступны для быстрого просмотра в списке контентных единиц в административном интерфейсе

Zion WebEngine Административный интерфейс Классы Контент/Контентные единицы Место в структуре Типы Элементы Что такое Тип контента?

Zion WebEngine 21.06.08
  • Способы уведомления о заказах переименованы в реакции на заказы (спасибо Moto-Retail18):
    • Такое название больше соответсвует действительности, т.к. в качестве реакции на заказ доступны не только различные уведомления, но и другие действия
    • В связи с этим внесены изменения в различные классы, вспомогательные классы и меню администратора
  • Создан новый настраиваемый модуль для реакции на заказ:
    • С его помощью можно будет предоставлять накладную в том виде, в котором запросит покупатель:
      • Разработка пока не зваершена

Zion WebEngine Zion Catalog Zion xDelivery Zion Export Что такое Меню администратора? Классы Меню администратора Настраиваемые модули Реакции на заказ

Zion WebEngine 21.06.03
  • Доработан класс для управления корзиной заказов (спасибо Devi и Veria):
    • Реализована возможность отслеживания конверсий и настройки ретаргетинга в системах внешней аналитики (например Яндекс.Метрика) при отправке формы заказа в интернет-магазине:
      • Отслеживание добавления товара в корзину, переход в корзину и переход к оформлению заказа уже были доступны ранее

Zion Catalog Интернет-магазин Классы Корзина для заказов Формы Что такое Классы?

Zion WebEngine 21.05.31
  • Доработан плагин универсального меню (спасибо Good Авто):
    • Устранена проблема из-за которой в случае неуказания некоторых необязательных параметров мог не отобразится список элементов (например, характеристик) с указанной вкладки

Zion WebEngine Вкладки Меню/Списки/Навигация Плагины Характеристики/Разновидности Элементы Что такое Элементы?

Zion WebEngine 21.05.28
  • Доработан класс для управления импортом из CRM Intrum (спасибо Good Авто):
    • Теперь в тексте, который импортируется в элемент Основной текст, переносы строк конвертируются в параграфы

Zion Import Импорт/Экспорт Классы Основной текст Элементы Элемент "Основной текст"

Zion WebEngine 21.05.27
  • Доработан класс для работы с обновлениями на стороне сервера:
    • При сборе данных о пользователях CMS учтена защита от отслеживания в современных веб-браузерах

Zion Server Что такое CMS Zion WebEngine? Веб-браузер Веб-сервер/Хостинг Доступы/Пользователи Классы Обновления CMS

Zion WebEngine 21.05.26
  • Доработаны плагин универсального меню, класс для упавления навигацией и элемент HTML-код веб-страницы (спасибо Оптика От Склада):
    • Ранее для плагина Menu был реализован параметр notzero, который было рекомендовано использовать например, для отображения только товаров в наличии. Однако выявились случаи, когда наличие товаров может быть не только нулевым, но и отрицательным:
      • Для отображения товаров в наличии теперь реализован новый параметр positive, который подойдёт для этой цели больше, так как с ним будут отображены только записи, у которых в указанном поле будет число, которое больше нуля
      • А параметр notzero будет полезно использовать, например, для отображения только тех, товаров для которых указана цена
    • Реализовано новое условие IS_HAS_POSITIVE_VALUE_поле??истина::ложь:
      • С его изпользованием можно отоборазить разный код (в оформлении меню/списка или в HTML-коде веб-страницы) в зависимости от того, является ли у той или иной записи указанное поле положительным числом:
        • Будет полезно, например, для оформления списка товаров в корзине:
          • Параметры positive и notzero, в данном случае не подойдут, так как лучше отобразить все записи в корзине, чтобы была возможность удалить оттуда товары, которых в наличии нет

Zion WebEngine HTML-код веб-страницы Интернет-магазин Классы Корзина для заказов Меню/Списки/Навигация Сайт-каталог Элементы Плагин Menu

Zion WebEngine 21.05.24
  • Доработан настраиваемый модуль для изменения числа товаров в наличии при заказе (спасибо Оптика От Склада):
    • Теперь доступно не только уменьшение числа товаров в наличии при новом заказе, но и восстановление этого же числа при отмене заказа
  • Доработан класс для управления заказами:
    • Внесены в коррективы в записи по умолчанию для способов уведомлений о заказах

Zion Catalog Классы Корзина для заказов Настраиваемые модули Реакции на заказ

Zion WebEngine 21.05.22
  • Доработан вспомогательный класс для работы с изображениями (спасибо Школа-интернат № 85):
    • При попытке уменьшить слишком большое изображение теперь не происходит фатальных ошибок

Zion WebEngine Изображение Классы Что такое Классы?

Zion WebEngine 21.05.14
  • Доработан настраиваемый модуль для оплаты через банк (спасибо Moto-Retail18):
    • Устранены недочёты при автоматической корректировке таблиц данных

Zion Catalog База данных/Таблицы данных Настраиваемые модули Способы оплаты

Zion WebEngine 21.05.12
  • Доработан класс для управления миграцией со старых версий CMS (спасибо СпецТехникаПермь):
    • Реализована временная смена формата, в котором хранятся опции проекта, в тот формат, который проще импортировать
    • Доработана конвертация SEO-параметров
    • Теперь мигратор совместим с версией Zion WebEngine X6.08.04

Zion WebEngine Zion WebEngine X6.08.04 Что такое CMS Zion WebEngine? SEO-параметры Классы Миграция

Zion WebEngine 21.05.11
  • Доработан класс для управления импортом из CRM Intrum (спасибо Good Авто):
    • Учтено, что данные о ссылках на файлы из CRM через webhooks приходят не в том же виде, что через API

Zion Import Импорт/Экспорт Классы Файлы/Папки

Zion WebEngine 21.05.06
  • Устранены недочёты в комплекте поставки предыдущего обновления (спасибо ColorHouse.Shop)

Zion Catalog Что такое Комплект поставки? Обновления CMS

Zion WebEngine 21.05.05
  • Доработан настраиваемый модуль для онлайн-оплаты через интернет-эквайринг от Сбербанка (спасибо Оптика От Склада):
    • Реализована возможность отдельно задавать настройки для тестовой и боевой среды
    • Реализована возможность быстро переключаться между тестовой и боевой средами

Zion xPayment Настраиваемые модули Способы оплаты

Zion WebEngine 21.05.04
  • Доработан класс для управления корзиной заказов (спасибо Оптика От Склада):
    • Устранены недочёты в форме заказа в интернет-магазине:
      • Могли появляться запросы на указание данных для полей, которые при тех или иных параметрых были скрыты
  • Доработан класс для управления импортом из CRM Intrum (спасибо Good Авто):
    • Учтены некоторые события в CRM, на которые не нужно реагировать при импорте в реальном времени

Zion Catalog Zion Import Импорт/Экспорт Интернет-магазин Классы Корзина для заказов Формы

Zion WebEngine 21.04.30
  • Доработаны классы для управления базой данных и типами (спасибо Оптика От Склада):
    • Теперь, если для типа выбран шаблон по умолчанию, становится доступно указание дополнительных полей, которые могут быть отображены в списке записей контента соответствующего типа:
      • Может быть полезно, например, когда помимо названия и других стандартных полей, нужно отобразить цену или остаток товара
      • Доступно при наличии в комплекте поставки Zion PubHub или Zion Catalog
  • Доработан элемент Число:
    • Пока только для этого элемента доступно включение/отключение возможности отображения дополнительных полей в списке записей контента того или иного типа
      • Доступен при наличии в комплекте поставки Zion PubHub или Zion Catalog

Zion WebEngine Zion Catalog Что такое Комплект поставки? База данных/Таблицы данных Классы Контент/Контентные единицы Сайт-каталог Типы Число Шаблоны контента Элементы

Zion WebEngine 21.04.29
  • Доработан класс для управления импортом из CRM Intrum (спасибо Good Авто):
    • Реализовано управление видимостью данных при импорте:
      • Если поле отвечающее за видимость не выбрано, то все данные будут видимыми
      • Если поле выбрано и указано значение, которому должны соответствовать видимые записи, то видимыми будут только те записи, у которых в выбранном поле будет это значение:
        • Остальные данные будут скрываться при импорте
      • Это полезно, например, в тех случаях, когда в CRM пока указаны не все необходимые данные и отображать такую информацию на сайте пока преждевременно

Zion Import Импорт/Экспорт Классы

Zion WebEngine 21.04.28
  • Доработан класс для управления импортом из CRM Intrum (спасибо Good Авто):
    • Реализовано удаления данных в реальном времени через WebHook

Zion Import Импорт/Экспорт Классы

Zion WebEngine 21.04.26
  • Доработан класс для управления импортом из CRM Intrum (спасибо Good Авто):
    • Устранены некоторые недочёты для ручного или автоматического импорта
    • Реализовано добавление и обновление данных в реальном времени через WebHook
    • Ведётся реализация удаления данных в реальном времени через WebHook

Zion Import Импорт/Экспорт Классы

Zion WebEngine 21.04.23
  • Доработан класс для управления импортом из CRM Intrum (спасибо Good Авто):
    • Устранены некоторые недочёты для ручного или автоматического импорта
    • Ведётся внедрение импорта в реальном времени через WebHook

Zion Import Импорт/Экспорт Классы