Как использовать бизнес-события в 1С:Документооборот?

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

Для этих задач может хорошо подойти механизм бизнес-событий.
Бизнес-событие – это отражение факта, что произошло некоторое важное для организации событие, которое подтверждено изменением данных в информационной базе. И к таким событиям можно привязать обработчики на встроенном языке 1С.

Использование бизнес-событий в 1С:Документооборот в клиент-серверном варианте на живых примерах подробно рассмотрена в видеокурсе.

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

• детекторы событий (типовые и пользовательские), 
• реестр произошедших событий, 
• обработчики событий (типовые и пользовательские).

Детекторы используются для того, чтобы обнаруживать события. Как только детектор «сработал», записывается новое бизнес-событие. Затем новое бизнес-событие в соответствии с подписками на него будет обработано специальными обработчиками.Обработка одного события происходит в границах одной транзакции. После успешной обработки событие получает статус Задание выполнено. Если событие обработано с ошибками, программа предпримет попытку обработать его несколько раз, а затем удалит, если исправить эту ошибку окажется невозможным. 

Если хоть один обработчик событий завершит свою операцию с ошибкой, то обработка всех событий и все действия других обработчиков будут отменены. Во всех случаях информация о результатах обработки будет записана в журнал регистрации. По необработанным событиям будет произведена попытка выполнения обработчиков 3 раза. Необработанные бизнес-события будут храниться в регистре сведений «Произошедшие бизнес-события», чтобы администратор мог разобраться с причинами ошибок и устранить их. Обработанные бизнес-события будут храниться определенное кол-во дней (указывается в настройках программы), а потом будут удалены. Чтобы включить механизм бизнес-событий нужно в настройках программы активировать настройку «Использовать бизнес-события». Далее можно использовать типовые бизнес-события такие, как:

1. Возобновление процесса
2. Добавление в категорию
3. Завершение процесса
4. Задача выполнена
5. Захват файла для редактирования
6. Изменение брони
7. Изменение внутреннего документа
8. Изменение входящего документа
9. Изменение значения показателя процесса
10. Изменение исходящего документа
11. Изменение мероприятия
12. Изменение отсутствия
13. Изменение проекта
14. Изменение проектной задачи
15. Изменение состава комплекта
16. Изменение файла
17. Назначение ответственным за документ
18. Освобождение файла
19. Остановка процесса
20. Отмена выполнения задачи
21. Перенаправление задачи
22. Перерегистрация внутреннего документа
23. Перерегистрация входящего документа
24. Перерегистрация исходящего документа
25. Подошел срок задачи
26. Получение входящего письма
27. Прерывание процесса
28. Просрочена задача
29. Регистрация внутреннего документа
30. Регистрация входящего документа
31. Регистрация исходящего документа
32. Создание брони
33. Создание внутреннего документа
34. Создание входящего документа
35. Создание задачи
36. Создание исходящего документа
37. Создание контрагента
38. Создание мероприятия
39. Создание отсутствия
40. Создание проекта
41. Создание проектной задачи
42. Создание сообщения
43. Создание файла
44. Старт процесса

1. В справочнике «Виды бизнес-событий» добавить новое бизнес-событие.
2. Создать детектор для этого события. У детектора установить флаг «Детектор включен».
3. Создать дополнительный обработчик. Установить у обработчика флаг «Обработчик включен». Настроить у обработчика подписку на событие.

Рассмотрим самый простой вариант привязки типового обработчика к типовому событию.

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

Создадим новый документ. Открываем регистр сведений «Произошедшие бизнес-события». Видим, что наше событие пока не обработано.

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

Рассмотрим теперь более сложный случай привязки типового события к своему обработчику.

Создаем новый обработчик бизнес-события. Заполняем его наименование, описание и код обработки события. Устанавливаем флаг «Обработчик включен».

Указываем подписку для данного обработчика.

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

Поскольку к одному событию теперь привязано два обработчика, то возникает вопрос: в каком порядке будут выполняться обработчики? Порядок вызова обработчиков не определен, поэтому нужно при использовании нескольких обработчиков предусматривать все возможные порядки запуска.

Использование бизнес-событий в 1С:Документооборот в клиент-серверном варианте на живых примерах подробно рассмотрена в видеокурсе.