Интеграции: бизнес-логика

Домен интеграций объединяет внешние контуры платформы: обмен с 1С, ЭДО, почтовые/календарные провайдеры, шину сообщений и другие подключаемые сервисы. Цель домена — обеспечить предсказуемый двусторонний обмен данными между 1Формой и внешними системами без нарушения согласованности внутренних бизнес-процессов. Документ описывает основные направления, бизнес-правила, сценарии, зависимости и операционные риски. Аудитория — инженеры поддержки и разработчики, настраивающие и сопровождающие интеграции.

Основные направления

1. 1С-интеграция

• Конфигурация обмена и сценарии-конструкторы.
• Очередь событий 1С.
• Обработка входящих событий в реальном времени.

2. ЭДО и внешние документы

• Отправка/обработка документов через Diadoc/SBIS.
• Хранение связей и статусов документов.

3. Интеграционная очередь и шина

• Универсальная обработка событий по правилам обработки потоков.
• Повторные попытки и диагностика ошибок в MessageQueue.

4. Сервисные интеграции

• Exchange, auth providers, внешние API-коннекторы.

5. Веб-аналитика (Matomo)

Интеграция с Matomo (v2.256+) предоставляет аналитику использования системы. Требует настройки администратором (см. Интеграции — администрирование, § Matomo).

Что отслеживается:

• Типы посещений: прямые переходы, переходы с сайтов, из поиска, рекламных кампаний.
• Действия: загрузки файлов, переходы по ссылкам, длительность сессий.
• Цели и конверсии.
• Идентификаторы пользователей (связь действий между сессиями и устройствами).

Инструменты:

• Автоматические PDF/HTML-отчёты по email.
• Визуализации: круговые и столбчатые диаграммы, облака тегов.
• Экспорт: CSV, XML, PHP, Excel, JSON; REST API.
• Мобильные приложения Matomo (iOS / Android).

Представления: обзор посещений, журнал посещений, карта в реальном времени, география, устройства и ПО.

Бизнес-правила и основные сценарии

Бизнес-правила домена интеграций:

1. Любая интеграция должна иметь валидную конфигурацию и учётные данные.
2. Асинхронные процессы управляются политикой обработки потока (повтор / остановка / ошибка).
3. Ошибка во внешнем сервисе не должна скрыто менять внутреннее состояние как «успех».
4. Для критичных сценариев нужен операционный журнал с контекстом события.

Основные сценарии:

• Сохранение и валидация конфигурации интеграции.
• Приём и обработка входящего внешнего события.
• Фоновая обработка очереди и восстановление после ошибок.

Зависимости домена: tasks, ext-params, users-and-groups, calendar, mail, contracts.

Операционные риски:

• Неверное сопоставление (mapping) пользователей/объектов.
• Зависания очередей при ActionOnError = Stop.
• Ошибки сетевого доступа и истёкшие учётные данные.

При инцидентах проверять:

1. Логи интеграционного сервиса (1С/ЭДО).
2. Состояние MessageQueue, MessageQueueLog, MessageFlows.
3. Актуальность конфигурации и доступность внешнего сервиса.