Принципы и ограничения¶
Архитектурные принципы¶
- Асинхронность. Все операции обмена выполняются асинхронно с использованием регистров сведений и фоновых заданий 1С. Пользователь не ждёт завершения обмена при записи объекта.
- Надёжность и восстанавливаемость. Состояние обработки сообщений хранится в базе данных 1С — адаптер безопасно переживает перезапуски, сбои и временную недоступность Kafka.
- Масштабируемость. Обработка сообщений поддерживает параллельное выполнение в нескольких потоках; число потоков настраивается на лету.
- Конфигурируемость. Поведение интеграции управляется метаданными (справочники, константы, регистры сведений) — без изменения кода.
- Расширяемость. Поддерживаются разные способы сериализации и прикладной обработки — от простой функции до полноценной КД 3.1.
- Безопасность для пользователя. Ошибки регистрации перехватываются и не блокируют работу пользователя — запись объекта в 1С всегда успешна.
Ограничения и особенности¶
Автоматический повтор при ошибке выгрузки¶
Если сообщение не удалось доставить в Kafka (статус ОшибкаВыгрузки), система автоматически повторяет отправку — не более 3 раз, с интервалом равным расписанию регламентного задания.
После исчерпания попыток сообщение требует ручного вмешательства — администратор возвращает его в очередь из РС «Исходящие сообщения».
Ошибки сериализации / десериализации
Статус ОшибкаОбработки не повторяется автоматически. Логика обработчика должна быть исправлена прежде, чем сообщение будет возвращено в очередь.
Дедупликация исходящих¶
Если объект изменился несколько раз до выгрузки, в Kafka отправляется только последнее состояние. Промежуточные версии помечаются как «Дубль» и исключаются из обработки.
Полная история не сохраняется
Если принимающей стороне нужна вся история изменений объекта — настройте другой механизм (например, прямой API или отдельный поток регистрации каждого изменения с уникальным ключом).
Только клиент-серверная ИБ¶
Файловый режим работы не поддерживается. Для использования адаптера необходима клиент-серверная информационная база.
Ограничения на размер сообщения¶
- Табличные части объекта — до ~100 000 строк.
- Итоговый размер сообщения — до ~10 МБ.
Для больших объёмов данных используйте другие механизмы (например, прямую загрузку файлов).
Дополнительные индексы¶
Дополнительные индексы в СУБД ускоряют выборку сообщений из очередей.
- При внедрении как расширения — индексы создаются вручную.
- При внедрении в основную конфигурацию с лицензией «КОРП» — создаются автоматически.
Системные требования¶
| Параметр | Значение |
|---|---|
| Платформа | 1С:Предприятие 8.3.21 и выше (для Linux — 8.3.24 и выше) |
| ОС | Windows 64-bit / Linux 64-bit |
| Linux-зависимость | glibc 2.28 и выше; на старых дистрибутивах Linux возможны проблемы с запуском внешней компоненты |
| Библиотеки | 1С:Библиотека стандартных подсистем 3.1.10 и выше |
| Инфраструктура | Доступный кластер Apache Kafka |
| Лицензия | «ПРОФ» и выше |
Подробные требования к среде развёртывания — см. Установка и подключение.
Рекомендации по эксплуатации¶
- Контролируйте рост очередей — настройте алерты и мониторинг.
- Для продуктивных контуров обязательны SLA и уведомления об их нарушении.
- При высоких нагрузках увеличивайте количество потоков обработки и разделяйте топики по типам данных.
- Настройте сроки хранения сообщений по статусам — иначе очереди разрастутся.
Архитектура предназначена для корпоративных и высоконагруженных интеграционных сценариев и может служить базой для построения единого событийного контура предприятия.