Обработчик ошибок

Рисунок 1. Пиктограмма функции

Общее описание функции

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

Эта функция позволяет:

Производить фильтрацию ошибок по коду.
Контролировать количество возникших ошибок.
Останавливать бизнес-процесс по ошибке.

Сценарии использования

Можно предложить два сценария использования функции обработчика ошибок. При необходимости сценарии могут совмещаться:

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

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

Настройка параметров

Рисунок 2. Окно "Обработчик ошибок". Вкладка "Параметры"

Вкладка Параметры окна свойств функции содержит следующие поля:

Допустимое число вхождений в функцию

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

Фильтровать ошибки по коду

Позволяет задать допустимый код ошибки.

Переменная с кодом ошибки

Переменная, в которую каким-либо способом заносится код ошибки, возникшей в проблемной функции (обычно указывается в свойствах проблемной функции на вкладке Общие в поле Переменная для кода ошибки).

При достижении заданного числа ошибок

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

Завершиться с ошибкой.
Выполнить функцию по связи — в этом поле выбирается одна из функций, к которым проведены исходящие связи от функции обработчика ошибок. При этом в поле будет указано название функции, к которой будет переходить управление после функции обработчика ошибок. Также будет указано имя связи между ними (если оно было указано).