Событие "Наступление времени атрибута"

Описание настройки

Событие "Наступление времени атрибута" доступно для всех классов объектов, для которых выполняются действия по событию.

Это событие не является общим и доступно только для объектов одного класса, при попытке выбора более одного класса объектов или нескольких типов разных классов событие не доступно.

Событие "Наступление времени атрибута" означает, что действие по событию будет выполняться при:

Вариант начала отсчета времени относительно наступления события задается в параметре "Время действия относительно наступления события": за определенное время до наступления события, в момент наступления события или через определенное время после наступления события.

Для атрибутов типа "Дата" и "Дата/Время" момент наступления события определяется однозначно, для атрибутов типа "Счетчик времени (обратный)" — вычисляется с учетом класса обслуживания.

Для расчета параметра "Время действия относительно наступления события" применяются астрономические часы и календарные дни, а не рабочие часы.

Добавление действия по событию

Место в интерфейсе

Меню навигации "Настройка системы" → настройка "Действия по событиям".

Выполнение действия

На странице "Действия по событиям" нажмите кнопку Добавить действие, на форме добавления действия по событию заполните параметры и нажмите кнопку Сохранить.

Поля на форме добавления:

  • Название — название действия по событию, используемое в системе.
  • Код — уникальный код действия по событию. Значение заполняется автоматически (транслитерация названия, если поле "Название" заполнено), код можно изменить.
  • Описание — дополнительная информация о действии по событию и его назначении.

  • Объекты — классы/типы объектов, относительно которых совершается событие.

    Для выбора класса или типа установите флажок. При установке флажка у класса или типа флажки проставляются у всех вложенных типов. Флажки вложенных типов доступны для редактирования.

    При снятии флажка у класса или типа флажки снимаются у всех вложенных типов. Если снять флажок хотя бы у одного вложенного типа, то снимается флажок у класса, флажок у родительского типа сохраняется.

  • Метки — одна или несколько меток, определяющих процессы, в которых используется данное действие по событию, подробнее.

  • Событие — "Наступление времени атрибута".

    После выбора данного события на форме появляются дополнительные параметры:

    • Атрибут — атрибут, значение которого определяет выполнение действия по событию.

      Возможные значения: невычислимые атрибуты типа "Дата", "Дата/время", "Счетчик времени (обратный) класса объектов, выбранного в параметре "Объекты", или его типа.

      Если в параметре "Объекты" выбран класс объектов, то в списке отображаются только атрибуты класса.

      Если в параметре "Объекты" выбраны несколько типов класса, то список включает только атрибуты, общие для этих типов.

      Для выбора не доступны атрибуты "Дата создания", "Дата архивирования", "Дата последнего изменения".

    • Время действия относительно наступления события — вариант отсчета времени.

      Возможные значения:

      • "За" — действие выполнится за N астрономических секунд/минут/часов/дней/недель до предполагаемого наступления события.

        Задается временной интервал: число секунд, минут, часов, дней, недель.

      • "В одно время" — действие по событию выполнится в момент наступления события:

        • для атрибута типа "Дата" — в 00:00 при наступлении даты;
        • для атрибута типа "Дата/Время" — в указанное время;
        • для атрибута типа "Счетчик времени (обратный) — в момент истечения запаса времени, значение счетчика времени = 00:00.
      • "Спустя" — действие выполнится через N астрономических секунд/минут/часов/дней/недель после предполагаемого наступления события. Задается временной интервал: число секунд, минут, часов, дней, недель.

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

  • Атрибуты, передаваемые в контекст — атрибуты, которые будут использоваться при выполнении действия по событию. Поле отображается после выбора события.

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

    Для действий типа "Оповещение", "Уведомление в интерфейсе", "Уведомление в мобильном приложении", в поле Атрибуты, передаваемые в контекст рекомендуется указывать адрес электронной почты (email) или атрибуты, используемые для вычисления ролей, указанных в параметре "Кому" для действия по событию.

Результат настройки

На экране отобразится карточка действия по событию. Действие по событию также отобразится в списке на странице "Действия по событиям".

Последующие настройки

Включение или выключение действия по событию "Наступление времени атрибута", редактирование параметров действия и удаление действия выполняется в списке действий по событию и в карточке действия по событию "Наступление времени атрибута", см. Дополнительные настройки.

Расчет наступления времени атрибута

Наступлением даты для атрибута типа "Дата" считается 00 часов и 00 минут даты, заданной в атрибуте по серверному времени.

Если дата наступления события прошла, пока приложение было выключено, то действие по событию может выполняться при запуске приложения, при условии что дата наступления события попадает в определенный период от момента запуска приложения (по умолчанию 2 часа). Период задается в конфигурационном файле dbaccess.properties (параметр eventActions.deviationPeriod).

Если событие "Наступление времени атрибута" произошло с архивным объектом, то действие по событию выполняется.

Если предполагается возможность сдвига значения атрибута типа "Дата" или "Дата и время" назад, например, при изменении категории запроса время его выполнения сдвигается на два дня назад, то синхронное /асинхронное действие по событию "Наступление времени атрибута" не будет срабатывать. Действие по событию не выполняется, если при его создании/включении время наступления атрибута прошло. В этом случае рекомендуется настраивать действие по эскалации на 100% времени, подробнее.

Особенности для атрибута типа "Счетчик времени (обратный)"

Действие по событию будет выполняться, только если счетчик времени активен. Счетчик времени активен в период, равный астрономическому периоду до истечения счетчика времени

Пример 1. В понедельник в 9:00 регистрируется заявка с классом обслуживания 8*5 (по будням, c 9:00 до 17:00), в часовом поясе Екатеринбург, нормативное время решения заявки 5 часов.

Время действия относительно наступления события:

  • "За 1 час" — действие по событию сработает в 13:00, когда значение обратного счетчика будет 1:00.
  • "В одно время" — действие по событию сработает в 14:00, когда значение обратного счетчика будет 0:00.
  • "Спустя 1 час" — действие по событию сработает спустя 1 час, после того, как значение обратного счетчика будет 0:00.

Для расчета параметра "Время действия относительно наступления события" применяются астрономические часы и календарные дни, а не рабочие часы.

Пример 2. В понедельник, 21 октября 2024, в 12:00 регистрируется заявка с классом обслуживания 9*5 (по будням, с 9:00 до 18:00) в часовом поясе Екатеринбург, нормативное время решения заявки 40 часов. Значение обратного счетчика в момент регистрации заявки = 40:00.

Время действия относительно наступления события:

  • "За 40 часов" — действие по событию выполнится 24 октября в 00:00, когда на счетчике останется 16:00.

    В момент создания заявки рассчитывается дедлайн истечения счетчика с учетом класса обслуживания. В примере это пятница, 25 октября, 16:00 (через 94 астрономических часа после создания заявки).

    От этого дедлайна высчитывается планируемое время запуска действия по событию (отнимается 40 астрономических часов, без учета класса обслуживания).

    Действие по событию будет выполнено 24 октября, в 00:00, за 40 астрономических часов до момента истечения счетчика времени.

    Если бы система ориентировалась на рабочие, а не астрономические часы, действие по событию выполнилось бы сразу, т.к. в момент создания заявки как раз остается 40 часов счетчика времени.

Особенности работы в случае приостановки счетчика

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