Интеграция "1С:Підприємство" с Битрикс 24- универсальный обмен между объектами Битрикс 24 и "1С:Підприємство".

Решение может работать на облачном и коробочном Битрикс 24. Настройки на стороне "Битрикс 24" выполнены в виде скриптов, без изменения "Битрикс 24".

Как реализовано:

• В "1С:Підприємство" добавлены API-команды. Система взаимодействия построена  так, что "Битрикс 24" - активная сторона, а  "1С:Підприємство" - отдающая и принимающая информацию сторона.

• Соответствие объектов (сущностей) и их полей настраивается на стороне "1С:Підприємство".

• Минимальный тариф "Битрикс24" - «СРМ+». Не требуется перехода на тариф «Компания», как для стандартного обмена с Битрикс24.

Для настройки обмена используются следующие объекты метаданных:

1. Справочники Битрикс 24.

2. Структура метаданных.

3. Сущности обмена с Битрикс 24.

Рис.1. Данные для настройки обмена.

1. «Справочники Битрикс24» (+ Справочник «Значения справочников Битрикс24»).

Предусмотрена настройка соответствия значений справочного типа (справочник, перечисление, …) к значениям в Битрикс24. Это сделано для тех случаев, когда строковое представление значений справочника (перечисления) не (всегда) соответствует своему аналогу в Битрикс24 (рис. 2).

Настройка обмена значениями реквизитов выполняется в справочниках соответствий объектов Битрикс 24 и "1С:Підприємство", без изменения программного кода.

Перечень справочников для обмена:

• Контрагенты;
• Контактные лица;
• Склады;
• Остатки по складам;
• Товары;
• Бизнес-процесс.

Рис.2. Настройка соответствия значений справочного типа (справочник, перечисление, …) к значениям в Битрикс 24.

Соответствие значений справочников Битрикс24 - Настройка соответствия справочных значений значениям в Битрикс24.

Рис.3. Настройка соответствия справочных значений значениям в Битрикс24.

2. Структура метаданных – представление метаданных, участвующих в обмене с Битрикс24, в виде справочника (рис. 4).

Рис.4. Структура метаданных.

3. Настройка соответствия сущностям Битрикс24 реквизитов или связанных элементов в "1С:Підприємство".

Данная схема обмена предполагает возможность пользовательского (без изменений в коде или других изменений конфигурации) дополнения существующего набора полей обмена сущностей, при условии, что используются типы данных "1С:Підприємство", используемые в базовой поставке (например, простые типы (строка, дата, число, булево)). Это делается путем создания (если необходимо) элемента справочника Структура метаданных и добавления с указанием соответствующему ему полю сущности Битрикс24 (элемент справочника Сущности обмена с "1С:Підприємство"). Аналогично для связанных объектов: добавить элемент справочника Сущности обмена с "1С:Підприємство" и настроить связь со связанным объектом (рис.5).

Аналогично при необходимости исключить из обмена некоторые поля можно, не прибегая к изменениям в коде. Достаточно просто пометить на удаления элемент справочника Сущности обмена с "1С:Підприємство".

В наборе обмена существуют также программно определяемые поля, которые невозможно определить простым соответствием реквизиту справочника/документа или связанному объекту. В таких случаях без изменений в коде обойтись не получится. В качестве примера такого поля можно привести параметр Годовой оборот. Такого реквизита в справочнике контрагенты нет, но есть отображение данного показателя на форме элемента, а сами данные берутся по объекту за определенный период из соответствующего регистра. Очевидно, что для таких полей предусмотрен только односторонний обмен (т.е. только выгрузка из "1С:Підприємство" в Битрикс24)

Но, как показала практика, таких полей не много, и в большинстве случаев встречается связь один-к-одному (один реквизит "1С:Підприємство" соответствует полю сущности Битрикс24).

Рис.5. Сущности метаданных.

Для удобства восприятия информации однотипные поля из связанных объектов можно связанные поместить во вложенную группу (рис. 6).

Рис. 6. Пример связанных однотипных полей с объектами помещенных в вложенную группу (поля контактной информации).

Но это допускается только для связанных объектов. Поля обмена со связью один-к-одному обязательно должны находится в корневой группе сущности!

Для связанных объектов предусмотрена возможность настройки разного отбора для выгрузки в Битрикс24 и загрузки с него. При выгрузке в Битрикс24, например, может быть выгружена контактная информация с типом «Телефон», а загружаться это же поле будет уже не только с типом Телефон, а еще и с видом «Рабочий», или «телефон контрагента», или «телефон контрагента из Битрикс24». Для выгрузки можно задавать «не строгий» отбор, а для записи в "1С:Підприємство" необходимо указывать отбор как можно конкретнее и точнее. Иначе при записи данных в регистр может возникнуть ошибка и загружаемые данные из Битрикс24 в "1С:Підприємство" записаны не будут.

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

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

Регистры сведений.

ID Битрикс24 – Хранение идентификатора объекта Битрикс24 в "1С:Підприємство".

Рис. 8. Хранение идентификатора объекта.

Протокол выгрузки в Битрикс24 – Фиксация ошибок обмена. При необходимости можно фиксировать в том числе и успешные операции.

Рис.9. Фиксация ошибок обмена.

Настройка обмена значениями реквизитов выполняется в справочниках соответствий объектов Битрикс 24 и "1С:Підприємство", без изменения программного кода.

Разработчик: Компания «ЭНСИТИ»

www.nct.ua
info@nct.ua

Варианты предложения: