Руководство пользователя Реестра Сервисов

6.Администрирование.

6.9.Управление справочником «Политики обработки ошибок».

Справочник «Политики обработки ошибок» предназначен для централизованного определения правил реакции системы на возникающие ошибки при выполнении сервисов. Каждая политика содержит набор правил, которые определяют, как система должна вести себя при возникновении конкретных ситуаций (например, таймаут, недоступность системы, ошибка валидации данных).

Область «Управление справочником «Политики обработки ошибок»» содержит все используемые в Реестре политики обработки ошибок. Кнопка «Создать политику» создаёт новую политику обработки ошибок.

После создания новой политики обработки ошибок, она появляется в списке политик обработки ошибок.

**Рисунок 103**Список политик обработки ошибок после добавления новой политики.

После нажатия на её название, открывается список правил политики обработки ошибок.

Каждая политика состоит из двух уровней: заголовка и правил обработки ошибок.

Заголовок политики содержит общие настройки, описанные в таблице 44.

**Таблица 44**Заголовок политики.
Поле	Тип	Заполнение	Описание
Название политики	Текстовое поле	Обязательное	Уникальное название, например: «Политика обработки таймаутов». Максимальная длинна поля: 200 символов.
Сервисы	Кнопка	Автоматическое	Осуществляет переход на вкладку «Сервисы» с фильтрацией/выборкой сервисов, в которых применяется данная политика обработки ошибок.
Использовать по умолчанию	Чек-бокс	Необязательное	Если включено, то политика становится политикой по умолчанию для новых сервисов. В системе может быть только одна политика по умолчанию.
Время хранения сообщений в DLQ	Числовое поле	Обязательное	Время хранения сообщений в очереди недоставленных сообщений (DLQ) в минутах.
Действие по умолчанию	Выпадающий список	Обязательное	Действие, применяемое ко всем ошибкам, для которых не задано специальное правило. Возможные значения: пропуск; повтор. Если выбран повтор, то применяются параметры по умолчанию: пауза 1 минута, 10 попыток с экспоненциальной задержкой. Параметры настраиваются пользователем самостоятельно в режиме редактирования правила «повтор».

Важно! Несмотря на пояснительный текст в интерфейсе, система не устанавливает параметры по умолчанию автоматически. При создании правила с действием «повтор» необходимо вручную указать:

количество попыток (до 10);
паузу между попытками в секундах (кратно 60);
включить экспоненциальную задержку (да/нет).

Каждая политика может содержать множество правил. Каждое правило настраивается отдельно. Поля настройки правил приведены в таблице 45.

**Таблица 45**Правила обработки ошибок.
Поле	Тип	Заполнение	Описание
Код ошибки	Текстовое поле	Обязательное	Конкретный код ошибки. Пользовательские коды обозначения ошибок выполнения. Определяются администратором. Максимальная длинна поля: 100 симоволов.
Действие	Выпадающий список	Обязательное	Определяет реакцию на ошибку: пропуск — игнорировать ошибку; повтор — повторить операцию.
Описание	Текстовое поле	Необязательное	Пояснение правила для администратора. Максимальная длина поля: 200 символов.
Количество попыток	Числовое поле	Необязательное	Активно, если выбрано действие «Повтор». Показывает сколько раз повторять операцию.
Пауза между попытками, (в секундах, кратных 60)	Числовое поле	Необязательное	Активно, если выбрано действие «Повтор». Интервал ожидания между попытками. Значение должно быть кратно 60 секундам. При попытке ввести некратное значение, система пересчитывает значение в большую сторону до кратного числа.
Экспоненциальная задержка	Выпадающий список	Необязательное	Активно, если выбрано действие «Повтор». Увеличивать ли паузу с каждой попыткой (Да/Нет)
Изменил	Логин пользователя	Автоматическое	Заполняется автоматически при сохранении/изменении записи на основании данных входа в систему соответствующего пользователя.
Дата	Дата и время	Автоматическое	Формат: ДД.ММ.ГГГГ ЧЧ:мм:сс.
Действия	Кнопки управления «Сохранить», «Отмена», «Удалить»	Автоматическое	Появляются при редактировании имеющихся записей. При создании новой записи кнопка «Отмена» неактивна.

Важно! Поля «Количество попыток», «Пауза между попытками» и «Экспоненциальная задержка» отображаются только если выбрано действие «Повтор».

Режимы работы.

Создание правила.

Нажмите кнопку «Создать правило» под таблицей, заполните обязательные поля и нажмите кнопку «Сохранить».

Редактирование политики/правила.

Для редактирования политики нажмите кнопку «Управление политикой (переименование, удаление)». После внесения правок нажмите кнопку «Сохранить».

Для редактирования правила кликните по любой ячейке строки с правилом. Доступны действия: «Сохранить», «Отмена», «Удалить».

Удаление.

Удаление политики запрещено, если она используется хотя бы в одном сервисе. В этом случае Система вернёт ошибку.

**Рисунок 104**Список правил политики обработки ошибок.

Кнопка «Создать правило» создаёт новое правило политики обработки ошибок.

**Рисунок 105**Создание правила политики обработки ошибок.

После нажатия на кнопку «Управление политикой (переименование, удаление)» открывается управление политикой.

**Рисунок 106**Управление политикой обработки ошибок.

Редактирование имеющихся данных происходит аналогично.

**Рисунок 107**Редактирование имеющейся в справочнике политики обработки ошибок.

Кнопки редактирования появляются после нажатия на строку с данными.

Валидация и ограничения:

Уникальность названия: название политики должно быть уникальным в пределах справочника.
Обязательные поля: не допускается сохранение политики или правила с незаполненными обязательными полями.
Целостность данных: удаление политики, привязанной к сервисам, невозможно — Система выдаст ошибку выполнения.
Ошибки: в текущей версии вся валидация происходит на сервере. При нарушении правил заполнения полей пользователь получит техническую ошибку (например, size must be between… или ConstraintViolationException) при попытке сохранения данных.

Рекомендации:

используйте понятные названия для политик, отражающие их назначение;
для критически важных операций настройте правило с действием повтор;
для второстепенных операций достаточно действия пропуск;
не создавайте избыточное количество политик: это усложняет управление;
перед удалением политики убедитесь, что она не используется в сервисах (кнопка «сервисы» в заголовке политики позволяет быстро перейти к списку связанных сервисов).

Где в Реестре сервисов нужно выбирать политику обработки ошибок?

Созданные политики обработки ошибок выбираются в форме редактирования сервиса, в разделе «Реализация»:

Откройте или создайте сервис.
Перейдите во вкладку «Реализация», прокрутите форму в самый низ: поле «Политика обработки ошибок» находится сразу после блока «Регламент выполнения».
Выберите нужную политику из выпадающего списка.
Список политик загружается из справочника «Политики обработки ошибок», который находится в разделе «Администрирование». Выбранная политика определяет, как система будет реагировать на ошибки при выполнении сервиса: повторять попытки, фиксировать ошибку, отправлять уведомления и так далее.