Настройка виконання зображень товарів з 1С в 1С-Bitrix
Зображення передаються з 1С в Bitrix в складі стандартного обміну CommerceML. В import.xml для кожного товару блок <Картинка> містить відносний шлях до файлу зображення. Файли передаються окремо — завантажуються на сервер до відправки XML або в тому ж HTTP-сеансі обміну.
Як працює передача зображень
У протоколі CommerceML зображення виконуються в два етапи:
-
Завантаження файлів. Через
POST /bitrix/admin/1c_exchange.php?type=catalog&mode=file1С заливає зображення в папку/bitrix/catalog_export/(або настроюючу папку обміну). -
Завантаження XML.
import.xmlмістить посилання на файли:<Картинка>images/photo1.jpg</Картинка>. При розборі XML Bitrix знаходить файл за шляхом та привязує до елемента інфоблока.
В інфоблоці зображення потрапляє в PREVIEW_PICTURE (превю) або DETAIL_PICTURE (детальне). Додаткові зображення — в властивість типу «Файл» або через \Bitrix\Iblock\PropertyTable якщо використовується кілька фотографій.
Настройка в 1С
В обробці «Виконка на сайт» (1С:УТ, 1С:Роздріб та ін.) повинен бути включений параметр «Виконувати картинки». Без цього прапорця XML формується без блоків <Картинка>, та зображення не передаються.
Важливо: 1С виконує зображення тільки тих товарів, які змінилися (при інкрементальному обміні). Якщо зображення додали до товару вперше — воно попаде при ближайшому обміні. Якщо зображення поменяли, а інші дані товара не менялись — 1С може не включити товар у виконку. Рішення: при оновленні зображення в 1С вручну «трогати» запис товара (змінити будь-яке поле та зберегти).
Множинні зображення
По стандарту CommerceML для кількох зображень можна передавати кілька тегів <Картинка>. Bitrix за замовчуванням обробляє перше зображення як DETAIL_PICTURE, решта теряються — якщо властивість «Додаткові зображення» в інфоблоці не настроєна.
Для підтримки галереї зображень:
- В інфоблоці створюється властивість типу «Файл», множинна, наприклад з кодом
MORE_PHOTO. - В обробнику події
OnIBlockChange(або агенті постобробки) додаткові зображення з XML записуються в цю властивість. - В шаблоні компонента
catalog.elementвиводимо галерею через$arResult["PROPERTIES"]["MORE_PHOTO"].
Повторна виконка зображень
При повному обміні зображення заново завантажуються на сервер та перепривязуються до елементів. Це означає, що при кожному обміні файли перезаписуються. Якщо зображення редагувалися на стороні сайту (ресайз, ватермарк) — вони будуть перезаписані оригіналами з 1С.
Рішення: при необхідності кастомної обробки — застосовувати її через агент після обміну, а не вручну редагувати файли.
Проблеми з кодуванням імен файлів
Якщо імена файлів містять кирилицю — можливі проблеми при передачі через HTTP. 1С іноді передає імена файлів в UTF-8, іноді в Windows-1251. В обробнику Bitrix перевіряємо кодування імені файлу та при необхідності транслітеруємо його при збереженні.
Розмір зображень та продуктивність
При великому каталозі (тисячи товарів з кількома зображеннями) завантаження зображень в процесі обміну може займати значний час. Рекомендації:
- Включити стиск зображень на стороні 1С перед виконкою (або використовувати зовнішню обробку ресайзу)
- На стороні Bitrix — ресайз через
CFile::ResizeImageGet()з кешуванням, а не при кожному зверненні - Зберігати оригінальні файли окремо від отресайзених превю