Это старая версия документа!

События шины данных

В шину данных отправляются сообщения о действиях пользователей или самой Системы.
События - это сообщения о том, что в Системе произошло.
Модуль триггеров работает с этими сообщениями и может передавать параметры сообщения на обработку указанным скриптам.
Глобально есть 2 варианта событий в Системе, на которые может быть подписан триггер:

  1. Создание объекта
  2. Изменение объекта

Есть также «обобщенные» события, на основе которых генерируются другие, частные события.

**Например**:

Подписавшись на событие «Создание/изменение объекта», триггер будет срабатывать на создание объекта и изменение его характеристик и реквизитов.

**Пример 2**:

Если триггер подписать на «обобщенное» событие «Создание/изменение документа», то он будет срабатывать на пять конкретных событий: «Создание документа» и «Изменение документа», на основе которого так же генерируются события «Перемещение документа по иерархии», «Первая установка активной версии документа» и «Изменение активной версии документа».

Есть также дополнительные служебные события.

Перечень событий шины данных

Горизонтальные связиСоздание/удаление горизонтальной связи Событие, на основе которого генерируются следующие события:
• Создание горизонтальной связи
• Удаление горизонтальной связи
Создание горизонтальной связи Событие на создание горизонтальной связи между объектами либо объектом и контактом в Системе
Удаление горизонтальной связи Событие на удаление горизонтальной связи между объектами либо объектом и контактом в Системе.
ДокументыСоздание/изменение документа • Событие, на основе которого генерируются следующие события:
º Создание документа
º Изменение документа
• Содержит список DocumentRequisitesChanges установленных или измененных значений реквизитов документа в процессе его создания/изменения.
По таким реквизитам генерируются события на установку или изменение соответствующего типа реквизита документа.
Создание документа • Событие на создание документа.
• Содержит список DocumentRequisitesChanges установленных или измененных значений реквизитов документа в процессе его создания.
По таким реквизитам генерируются события на установку или изменение соответствующего типа реквизита документа).
Изменение документа • Событие на изменение документа.
• Событие, на основе которого генерируются следующие события:
º Перемещение документа по иерархии
º Первая установка активной версии документа
º Изменение активной версии документа
• Так же генерируется при изменениях в списке «DocumentRequisitesChanges»
• Содержит список DocumentRequisitesChanges установленных или измененных значений реквизитов документа в процессе его изменения.
º По таким реквизитам генерируются события на установку или изменение соответствующего типа реквизита документа.
Перемещение документа по иерархии • Событие на перемещение документа по иерархии объектов в Системе.
• Содержит список DocumentRequisitesChanges установленных или измененных значений реквизитов документа в процессе его перемещения.
º По таким реквизитам генерируются события на установку или изменение соответствующего типа реквизита документа.
Первая установка активной версии документа • Событие только на первичную ручную установку активной версии документа.
При последующих ручных изменениях активной версии документа генерируется событие «Изменение активной версии документа».
• Содержит список DocumentRequisitesChanges установленных или измененных значений реквизитов документа в процессе первичной ручной установки его активной версии.
º По таким реквизитам генерируются события на установку или изменение соответсвующего типа реквизита документа.
Изменение активной версии документа • Событие на изменение активной версии документа (любое изменение кроме первичного, см. событие «Первая установка активной версии документа».
• Содержит список «DocumentRequisitesChanges» установленных или измененных значений реквизитов документа в процессе изменения его активной версии.
º По таким реквизитам генерируются события на установку или изменение соответсвующего типа реквизита документа.
Создание/изменение версии документа Событие, на основе которого генерируются следующие события:
• Создание версии документа
Создание версии документаСобытие на создание версии документа.
СистемаИзменение версии системыСобытие на изменение версии сборки Системы
Настраиваемые команды. Вызов команды по объектуВызов настраиваемой команды по объектуСобытие на вызов настраиваемой команды пользователем Системы (на данный момент делается в меню «…» карточки объекта, если команда создана)
ОбъектыСоздание/изменение объекта • Событие, на основе которого генерируются следующие события:
º Создание объекта
º Изменение объекта
• Содержит список «ProjectFieldChanges» изменений полей объекта в процессе его создания/изменения. Под полем объекта понимаются его характеристики: название, родительский объект, приоритет, статус, % завершения, плановые, расчетные и фактические даты, руководитель, исполнитель.
º По таким полям генерируются события на установку или изменение соответствующего поля объекта.
• Содержит список ProjectRequisitesChanges установленных или измененных значений реквизитов объекта в процессе его создания/изменения.
º По таким реквизитам генерируются события на установку или изменение соответсвующего типа реквизита объекта.
Создание объекта • Событие на создание объекта в иерархической структуре Системы.
• Содержит список ProjectFieldChanges изменений полей объекта в процессе его создания/изменения. Под полем объекта понимаются его характеристики: название, родительский объект, приоритет, статус, % завершения, плановые, расчетные и фактические даты, руководитель, исполнитель.
º По таким полям генерируются события с базовым типом SL.Bus.Messages.Triggers.Projects.ProjectFieldMessageBase (на установку или изменение соответствующего поля объекта).
• Содержит список «ProjectRequisitesChanges» установленных или измененных значений реквизитов объекта в процессе его создания/изменения.
º По таким реквизитам генерируются события на установку или изменение соответсвующего типа реквизита объекта.
Изменение объекта • Событие на изменение объекта в иерархической структуре Системы.
• Генерируется при изменениях в списках ProjectFieldChanges и ProjectRequisitesChanges (см. ниже).
• Содержит список ProjectFieldChanges изменений полей объекта в процессе его создания/изменения. Под полем объекта понимаются его характеристики: название, родительский объект, приоритет, статус, % завершения, плановые, расчетные и фактические даты, руководитель, исполнитель.
º По таким полям генерируются события на установку или изменение соответствующего поля объекта.
• Содержит список ProjectRequisitesChanges установленных или измененных значений реквизитов объекта в процессе его создания/изменения.
º По таким реквизитам генерируются события на установку или изменение соответсвующего типа реквизита объекта.
Участник проекта изменёнСобытие, на основе которого генерируются следующие события:
• Добавлен участник проекта
Добавлен участник проектаСобытие на добавление участника объекта.
Создание/изменение поля объекта • Под объектом понимается как объект дерева проекта, так и объект шаблона проекта.
• Под полем объекта понимаются его характеристики: название, родительский объект, приоритет, статус, % завершения, плановые, расчетные и фактические даты, руководитель, исполнитель
• Событие, на основе которого генерируются события на установку или изменение:
º Родительского проекта
º Названия объекта
º Приоритета объекта
º Руководителя объекта
º Делегированного руководителя объекта
º Исполнителя объекта
º Делегированного исполнителя объекта
º Расчетных плановых дат начала и конца объекта
º Плановых дат начала и конца объекта
º Фактических дат начала и конца объекта
º Процента завершения объекта
º Статуса объекта
Установка родительского проектаСобытие на установку родительского объекта (в момент создания объекта).
Изменение родительского проектаСобытие на изменение родительского объекта (у существующего объекта).
Установка названияСобытие на установку названия объекта (в момент создания объекта).
Изменение названияСобытие на изменение названия объекта (у существующего объекта).
Установка приоритета объектаСобытие на установку приоритета объекта (в момент создания объекта).
Изменение приоритета объектаСобытие на изменение приоритета объекта (у существующего объекта).
Установка руководителя • Событие на установку пользователя на роль «Руководитель» объекта (в момент создания объекта).
• При последующих изменениях руководителя (когда делегированный пользовать принимает полномочия) генерируется событие «Изменение Руководителя»
Изменение руководителяСобытие на изменение пользователя у роли «Руководитель» объекта (в момент принятия пользователем полномочий у существующего объекта)
Установка делегированного руководителя • Событие на установку делегированного пользователя на роль «Руководитель» объекта (в момент создания объекта).
• В момент создания объекта данное событие все равно генерируется не зависимо от того, была ли сразу делигрована роль «Руководитель» другому пользователю или нет (к примеру, в режиме редактирования карточки создаваемого объекта).
В обоих случаях параметр NewOwnerId будет = Null.
• Если в процессе создания объекта сразу делигруется роль «Руководитель» другому пользователю, то при сохранении (непосредственном создании) объекта сначала генерируется событие на установку делегированного руководителя (в параметр NewOwnerId пишется Null), а после - событие на изменение делегированного руководителя, где уже в параметр NewOwnerId проставляется соответсвующий идентификатор пользователя, которому была делегирована роль «Руководитель».
• При последующих делигерированиях роли «Руководитель» генерируется событие «Изменение делегированного Руководителя».
Изменение делегированного руководителя • Событие на делегирование пользователю роли «Руководитель» объекта (у существующего объекта).
• Событие генерируется именно в тот момент, когда роль «Руководитель» делегируется пользователю (не путать с событием «Изменение Руководителя»).
• Содержит список ChildProjectsDelegatedOwnerChangedMessages изменений делегированных руководителей в дочерних объектах (при делегировании всей иерархии объектов или объектов пользователя из иерархии объектов).
º Содержит изменения только по тем объектам, по которым было произведено делегирование.
º По соответствующим дочерним объектам генерируются такие же события (Изменение делегированного Руководителя).
• Если в объекте «А» делегируются только объекты указанного пользователя, который не является руководителем объекта «А», то в событии для данного объекта в параметр «NewOwnerId» запишется значение «Null», т.к. данный объект не был делегирован.
Установка исполнителя • Событие на установку пользователя на роль «Исполнитель» объекта (в момент создания объекта).
• При последующих изменениях исполнителя (когда делегированный пользовать принимает полномочия) генерируется событие «Изменение Исполнителя»
Изменение исполнителяСобытие на изменение пользователя у роли «Исполнитель» объекта (в момент принятия пользователем полномочий у существующего объекта).
Установка делегированного исполнителя • Событие на установку делегированного пользователя на роль «Исполнитель» объекта (в момент создания объекта).
• В момент создания объекта данное событие все равно генерируется не зависимо от того была ли сразу делигрована роль «Исполнитель» другому пользователю или нет (к примеру, в режиме редактирования карточки создаваемого объекта).
В обоих случаях параметр NewResponsibleId будет = Null.
• Если в процессе создания объекта сразу делигруется роль «Исполнитель» другому пользователю, то при сохранении (непосредственном создании) объекта сначала генерируется событие на установку делегированного исполнителя (в параметр NewResponsibleId пишется Null), а после событие на изменение делегированного исполнителя, где уже в параметр NewResponsibleId проставляется соответсвующий идентификатор пользователя, которому была делегирована роль «Исполнитель».
• При последующих делигерированиях роли «Исполнитель» генерируется событие «Изменение делегированного Исполнителя»
Изменение делегированного исполнителя• Событие на делегирование пользователю роли «Исполнитель» объекта (у существующего объекта).
• Событие генерируется именно в тот момент, когда роль «Исполнитель» делегируется пользователю (не путать с событием «Изменение Исполнителя»).
• Содержит список ChildProjectsDelegatedResponsibleChangedMessages изменений делегированных исполнителей в дочерних объектах (при делегировании всей иерархии объектов или объектов пользователя из иерархии объектов).
º Содержит изменения только по тем объектам, по которым было произведено делегирование.
º По соответствующим дочерним объектам генерируются такие же события (Изменение делегированного Исполнителя).
• Если в объекте «А» делегируются только объекты указанного пользователя, который не является исполнителем объекта «А», то в событии для данного объекта в параметр «NewResponsibleId» запишется значение «Null», т.к. данный объект не был делегирован.
Установка расчетной плановой даты начала • Событие на установку расчетной плановой даты начала (РДН) в момент создания объекта.
• На данный момент при создании объекта сначала генерируется событие на установку РДН = Null (или 0001-01-01T00:00:00), а после - событие на ее изменение, где уже проставляется нужная РДН.
• При последующих изменениях РДН объекта генерируется событие «Изменение Расчетной плановой даты начала».
Изменение расчетной плановой даты началаСобытие на изменение расчетной плановой даты начала (РДН) у существующего объекта.
Установка расчетной плановой даты конца• Событие на установку расчетной плановой даты окончания (РДО) в момент создания объекта.
• На данный момент при создании объекта сначала генерируется событие на установку РДО = Null (или 0001-01-01T00:00:00), а после - событие на ее изменение, где уже проставляется нужная РДО.
• При последующих изменениях РДО объекта генерируется событие «Изменение Расчетной плановой даты конца».
Изменение расчетной плановой даты концаСобытие на изменение расчетной плановой даты окончания (РДО) у существующего объекта.
Установка плановой даты начала • Событие на установку плановой даты начала (ПДН) в момент создания объекта.
• Если при создании объекта не была указана ПДН, то событие все равно сгенерируется с установкой ПДН = Null (или 0001-01-01T00:00:00).
• При последующих установках/изменениях ПДН объекта генерируется событие «Изменение Плановой даты начала».
Изменение плановой даты началаСобытие на изменение плановой даты начала (ПДН) у существующего объекта.
Установка плановой даты концаСобытие на установку плановой даты окончания (ПДО) в момент создания объекта.
• Если при создании объекта не была указана ПДО, то событие все равно сгенерируется с установкой ПДО = Null (или 0001-01-01T00:00:00).
• При последующих установках/изменениях ПДН объекта генерируется событие «Изменение Плановой даты конца».
Изменение плановой даты концаСобытие на изменение плановой даты окончания (ПДО) у существующего объекта.
Установка фактической даты начала • Событие на установку фактической даты начала (ФДН) в момент создания объекта.
• Хотя в момент создания объекта он не имеет фактических дат, данное событие все равно сгенерируется с установкой ФДН = Null (или 0001-01-01T00:00:00).
• При последующих установках/изменениях ФДН объекта генерируется событие «Изменение Фактической даты начала».
Изменение фактической даты началаСобытие на изменение фактической даты начала (ФДН) у существующего объекта.
Установка фактической даты конца • Событие на установку фактической даты окончания (ФДО) в момент создания объекта.
• Хотя в момент создания объекта он не имеет фактических дат, данное событие все равно сгенерируется с установкой ФДО = Null (или 0001-01-01T00:00:00).
• При последующих установках/изменениях ФДО объекта генерируется событие «Изменение Фактической даты конца».
Изменение фактической даты концаСобытие на изменение фактической даты окончания (ФДО) у существующего объекта.
Установка процента завершенияСобытие на установку процента выполнения объекта (в момент создания объекта).
Изменение процента завершенияСобытие на изменение процента выполнения объекта (у существующего объекта).
Установка статусаСобытие на установку статуса объекта (в момент создания объекта).
Изменение статусаСобытие на изменение статуса объекта (у существующего объекта).
Создание/изменение базового планаСобытие, на основе которого генерируются следующие события:
• Базовый план создан
Базовый план создан • Событие на создание базового плана (БП) у объекта.
• Событие генерируется для каждого объекта, сохраненного в БП.
Назначены целевые планы для объектаСобытие на назначение целевого плана в объекте типа «Проект» (из базового плана (БП)).
РеквизитыУстановка/изменение реквизита объекта или справочника
Реквизиты дискуссии / документа / объекта / согласования / справочника Установка/изменение реквизита
Установка реквизита «Адрес»
Изменение реквизита
Установка реквизита «Да/Нет»
Изменение реквизита
Установка реквизита «Счетчик»
Изменение реквизита
Установка реквизита «Дата»
Изменение реквизита
Установка реквизита «Классификатор»
Изменение реквизита
Установка реквизита «Файл»
Изменение реквизита
Установка реквизита «Формула»
Изменение реквизита
Установка реквизита «Html»
Изменение реквизита
Установка реквизита «Число», формат «Денежный»
Изменение реквизита
Установка реквизита «Число», формат «Число»
Изменение реквизита
Установка реквизита «Число», формат «Проценты»
Изменение реквизита
Установка реквизита «Процесс»
Изменение реквизита
Установка реквизита «Строка»
Изменение реквизита
Согласования Создание/изменение согласования
Создание согласования
Изменение согласования
Перемещение согласования по иерархии
Согласование закрыто
Маршрут согласования пройден
Создание/изменение маршрута согласования
Создание маршрута согласования
Изменение маршрута согласования
Справочники Создание/изменение записи справочника
Создание записи справочника
Изменение записи справочника
Табель учета времени. Отправка на утверждение
ТаймерЗапланированное событие таймера
Запланированное повторяющееся событие таймера
Событие таймера, запланированное по подписке
Напоминание о запланированном событии
Уведомления. Послано уведомление
Форма сбора отчетности Отправка
Отправка адресату
Отправка адресатам
Входящие запросыПриемка объекта
Отказ от принятия полномочий
Отказ от принятия полномочий руководителя
Отказ от принятия полномочий исполнителя
Отказ от принятия полномочий участника
ПользователиПользователю назначена группа
Пользователь исключен из группы

Типовые параметры событий

Guid …ID Идентификатор объекта
Пример: Guid RelationId, Guid DiscussionId, Guid DocumentId, Guid ProjectId
String …Name Название объекта
Пример: String DiscussionName, String DocumentName, String ProjectName
List`1<FieldMessageBase> …ChangesСписок установок или изменений значений реквизитов документа/объекта/дискуссии/справочника, если таковые происходили
Пример: List`1<FieldMessageBase> DiscussionRequisitesChanges, List`1<FieldMessageBase> DocumentRequisitesChanges
DateTime DocumentCreateDate Дата и время создания документа
← К оглавлению
Запуск по таймеру→