Коннектор 1С-ESB
Полное руководство по установке, настройке и использованию программного модуля для интеграции 1С с корпоративными системами
Функциональные характеристики
ПО "Коннектор 1С-ESB. Программный модуль для интеграции приложений на платформе 1С:Предприятие с шинами данных или брокерами сообщений"
Графическая настройка
Интуитивный интерфейс для конфигурации приёма и отправки сообщений
Гибкое форматирование
Настройка форматов, способов доставки и схем сериализации без правки кода
Кастомные модули
Подключение пользовательских алгоритмов для сериализации и десериализации
Управление версиями
Передача объектов с учётом версий и точным описанием изменений
Автоматизация
Автоматическое и программируемое формирование сообщений по правилам
Планировщик
Гибкое расписание отправки сообщений от минут до периодов
Централизованный агент
Единый сервис-агент обработки сообщений для всех 1С-конфигураций
Кроссплатформенность
Поддержка Windows и Linux без дополнительных зависимостей
Системные требования
Технические характеристики для установки и эксплуатации ПО
Аппаратные требования
- Процессор: архитектура x86-64 (Intel64/AMD64)
- ОЗУ: не менее 2 ГБ (рекомендуется 4 ГБ и выше)
- Накопитель: HDD объёмом 40 ГБ и выше
Поддерживаемые ОС
- CentOS 9; Debian 12; RHEL 8, 9
- Ubuntu 20.04, 22.04, 24.04 LTS
- Windows 10, 11; Server 2022, 2019, 2016, 2012
- Astra Linux, РЕД ОС, Альт с поддержкой .NET 8
Программные требования
- 1С: версия ≥ 8.3.21
- СУБД: MariaDB ≥ 11.3; PostgreSQL ≥ 14
- .NET: версия 8.0 и выше
Архитектура решения
Компонентная структура и взаимодействие системы Коннектор 1С-ESB
Компоненты системы
-
Расширение для конфигурации 1С (1C ESB) Интеграционный модуль для платформы 1С:Предприятие
-
Транзитная СУБД Промежуточное хранилище для обмена сообщениями
-
Кроссплатформенный агент Универсальный модуль передачи сообщений
Взаимодействие компонентов
Схема взаимодействия компонентов системы
Установка и настройка
Полное руководство по развертыванию системы Коннектор 1С-ESB
Подготовка 1С
Добавьте внешний источник данных из прилагаемой конфигурации и установите расширение "КоннекторESB.cfe"
Настройка СУБД
Установите PostgreSQL или MariaDB, восстановите базу из резервной копии и настройте ODBC-источник
Развертывание агента
Распакуйте архив в каталог агента и настройте конфигурационный файл Amq1C.dll.config
Запуск службы
Установите службу Windows через installService.cmd или настройте демон systemd для Linux
Настройка конфигурации 1С
Роли доступа
- Пользователь: просмотр сообщений
- Администратор: полный доступ к настройкам
Константы
- Уникальный ИД базы 1С
- Параметры подключения к транзитной СУБД (ODBC, пользователь, пароль)
- Настройки автоматического удаления старых сообщений
Сервисы сообщений
- Исходящие сообщения
- Входящие сообщения
- Регламентные задания для автоматической обработки
Настройка агента
Конфигурационный файл
Настройте Amq1C.dll.config:
- Параметры подключения к FESB
- Параметры транзитной СУБД
- Имена очередей сообщений
Безопасность
Amq1C.exe encrypt
Установка службы
installService.cmd
sudo systemctl enable amq1c.service
Настройка сообщений
Конфигурация отправки и получения сообщений в системе
Настройка сообщений
Варианты запуска
- История данных: активируется при записи истории объектов (должна быть включена)
- Регламентное задание: запускается автоматически с алгоритмом на языке 1С
- Ручной запуск: для автоответов на входящие сообщения
Параметры сообщений
- Формат сообщения: JSON/XML
- Состав сообщения: ссылка или объект
- Способ сериализации: рекомендуется "Глобальный сериализатор"
Входящие сообщения
- Определите правила обработки сообщений ESB
- Укажите алгоритм после десериализации (на языке 1С)
- Настройте автоответ при необходимости
Графический интерфейс
Настройка сообщений происходит в графическом интерфейсе коннектора 1С-ESB. Для настройки перейдите в конфигурацию 1С и в графическом интерфейсе настройте нужные параметры.
Управление службой
Команды для управления работой Коннектора 1С-ESB
Включение
Перейдите в раздел «Службы» → выберите службу коннектора → нажмите правой кнопкой мыши → выберите «Включить»
Отключение
Перейдите в раздел «Службы» → выберите службу коннектора → нажмите правой кнопкой мыши по службе → выберите «Отключить»
Перезапуск
Перейдите в раздел «Службы» → выберите службу коннектора → нажмите правой кнопкой мыши → выберите «Отключить» → заново включите: выберите «Включить»
Включение
sudo systemctl start amq1c.service
Отключение
sudo systemctl stop amq1c.service
Перезапуск
sudo systemctl restart amq1c.service
Сопровождение и поддержка
Комплексное техническое обслуживание и обновления
Обновления ПО
Последние версии программного обеспечения и справочной документации доступны сразу после выпуска обновлений. Доставка по электронной почте по запросу.
Консультационная поддержка
Помощь при установке, консультации по возможностям ПО и сценариям использования. Удаленная поддержка и выезд специалиста.
Инцидентная поддержка
Решение инцидентов с ПО, идентификация проблем, предоставление исправлений и обходных решений.
Требования к специалистам
- Программист/администратор 1С: установка коннектора для конфигураций 1С и настройки параметров
- Администратор интеграционных решений: подключение коннектора к интеграционным решениям (брокер сообщений, корпоративная шина данных, интеграционная платформа)
Документация и файлы
Скачайте полную документацию и руководство пользователя