Failure ошибка инициализации экспорта

Все сказанное ниже действительно для 1С-Битрикс: Управление сайтом 15.0.6 и 1С: Предприятие Управление торговлей, редакция 11.1 (11.1.2.31).
Точка актуальности статьи – май 2023.
Обращайте на это внимание.
Очень многие вещи, освоив однажды, мы делаем практически машинально.
Однако, не каждый из умеющих водить автомобиль, может стать инструктором вождения.
Одно дело – сделать самому, совсем другое – рассказать другому, как делать. Многим знаком этот старинный анекдот.
 — Дорогая, где чай? Я никак не могу найти…. — Ах, какой ты беспомощный! Чай в аптечке, в банке из-под какао, на которой наклейка «СОЛЬ».
Именно поэтому большинство инструкций по интеграции 1С и Битрикс не заостряют внимание на моментах, на которые начинающий может потратить от нескольких часов, до нескольких дней своего времени.
Попробую максимально закрыть этот вопрос именно в плане быстрого старта
(не ошибусь, если скажу – у многих есть желание посмотреть, как работает 1С Управление торговлей в связке с интернет магазином).
Огромное спасибо разработчикам Битрикс за виртуальную машину. С ней установка системы для тестирования стала занимать минуты.
Дальше – обращайтесь к форумам, гуру, куру и т.п.

Приступаем.

Что нужно скачать:  

1. продукт «1С-Битрикс: Виртуальная машина»  
   http://www.1c-bitrix.ru/download/vmbitrix.php
2. бесплатные дополнения для торговых конфигураций 1С
   http://1c.1c-bitrix.ru/ecommerce/download.php(интересное начинается прямо здесь. Как видно на экране — перепутаны местами ссылки 11.1.2.31 и 11.1.4.13 для модуля обмена 3.1.2.31.)
   Но нас интересует Версия модуля обмена 4.0.5.1, так как релиз прикладного решения будет  Управление торговлей, редакция 11.1 (11.1.2.31). 
   Здесь все нормально.

Виртуальную машину запускаем в плейере.

Дополнения устанавливаем в каталог шаблонов 1С.

Из шаблонов же создаем базу Управление торговлей Демо, редакция 11.1 (11.1.2.31). Включаем в конфигураторе возможность изменения,  и интегрируем модуль дополнения от Битрикс.
Этот процесс полностью описан в файле документации, идущем в комплекте с модулем. Цитирую дословно:

1. Установить скаченный установщик модуля обмена;
2.  Запустить систему 1С:Предприятие в режиме «Конфигуратор».
3.  Сделать архивную копию информационной базы. Для этого в меню «Администрирование» выбрать пункт «Выгрузка информационной базы» и в открывшемся диалоге указать имя файла, в который будут записаны данные.

1. Открыть конфигурацию, для этого в меню «Конфигурация» выбрать пункт «Открыть конфигурацию».
2.  Включить возможность изменения объектов конфигурации, для этого в меню «Конфигурация» выбрать «Поддержка», затем «Настройка поддержки». В открывшемся окне  нажать кнопку «Включить возможность изменения». В окне «Настройка правил поддержки» выбрать дважды «Объект поставщика редактируется с сохранением поддержки», нажать «ОК». Сохранить конфигурацию.

1. Вызвать режим «Сравнить, объединить с конфигурацией из файла» из меню «Конфигурация». В этом режиме будут показаны только различающиеся объекты дополнения и используемой конфигурации, поэтому полностью идентичные объекты могут отсутствовать в окне сравнения-объединения. Также может отсутствовать флажок включения таких объектов в объединение.
2. В диалоге выбора указать файл конфигурации «XXX.cf». По умолчанию он лежит по следующему адресу: C:Users…AppDataRoaming1C1Cv82 mplts1С-БитриксОбменССайтом(конфигурация 1С).
3. Исключить из объединения все объекты конфигурации.
4. Нажать кнопку «Действия» – «Отметить по подсистемам файла». Установить флажок напротив пункта: «Битрикс» и нажать «Установить».

1. Включить в объединение (установить флажок) подсистему «Битрикс»: «Конфигурация»  —  «Общие» – «Подсистемы» – «Администрирование» – «Битрикс».

10. Выполнить сравнение и объединение конфигураций (кнопка «Выполнить»).

11.  Сохранить конфигурацию и обновить конфигурацию базы данных.

Обратить внимание.
 Рекомендуется запустить 1С с параметром «ЗапуститьОбновлениеИнформационнойБазы», для того, чтобы 1С заполнил все служебные данные в 1С. Запуск с параметром можно запустить как через командную строку, так и из конфигуратора.

 — Для того, чтобы запустить из командной строки нужно указать следующие параметры:

«<Адрес  к 1cv8.exe>» ENTERPRISE (/F или /S в зависимости от типа базы) «»<Адрес к базе> » /N«<Логин>» /P«<Пароль>» /C ЗапуститьОбновлениеИнформационнойБазы

— Для того, чтобы запустить из конфигуратора нужно зайти: Сервис -> Параметры. На вкладке «Запуск 1С: Предприятия» нужно указать параметр запуска.

Заодно лучше установить режим запуска «Толстый клиент управляемое приложение»

Пока мы занимались с 1С, подоспела виртуальная машина.

Загружаем дистрибутив «Управление сайтом» Бизнес Демо

  Выбираем и настраиваем магазин.

Все настройки оставляем по умолчанию. Если есть желание навести марафет – введите сразу свои данные и снимите неиспользуемые флажки (виды оплаты и доставки)

В 1С настраиваем связь с сайтом. Проверяем, что сайт доступен.

Обратить внимание.
 Делаем архивы.
1С – средствами 1С, а сайт – средствами виртуальной машины (если сделать архив через админку сайта, он пропадет при первом обмене с 1С).
Не забудьте убрать параметр запуска «ЗапуститьОбновлениеИнформационнойБазы» он уже не нужен.

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

Первая незадача – загрузка не проходит.
Получаем ошибку: «Не удалось загрузить данные с сервера. Ответ сервера: failure Ошибка инициализации экспорта».

Потому что по умолчанию ни у одной группы пользователей нет на это прав.

Обратить внимание.
Нужно в административной части сайта зайти в раздел Магазин – Интеграция с 1С — Экспорт каталога. Выделить как минимум группу Администраторы и сохранить изменения.
После этого загрузка товаров с сайта пройдет.
Помимо номенклатуры со всеми свойствами и характеристиками, загрузится цена BASE (запомните это наименование – оно нам пригодится) и документ установки цен

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

Переходим к выгрузке номенклатуры на сайт Битрикс из 1С.

Для начала – стандартным обменом 1С.

Переходим на вкладку Выгрузка товаров.

Обратить внимание.

Если произвести обмен сейчас – на сайте вообще не произойдет изменений. Вся номенклатура выгрузится в новый инфоблок, которого в пользовательской части сайта не видно.
Чтобы правильно попасть в уже настроенный инфоблок торгового каталога (он у нас называется Одежда) нужно правильно заполнить идентификатор каталога. Как его узнать ?
В административной части  сайта – переходим в Настройках к инфоблокам

И устанавливаем флажок «Показывать код загрузки из внешних источников »

После этого для Информационного блока Одежда увидим внешний код «clothes_s1»

Его можно поправить здесь или внести в 1С.

Далее переходим к настройке отбора в 1С

Обязательно создать и выбрать Соглашение

Как видно условия два: Доступно внешним пользователям и Сегмент партнеров – пустой

Обратить внимание.

На самом деле – есть еще и три: Оно должно называться BASE.Если пропустить этот момент, номенклатура на сайте будет заменена, но все товары будут недоступны для заказа. У них не будет ни количества, ни цен.

Остальные настройки в соглашении – могут быть «по вкусу». В том числе цена (многие волнуются по этому поводу).

Как и настройки отбора.

Обратить внимание.

После всех настроек – переводим режим обмена в состояние – выгружать в каталог на диске.

И производим обмен. Это нам даст возможность посмотреть, что же собственно выгружается, а 1С – проверить возможность записи в каталог.

После этого переключаемся в режим обмена с сайтом напрямую.

Обмениваемся с сайтом магазина.

 Обмен прошел – номенклатура, цены, количество, картинки – все на месте.

Переходим к модулю обмена от Битрикс.

Тут гораздо больше настроек. Но основные нужно заполнить также как и в предыдущем случае.

Обмениваемся и видим — товаров нет в наличии. Если копнуть глубже – не загрузились цены.

Обратить внимание.

Для настройки обмена модулем Битрикс нужно правильно ввести внутренний код цены сайта.
Помните, мы договаривались, что первый обмен пойдет не напрямую на сайт, а в каталог на диске.
Ищем там файл prices_..
Открываем его в любом текстовом редакторе и ищем, тег ИдТипаЦены – это и есть внешний код цены сайта.
 На сайте в разделе Магазин – Типы цен – редактируем базовую цену.  Записываем правильный внешний код.

После этого сайт магазина приобретает правильный вид

Обратить внимание.

Если захотим вернуться к стандартному обмену — он не пройдет. Нужно на сайте в разделе Настройки — Командная PHP-строка – выполнить две строки кода

COption::SetOptionString(«catalog», «DEFAULT_SKIP_SOURCE_CHECK», «Y») ;

COption::SetOptionString(«sale», «secure_1c_exchange», «N») ;

После этого можно обмениваться с сайтом как модулем обмена Битрикс, так и стандартным обменом конфигурации.

А так же переходить к обмену заказами и многим другим интересным вещам в связке 1С:Предприятие – 1С Битрикс.

04.08.15 — 15:25

1 — 04.08.15 — 15:28

2 — 04.08.15 — 15:29

(1) Что ж ты их так пиаришь то постоянно?

3 — 04.08.15 — 15:30

(2) да потому что реально больше не от кого помощи ждать

4 — 04.08.15 — 15:30

если люди профессионально этим занимаются, то почему бы не дать. все таки проблема.

5 — 04.08.15 — 15:31

(2) потому что жадный

6 — 04.08.15 — 15:34

(3) Я бы не был столь категоричным. За деньги тут сейчас пара десятков желающих помочь найдется.

7 — 04.08.15 — 15:48

А есть информация по теме?

8 — 04.08.15 — 15:51

offers.xml ходят предложения. И остатки.

Что то неожиданное ты ему передаешь. У тебя в предложениях стоит Истина во внешнем подключении?

Посмотри в общем модуле Б_ОбменССайтомСервер есть процедура формирования файла XML, он формируется в системной Temp, отлови и посмотри что в нем.

И со стороны сайта импорт то настроен?

http://cms1c.ru — пацаны крутые. Но много кто обмена занимается.

9 — 04.08.15 — 15:53

Функция называется ЗаписьИОтправкаXMLДанныхНаСайт, в ней точну остановы после МойXML.Закрыть() и смотри что в нем.

10 — 04.08.15 — 15:55

11 — 04.08.15 — 15:56

(7) А что по теме, по теме надо лезть в битрикс, смотреть на его стороне, что ему там 1С пихает в качестве данных, как товарищ в (8) написал. Если там с виду валидный xml-файл, то пошагово проверять, на каком именно месте валится загрузка.

Рекомендации из http://dev.1c-bitrix.ru/support/forum/forum26/topic47899/ выполнены?

12 — 04.08.15 — 15:57

13 — 04.08.15 — 16:00

(11) — экранирование в последней редакции они уже сделали. (12) — там бы просто сервер возвращал что нельзя устанавливать несколько цен.

Тут ошибка именно в формировании файла. Отловить и посмотреть. Может быть ему какое название свойства не нравится. Или просто предложение не настроено.

14 — 04.08.15 — 16:29

(13) Ошибка на сервере, там и смотреть

15 — 04.08.15 — 16:37

(14) А как ты на сервере посмотришь? Там скрипт в 5000+ строк. Да и если на хостинге сайт. То так просто не отловишь. Только если на стороне сайта в скрипте запись в логи организовывать. Легче на стороне 1С отловить и посмотреть что в нем. Ну и сначала пройтись по всем настройкам по инструкции.

16 — 05.08.15 — 09:02

(15) Неужели на сервере нету логов?

17 — 05.08.15 — 11:20

(15) Не обязательно все 5000 строк смотреть, начать с процедуры открытия xml-ки и дальше по коду.

18 — 05.08.15 — 11:31

(0)обмен стоит товарами и заказами ?

19 — 05.08.15 — 12:09

(18) Обмен только товарами.

Посмотрела в папке «Temp» файл «import0_1.xml». С ним вроде всё хорошо. Но уже там нет цен.

20 — 05.08.15 — 12:14

В принципе, обмен происходит — в битриксе появляется структура, сами товары и даже картинки, но нет остатков и цен

21 — 05.08.15 — 12:34

(20) А в xml есть остатки и цены? Модуль «Интернет-магазин» на сайте у вас есть?

22 — 05.08.15 — 14:25

(21) Нет, в xml цен и остатков не нашла.

Модуль стоит.

Кстати, делаю обмен через стандартную обработку

23 — 05.08.15 — 14:32

(22) Ну если в xml нет цен и остатков, значит надо смотреть в 1С, почему она их туда не кладет.

24 — 05.08.15 — 14:33

стоит поискать скрипт для битрикса, который умеет делать всё, что и стандартный битриксовый обмен с 1С, но без записи в бд.

но вот название не помню, хоть убейте.

• Немного теории
• Резюме
• Стандартные возможности обмена 1С и Битрикса
• Протокол
• Формат
• Алгоритм
• Подготовка к обмену
  • Авторизация
  • Запрос настроек сайта
• Обмен товарами (1С -> Битрикс)
  • Шаг 1. Передача файла (повторяющийся)
  • Шаг 2. Основной
  • Шаг 3. Деактивация старых данных
  • Шаг 4. Завершение импорта
• Обмен справочниками (1С -> Битрикс)
  • Шаг 1. Передача файла (повторяющийся)
  • Шаг 2. Основной
• Формат файлов
• Формат файла обмена товарами
• Формат файла обмена предложениями
• Формат файла обмена ценами товаров и предложений
• Формат файла обмена остатками товаров и предложений
• Формат файла обмена справочниками
• Как дорабатывать обмен?
• Заключение

Нельзя просто взять и интегрировать сайт с 1С
Народное творчество

Интеграция сайта на 1С-Битрикс: Управление сайтом и 1С — неисчерпаемый источник вопросов и проблем. На сайте идей для Битрикс в соответствующем разделе 16 страниц, на форуме про это больше 23 000 сообщений. В форме обращения в техподдержку Битрикса есть даже отдельный тип заявки «Обмен с 1С».

Считается, что интеграция 1С и сайта на Битриксе должна работать из коробки. Самые простые функции действительно можно запустить за час-два. А вот на доработку обмена можно потратить и 10, и 100 часов.

Доработка обмена сайта и 1С — это уже магия уровня «эксперт», пугает даже бородатого опытного разработчика. В этой статье мы поговорим о том, как происходит обмен данными между этими двумя монстрами и как можно расширять возможности этого обмена. Статья содержит множество технических деталей обмена и будет полезна в основном программистам, которые хотят разобраться в предмете.

В данной статье будет рассмотрена общая теория обмена между двумя IT-системами и два стандартных обмена между 1С и сайтом на 1С-Битрикс: обмен товарами и обмен справочниками.

Немного теории

Интеграция — обмен информацией между двумя IT-системами. Иногда называют просто обмен. Определяется форматом данных, протоколом (стандартом) передачи данных, алгоритмом работы.

Формат = как выглядят данные (например, XML, YML, JSON, CSV).

Протокол = как данные оказываются в другом месте (например, HTTP, SIP, SMTP, FTP).

Алгоритм = что при этом происходит. Представляется блок-схемой или диаграммой UML Activity.

Примеры интеграций:

• обмен товарами между самописной учетной системой и сайтом (протокол FTP, формат CSV);
• парсинг курсов валюты с сайта ЦБ РФ (протокол HTTP, формат XML);
• интеграция сайта с Яндекс.Маркет (протокол HTTP, формат YML).

Процедуру обмена можно разделить на 3 части:

1. Экспорт данных из системы А в требуемый формат;
2. Передача данных;
3. Импорт данных требуемого формата в систему Б.

Часто весь обмен называют «импорт» («загрузка») и «экспорт» («выгрузка»). Это не ошибка, по такой формулировкой говорящий показывает, точка зрения какой системы ему ближе. То, что для 1С экспорт товаров, для Битрикса импорт. В дальнейшем тексте статьи мы не будем использовать эти понятия, чтобы не порождать двусмысленности.

И еще одно важное уточнение. «1С» — в зависимости от контекста, это может быть компания-легенда «ООО 1С», их разработка «1С:Предприятие» или конкретная конфигурация (например, «1С: Управление торговлей» или «1С:ERP Управление предприятием») с установленным модулем обмена с сайтом. В мире веб-разработки имеется в виду как раз последнее определение. В статье будет действовать аналогичное соглашение. Так же и с сайтом на платформе 1С-Битрикс: Управление сайтом — обычно это просто «Битрикс».

Резюме

Интеграция — обмен данными между двумя системами.

Формат — как выглядят данные.

Протокол — как передаются данные. 

1С — софт.

Битрикс — сайт.

Краткость — сестра. 

Стандартные возможности обмена 1С и Битрикса

«Из коробки» (без доработок программиста) работают 4 типа обмена:

1. товары из 1С на сайт (тип «catalog»);

2. справочники из 1С на сайт (тип «reference»);

3. пользователей/контрагентов из 1С на сайт (тип «sale»);

4. заказы (тип «sale»):

1. из 1С на сайт;

2. из сайта в 1С.

Протокол

Все взаимодействия между 1С и Битриксом проводятся по HTTP, синхронно. Т.о. 1С подобна браузеру, она «открывает» специальную страницу, отправляет данные (методами POST и GET) и получает текстовый ответ. Есть даже способ имитировать выгрузку из 1С браузером (и мы часто используем этот трюк во время разработки и отладки). Подробнее про отладку мы рассказали в предыдущей статье «Типовые ошибки интеграции между 1С и 1С-Битрикс».

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

Протокол синхронный. 1С отправляет следующий запрос на сайт только после получения ответа на предыдущий (или получения ошибки таймаута).

Формат

Данные передаются в двух форматах. 

Первый формат — текстовый для ответов сайта на запросы из 1С. Сайт выводит в первой строке ответа «success», если завершил некую процедуру, «progress», если продолжает ее выполнять и «error» или «failure», если была ошибка. В последующих строках могут быть дополнительные данные (зависит от каждого конкретного запроса).

Второй формат — CommerceML 2. Основан на XML, в этом формате передаются товары, предложения, цены, склады, заказы и контрагенты (пользователи+платежные профили).

Алгоритм

Подготовка к обмену

Выше мы уже сказали, что протокол обмена — синхронный HTTP. Все перечисленные типы обмена подразумевают выполнение нескольких запросов (шагов обмена) друг за другом. Первые два шага одинаковы для любого типа обмена, различия начинаются дальше

Авторизация

Любой обмен начинается с авторизации 1С на сайте методом Basic access. В случае успеха сайт выводит «success»,  имя и значение Cookie (которую будет проверять во всех последующих запросах), id сессии и прочие параметры (зависят от type — типа обмена).

Возможные ошибки

Запрос настроек сайта

На этом шаге 1С узнает важные для обмена настройки сайта. Управление этими параметрами на сайте происходит на странице «Интеграция с 1С» в панели управления сайтом.

Получив эти параметры, 1С начинает формирование данных для передачи на сайт. Если «zip=yes», то все файлы будут переданы как zip-архив. Иначе каждый выгружается по отдельности. Желательно включать всегда.

Возможные ошибки

Обмен товарами (1С -> Битрикс)

Данный тип обмена (type=catalog) используется для создания и обновления на сайте следующих сущностей:

• инфоблок товаров;

• UF-поля разделов в этом инфоблоке;

• свойства элементов в этом инфоблоке;

• инфоблок SKU;

• типы цен;

• склады;

• разделы в инфоблоке товаров;

• элементы в инфоблоке товаров (товары);

• цены товаров;

• наличие товаров по складам.

При обмене товарами 1С формирует XML-файлы, передает их на сайт и контролирует их обработку сайтом. 1С может передать 4 вида файлов:

В файлах с префиксом import_ — разделы каталога, товары, свойства товаров.

В файлах с префиксом offers_ — SKU.

В файлах с префиксом prices_ — цены товаров и предложений.

В файлах с префиксом rests_ — остатки товаров и предложений по складам.

На шаге авторизации в случае успеха сервер вернет дополнительный параметр timestamp (текущее время). 1С сохранит timestamp и передаст на сайт на последнем шаге обмена товарами. 

Шаг 1. Передача файла (повторяющийся)

Шаг может выполняется несколько раз. Каждый файл выгружается частями не более file_limit байт (см. предыдущий шаг) в бинарном виде через сырой POST-запрос. Сайт создает файл, если его нет. Имя файла берет из GET-параметра filename и дописывает в него переданный контент. Так продолжается до тех пор, пока 1С не передаст все части этого файла. 

Возможные ошибки

Шаг 2. Основной

Этот шаг — особенный. Файл уже целиком загружен на сайт и Битрикс готов его обработать. Его обработка может состоять из 11 более мелких операций, о которых 1С ничего не знает. Поэтому в параметре GET приходит mode=import (один и тот же запрос!), но сайт выполняет совершенно разные операции. Текущий прогресс Битрикс сохраняет в сессии в переменной $_SESSION[BX_CML2_IMPORT][NS]. Например, узел STEP в этом массиве отвечает как раз за номер внутренней операции импорта.

Шаг 2.1 Распаковка архива (повторяющийся, необязательный)

Шаг исполняется, только если 1С передала файл в формате ZIP. Распаковка происходит в той же директории, где лежат все файлы обмена товарами (по умолчанию — /upload/1c_catalog/). Эта операция не нумеруется внутри Битрикса (значение STEP в сессии не изменяется).

Возможные ошибки

Шаг 2.2 Удаление временных таблиц

Работать напрямую с файлом XML (тем более, если он большой) неудобно и неэффективно. Поэтому все данные прочитываются во временную таблицу b_xml_tree. На этом подготовительном шаге таблица b_xml_tree, если она существует, удаляется.

Шаг 2.3 Создание временных таблиц

Таблица b_xml_tree создается. Если объявлена PHP константа BX_XML_CREATE_INDEXES_IMMEDIATELY, таблица сразу же индексируется. В конце этого шага Битрикс испускает событие OnBeforeCatalogImport1C.

Возможные ошибки

Шаг 2.4 Загрузка файла во временную таблицу (повторяющийся)

Битрикс шаг за шагом начинает читать переданный из 1С файл, добавляя записи в таблицу b_xml_tree. Чтобы избежать проблем с временем исполнения, процесс происходит пошагово. Управление продолжительностью шага происходит на странице «Интеграция с 1С» в панели управления сайтом.

Возможные ошибки

Шаг 2.5 Индексация временных таблиц

Для повышения скорости работы импорта таблица b_xml_tree индексируется после прочтения файла.

Возможные ошибки

Шаг 2.6 Импорт метаданных

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

1. Инфоблоки товаров и SKU

2. Служебные свойства каталога (с префиксом CML2_: CML2_BAR_CODE, CML2_ARTICLE, CML2_ATTRIBUTES…)

3. Торговый каталог

4. Свойства инфоблоков

5. UF-поля разделов инфоблоков

6. Типы цен

7. Склады

8. Единицы измерения

Важно: никакие сущности при импорте метаданных не удаляются. Случайно выгруженный из 1С склад или тип цены остается на сайте, пока администратор не удалит его вручную.

Возможные ошибки

Шаг 2.7 Импорт разделов каталога

На этом шаге в инфоблоке создаются и обновляются все разделы каталога, которые были в XML файле. Сопоставление разделов из XML-файла и в БД происходит по XML_ID.

Если на сайте нет раздела с XML_ID из файла, он создается. Если есть, то выполняется сравнение полей из XML файла с аналогичными полями в БД. Если изменения нет, то Битрикс только обновляет поле TIMESTAMP_X и пропускает раздел. Если изменения есть — происходит полноценное обновление. Это происходит независимо от настроек сайта.

Для экономии ресурсов сервера добавление разделов происходит без пересчета дерева (речь о полях LEFT_MARGIN и RIGHT_MARGIN).

Возможные ошибки

Так как импорт разделов не пошаговый, при обмене большом дереве разделов на сайте может возникать ошибка превышения времени исполнения. Решения три.

1. Увеличить время исполнения на странице «Интеграция с 1С» и в настройках сервера (nginx).

2. Доработать 1С, чтобы ошибки на этом этапе игнорировались пока не будет получен ответ «progress».

3. Повторить всю выгрузку несколько раз.

Объясним, как поможет повтор шага или всей выгрузки. Допустим, в XML-файле и на сайте 20001 раздел. Пусть за один проход Битрикс успевает импортировать только 10000 разделов.

Битрикс каждый раз обрабатывает столько разделов, сколько успевает. При повторении выгрузки первые 10000 разделов он пропустит (обновит только TIMESTAMP_X) и обновит еще 10000 разделов, пока не наступил таймаут. И только на 3-ей выгрузке из 1С шаг будет завершен корректно.

Шаг 2.8 Пересчет дерева разделов

На этом шаге Битрикс выполняет две задачи:

1. Удаление/деактивация разделов (в старых версиях модуля обмена в 1С)

2. Перестройка дерева разделов

В старых версиях 1С отличить полную выгрузку от частичной просто: при частичной в узле «Классификатор» был атрибут СодержитТолькоИзменения=»true», при полной его не было.

В 2019 году 1С всегда выгружает этот атрибут. Если этого атрибута нет, Битрикс мог (и до сих пор может, просто этот код не используется) удалить, деактивировать старые разделы (или пропустить их). На выбор влиял параметр на странице «Интеграция с 1С». Сейчас эта настройка уже ни на что не влияет и ни деактивации, ни удаления не происходит.

Также на этом шаге пересчитываются служебные поля LEFT_MARGIN и RIGHT_MARGIN всех разделов.

Шаг 2.9 Импорт товаров (повторяющийся)

На этом шаге в инфоблоке создаются и обновляются все товары, которые были в XML файле. Сопоставление товаров в файле товарам на сайте происходит по полю XML_ID.

Если на сайте нет товара с XML_ID из файла, он создается. Если есть, то выполняется сравнение полей из XML файла с аналогичными полями в БД. 

Если изменения нет, и задан параметр «Использовать контрольные суммы элементов для оптимизации обновления каталога», Битрикс только обновляет поле TIMESTAMP_X и пропускает товар. Иначе происходит полноценное обновление.

При импорте товара заполняется поле TMP_ID. Значение для этого поля хранится в узле <НомерВерсии>. Если узла нет — Битрикс вычисляет контрольную сумму от всей информации о товаре из XML файла.

Возможные ошибки

Шаг 2.10 Деактивация/удаление товаров (повторяющийся)

На этом шаге раньше (как и на шаге  2.8 Пересчет дерева разделов) Битрикс проводил чистку товаров. Чистка товаров происходила только если в узле “Классификатор” XML файла не было пометки СодержитТолькоИзменения=»true» (старый формат выгрузки). Есть аналогичная настройка для выбора, что делать с товарами.

В 2019 году на этом шаге ничего не происходит.

Шаг 2.11 Завершение импорта

Служебный шаг. Обработки данных нет, только испускается событие OnSuccessCatalogImport1C.

Шаг 3. Деактивация старых данных

На этом шаге в 2019 году Битрикс деактивирует все товары и разделы каталога, не затронутые в текущей сессии. Для этого время последнего изменения сравнивается с timestamp, который передает 1С — время начала текущей сессии, полученное на шаге авторизации.

Напомним, что эти настройки в панели управления сайта сейчас ни на что не влияют (всегда происходит деактивация):

Этот шаг будет выполнен, только если современная 1С делает полную выгрузку. Для выгрузки изменений и в старых версиях 1С этого шага нет.

Шаг 4. Завершение импорта

Служебный шаг. Обработки данных нет, только испускается недокументированное событие модуля catalog OnCompleteCatalogImport1C. Аргументы обработчика аналогичны обработчикам события OnSuccessCatalogImport1C, возвращаемого значения нет.

Обмен справочниками (1С -> Битрикс)

Данный тип обмена (type=reference) используется для создания и обновления на сайте HL-блоков. Этот тип намного короче чем обмен товарами и повторяет многие из его шагов.

Часто обмен справочниками — простой и быстрый способ расширить стандартные функции обмена.

Шаг 1. Передача файла (повторяющийся)

см. аналогичный шаг обмена товарами, (отличается только mode, в данном типе обмена mode=reference).

Шаг 2. Основной

Шаг 2.1 Распаковка архива (повторяющийся, необязательный)

см. аналогичный шаг обмена товарами.

Шаг 2.2 Подготовка справочника

На этом шаге Битрикс создает HL-блок (если не существует) и все UF-поля. В начале шага испускается событие модуля catalog OnBeforeCatalogImportHL. Событие недокументированное, в обработчики передаются массив параметров компонента и путь к XML-файлу. Обработчик может вызвать ошибку и вернуть произвольное сообщение.

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

• 1С не может удалить справочник или поле, только создать;

• 1С может создать только поля следующих типов: Строка, Булево, Дата, Число;

• все поля, создаваемые 1С будут одиночными, необязательными, скрытыми в фильтре, показанными и редактируемыми в таблице;

• Битрикс автоматически создает поля: UF_NAME, UF_XML_ID, UF_VERSION, UF_DESCRIPTION.

Возможные ошибки

Расшифровка кодов ошибок.

Шаг 2.3 Импорт элементов (повторяющийся)

На этом шаге Битрикс импортирует все элементы HL-блока.

Если выгрузка была полной, Битрикс удаляет все элементы HL-блока, у которых значение поля UF_VERSION не начинается с <ID текущей сессии> + «#»

В конце шага Битрикс испускает событие модуля catalog OnSuccessCatalogImportHL. Аргументы — массив параметров компонента и путь к файлу.

Возможные ошибки

Аналогичны ошибкам на предыдущем шаге.

Формат файлов

Формат файла обмена товарами

Официальная документация Битрикса по файлу обмена товарами (с примером): https://dev.1c-bitrix.ru/api_help/sale/xml/import.php

Формат файла обмена предложениями

Официальная документация Битрикса по файлу обмена предложениями (с примером): https://dev.1c-bitrix.ru/api_help/sale/xml/offers.php

Формат файла обмена ценами товаров и предложений

Официальная документация Битрикса по файлу обмена ценами (с примером): https://dev.1c-bitrix.ru/api_help/sale/xml/prices.php

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

Официальная документация Битрикса по файлу обмена остатками (с примером): https://dev.1c-bitrix.ru/api_help/sale/xml/rests.php

Формат файла обмена справочниками

Официальная документация Битрикса по файлу обмена справочниками (с примером): https://dev.1c-bitrix.ru/api_help/sale/xml/references.php.

Поясним некоторые места этого XML.

• Узел <Ид>

• Значение становится названием сущности (после транслитерации).

• С префиксом «b_» становится названием таблицы (после транслитерации).

• Узел <Наименование> Не используется. Вообще. Но если узла не будет в файле, Битрикс выдаст ошибку (sic!)

• Каждый <Реквизит> описывается тремя узлами:

• <Ид>

• Значение становится XML ID поля

• С префиксом «UF_» становится кодом поля

• <Наименование>

• Значение становится названием UF-поля.

• <ТипЗначений>

• 4 допустимых значения: Строка, Булево, Дата, Число

• Каждый <ЭлементСправочника> описывается полями:

• <Ид>

• Становится значением поля UF_XML_ID

• <НомерВерсии>

• C префиксом <ID текущей сессии> + «#» становится значением поля UF_VERSION

• <ЗначенияРеквизитов>

• Реквизит Код

• Становится значением поля UF_NAME

• Реквизит Наименование

• Становится значением поля UF_DESCRIPTION

• Реквизит ПометкаУдаления

• Не используется

• Прочие реквизиты

• Поля типа «Дата» представлены в формате YYYY-MM-DD HH:MI:SS.

• Поля типа «Булево» представлены строками true или false (или пустой строкой).

Как дорабатывать обмен?

Все запросы (при стандартном обмене) 1С присылает на служебную страницу /bitrix/admin/1c_exchange.php. Но если заглянуть в файл, выяснится что вся логика скрыта в недрах модуля «Торговый каталог»  в файле /bitrix/modules/sale/admin/1c_exchange.php. Эти страницу нельзя изменять, но можно скопировать (обычно мы копируем в /bitrix/admin/1c_exchange_custom.php) и изменить адрес в 1С.

На этой странице, в зависимости от переданных GET-параметров (совсем как комплексные компоненты в режиме не-ЧПУ) подключаются разные простые компоненты. Компоненты без шаблонов.

Значительная часть логики вынесена из этих компонентов в классы. Связь видов обмена, GET-параметров, компонентов и основных классов приведена ниже в таблице. 

Существует 3 принципиально разных способа доработать обмен с 1С:

1. Не трогать стандартный обмен, использовать обработчики событий.

2. Кастомизировать файлы обмена на стороне сайта и доработать по требованиям

3. Выгружать нужные данные как справочники и обрабатывать самостоятельно.

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

Второй способ реализуется так:

1. Создать собственную страницу обмена. Обычно это /bitrix/admin/1c_exchange_custom.php.

2. На эту страницу перенести код из /bitrix/modules/sale/admin/1c_exchange.php.

3. Кастомизировать нужный компонент обмена и заменить вызов системного компонента на вызов собственного (например, bitrix:catalog.import.1c на intervolga:catalog.import.1c) на новой странице обмена.

4. Может понадобиться изменение логики класса. Используйте наследование (например, класс IntervolgaCustomExchangeCml может быть наследником CIBlockCMLImport и переопределять метод ImportElements).

После правок на сайте нужно изменить параметр «Адрес сайта и путь до скрипта обмена» в 1С. Имя пользователя и пароль одинаковые как для стандартного обмена, так и для доработанного.

Третий способ(через справочники) подходит, если у нужной сущности 1С совсем нет аналога на сайте или по каким-то причинам стандартный импорт совсем не годится. У модуля highloadblock есть все необходимые события (создание, редактирование, удаление) и для ненагруженных проектов это достаточно неплохое решение. 

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

Отладка обмена — отдельный больной вопрос. Обычно решается логированием всех происходящих в недрах Битрикса процессов. В ИНТЕРВОЛГЕ разработали свою систему логирования обмена, которая представляет весь процесс в виде диаграммы Гантта. На ней сразу видно, если идут одновременно 2 обмена или 1С не дожидается ответа и начинает слать новые запросы.

Заключение

Часто самой сложной задачей в процессе разработки является именно интеграция с 1С. Отчетливое понимание происходящих в Битриксе процессов необходимо для серьезных проектов. 

Нужно настроить и доработать интеграцию 1С и сайта? Обращайтесь к нам, мы это умеем.

Хотели бы работать у нас? Мы ищем разработчиков и предлагаем интересные проекты.