1. Справочники Битрикс 24.
2. Структура метаданных.
3. Сущности обмена с Битрикс 24.
Рис.1. Данные для настройки обмена.
Настройка обмена значениями реквизитов выполняется в справочниках соответствий объектов Битрикс 24 и "1С:Підприємство", без изменения программного кода.
Перечень справочников для обмена:
Рис.2. Настройка соответствия значений справочного типа (справочник, перечисление, …) к значениям в Битрикс 24.
Соответствие значений справочников Битрикс24 - Настройка соответствия справочных значений значениям в Битрикс24.
Рис.3. Настройка соответствия справочных значений значениям в Битрикс24.
Рис.4. Структура метаданных.
Данная схема обмена предполагает возможность пользовательского (без изменений в коде или других изменений конфигурации) дополнения существующего набора полей обмена сущностей, при условии, что используются типы данных "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С:Підприємство", без изменения программного кода.
Разработчик: Компания «ЭНСИТИ»