Перейти к содержанию

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

Обзор

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

Цель домена

Обеспечить предсказуемый двусторонний обмен данными между 1Формой и внешними системами без нарушения консистентности внутренних бизнес-процессов.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Зависимости

  • tasks, ext-params, users-and-groups, calendar, mail, contracts.

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

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

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

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