c сайтом 1С-Битрикс

Интеграция – это обмен информацией между разными IT-системами. Этот обмен зависит от формата информации, используемых протоколов ее передачи и алгоритмов работы.

Список понятий:

• Формат - как выглядит информация (данные), к примеру, XML, CSV и т.п.
• Протокол - каким путем информация передается из одного места в другое, это может FTP, HTTP, SMPT и др.
• Алгоритм - описывает происходящий процесс в виде блок-схемы или диаграммы UML Activity.
• Обмен данными = интеграция

1. Стандартный обмен данными 1С и сайта на 1С-Битрикс

Без проведения доработки пользователи могут настроить 4 вида обмена между ПО и сайтом:

1. Реализуемая продукция из 1С по типу catalog.
2. Справочники из ПО по типу reference.
3. Пользователи или контрагенты по типу sale.
4. Заказы по типу sale в двустороннем направлении, то есть, из ПО на сайт и с сайта в ПО.

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

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

Для передачи данных 1С и Битрикс используется 2 основных формата:

• Текстовый, задействованный в процесс передачи ответов с сайта за посылаемые запросы 1С. В первой строке при успешном завершении процедуры пишется «succes», если процедура выполняется, то «progress», в случае ошибки «error», «failure». В остальных строках приводится дополнительная информация, количество которой напрямую связано с особенностями запроса.
• Формат CommerceML в основе которого лежит XML. В него собираются данные о товарах, ценах, предложениях, складах, заказах и контрагентах, а также пользователях и платежных профилях.

Для обмена данными 1С и Битрикс используется синхронный HTTP. Он проводится в несколько основных шагов. 2 первых идентичны для любого типа обмена, затем для HTTP начинаются отличия:

Обмен данными всегда стартует только после того, как была произведена авторизация 1С при помощи метода Basic access. Если сайт успешно авторизовал 1С, то система выдает success, имя, значение Cookie, id этой сессии и другие параметры.

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

После того как эти параметры получены, ПО приступает к формированию данных в формат для отправки на сайт. В случае, когда архив zip=yes, то файлы включают в него и передаются в zip-архиве. Если zip ≠yes, то каждый сформированный 1С выгружается по 1, что значительно замедляет процесс, поэтому желательно всегда прописывать, что zip=yes.

2. Обмен товарами из 1С в Битрикс

Тип обмена данными type-catalog задействован при создании обновления на сайте таких позиций, как:

• инфоблок товаров;
• UF-поля разделов в этом инфоблоке;
• свойства элементов в этом инфоблоке;
• инфоблок SKU;
• типы цен;
• склады;
• разделы в инфоблоке товаров;
• элементы в инфоблоке товаров (товары);
• цены на товары;
• наличие товара в том или ином складе.

Когда производится обмен товара, то 1С создает XML-файлы, отправляет их в Битрикс и проверяет, как сайт их обрабатывает. Из программы можно отправить несколько видов файлов:

• с префиксом import (в них заносятся разделы каталогов, товары и их свойства);
• с префиксом offers (в них заносится SKU);
• с префиксом prices (в них заносятся цены на товары и предложения);
• с префиксом rests (в них заносятся остатки по товарным позициям, предложения со складов).

Если авторизация прошла успешно, то сервер отправит параметр timestamp. Программа сохранит его и отправит на последнем шаге после обмена товарами.

Описанная процедура повторяется такое число раз, сколько товаров передается из 1С в Битрикс. Каждый файл загружается на сервер в бинарном виде при помощи POST-запроса. Если его нет, то Битрикс создает файл с именем из GET-параметра (filename) и добавляет в него полученный из 1С контент, эти действия продолжаются до тех пор, пока 1С не отправит части файла в бинарном виде.

3. Основной этап обмена данными

Описанная процедура является одной из самых важных. Переданный в процессе файл является полностью загруженным в Битрикс и система готова с ним работать. Как правило, для обработки проводится 11 небольших операций, о которых 1С не оповещается. В связи с этим с параметром GET отправляется один и тот же запрос mode-import, но при этом на сайт выполняет отличающиеся друг от друга операции. Весь прогресс сохраняется в сессии (переменная $_SESSION[BX_CML2_IMPORT][NS]).

Данный этап актуален только в тех случаях, когда информация из 1С передается в Битрикс при помощи файлов, упакованных в zip-архив. Архив распаковывается в директории, где расположены другие файлы, задействованные при обмене товарами, если пользователь не менял путь, то по умолчанию это upload/1c_catalog/. Операция не отмечается системой Битрикса при помощи нумерации.

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

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

Когда таблица создана, при объявлении PHP константы BX_XML_CREATE_INDEXES_IMMEDIATELY, система автоматически ее индексирует. По завершению данного этапа запускается событие OnBeforeCatalogImport1C.

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

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

После того как файл прочитан, чтоб ускорить процесс переноса информации в таблицу, система проводит индексацию.

Система создает или обновляет уже имеющие данные:

• инфоблоки товаров и SKU;
• служебные свойства каталога (с префиксом CML2_: CML2_BAR_CODE, CML2_ARTICLE, CML2_ATTRIBUTES…);
• торговый каталог;
• свойства инфоблоков;
• UF-поля разделов инфоблоков;
• типы цен;
• склады;
• единицы измерения.

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

На этом этапе в Битрикс создаются и проходят обновления разделы каталога, до этого указанные в файле XML. Сопоставление разделов из БД в 1С и XML файла происходит при помощи XML_ID. Если раздела с таким файлом на сайте нет, то он создается заново. Если есть, то просто проводится сравнительный анализ данных. Если изменения обнаружены, то Битрикс включает обновление в поле TIMESTAMP_X и переходит к следующему разделу (при наличии изменений запускается обновление).

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

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

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

Можно повторить выгрузку. В файле XML и в Битрикс может быть создано какое-то количество разделов. За один проход система успевает получить определенное количество разделов. В каждом подходе сайт успевает обработать только определенное количество разделов, кратное количеству разделов за один проход. При повторной операции он выгрузит еще кратное определенному количеству за один проход, а предыдущие уже пропустит. Получается, что 100% выгрузка по факту будет совершена только после нескольких запусков выгрузки, равное количеству кратности и операция будет завершена корректно, о чем система и оповестит пользователя.

Этот процесс подразумевает выполнение следующих задач в Битрикс:

• выключение или удаление разделов;
• проведение перестройки дерева для разделов.

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

На этом этапе происходит пересчет служебных полей (LEFT_MARGIN, RIGHT_MARGIN) для всех имеющихся разделов.

DONE Ассоциативный массив, счетчик обработанных товаров и всех товаров в файле

На этом этапе происходит непосредственно создание и обновление товаров из XML файла. Также система проводит сверку по полю XML_ID, сравнивая между собой аналогичные поля в БД 1С и файла XML. В случае если изменений не обнаружено, то система обновляет поле TIMESTAMP_ID и переходит к следующему товару. Это актуально в том случае, когда пользователь указала такой параметр, как «Использовать контрольные суммы элементов для оптимизации обновления каталога».

Когда происходит импортирование товаров, то система заполняет поле TMP_ID, его значение сохраняется в узле <НомерВерсии>. В случае отсутствия узла, сайт автоматически определяет контрольную сумму для всего объема данных из XML файла.

Сайт инициирует чистку товаров, в случае если в узле «Классификатор» XML файла пользователь не сделал отметку СодержитТолькоИзменения="true" (актуально для старого формата выгрузки). Такая же настройка действует и на выбор системы, что именно нужно делать с тем или иным товаром.

4. Системный этап интеграции

На этом этапе отсутствует обработка информации, а итогом является событие OnSuccessCatalogImport1C.

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

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

Внутренний системный процесс, не подразумевающий обработку данных. На нем создается недокументированное событие в модуле catalog событие – OnCompleteCatalogImport1C.

1. 3. Обмен справочниками из 1С в Битрикс

Тип обмена type-reference. Применяется системой для того, чтобы создать и обновить на сайте HL-блоки. Схож с типом, используемым для обмена товарами, но имеет меньшее количество этапов. Благодаря обмену справочниками пользователь имеет возможность быстро увеличить количество доступных функций обмена в стандартном виде.

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

Процесс аналогичен этапу обмена товарами, (отличается только mode, здесь mode=reference).

1. 4. Основной процесс

Аналогичен этапу обмену товарами.

1. 6. Подготовка справочника

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

• в 1С можно только создавать поля и справочники, удаление невозможно;
• в 1С можно создать поля только определенных типов, а именно Число, Дата, Булево, Строка;
• поля, которые создаются в 1С относятся к категории одиночных и необязательных, они скрываются в фильтре, но показываются в таблице и доступны для редактирования;
• сайт на Битрикс сам создает следующие виды полей UF_DESCRIPTION, UF_NAME, UF_VERSION, UF_XML_ID.

4.7 Коды ошибок

1. 7. Импорт элементов (повторяющийся)

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

При реализации стандартного обмена между 1С и Битрикс все запросы отправляются на страницу /bitrix/admin/1c_exchange.php, но при этом вся логика сохраняется в файле /bitrix/modules/sale/admin/1c_exchange.php, находящимся в модуле «Торговый каталог». Вносить изменения на указанной ранее странице нельзя, но допускается копирование и изменение адреса в ПО 1С.

Уже после копирования, учитывая переданные GET-параметры, разрешается подключение простых компонентов, не имеющих шаблонов.

Разработчикам доступны 3 основных способа, при помощи которых можно дорабатывать обмен 1С и Битрикс:

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

• создать отдельную страницу для обмена;
• внести в нее код из /bitrix/modules/sale/admin/1c_exchange.php
• провести кастомизацию нужного компонента обмена, изменить вызов системного компонента на выбранный пользователем, используя для этого новую страницу;
• поработать над логикой класса, к примеру, использовать наследование.

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

3. Производить выгрузку информации в виде справочника и затем вручную проводить обработку – подойдет в тех случаях, когда 1С не имеет аналога в Битрикс, или использование стандартной интеграции абсолютно невозможно. При этом необходимо чтобы модуль higloadblock имел такие события, как удаление, корректировка, создание.

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

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

Зачастую сложнейшей задачей при разработке сайта является интеграция с 1С. Чтобы процесс прошел насколько возможно легко и просто, от разработчика 1С требуется знание и самое главное понимание процессов Битрикса. Заказать услугу по настройке обмена можно, обратившись в офис компании «АйТи-Консалтинг». Профессиональные специалисты 1С проконсультируют и реализуют процесс подключения систем в короткие сроки с гарантией качества.