Интеграция программ с конфигурациями линейки "BAS", конфигурациями "УТП", "УПП", "УТ 2.3" с "Битрикс24" по API в режиме реального времени
Универсальный обмен между "Битрикс24" и BAS позволяет настроить двухсторонний обмен практически любыми данными между "Битрикс24" и BAS.
Решение может работать на облачном и коробочном "Битрикс24". Настройки на стороне "Битрикс24" выполнены в виде скриптов, без изменения "Битрикс24".
Как реализовано:
-
В "BAS" добавлены API-команды. Система взаимодействия построена так, что "Битрикс24" - активная сторона, а BAS - отдающая и принимающая информацию сторона.
-
Соответствие объектов (сущностей) и их полей настраивается на стороне BAS.
-
Минимальный тариф "Битрикс24" - «СРМ+». Не требуется перехода на тариф «Компания», как для стандартного обмена с Битрикс24.
Интеграция программ BAS с "Битрикс24" - универсальный обмен между объектами "Битрикс24" и программ BAS.
Решение может работать на облачном и коробочном "Битрикс24". Настройки на стороне "Битрикс24" выполнены в виде скриптов, без изменения "Битрикс24".
Как реализовано:
-
В BAS добавлены API-команды. Система взаимодействия построена так, что "Битрикс24" - активная сторона, а BAS- отдающая и принимающая информацию сторона.
-
Соответствие объектов (сущностей) и их полей настраивается на стороне BAS.
-
Минимальный тариф "Битрикс24" - «СРМ+». Не требуется перехода на тариф «Компания», как для стандартного обмена с Битрикс24.
Для настройки обмена используются следующие объекты метаданных:
1. Справочники "Битрикс24".
2. Структура метаданных.
3. Сущности обмена с "Битрикс24".
Рис.1. Данные для настройки обмена.
1. «Справочники Битрикс24» (+ Справочник «Значения справочников Битрикс24»).
Предусмотрена настройка соответствия значений справочного типа (справочник, перечисление, …) к значениям в Битрикс24. Это сделано для тех случаев, когда строковое представление значений справочника (перечисления) не (всегда) соответствует своему аналогу в Битрикс24 (рис. 2).
Настройка обмена значениями реквизитов выполняется в справочниках соответствий объектов "Битрикс24" и BAS, без изменения программного кода.
Перечень справочников для обмена:
- Контрагенты;
- Контактные лица;
- Склады;
- Остатки по складам;
- Товары;
- Бизнес-процесс.
Рис.2. Настройка соответствия значений справочного типа (справочник, перечисление, …) к значениям в "Битрикс24".
Соответствие значений справочников "Битрикс24" - Настройка соответствия справочных значений значениям в "Битрикс24".
Рис.3. Настройка соответствия справочных значений значениям в "Битрикс24".
2. Структура метаданных – представление метаданных, участвующих в обмене с "Битрикс24", в виде справочника (рис. 4).
Рис.4. Структура метаданных.
3. Настройка соответствия сущностям "Битрикс24" реквизитов или связанных элементов в BAS.
Данная схема обмена предполагает возможность пользовательского (без изменений в коде или других изменений конфигурации) дополнения существующего набора полей обмена сущностей, при условии, что используются типы данных BAS, используемые в базовой поставке (например, простые типы (строка, дата, число, булево)). Это делается путем создания (если необходимо) элемента справочника Структура метаданных и добавления с указанием соответствующему ему полю сущности "Битрикс24" (элемент справочника Сущности обмена с BAS). Аналогично для связанных объектов: добавить элемент справочника Сущности обмена с BAS и настроить связь со связанным объектом (рис.5).
Аналогично при необходимости исключить из обмена некоторые поля можно, не прибегая к изменениям в коде. Достаточно просто пометить на удаления элемент справочника Сущности обмена с BAS.
В наборе обмена существуют также программно определяемые поля, которые невозможно определить простым соответствием реквизиту справочника/документа или связанному объекту. В таких случаях без изменений в коде обойтись не получится. В качестве примера такого поля можно привести параметр Годовой оборот. Такого реквизита в справочнике контрагенты нет, но есть отображение данного показателя на форме элемента, а сами данные берутся по объекту за определенный период из соответствующего регистра. Очевидно, что для таких полей предусмотрен только односторонний обмен (т.е. только выгрузка из BAS в "Битрикс24")
Но, как показала практика, таких полей не много, и в большинстве случаев встречается связь один-к-одному (один реквизит BAS соответствует полю сущности "Битрикс24").
Рис.5. Сущности метаданных.
Для удобства восприятия информации однотипные поля из связанных объектов можно связанные поместить во вложенную группу (рис. 6).
Рис. 6. Пример связанных однотипных полей с объектами помещенных в вложенную группу (поля контактной информации).
Но это допускается только для связанных объектов. Поля обмена со связью один-к-одному обязательно должны находится в корневой группе сущности!
Для связанных объектов предусмотрена возможность настройки разного отбора для выгрузки в Битрикс24 и загрузки с него. При выгрузке в "Битрикс24", например, может быть выгружена контактная информация с типом «Телефон», а загружаться это же поле будет уже не только с типом Телефон, а еще и с видом «Рабочий», или «телефон контрагента», или «телефон контрагента из "Битрикс24"». Для выгрузки можно задавать «не строгий» отбор, а для записи в BAS необходимо указывать отбор как можно конкретнее и точнее. Иначе при записи данных в регистр может возникнуть ошибка и загружаемые данные из "Битрикс24" в BAS записаны не будут.
Предусмотрена связь не только реквизита метаданных с соответствующим полем сущности "Битрикс24", но также и категорий, и связанного справочника и регистра сведений с возможностью установки отбора (рис.7).
Рис.7. Связь метаданных с категорией, связанного справочника и регистра сведений с возможностью установки отбора.
Регистры сведений.
ID Битрикс24 – Хранение идентификатора объекта Битрикс24 в BAS.
Рис. 8. Хранение идентификатора объекта.
Протокол выгрузки в "Битрикс24" – Фиксация ошибок обмена. При необходимости можно фиксировать в том числе и успешные операции.
Рис.9. Фиксация ошибок обмена.
Настройка обмена значениями реквизитов выполняется в справочниках соответствий объектов "Битрикс 24" и BAS, без изменения программного кода.
Разработчик: Компания «ЭНСИТИ»
Варианты предложения:
- Комментарии