# Монитор интеграции и репликации

Монитор интеграции и репликации используется для контроля выполнения интеграционного обмена. В нем отображаются каналы, сессии импорта и экспорта, логи обработки сообщений, принятые и подписанные объекты, а также ошибки, возникающие при обработке или подписке на канал.

Монитор применяется после настройки каналов и заданий. По нему можно понять, был ли запущен обмен, сколько объектов обработано, на каком этапе возникла ошибка и какие сообщения требуют повторной обработки или исправления.

## Интерфейс монитора и списки сессий

В верхних областях монитора выбирается канал информационного обмена и сессия импорта или экспорта. После выбора сессии в нижней области отображаются журналы и вкладки детализации.

### Интерфейс монитора

Интерфейс монитора состоит из нескольких областей:

- **Список каналов информационного обмена** — показывает настроенные каналы;
- **Список сессий** — показывает сессии импорта и экспорта для выбранного канала;
- **Детализация сессии** — показывает дополнительную информацию по выбранной сессии. Состав вкладок зависит от типа сессии: импорт или экспорт.

![](img/rpl_monitor_main_window.jpg)

### Список каналов информационного обмена

Данные о сессиях импорта и экспорта отображаются в разрезе выбранного канала. В списке каналов также выводятся признаки активности и даты последних сессий.

| Поле | Описание | Тип данных |
|---|---|---|
| **Наименование** | Наименование канала. | Текст |
| **Системное имя** | Системное имя канала. | Текст |
| **Включен** | Признак активности канала. | Логический |
| **Доступен** | Результат диагностики канала. Значение **Да** означает успешную диагностику, **Нет** — отрицательный результат, **-** — диагностика не выполняется. | Текст |
| **Экспорт** | Дата последней сессии экспорта. | Дата |
| **Удачный экспорт** | Дата последней сессии экспорта, завершенной без ошибок. | Дата |
| **Импорт** | Дата последней сессии импорта. | Дата |
| **Удачный импорт** | Дата последней сессии импорта, завершенной без ошибок. | Дата |

### Список сессий

Список сессий разделен на две области: слева отображаются сессии импорта, справа — сессии экспорта. Для одного канала могут быть настроены оба направления обмена. Сессия создается при запуске канала по расписанию, вручную или при поступлении сообщения через web-сервис.

На панели фильтрации доступен признак **Показать пустые**. Он отображает сессии, для которых не были загружены или подготовлены объекты.

### Атрибуты сессии импорта

| Поле | Описание | Тип данных |
|---|---|---|
| **Индикатор** | Цветовой индикатор состояния сессии. Зеленый цвет означает завершение без ошибок, красный — ошибку сессии или ошибку обработки одного из импортируемых объектов. | Индикатор |
| **Идентификатор** | Уникальный идентификатор сессии. | Число |
| **№** | Номер сессии импорта по порядку в рамках канала. | Число |
| **Дата начала** | Дата и время начала загрузки объектов для сессии импорта. | Дата/время |
| **Дата начала обработки** | Дата и время начала обработки загруженных объектов. | Дата/время |
| **Дата завершения** | Дата и время завершения обработки загруженных объектов. | Дата/время |
| **Количество объектов** | Количество объектов, загруженных для обработки в сессии. | Число |
| **Состояние** | Состояние сессии импорта. | Ссылка |
| **Код ошибки сессии** | Дополнительный статус ошибки. | Ссылка |
| **Количество обработанных объектов** | Количество обработанных объектов. Для завершенной сессии должно соответствовать количеству загруженных объектов. | Число |
| **Количество ошибок** | Количество объектов, при импорте которых произошли ошибки. | Число |

Возможные состояния сессии импорта: **В ожидании**, **Загрузка данных в шлюзы**, **В ожидании обработки шлюзов**, **Обработка шлюзов**, **Завершена обработка**, **Прервано с ошибкой**.

### Атрибуты сессии экспорта

| Поле | Описание | Тип данных |
|---|---|---|
| **Индикатор** | Цветовой индикатор состояния сессии. Зеленый цвет означает завершение без ошибок, красный — ошибку сессии или ошибку обработки одного из экспортируемых объектов. | Индикатор |
| **Идентификатор** | Уникальный идентификатор сессии. | Число |
| **№** | Номер сессии экспорта по порядку в рамках канала. | Число |
| **Дата начала** | Дата и время начала выгрузки подписанных объектов. | Дата/время |
| **Дата завершения** | Дата и время завершения экспорта подписанных объектов. | Дата/время |
| **Состояние** | Состояние сессии экспорта. | Ссылка |
| **Код ошибки сессии** | Дополнительный статус ошибки. | Ссылка |
| **Количество подписанных объектов** | Количество объектов, подписанных на экспорт в рамках выбранного канала. | Число |
| **Количество ошибок** | Количество объектов, экспорт которых завершился ошибкой. | Число |

Возможные состояния сессии экспорта: **В ожидании**, **Подписка**, **В ожидании начала подготовки данных**, **Подготовка данных**, **В ожидании подготовки приемником**, **Завершена обработка**, **Прервано с ошибкой**, **Завершено, изменений нет**.

## Лог сессии и импорт

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

### Лог сессии

Лог сессии фиксирует основные этапы импорта или экспорта. Если на одном из этапов произошла критическая ошибка, которая прервала обработку, она также отображается в логе. Лог сессии обычно проверяется первым: он показывает общий ход обработки до перехода к детализации по объектам.

Пример лога сессии импорта:

![](img/rpl_monitor_import_session_log.jpg)

Пример лога сессии экспорта:

![](img/rpl_monitor_export_session_log.jpg)

### Лог импорта

Вкладка **Лог импорта** показывает обработанные сообщения импорта: успешно загруженные объекты и объекты, которые не были загружены из-за ошибок.

По умолчанию отображаются только сообщения с ошибками. Чтобы увидеть все сообщения, снимите признак **Отображать только ошибки** на панели фильтрации.

| Поле | Описание | Тип данных |
|---|---|---|
| **Тип ошибки** | Тип ошибки, возникшей при обработке объекта. | Текст |
| **Текст ошибки** | Текст ошибки. | Текст |
| **Объект** | `gid` загруженного объекта. | Текст |
| **Класс-шапка бизнес-объекта** | Системное имя основного класса загруженного бизнес-объекта. | Текст |
| **Дата и время обработки** | Дата и время завершения обработки объекта. | Дата |
| **Стек ошибки** | Полный стек ошибки. Также выводится в детализации выбранной строки. | Текст |
| **Заголовок объекта** | Заголовок загруженного объекта. | Текст |
| **Мнемокод объекта** | Мнемокод загруженного объекта. | Текст |

Операция **Скачать XML** позволяет скачать обработанный XML-файл. Операция поддерживает множественный выбор строк. Для больших сообщений текст XML в детализации может отображаться частично, чтобы снизить нагрузку на систему.

### Сводные данные

Вкладка **Сводные данные** показывает результаты импорта в разрезе классов системы. Она используется для быстрой оценки результата сессии: сколько объектов обработано успешно и по каким классам возникли ошибки.

| Поле | Описание | Тип данных |
|---|---|---|
| **Мнемокод класса** | Системное имя класса. | Текст |
| **Заголовок класса** | Наименование класса. | Текст |
| **С ошибками** | Количество объектов, при загрузке которых возникли ошибки. | Число |
| **Успешно** | Количество успешно загруженных объектов. | Число |
| **Всего объектов** | Общее количество объектов, по которым выполнялся импорт. | Число |
| **Произошли ошибки** | Признак наличия ошибок по объектам класса. | Логический |

### Принятые объекты

Вкладка **Принятые объекты** показывает успешно принятые объекты для выбранной сессии импорта. По этим строкам можно проверить, какие записи были созданы или обновлены в Global ERP.

| Поле | Описание | Тип данных |
|---|---|---|
| **Заголовок класса** | Системное имя класса. | Текст |
| **Заголовок объекта** | Заголовок загруженного объекта. | Текст |
| **Мнемокод объекта** | Мнемокод объекта. | Текст |
| **gid объекта** | `gid` загруженного объекта. | Текст |

### Ошибки при обработке

Вкладка **Ошибки при обработке** показывает объекты, при загрузке которых произошли ошибки. Для анализа обычно используются текст ошибки, стек ошибки, класс и `gid` объекта.

| Поле | Описание | Тип данных |
|---|---|---|
| **Заголовок класса** | Системное имя класса. | Текст |
| **Заголовок объекта** | Заголовок загружаемого объекта. | Текст |
| **Мнемокод объекта** | Мнемокод загружаемого объекта. | Текст |
| **gid объекта** | `gid` загружаемого объекта. | Текст |
| **Текст ошибки** | Текст ошибки. | Текст |
| **Стек ошибки** | Полный стек ошибки. | Текст |

### Сообщения, превысившие лимит ошибок

Вкладка показывает сообщения, по которым было выполнено максимальное количество попыток импорта. Каждая сессия импорта, в которой обрабатывалось сообщение, считается одной попыткой. Максимальное количество попыток настраивается в канале информационного обмена.

Перед повторной обработкой таких сообщений определяется причина ошибки в логе импорта или в ошибках обработки.

| Поле | Описание | Тип данных |
|---|---|---|
| **Источник** | `gid` объекта, который должен был быть обновлен при успешной загрузке сообщения. Если объект ранее не создавался, поле не заполняется. | Текст |
| **Очередность** | Номер сообщения в очереди. Присваивается при загрузке сообщения в систему. | Число |
| **Дополнительная информация** | Дополнительная информация по сообщению, если она предусмотрена обработкой конкретного канала. | Текст |
| **GUID входящего сообщения** | GUID входящего сообщения. | Текст |
| **Количество ошибок** | Количество попыток загрузки, выполненных в рамках сессий импорта. | Число |

## Экспорт в мониторе интеграции

Для сессий экспорта в мониторе отображаются лог экспорта, подписанные объекты и ошибки подписки на канал. Эти вкладки используются для проверки того, какие объекты были подготовлены к отправке, какие успешно обработаны и где возникли ошибки.

### Лог экспорта

Вкладка **Лог экспорта** показывает объекты, обработанные при экспорте. В списке отображаются как успешно экспортированные объекты, так и объекты, выгрузка которых не состоялась из-за критической ошибки. Если внешний контур не получил данные, проверка обычно начинается с этой вкладки и лога сессии экспорта.

По умолчанию отображаются только сообщения с ошибками. Чтобы увидеть все сообщения, снимите признак **Отображать только ошибки** на панели фильтрации.

| Поле | Описание | Тип данных |
|---|---|---|
| **Тип ошибки** | Тип ошибки, возникшей при экспорте объекта. | Текст |
| **Текст ошибки** | Текст ошибки. | Текст |
| **Объект** | `gid` экспортируемого объекта. | Текст |
| **Класс-шапка бизнес-объекта** | Системное имя основного класса экспортируемого бизнес-объекта. | Текст |
| **Дата и время обработки** | Дата и время завершения выгрузки объекта. | Дата |
| **Стек ошибки** | Полный стек ошибки. | Текст |

### Подписанные объекты

Вкладка **Подписанные объекты** показывает объекты, подписанные на экспорт. Для сессии в состоянии **Завершена обработка** отображаются объекты, подписанные на экспорт в рамках этой сессии. Для сессии в состоянии **Неотправленные данные** отображаются объекты, которые еще ожидают экспорта.

| Поле | Описание | Тип данных |
|---|---|---|
| **Объект** | `gid` объекта, подписанного на экспорт. | Текст |
| **Класс-шапка бизнес-объекта** | Класс, который является основным для подписанного на экспорт бизнес-объекта. | Текст |
| **Действие** | Действие в базе данных, которое стало триггером подписания объекта на экспорт: `UPDATE`, `DELETE` или `INSERT`. | Текст |

### Ошибки подписки на канал

Вкладка **Ошибки подписки на канал** показывает объекты, при подписании которых на канал произошли ошибки. Вкладка отображается только для сессии экспорта со значением **Неотправленные данные** в поле **Состояние**. Ошибки на этой вкладке относятся к этапу подготовки объекта к экспорту, а не к отправке сообщения во внешнюю систему.

| Поле | Описание | Тип данных |
|---|---|---|
| **Дата** | Дата и время попытки сформировать сообщение на экспорт. | Дата/время |
| **Класс** | Системное имя класса. | Текст |
| **Наименование класса** | Наименование класса. | Текст |
| **Объект** | `gid` объекта, для которого выполнялась попытка сформировать сообщение на экспорт. | Текст |
| **Текст ошибки** | Текст ошибки. | Текст |
| **Ошибка генерации XML** | Стек ошибки. | Текст |