Расширение для 1С:Предприятие

Бром (Brom) - это интеграционная компонента, которая предоставляет программный  интерфейс взаимодействия (API) с информационными системами на базе 1С:Предприятие.

Компонента представляет собой расширение (файл формата CFE), которое устанавливается поверх произвольной конфигурации 1С. Логика работы расширения не привязана к конкретной модели данных прикладного решения,  а также не требует наличия встроенных стандартных библиотек. По этой причине расширение может устанавливаться как на типовые программные продукты фирмы 1С, так и на отраслевые решения (самописные конфигурации). Расширение может устанавливаться на любые конфигурации, работающие в режиме совместимости 8.3.10 (или выше), в том числе на типовые конфигурации, находящиеся на поддержке поставщика.

Функциональные возможности расширения

Расширение "Бром" позволяет:

  • получать данные различных ссылочных коллекций (справочников, документов, ПВХ и тд...) с учетом сложных условий отбора и сортировки;
  • модифицировать данные коллекций (добавлять, удалять и редактировать элементы справочников, документов и пр. объектов);
  • получать и изменять значения констант;
  • получать данные с помощью произвольных запросов на языке 1С:Предприятие;
  • вызывать процедуры и функции серверных модулей (общих модулей и модулей менеджеров) с передачей произвольного количества параметров вызова и с передачей полученного значения обратно в качестве результата вызова; 
  • исполнять произвольный код 1С на стороне сервера с возможностью передачи параметров и получения возвращаемого значения.

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

Как это работает

При установке расширения в прикладную конфигурацию добавляется web-сервис "brom_api". При публикации информационной базы на web-сервере публикуется также и дополнительный web-сервис расширения. В сервисе реализованы механизмы взаимодествия с данными прикладного решения. Взаимодействие с сервисом происходит через стандартизированный протокол SOAP путем отправки и получения XML-сообщений заранее известной структуры.

Интерфейс взаимодействия по протоколу SOAP подробно описан в разделе "SOAP взаимодействие".

Сравнение с OData

Как известно, платформа 1С:Предпритие предоставляет доступ к данным прикладного решения через стандартизированный протокол OData (Open Data Protocol). Зачем же в таком случае внедрять дополнительное расширение, если доступ к данным и так есть?

Дело в том, что у обоих механизмов взаимодействия есть свои преимущества и недостатки. Ниже представлена таблица, сравнивающая их по ряду признаков:

Бром OData
Получение данных коллекций со сложными условиями отбора и сортировки
Постраничный вывод данных коллекций
Добавление и редактирование данных
Поддержка работы с типами 1С:Предприятие (ссылки, таблицы, деревья и пр.)
Выполнение произвольных запросов
Вызов серверных процедур и функций
Выполнение произвольного серверного кода
Готовые интсрументы визуализации / пользовательские интерфейсы
Передача данных в формате JSON