Бизнес-события в 1С:Документооборот

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

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


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

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

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


Детекторы используются для того, чтобы обнаруживать события. Как только детектор «сработал», записывается новое бизнес-событие. Затем новое бизнес-событие в соответствии с подписками на него будет обработано специальными обработчиками.Обработка одного события происходит в границах одной транзакции. После успешной обработки событие получает статус Задание выполнено. Если событие обработано с ошибками, программа предпримет попытку обработать его несколько раз, а затем удалит, если исправить эту ошибку окажется невозможным. Если хоть один обработчик событий завершит свою операцию с ошибкой, то обработка всех событий и все действия других обработчиков будут отменены. Во всех случаях информация о результатах обработки будет записана в журнал регистрации.
По необработанным событиям будет произведена попытка выполнения обработчиков 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. Создать дополнительный обработчик. Установить у обработчика флаг «Обработчик включен». Настроить у обработчика подписку на событие.

Привязка запуска шаблона процесса к типовому событию

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

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



На закладке «Автоматический запуск» указываем событие «Создание внутреннего документа».

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

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

Дополнительный обработчик типового события

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

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

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

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

6 комментариев:

  1. Анонимный29 июня 2017 г., 17:39

    Добрый день!
    Простите, что не совсем по теме, но все же:
    Документооборот 8 КОРП, редакция 1.4 (1.4.9.4) - подскажите, пожалуйста, можно ли запретить для определенных видов Внутренних документов (договоров) запуск произвольных процессов (не по шаблону)?

    ОтветитьУдалить
    Ответы
    1. В типовом варианте нельзя. Нужна доработка.

      Удалить
    2. Анонимный30 июня 2017 г., 9:15

      Владимир, спасибо!
      Скажите, пожалуйста - существует ли такая возможность в типовом варианте более новых релизов?

      Удалить
    3. Пока о таких планах не известно...

      Удалить
  2. Добрый день.
    Пока нигде не встречал функционала по исполнению договоров с применением бизнес-событий, когда, очередной платеж зависит, например, от даты отгрузки, пересечения границы, поступления товара на склад заказчика и т.д и т.п.,то есть от некоторого события, описанного в договоре. Более того, условия и поставки и оплаты могут быть описаны в договоре по достаточно сложной схеме, когда очередной этап поставки и/или оплаты зависит от некоторого события, соответственно, в зависимости от этих событий должны запускаться бизнес-процессы для менеджеров и исполнителей по данному договору. Есть ли у Вас такой опыт внедрения системы исполнения договоров?

    ОтветитьУдалить
  3. Добрый день, Владимир! Не знала, где написать Вам, в каком разделе. Поэтому пишу здесь. Прошу подсказать: почему может не приниматься почта? Поток подвисает и все.. Как с этим бороться? Потоки менять пробовала - не помогает. Пробовала удалить и заново прописать. Он все равно выделяется красным.Тоже не помогает. Очень срочно нужна помощь. Спасибо. Анна.

    ОтветитьУдалить