Подписки на события

Подписки на события позволяют назначать обработчики событий для одного или группы объектов встроенного языка.

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

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

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

Затем необходимо выбрать процедуру-обработчик события.

При наступлении события указанного события выполняется следующая последовательность действий:

• сначала отрабатывается событие в самом объекте и вызывается обработчик события, определенный в модуле объекта или набора записей;
• если в процессе выполнения обработчика параметр Отказ установлен в значение Истина или вызвано исключение, действие прерывается;
• затем вызываются в произвольном порядке внешние обработчики, назначенные для данного события;
• в качестве источника в назначенный обработчик передается сам объект (набор записей) вызвавший событие;
• если в процессе выполнения назначенного обработчика параметр Отказ установлен в значение Истина или вызвано исключение, действие прерывается.

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

Назначение обработчиков событий доступно также и средствами встроенного языка. Для этого используются операторы ДобавитьОбработчик и УдалитьОбработчик.