 Если название события начинается со слова "Перед...", то привязанные к такому событию пакеты действий могут быть отменены. Для этого в пакете действий должно присутствовать действие "Отменить". Такие привязки могут использоваться для реализации запрета действия при выполнении или не выполнении какого-то условия. Например, нельзя понизить приоритет задачи, если ее заказчик — генеральный директор организации.
|
В событиях, связанных с затратами ресурсов, используются контекстные параметры "Исполнитель (пользователь)" и "Исполнитель (задача)". Параметр "Исполнитель (пользователь)" используется для внесения затрат по сотруднику; в этом параметре передается ID пользователя, по которому вносятся затраты. Параметр "Исполнитель (задача)" используется для внесения затрат по ресурсу; в этом параметре передается ID задачи из Справочника ресурсов (раздел "Системный").
|
Глобальные
Глобальные события доступны только в разделе Общие SMART.
Событие возникает, если была изменена схема данных ДП "Таблица".
Параметр события:
•ID категории, в которой была выполнена денормализация ДП "Таблица" |
Событие возникает при изменении настроек ДП в интерфейсе администрирования системы.
Параметр события:
•@ExtParamID — ID ДП, для которого были изменены настройки. |
Событие возникает при изменении настроек ДП в категории в интерфейсе администрирования системы.
Параметр события:
•@ExtParamID — ID ДП, для которого были изменены настройки. •@SubcatID — ID категории, в которой были изменены настройки ДП. |
Событие возникает, когда смарт-расписание отрабатывает с ошибкой.
Параметры события:
•ID категории (NULL, если смарт-расписание общее) •ID задачи (NULL, если расписание вне контекста задач) •ID пакета действий •ID привязки пакета к расписанию •Текст ошибки |
Событие возникает при изменении встречи в календаре.
Параметры события:
•ID пользователя (@eventParam0) •ID подписки (@eventParam1) •Ключ события (@eventParam2) •Событие удалено (@eventParam3) •Вложенные события (@eventParam4) |
Событие возникает при создании встречи.
Параметры события:
•ID пользователя (@eventParam0) •ID подписки (@eventParam1) •Ключ события (@eventParam2) •Вложенные события (@eventParam3) |
ДП и свойства задачи
Инициируется при вычислении значения ДП по умолчанию.
В качестве параметров события передаются параметры текущей задачи.
|
Если событие вызывается для ДП типа "Файл" и пакет содержит действие "Отмена", то файл нельзя загрузить, заменить или удалить, но внести изменения в существующий файл можно. Для ограничения редактирования используйте событие "Перед редактированием файла"
|
Приоритеты имеют численные эквиваленты: низкий приоритет — 0; обычный — 1; высокий — 3
|
•Перед сменой текста задачи
•Перед сохранением значений в строке ДП Таблица
В качестве параметров события передаются ID задачи, ID строки, а также старое и новое значения строки в формате JSON.
|
•После прохождения опроса
•После смены ДП
Приоритеты имеют численные эквиваленты: низкий приоритет — 0; обычный — 1; высокий — 3
|
•После смены текста задачи
•После сохранения значений в строке ДП Таблица
Другое
Инициируется при установке настройки категории "Специальные пользователи".
В качестве параметров события передаются:
•ID пользователя (@eventParam0) •ID категории (@eventParam1) |
Инициируется при установке настройки категории "Ограничить исполнителей смарт-выражением".
В качестве параметров события передаются:
•ID пользователя (@eventParam0) •ID категории (@eventParam1) •№ задачи (@eventParam2) •№ задачи ресурса (@eventParam3) |
•При произвольном событии
Задачи и комментарии
Доступны параметры события:
•JSON с массивом дат, трудозатрат на дату и комментариев •пользователь, осуществляющий действие •номер задачи передается в контекстном параметре @ContextID |
•Перед написанием комментария
Обрабатывает отправку уведомлений "в конверт" (увеличивающих счетчик индикатора непрочитанных комментариев) и push-сообщений для мобильных приложений. В настройках события нужно выбрать тип уведомления, которое будет обрабатываться событием. Возможные типы соответствуют настройкам получаемых уведомлений и push-сообщений в профиле пользователя. К событию может быть привязан пакет с действием "Отменить". Таким образом можно дополнительно регулировать отправку уведомлений и push-сообщений для категории.
Оба механизма вместе — настройки профиля пользователя и обработка события "Перед отправкой уведомления" в категории — позволяют гибко настраивать отправку уведомлений и push-сообщений: на уровне пользователей (с помощью настроек профиля), категорий, а также условий смарт-фильтра в событии (в нем могут дополнительно проверяться, например, принадлежность к группе пользователей или роль пользователя в задаче — заказчик, исполнитель, подписчик)
|
Смарт-пакет, привязанный к этому событию, отрабатывает в контексте исходной категории (в отличие от события "Перед постановкой и переносом задачи", которое обрабатывается в контексте целевой категории).
|
Смарт-пакет, привязанный к этому событию, отрабатывает в контексте целевой категории (в отличие от события "Перед переносом задачи из категории", которое обрабатывается в контексте исходной категории).
При настройке события отображается дополнительное поле "Значение". Оно может принимать одно из трех значений:
•Активно при постановке и переносе (по умолчанию), •Активно только при постановке, •Активно только при переносе. |
•Перед удалением задачи
Инициируется в категориях с включенным режимом "Последовательное выполнение подзадач" или в проектных задачах. Событие возникает для связей типа StartToFinish или StartToStart (когда связанная подзадача переходит из состояния "Новая" ), а также для связей типа FinishToStart или FinishToFinish (когда связанная подзадача переходит в статус "Завершена").
Для подзадач последовательного выполнения всегда проставляется связь FinishToStart.
Для обычных связей между задачами событие не возникает
|
•После изменения фактических трудозатрат
Инициируется после простановки очередного "лайка" при включенном режиме "Лайки" в настройках категории в блоке "Счетчики"
|
•После написания комментария
•После постановки задачи
Заказчики, исполнители, подписчики
•Перед добавлением подписчика
•Перед назначением исполнителя
•Перед сменой заказчика
•Перед сменой ответственного
•Перед удалением исполнителя
•После назначения исполнителя
•После смены заказчика
•После смены ответственного
•После удаления исполнителя
Маршруты, переходы
•Перед переходом
Следует помнить, что принудительная смена статуса отличается от обычной — при принудительной смене статуса все сопутствующие автоматизации (запросы подписей, процедуры проверки и изменения значений ДП и т.д.) не выполняются
|
•После перехода
Следует помнить, что принудительная смена статуса отличается от обычной — при принудительной смене статуса все сопутствующие автоматизации (запросы подписей, процедуры проверки и изменения значений ДП и т.д.) не выполняются
|
Следует помнить, что принудительная смена статуса отличается от обычной — при принудительной смене статуса все сопутствующие автоматизации (запросы подписей, процедуры проверки и изменения значений ДП и т.д.) не выполняются
|
Подписи
•Перед акцептом подписи
•Перед делегированием подписи
•Перед запросом динамической подписи
•Перед запросом подписи на переходе
•Перед началом этапа согласование
•Перед отзывом подписей
•Перед отклонением подписи
•Перед удалением подписи
•Перед эскалированием подписи
•После делегирования подписи
•После завершения этапа согласования
•После запроса обязательных подписей на этапе согласования
•После запроса подписи на переходе
Инициируется заданием OverdueSignaturesJob, которое запускается по расписанию
|
•После отзыва подписи
•После отклонения статической подписи
•После подписания статической подписи
•После удаления динамической подписи
•После эскалирования динамической подписи
Пользователи
События, связанные с обработкой учетных записей пользователей, доступны только в разделе Общие SMART.
•Во время открытия профиля пользователя
•После изменения пользователя
•После создания пользователя
•После удаления пользователя
•После восстановления пользователя
Ресурсное планирование
Контекстный параметр "Дата" — это массив дат. Получить значение даты в смарт-выражении можно так:
OPENJSON ( JSON_QUERY ( @eventParam3, '$' )
|
•Перед блокировкой фактических трудозатрат
Событие возникает перед изменением значения в колонке "План" в блоке "Ресурсы".
Параметры события:
•задача, в которой выполняются изменения; •пользователь, от имени которого выполняется действие; •инициатор действия, вызвавшего событие — возможные значения Plan (прямое изменение плана из интерфейса), Performers (действия над исполнителями), Automation (смарт-автоматизация); •ресурс, по которому изменяется план; •дельта (абсолютная разница общих планов до и после в минутах) |
Событие возникает перед изменением значения в колонке "Исполнитель" в блоке "Ресурсы".
Параметры события:
•задача, в которой выполняются изменения; •пользователь, от имени которого выполняется действие; •ресурс, по которому изменяется план; •исполнитель-пользователь, для которого меняется план; •исполнитель-задача (для внешних ресурсов и материальных объектов); •дельта (абсолютная разница общих планов до и после в минутах) |
•Перед разблокированием фактических трудозатрат
Контекстный параметр "Дата" — это массив дат. Получить значение даты в смарт-выражении можно так:
OPENJSON ( JSON_QUERY ( @eventParam3, '$' )
|
Контекстный параметр "Дата" — это массив дат. Получить значение даты в смарт-выражении можно так:
OPENJSON ( JSON_QUERY ( @eventParam3, '$' )
|
•После блокировки фактических трудозатрат
Событие возникает после изменения значения в колонке "План" в блоке "Ресурсы".
Параметры события:
•задача, в которой выполняются изменения; •пользователь, от имени которого выполняется действие; •инициатор действия, вызвавшего событие — возможные значения Plan (прямое изменение плана из интерфейса), Performers (действия над исполнителями), Automation (смарт-автоматизация); •ресурс, по которому изменяется план; •дельта (абсолютная разница общих планов до и после в минутах) |
Событие возникает после изменения значения в колонке "Исполнитель" в блоке "Ресурсы".
Параметры события:
•задача, в которой выполняются изменения; •пользователь, от имени которого выполняется действие; •ресурс, по которому изменяется план; •исполнитель-пользователь; •исполнитель-задача (для внешних ресурсов и материальных объектов); •дельта (абсолютная разница общих планов до и после в минутах) |
Событие возникает только после добавления нового планового ресурса в блок "Ресурсы" в карточке задачи. При изменении существующего значения плана событие не возникает.
Параметры события:
•задача, в которой выполняются изменения; •пользователь, от имени которого выполняется действие; •инициатор действия, вызвавшего событие — возможные значения Plan (прямое изменение плана из интерфейса), Performers (действия над исполнителями), Automation (смарт-автоматизация); •действие — AddResource (добавление ресурса), DeleteResource (удаление неразыменованного ресурса), AddPerformer (добавление исполнителя), DeletePerformer (удаление исполнителя); •ресурс (задача из системного справочника ресурсов); •исполнители-пользователи (список пользователей) — если действие выполняется над неразыменованным ресурсом, то в списке перечисляются все исполнители по этому ресурсу, если действие над исполнителем — то все добавленные\удаленные исполнители; •исполнители-задачи (список задач) — аналогично исполнителям-пользователям (для внешних ресурсов и материальных объектов).
Параметры смарт-события "После изменения плановых ресурсов".
Например, для формирования списка исполнителей-пользователей может использоваться такое смарт-выражение:
Смарт-выражение для формирования списка исполнителей-пользователей.
|
•После разблокировки фактических трудозатрат
Контекстный параметр "Дата" — это массив дат. Получить значение даты в смарт-выражении можно так:
OPENJSON ( JSON_QUERY ( @eventParam3, '$' )
|
Связи и подзадачи
•Перед добавлением подзадачи
•Перед назначением подзадачей
•Перед созданием связи между задачами
•Перед удалением подзадачи
•Перед удалением родительской
•Перед удалением связи между задачами
•После добавления подзадачи
•После назначения подзадачей
•После создания связи между задачами
•После удаления подзадачи
•После удаления родительской
•После удаления связи задач
Сроки и даты
За обработку этого события отвечает специальное задание, которое выполняется раз в минуту. Поэтому пакет действий, привязанный к этому событию, срабатывает как только срок выполнения задачи становится меньше текущего времени на сервере "Первой Формы"
|
•Перед изменением даты планового начала задачи
Параметр "Дата планового окончания задачи" выводится из использования, вместо него используется параметр "Срок". На переходный период данное смарт-событие возникает при изменении срока задачи, впоследствии оно также будет выведено из использования. Рекомендуется вместо него использовать смарт-событие "Перед сменой срока"
|
•Перед изменением даты фактического окончания задачи
•Перед сменой даты начала работы
•Перед сменой срока
•После изменения даты планового начала задачи
Параметр "Дата планового окончания задачи" выводится из использования, вместо него используется параметр "Срок". На переходный период данное смарт-событие возникает при изменении срока задачи, впоследствии оно также будет выведено из использования. Рекомендуется вместо него использовать смарт-событие "После смены срока"
|
•После изменения даты фактического окончания задачи
•После смены даты начала работы
•После смены срока
•После установки повторения
Файлы
Файл может вкладываться только в задачу, а не в ДП типа "Файл". Событие автоматически вызывается при завершении процесса редактирования файла через WebApps
|
•Перед вложением файла
Событие возникает в момент открытия файла на просмотр в WebDAV и WebApps. Совместно с действием "Отмена" используется для ограничения возможности редактирования файла. В этом случае в смарт-фильтре нужно указать, кто не должен редактировать файл. Для определения прав нужно пользоваться параметром события "Редактирующий пользователь" (а не "Текущий пользователь").
При открытии файла в WebApps не будут отображаться кнопки для сохранения файла, а в WebDAV будет отображаться сообщение о том, что файл заблокирован и может быть открыт только для чтения:
Сообщение о блокировании файла.
В случае отмены события файл будет открываться только на чтение вне зависимости от прав пользователя.
Событие возникает при редактировании файлов, вложенных как в ДП "Файл", так и непосредственно в задачу. Поэтому в смарт-фильтре нужно указывать, какой именно файл редактируется. Для этого используется параметр "Редактируемый файл"
|
•Перед удалением файла
•После добавления новой версии файла
•После изменения содержимого файла (без изменения версии)
Полезные ссылки
Управление ресурсами. Справочник ресурсов
Общие SMART
Изменение настроек ДП
Изменение настроек ДП в категории
