IE2017

Создание пользовательских уведомлений (бизнес-событий) в 1С: Документооборот, редакция 1.3

Программирование - Практика программирования

В этой статье я хочу рассказать метод создания собственных-пользовательских уведомлений (бизнес-событий) в конфигурации 1С: Документооборт.

Зачем это нужно?

Хороший вопрос :) Например, в организации возникла потребность оповещать пользователей документооборота на которых была(и) назначена задача и которые не приняли ее в работу в течении 1 часа. Соответственно оповещать необходимо через почту, т.е. отправлять на почту уведомления.

Это один из случаев при котором необходимо добавить в систему 1С: Документооборот новое бизнес-событие и обработать его, результатом обработки станет отправка уведомления на почту пользователя.

Итак приступим!

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


Например, добавим новое бизнес-событие "На вас назначена задача", которое будет создаваться, если пользователь не берет в работу задачу больше часа.


Теперь нужно добавить "Детектор бизнес-события". Детектор бизнес-события - это как раз тот инструмент, который отслеживает события в программе. Например, он может зарегистрировать новое бизнес-событие, если число активных пользователей превышает 50 или в определенном каталоге на диске появились новые файлы или если пользователь не берет в работу задачу более часа и т.п.

Добавим новый детектор бизнес-события.


В нем можно написать выражение на встроенном языке и если в выражении указать Результат = Истина, то система после выполнения автоматически создаст новое бизнес событие. Если же вы не хотите чтобы программа сама создала бизнес-событие, то можно указать Результат = Ложь и в коде (в выражении или в конфигурации) вызвать процедуру 

БизнесСобытияВызовСервера.ЗарегистрироватьСобытие()
 
Для того, чтобы система отслеживала новые события предусмотрено регламентное задание "Обработка детекторов бизнес-событий". Это задание исполняется один раз в минуту и выполняет все детекторы событий с флагом Включен.


Для обработки бизнес-события в программе предусмотрены "Дополнительные обработчики-бизнес событий". Далее просто приведу текст из справки 1С:

Обработчики бизнес-событий обрабатывают события, которые были созданы детекторами. Например, детектор зафиксировал, что число активных пользователей превышает 50 и создал событие, затем обработчик стартовал процесс Ознакомление для администратора.


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


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


Обработчик бизнес-события и бизнес-событие должны быть связанны между собой.


Вот таким образом в системе 1С: Документооборот добавляются новые бизнес-события!

См. также

Комментарии
1. Наталья Резникова (natarezn) 30.07.14 10:44 Сейчас в теме
Хочется как в штатах как в астериксе. модно и нелепо. с закрытием кода. Такое возможно ?
2. anton_sh 36 03.08.14 22:19 Сейчас в теме
Можно и как в астериксе, почему бы и нет ;)! Можете, например, создать собственный общий модуль закрытый, и в выражении (в детекторе или в доп. обработчике) обратиться к нужно процедуре или функции, которая будет возвращать лишь результат Истина или Ложь. Так же можно визуально скрыть код, дописав конфигурацию.
3. ivdic (ivdic) 30 28.10.14 14:16 Сейчас в теме
Можно ли как настроить не уведомление на почту а внутренее встплывающее уведомление как события в календаре?
4. Игорь Steelvan (Steelvan) 30 12.11.14 11:13 Сейчас в теме
(1) natarezn,

А в штатах всегда все через одно место.
У них и производства даже своего нет, все делают китайцы.
Только наклейки клеят и нам привозят. Made in China заклеивают на Made in USA (Тьфу).
5. lefthander lefthander (lefthander) 26.12.14 11:30 Сейчас в теме
Можно ли таким образом настроить уведомление на почту события календаря?
Oksana92; +1 Ответить
6. Алексей Стрельцов (lexxgod) 15.02.15 17:04 Сейчас в теме
Здравствуйте!
Не получается настроить уведомления о новых задачах пользователей!!!

Версия Документооборот 8, КОРП 1,3
Системная учетная запись проверку проходит - письмо пришло.
Напрямую письмо пользователю тоже приходит. А вот уведомления о новой задаче не приходит...
Подскажите, что может быть не так???

И еще вопрос! Можно ли как то настроить уведомления на почту, например при вводе документа в котором выбран этот пользователь?
7. Станислав Байковский (baykovsky) 17.02.15 19:48 Сейчас в теме
Ценность данной статьи близка к нулю, так как является всего лишь вольным пересказом контекстной справки программы.
Автору стоило привести несколько конкретных примеров с указанием кода обработчиков.
Raduga; logos; elisabet; badboychik; RaketaSoft; a.vavilchenko; +6 Ответить
8. KRIHA (KRIHA) 17.02.15 20:37 Сейчас в теме
Люди, извините что не в тему - помогите ответом на вопрос: можно ли в 1С:Документооборот в качестве исполнителя выбрать группу (или роль, или еще что) таким образом, что задача на исполнение приходит всем пользователям группы, но кто первый "схватил" и согласовал тот и собственно и завершает процесс согласования. Может быть я коряво написал - заранее приношу за это извинения.
9. Tatiana Snetkova (Kotovskij) 23.02.15 18:15 Сейчас в теме
(8) KRIHA,
выбрать группу пользователей нельзя, роль - да.

что касается "но кто первый "схватил"" - используйте механизм принятия задач к исполнению (принятая к исполнению ролевая задача становится персональной), либо достаточно просто исполнить задачу каким-либо из исполнителей ролей, чтобы она стала "персональной" (при выполнении задачи отметка о принятии к исполнению устанавливается автоматически)

не забудьте назначить исполнителей в регистре "Исполнители ролей"
10. Алексей Стрельцов (lexxgod) 24.02.15 14:36 Сейчас в теме
(6) lexxgod,
Подскажите пожалуйста кто нибудь!!!
Так и не получается настроить уведомления о новых событиях на почту...
Что еще нужно сделать?
11. Olga Golubeva (Raduga) 30.08.16 16:33 Сейчас в теме
(10) lexxgod:
1. В Настройках программы: флаги Использовать уведомления и Использовать бизнес-события
2. Настроить системную почтовую учетную запись (это видимо есть) - Настройка и Администрирование - Учетные записи
3. Настроить уведомления по умолчанию (в частности - для новых задач) - Настройка и Администрирование - Общие - Использовать уведомления - Настройка
4. Ввести адреса для уведомлений (по умолчанию должны браться из карточек пользователей) - Настройка и Администрирование - Общие - Использовать уведомления - Настройка - Адреса уведомлений
5. Включить регл. задания:
- «Обработка произошедших бизнес-событий»
- «Уведомление пользователей о произошедших событиях»


12. Алексей Мельников (Taliesien) 29.09.16 19:46 Сейчас в теме
Какова ценность данного инструмента? Насколько я понял это извращённый вариант регламентного задания? Что мешает просто настроить регламент, без этих плясок? Или я упустил какие-то преимущества?
На мой взгляд единственное преимущество, не надо редактировать конфу и всё...
Оставьте свое сообщение