Wiki [3.x] product:triggers

Что такое Триггеры

anonymous@undisclosed.example.com (Anonymous) — Tue, 17 Dec 2024 08:30:20 +0000

Что такое Триггеры

Триггеры – это отдельный модуль, который общается с системой по интеграционной шине.

Цель триггеров как инструмента – автоматизация бизнес-процессов. Возможность сделать так, чтобы пользователю приходилось делать меньше действий в системе и не совершать ошибок на уровне «забыл проставить нужный реквизит».

Как именно триггеры покрывают бизнес-процессы

Идеальная картина: нажал одну кнопочку – и готово. Система магическим образом узнала, чего от неё хотел пользователь. Всё заполнилось-настроилось-появилось как надо.

Реальность: есть множество небольших кейсов, условий, каждый из которых влечёт за собой действия, которые раньше пользователь воспроизводил вручную.

«Большая» автоматизация – это набор небольших сценариев. Каждый «большой» бизнес-процесс декомпозируется на составляющие.

Таким образом первоначально триггеры автоматизируют маленькие кусочки бизнес-процессов.

Когда начинать автоматизировать?

Только когда процессы, которые вы перенесли в систему, обкатаны вручную. Когда вы «на коленке» убедились в их жизнеспособности.

В момент первоначального внедрения ИСУП, вы можете только предполагать, как это будет работать.

Автоматизация фиксирует процессы.

Прежде чем процесс зафиксировать, нужно его обкатать, убедиться в его жизнеспособности.

Предположение → проверка гипотезы → правки → снова проверка → автоматизация.

Сначала нужно научиться работать с тем, что есть, вручную. Потом в этом процессе найти «где болит» – и устранить это «болит» триггерами.

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

Например, в отделе Сервиса приходилось делать двойную работу:

сначала записать в справочник в «Сделке» результат последнего контакта и что запланировано с этим клиентом далее;
вручную создать задачу на следующую активность, которая дублирует запись справочника.

Сейчас этот процесс автоматизирован. Когда триггер фиксирует событие о том, что в таком-то справочнике появилась запись из такого-то объекта, и там указан определённый классификатор, триггер через API инициирует создание нужного объекта.

Ожидания VS Реальность

Слабость автоматизации в том же, в чём и сила: в «бетонировании» бизнес-процессов.

Бизнес-процессы постоянно меняются.

Меняются требования, отчёты, данные, которые нужно вносить. Появляются новые идеи, которые конфликтуют со старыми.

Расхождения между реализованной автоматизацией и реальным бизнес-процессами могут показаться ошибками. Но на самом деле – это лишь старые бизнес-процессы, которые перестали быть актуальными.

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

Почти любые изменения в скрипте через значимый промежуток времени по трудозатратам – это как написание нового скрипта.

Процессы изменчивы, и это нормально. Самое сложное в триггерах – это соблюсти баланс.

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

Будьте аккуратны!

Триггер – это мощный инструмент в руках человека, понимающего настроенные в ADVANTA процессы и знающего, как они работают.

В руках сотрудника не совсем понимающего как все работает, но имеющего права доступа – этот инструмент может принести больше вреда, чем пользы.

Триггер это микроавтомат (робот), выполняющий набор рутинных действий при наступлении определенного события в бизнес-процессе, и поэтому чувствителен к изменению условий в которых он работает. Если изменились условия или процесс, то триггер, выполняющий рутину под старый процесс, скорее всего станет выполнять неадекватные новому процессу действия, или сломается.

Соответственно самый верный способ «завалить» работу триггеров – это создать хаос в настройках: забыть, зачем и что было настроено, смело добавлять, удалять и переименовывать реквизиты, объекты, справочники, менять ограничения по созданию дочерних объектов и т.п. Впрочем, такие действия обязательно создадут массу неадекватных данных и сломают отчетность, OLAP-кубы и прочие аналитические инструменты системы и без всяких триггеров. С ними же сломается все еще быстрее.

ВАЖНО! Для того, чтобы снизить все эти риски вам необходимо иметь:

2 системы
2 базы данных
2 инсталлированных модуля триггеров

И тогда у вас будут почти безграничные возможности автоматизации!

Кейсы и сценарии

Перевод этапа жизненного цикла

Действия пользователя:

изменяет реквизиты на карточке проекта или дочерних объектах.

Работа триггера (может быть как одно, так и все перечисленные действия):

меняет статус проекта;
меняет значения реквизита(ов) на карточке проекта;
меняет фазу жизненного цикла.

Автоматическая запись в справочник

Действия пользователя:

завершает контрольную точку (статус – «Завершено»)

Работа триггера (может быть как одно, так и все перечисленные действия):

создаёт запись в справочник у проекта;
меняет значения реквизита(ов) на карточке проекта;
меняет фазу жизненного цикла.

Кейс: Инициация проекта

Действия пользователя:

создает карточку проекта с заполненными реквизитами в папке «Инициативы»;
создает дискуссию или согласование, в котором обосновывает проект
1. в качестве реквизита указывает нового РП

Когда согласование завершено/дискуссия закрыта, система ADVANTA с помощью триггеров автоматически:

перемещает проект из папки «Инициативы» в папку «Проекты в работе»;
меняет фазу ЖЦ проекта с «идея» на «проект утвержден»;
блокирует реквизиты проекта для защиты от изменений;
делегирует данный проект согласованному РП;
меняет статус у КТ проекта «Назначение РП проекта» на «Завершен»;
отправляет уведомление владельцу компании о том, что в компании стартовал новый проект.

← К оглавлению

Как работают триггеры →

Настраиваемые команды над объектами

anonymous@undisclosed.example.com (Anonymous) — Mon, 02 Sep 2024 07:26:33 +0000

Настраиваемые команды над объектами

Начиная с версии Системы 3.24 мы реализовали механизм, позволяющий создавать дополнительные команды над пользовательскими объектами без необходимости доработки Системы.
Нужные команды вы сможете настроить по своему усмотрению.

Как создать команду?

Создавать или изменять команды может только Администратор Системы.

Перейдите на страницу «Администрирование», затем на страницу «Объекты»,
Перейдите в свойства нужного пользовательского объекта,
Портлет «Настраиваемые команды» расположен под портлетом «Ключевые показатели»,
Заполните поля «Название команды» и «Описание»,
Команда, которую создали внутри объекта, будет отображаться в виде кнопки в карточке всех объектов такого же типа в меню команд («три точки»).

Начиная с версии системы 3.29 появилась возможность также видеть и вызывать команды через списки - через иконку «три точки» объекта или через иконку «≡», если список представлен в виде таблицы.

Что нужно знать про настройку команд:
К вашему экземпляру Системы должен быть подключён модуль триггеров.

Параметры настраиваемой команды

(доступно начиная с версии 3.27)

На странице настраиваемой команды в Административной панели есть возможность задать перечень групп пользователей, для которых будет доступна эта команда в меню объекта:

Если команда создана без выбора групп пользователей, то она будет видна и доступна для вызова в меню «…» на карточках объектов данного типа у:

Пользователей с лицензией «Администратор».
Автора настраиваемой команды

Если же в настройках команды указаны определенные группы пользователей, то она будет видна и доступна для вызова в меню «…» на карточках объектов данного типа у:

Пользователей, которые входят в состав указанных групп (без дочерних), за исключением пользователей с лицензией «Наблюдатель». Если необходимо, чтобы пользователи из дочерних групп также имели доступ к этому пункту меню, необходимо их выбрать в настройках команды.
Пользователей с лицензией «Администратор».
Автора настраиваемой команды.

Также можно настроить передаваемые при вызове команды параметров:

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

Строка (форматы: Текст, URL, E-Mail, Сетевая папка)
Число (форматы: Число, Денежный, Проценты)
Дата
Процесс
Классификатор (в т.ч. основанный на базовом объекте: Проект, Документ, Дискуссия, Пользователь, Статус объекта)

После выбора реквизитов необходимо настроить их параметры:

Обязательный - активируйте чекбокс, чтобы значение реквизита было обязательным к заполнению в окне ввода значений параметров команды при ее вызове.
Название передаваемого параметра - название параметра, под которым в событие «Вызов настраиваемой команды по объекту» будет передано значение соответствующего реквизита.
Значение по умолчанию - значение реквизита которое будет выбрано по умолчанию в окне ввода значений параметров команды при ее вызове.
Действия - позволяет удалить реквизит

и затем нажать кнопку «Сохранить» в левой верхней части портлета «Параметры команды»

Использование настроенной команды

Система присваивает созданной команде уникальный идентификатор (guid).
Вызов команды из меню карточки объекта сгенерирует событие «Вызов настраиваемой команды по объекту» в шину данных с определёнными параметрами, включая guid команды и guid объекта, из которого вызвана команда.
На это событие можно подписать триггер, который выполнит написанный в нем скрипт.

(доступно начиная с версии 3.27)

Если у настраиваемой команды заданы параметры (добавлен хотя бы один реквизит), то при ее вызове на странице объекта отображается всплывающее окно «Параметры команды»:

В нем необходимо выбрать значения параметров и затем нажать кнопку «Выполнить».
При таком сценарии, кроме guid команды и guid объекта, из которого вызвана команда, в событие для обработки триггером будут переданы в качестве параметров и выбранные в форме значения реквизитов.

Что можно сделать?

С помощью такой «кнопки» вы сможете настроить самые разные команды.
Например,

Выгрузить из объекта все приложенные документы,
Направить уведомление на почту,
Сохранить базовый план вашего проекта, не загружая диаграмму Ганта,
Выполнить регламентную процедуру,
Сформировать запрос на изменение или согласование данных, которые внесли в объект,
Отправить запрос на доработку Системы - такую команду мы сделали в ADVANTA для коллег из других отделов.

Функционал таких команд ограничивается реализованными в системе методами API, которые регулярно пополняются.
Более подробно про реализованные API-методы вы можете прочитать здесь, а для получения информации об установке такого функционала в вашей системе вы можете обратиться в техническую поддержку или к вашему аккаунт-менеджеру.

Персонализированные команды позволяют реализовывать интеграции с другими системами в рамках API-методов.
Почитайте примеры интеграционных решений на базе системы ADVANTA.

Кейсы

Вот так, например, мы реализовали отправку поручений из системы на почту для одного из наших заказчиков.
Мы получили запрос: необходимо реализовать отправку объекта «Поручение» на email с указанием сроков и возможностью вложения документов, прикреплённых к объекту.
Добавили кнопку «Отправить поручение на почту»…

…чтобы поручение приходило как входящее письмо со всеми нужными данными.

C письмом можно дальше работать в рамках почтового клиента или сохранить нужные документы к себе на устройство.

Логика была реализована функционалом модуля триггеров и API Системы.

← К оглавлению

Готовые решения →

Перенос модуля Триггеров на СУБД другого типа

anonymous@undisclosed.example.com (Anonymous) — Fri, 24 Jan 2025 11:27:22 +0000

Перенос модуля Триггеров на СУБД другого типа

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

Инструкция по установке модуля триггеров версии 16.Х в ОС Windows
Инструкция по установке модуля триггеров версии 17.Х и выше в ОС Windows | в ОС Linux

Возможны два варианта переноса модуля Триггеров:

перенес модуля Триггеров на отдельную от Системы ADVANTA базу данных;
переход модуля триггеров с БД MS SQL на БД PostgreSQL (и наоборот).

В обоих случаях необходимо:

Сделать резервную копию БД триггеров, экспортировать триггеры и остановить модуль Триггеров - все его компоненты: Сайт, Движок и Агент. Отключить их автоматический запуск при перезагрузке сервера.
Развернуть модуль триггеров и новую БД на MS SQL/PostgreSQL.
Запустить компоненты «Сайт» и «Агент».
Импортировать ранее сохраненные триггеры.

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

При необходимости переноса модуля Триггеров с ОС Windows на ОС Linux можно воспользоваться инструкцией, представленной на отдельной странице: Перенос модуля Триггеров с ОС Windows на ОС Linux.

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

anonymous@undisclosed.example.com (Anonymous) — Fri, 04 Oct 2024 07:50:53 +0000

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

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

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

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

Например:

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

Пример 2:

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

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

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

Горизонтальные связи	Создание/удаление горизонтальной связи	Событие, на основе которого генерируются следующие события: • Создание горизонтальной связи • Удаление горизонтальной связи
	Создание горизонтальной связи	Событие на создание горизонтальной связи между объектами либо объектом и контактом в Системе
	Удаление горизонтальной связи	Событие на удаление горизонтальной связи между объектами либо объектом и контактом в Системе.
Дискуссии	Создание/изменение дискуссии	Событие, на основе которого генерируются следующие события: • Создание дискуссии • Перемещение дискуссии по иерархии • Изменение дискуссии • Закрытие дискуссии Содержит список `DiscussionRequisitesChanges` установленных или измененных значений реквизитов дискуссии в процессе ее создания/изменения. По таким реквизитам генерируются события на установку или изменение соответствующего типа реквизита дискуссии.
	Создание дискуссии	• Событие на создание дискуссии. • Содержит список `DiscussionRequisitesChanges` установленных или измененных значений реквизитов дискуссии в процессе ее создания. По таким реквизитам генерируются события на установку или изменение соответствующего типа реквизита дискуссии.
	Изменение дискуссии	• Событие на изменение дискуссии • Событие, на основе которого генерируются следующие события: Закрытие дискуссии • Так же генерируется при изменениях в списке `DiscussionRequisitesChanges`. • Содержит список `DiscussionRequisitesChanges` установленных или измененных значений реквизитов дискуссии в процессе ее изменения. По таким реквизитам генерируются события на установку или изменение соответствующего типа реквизита дискуссии.
	Перемещение дискуссии по иерархии	• Событие на перемещение дискуссии по иерархии объектов Системы. • Содержит список `DiscussionRequisitesChanges` установленных или измененных значений реквизитов дискуссии в процессе ее перемещения. По таким реквизитам генерируются события на установку или изменение соответствующего типа реквизита дискуссии.
	Закрытие дискуссии	• Событие на закрытие дискуссии. • Содержит список `DiscussionRequisitesChanges` установленных или измененных значений реквизитов дискуссии в процессе ее закрытия. По таким реквизитам генерируются события на установку или изменение соответствующего типа реквизита дискуссии.
	Создание/изменение ответа	Событие, на основе которого генерируются следующие события: • Добавление ответа в дискуссию
	Добавление ответа в дискуссию	Событие на добавление ответа в дискуссию.
	Запрошен ответ/комментарий в дискуссии	Генерируется при отправке следующих запросов: • Запрос ответа на дискуссию. В Системе этот запрос формируется, когда: º Пользователя добавляют в участники дискуссии через интерфейс Системы или API CreateTopic, CreateTopicWithFields, UpdateTopic, AskUsersToTopic (/components/Services/APIDiscussions.asmx) º Нажимают кнопку «Запросить ответ» в портлете «Участники дискуссии» через интерфейс Системы или API AskUsersToTopic, ReAskUsersToTopic (/components/Services/APIDiscussions.asmx) • Запрос комментария на дискуссию. В Системе этот запрос формируется, когда пользователя добавляют в качестве адресата в комментарий дискуссии (через интерфейс Системы при создании, просмотре, редактировании комментария).
	Добавление пользователя в участники дискуссии	• Событие на добавление пользователя в состав участников дискуссии (как при ее создании, так и в уже существующую). Примечание: При создании дискуссии событие на добавление автора дискуссии в состав ее участников не генерируется.
	Удаление пользователя из участников дискуссии	• Событие на удаление пользователя из состава участников существующей дискуссии. На данный момент пользователь может быть удален из участников существующей дискуссии, только если он не дал ни одного ответа.
Документы	Создание/изменение документа	• Событие, на основе которого генерируются следующие события: º Создание документа º Изменение документа • Содержит список `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» • Установка/Изменение реквизита типа «Число» • Установка/Изменение реквизита типа «Процесс» • Установка/Изменение реквизита типа «Строка»
	Установка реквизита «Адрес»	• Событие на установку значения соответствующего реквизита (в момент создания дискуссии / документа / объекта / согласования / записи справочника). • Если в момент создания дискуссии / документа / объекта / согласования / записи справочника значение реквизита не указано, то событие не генерируется. • При последующих установках/изменениях значения соответствующего реквизита в уже созданных дискуссиях / документах / объектах / согласованиях / записях справочника генерируется событие на изменение этого реквизита.
	Изменение реквизита «Адрес»	Событие на установку/изменение значения соответствующего реквизита у существующих дискуссий / документов / объектов / согласований / записей справочника
	Установка реквизита «Да/Нет»	• Событие на установку значения соответствующего реквизита (в момент создания дискуссии / документа / объекта / согласования / записи справочника). • Если в момент создания дискуссии / документа / объекта / согласования / записи справочниказначение реквизита не указано, то событие не генерируется. • При последующих установках/изменениях значения соответствующего реквизита в уже созданных дискуссиях / документах /объектах /согласованиях / записях справочника генерируется событие на изменение этого реквизита.
	Изменение реквизита «Да/Нет»	Событие на установку/изменение значения соответствующего реквизита у существующих дискуссий / документов / объектов / согласований / записей справочника.
	Установка реквизита «Счетчик»	Особенности: • Событие на установку значения соответствующего реквизита (в момент создания дискуссии / документа / объекта / согласования / записи справочника). • Если в мемент создания дискуссии / документа / объекта / согласования / записи справочника значение реквизита не указано, то событие не генерируется. • При последующих установках/изменениях значения соответствующего реквизита в уже созданных дискуссиях / документах / объектах / согласованиях / записях справочника генерируется событие на изменение этого реквизита
	Изменение реквизита «Счетчик»	Событие на установку/изменение значения соответствующего реквизита у существующих дискуссий / документов / объектов / согласований / записей справочника.
	Установка реквизита «Дата»	• Событие на установку значения соответствующего реквизита (в момент создания дискуссии / документа / объекта / согласования / записи справочника). • Если в мемент создания дискуссии / документа / объекта / согласования / записи справочника значение реквизита не указано, то событие не генерируется. • При последующих установках/изменениях значения соответствующего реквизита в уже созданных дискуссиях / документах / объектов /согласованиях / записях справочника генерируется событие на изменение этого реквизита.
	Изменение реквизита «Дата»	Событие на установку/изменение значения соответствующего реквизита у существующих дискуссий / документов / объектов / согласований / записей справочника.
	Установка реквизита «Классификатор»	• Событие на установку значения соответствующего реквизита (в момент создания дискуссии / документа / объекта / согласования / записи справочника). • Если в момент создания дискуссии / документа / объекта / согласования / записи справочника значение реквизита не указано, то событие не генерируется. • При последующих установках/изменениях значения соответствующего реквизита в уже созданных дискуссиях / документах /объектах /согласованиях / записях справочника генерируется событие на изменение этого реквизита.
	Изменение реквизита «Классификатор»	Событие на установку/изменение значения соответствующего реквизита у существующих дискуссий / документов / объектов / согласований / записей справочника.
	Установка реквизита «Файл»	• Событие на установку значения соответствующего реквизита (в момент создания дискуссии / документа / объекта / согласования / записи справочника). • Если в момент создания дискуссии / документа / объекта / согласования / записи справочника значение реквизита не указано, то событие не генерируется. • При последующих установках/изменениях значения соответствующего реквизита в уже созданных дискуссиях / документах /объектах /согласованиях / записях справочника генерируется событие на изменение этого реквизита.
	Изменение реквизита «Файл»	Событие на установку/изменение значения соответствующего реквизита у существующих дискуссий / документов / объектов / согласований / записей справочника.
	Установка реквизита «Формула»	• Событие на установку значения соответствующего реквизита (в момент создания дискуссии / документа / объекта / согласования / записи справочника). • Если в момент создания дискуссии / документа / объекта / согласования / записи справочника значение реквизита не указано, то событие не генерируется. • При последующих установках/изменениях значения соответствующего реквизита в уже созданных дискуссиях / документах /объектах /согласованиях / записях справочника генерируется событие на изменение этого реквизита.
	Изменение реквизита «Формула»	Событие на установку/изменение значения соответствующего реквизита у существующих дискуссий / документов / объектов / согласований / записей справочника.
	Установка реквизита «Html»	• Событие на установку значения соответствующего реквизита (в момент создания дискуссии / документа / объекта / согласования / записи справочника). • Если в момент создания дискуссии / документа / объекта / согласования / записи справочника значение реквизита не указано, то событие не генерируется. • При последующих установках/изменениях значения соответствующего реквизита в уже созданных дискуссиях / документах /объектах /согласованиях / записях справочника генерируется событие на изменение этого реквизита.
	Изменение реквизита «Html»	Событие на установку/изменение значения соответствующего реквизита у существующих дискуссий / документов / объектов / согласований / записей справочника.
	Установка реквизита «Число», формат «Денежный»	• Событие на установку значения соответствующего реквизита (в момент создания дискуссии / документа / объекта / согласования / записи справочника). • Если в момент создания дискуссии / документа / объекта / согласования / записи справочника значение реквизита не указано, то событие не генерируется. • При последующих установках/изменениях значения соответствующего реквизита в уже созданных дискуссиях / документах /объектах /согласованиях / записях справочника генерируется событие на изменение этого реквизита.
	Изменение реквизита «Число», формат «Денежный»	Событие на установку/изменение значения соответствующего реквизита у существующих дискуссий / документов / объектов / согласований / записей справочника.
	Установка реквизита «Число», формат «Число»	• Событие на установку значения соответствующего реквизита (в момент создания дискуссии / документа / объекта / согласования / записи справочника). • Если в момент создания дискуссии / документа / объекта / согласования / записи справочника значение реквизита не указано, то событие не генерируется. • При последующих установках/изменениях значения соответствующего реквизита в уже созданных дискуссиях / документах /объектах /согласованиях / записях справочника генерируется событие на изменение этого реквизита.
	Изменение реквизита «Число», формат «Число»	Событие на установку/изменение значения соответствующего реквизита у существующих дискуссий / документов / объектов / согласований / записей справочника.
	Установка реквизита «Число», формат «Проценты»	• Событие на установку значения соответствующего реквизита (в момент создания дискуссии / документа / объекта / согласования / записи справочника). • Если в момент создания дискуссии / документа / объекта / согласования / записи справочника значение реквизита не указано, то событие не генерируется. • При последующих установках/изменениях значения соответствующего реквизита в уже созданных дискуссиях / документах / объектах /согласованиях / записях справочника генерируется событие на изменение этого реквизита.
	Изменение реквизита «Число», формат «Проценты»	Событие на установку/изменение значения соответствующего реквизита у существующих дискуссий / документов / объектов / согласований / записей справочника.
	Установка реквизита «Процесс»	• Событие на установку значения соответствующего реквизита (в момент создания дискуссии / документа / объекта / согласования / записи справочника). • Если в момент создания дискуссии / документа / объекта / согласования / записи справочника значение реквизита не указано, то событие не генерируется. • При последующих установках/изменениях значения соответствующего реквизита в уже созданных дискуссиях / документах /объектах /согласованиях / записях справочника генерируется событие на изменение этого реквизита.
	Изменение реквизита «Процесс»	Событие на установку/изменение значения соответствующего реквизита у существующих дискуссий / документов / объектов / согласований / записей справочника.
	Установка реквизита «Строка»	• Событие на установку значения соответствующего реквизита (в момент создания дискуссии / документа / объекта / согласования / записи справочника). • Если в момент создания дискуссии / документа / объекта / согласования / записи справочника значение реквизита не указано, то событие не генерируется. • При последующих установках/изменениях значения соответствующего реквизита в уже созданных дискуссиях / документах / объектах /согласованиях / записях справочника генерируется событие на изменение этого реквизита.
	Изменение реквизита «Строка»	Событие на установку/изменение значения соответствующего реквизита у существующих дискуссий / документов / объектов / согласований / записей справочника.
Согласования	Создание/изменение согласования	• Событие, на основе которого генерируются следующие события: º Создание согласования º Изменение согласования • Содержит список `NegotiationRequisitesChanges` установленных или измененных значений реквизитов согласования в процессе его создания/изменения. ° По таким реквизитам генерируются события на установку или изменение соответсвующего типа реквизита согласования).
	Создание согласования	• Событие на создание согласования • Содержит список `NegotiationRequisitesChanges` установленных или измененных значений реквизитов согласования в процессе его создания. º По таким реквизитам генерируются события на установку или изменение соответсвующего типа реквизита согласования.
	Изменение согласования	• Событие на изменение согласования. • Событие, на основе которого генерируются следующие события: º Перемещение согласования по иерархии ° Согласование закрыто • Так же генерируется при изменениях в списке `NegotiationRequisitesChanges` (см. ниже) • Содержит список `NegotiationRequisitesChanges` установленных или измененных значений реквизитов согласования в процессе его изменения. ° По таким реквизитам генерируются события на установку или изменение соответсвующего типа реквизита согласования).
	Перемещение согласования по иерархии	• Событие на перемещение согласования по иерархии объектов Системы. • Содержит список `NegotiationRequisitesChanges` установленных или измененных значений реквизитов согласования в процессе его перемещения. º По таким реквизитам генерируются события с базовым типом (на установку или изменение соответсвующего типа реквизита согласования).
	Согласование закрыто	• Событие на закрытие согласования. • Содержит список `NegotiationRequisitesChanges` установленных или измененных значений реквизитов согласования в процессе его закрытия. ° По таким реквизитам генерируются события на установку или изменение соответсвующего типа реквизита согласования.
	Маршрут согласования пройден	• Генерируется при отправке запроса типа «Запрос о завершении согласования». Примечание: данный запрос отправляется автору согласования когда все согласующие в его маршруте дали ответ «Согласовано»/«Отказано» (во вкладку «Входящие» на главной странице Системы). • Содержит список `NegotiationRequisitesChanges` установленных или измененных значений реквизитов согласования в процессе его перемещения. º По таким реквизитам генерируются события на установку или изменение соответсвующего типа реквизита согласования.
	Создание/изменение маршрута согласования	Событие, на основе которого генерируются следующие события: • Создание маршрута согласования • Изменение маршрута согласования
	Создание маршрута согласования	• Событие на установку маршрута согласования. • Генерируется в момент создания согласования или согласования формы. • Содержит список пользователей и их настройки в маршруте согласования. Каждый пользователь списка содержит следующие данные: º Id (Идентификатор согласующего в маршруте согласования) º MemberId (Идентификатор карточки пользователя-согласующего) º Order (Порядковый номер пользователя в списке согласующих). Примечание: определяет принадлежность пользователя к группе согласующих. Если порядковый номер у нескольких согласующих один и тот же, то это означает, что пользователи находятся в одной и той же группе (актуально для последовательно-параллельного, параллельного маршрутов согласований) º Period (Плановый срок на ответ «Согласовано»/ «Отказано» (число)) º PeriodUnits (Единицы измерения срока на ответ. Возможные значения: Hours - рабочих часов; Days - рабочих дней)
	Изменение маршрута согласования	• Событие на изменение маршрута согласования. • Генерируется при изменении маршрута согласования у существующего согласования или согласования формы. • Содержит список пользователей и их настройки в новом маршруте согласования. • Содержит список пользователей и их настройки в предыдущем маршруте согласования. • Каждый пользователь списка содержит следующие данные: º Id (Идентификатор согласующего в маршруте согласования) º MemberId (Идентификатор карточки пользователя-согласующего) º Order (Порядковый номер пользователя в списке согласующих). Примечание: определяет принадлежность пользователя к группе согласующих. Если порядковый номер у нескольких согласующих один и тот же, то это означает, что пользователи находятся в одной и той же группе (актуально для последовательно-параллельного, параллельного маршрутов согласований) º Period (Плановый срок на ответ «Согласовано»/ «Отказано» (число)) º PeriodUnits (Единицы измерения срока на ответ. Возможные значения: Hours - рабочих часов; Days - рабочих дней)
Справочники	Создание/изменение записи справочника	• Событие на основе которого генерируются следующие события: º Создание записи справочника º Изменение записи справочника • Содержит список «DirectoryRecordFieldsChanges» установленных или измененных значений реквизитов записи справочника в процессе ее создания/изменения. º По таким реквизитам генерируются события на установку или изменение соответствующего типа реквизита записи справочника.
	Создание записи справочника	• Событие на создание записи справочника • Содержит список `DirectoryRecordFieldsChanges` установленных или измененных значений реквизитов записи справочника в процессе ее создания. º По таким реквизитам генерируются события на установку или изменение соответствующего типа реквизита записи справочника.
	Изменение записи справочника	• Событие на изменение записи справочника • Генерируется при изменениях в списке `DirectoryRecordFieldsChanges`. • Содержит список `DirectoryRecordFieldsChanges` установленных или измененных значений реквизитов записи справочника в процессе ее изменения. • По таким реквизитам генерируются события на установку или изменение соответствующего типа реквизита записи справочника.
	Удаление записи справочника	• Событие на удаление записи справочника.
Табель учета времени	Отправка табеля учета времени на утверждение	Событие на отправку табеля учета времени на утверждение
Таймер	Запланированное событие таймера	Событие на основе которого генерируются следующие события: • Запланированное повторяющееся событие таймера • Событие таймера, запланированное по подписке
	Запланированное повторяющееся событие таймера	• Событие генерируется по расписаниям всех пользовательских бизнес-операций, указанных в основной Системе в разделе «Администрирование/Дополнительные сервисы/Расписание пользовательских бизнес-операций».
	Событие таймера, запланированное по подписке	• Событие, которое генерируется с помощью API метода `InsertTimerEvent`. • Событие срабатывает 1 раз и в дату и время, которые были заданы в параметре `CallTime` API метода `InsertTimerEvent` при создании этого события.
	Напоминание о запланированном событии	• Вспомогательное событие, обеспечивающее сработку триггера в запланированное время. • Событие генерируется ПЕРЕД генерацией событий «Запланированное повторяющееся событие таймера» и «Событие таймера, запланированное по подписке»
Уведомления	Послано уведомление	• Вспомогательное событие, фиксирующее факт отправки события в очередь триггеров. • Событие генерируется ПОСЛЕ генерации событий «Запланированное повторяющееся событие таймера» и «Событие таймера, запланированное по подписке»
Форма сбора отчетности	Отправка	Событие, на основе которого генерируются следующие события: • Отправка формы сбора отчетности к адресату • Отправка формы сбора отчетности к адресатам
	Отправка адресату	Событие на отправку формы сбора отчетности к адресату
	Отправка адресатам	• Содержит список `Addressees` запросов на заполнение формы отправленных к адресатам. По таким запросам генерируются события на отправку формы сбора отчетности к адресату.
Входящие запросы	Приемка объекта	Генерируется при приемке или отклонении запроса типа «Перевод проекта в статус «На проверке»». Примечание: данный запрос отправляется уполномоченному руководителю объекта (во вкладку «Входящие» на главной странице Системы) при переводе объекта в статус «На проверке», если: • У объекта роли «Руководитель» и «Исполнитель» занимают разные пользователи • Включена опция «Использовать процедуру приемки задач» (Администрирование/Общие настройки)
	Отказ от принятия полномочий	Событие на основе которого генерируются следующие события: • Отказ от принятия полномочий руководителя • Отказ от принятия полномочий исполнителя • Отказ от принятия полномочий участника
	Отказ от принятия полномочий руководителя	Генерируется при отклонении запросов типа «Передача полномочий руководителя на проект» и «Временная передача полномочий руководителя на проект». Примечание: данные запросы отправляются, только если отключена опция «Пропускать фазу подтверждения принятия полномочий на проект» (Администрирование/Общие настройки)
	Отказ от принятия полномочий исполнителя	Генерируется при отклонении запросов типа «Передача полномочий исполнителя на проект» и «Временная передача полномочий исполнителя на проект» Примечание: данные запросы отправляются, только если отключена опция «Пропускать фазу подтверждения принятия полномочий на проект» (Администрирование/Общие настройки)
	Отказ от принятия полномочий участника	Генерируется при отклонении запроса типа «Приглашение участника в проект». Примечание: данный запрос отправляется при делегировании роли «Участник» в объектах типа «Проект» и «Задача», независимо от состояния опции «Пропускать фазу подтверждения принятия полномочий на проект» (Администрирование/Общие настройки)
Пользователи	Создание профиля пользователя	• Событие генерируется в случае корректного сохранения нового пользователя через интерфейс системы, или через API метод CreatePerson. • На каждого нового пользователя отправляется одно событие.
	Изменение профиля пользователя	• Событие генерируется в случае корректного сохранения изменений параметров имеющегося пользователя через интерфейс системы, или через API метод EditPerson. • На каждый измененный профиль пользователя отправляется одно событие.
	Пользователю назначена группа	• Событие генерируется в случае, если пользователю назначена одна или несколько новых групп пользователей. • На каждую новую группу отправляется одно событие.
	Пользователь исключен из группы	• Событие генерируется в случае, если пользователя удалили из одной или несколько групп пользователей. • На каждую удаленную группу отправляется одно событие.

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

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

← К оглавлению

Запуск по таймеру→

Принцип работы триггеров

anonymous@undisclosed.example.com (Anonymous) — Tue, 17 Dec 2024 08:30:20 +0000

Принцип работы триггеров

Триггеры пишутся на языке C#.

Где интерфейс настройки триггеров?

Триггеры – это отдельный подключаемый модуль. Чтобы получить к нему доступ, обратитесь к вашему менеджеру или в техническую поддержку.

Отфильтровать

Половина работы триггера: это понять, на какие события он должен реагировать.

Фильтрация событий проходит в несколько этапов с помощью 3 инструментов, которые дополняют друг друга.

Простой фильтр на события, который есть прямо в интерфейсе модуля триггеров.
LINQ-запрос(ы). Может как использоваться, так и не использоваться. Удобно, чтобы выбрать из большой базы данных какие-то специфичные объекты.
В рамках написания прописываются дополнительные условия – как раз здесь используется настроенный LINQ-запрос для последней тонкой фильтрации событий.

Как это выглядит в интерфейсе модуля триггеров:

Фильтрация на уровне интерфейса модуля триггеров:

Тонкая фильтрация в условии триггера:

Отреагировать

События, которые попали под условия фильтров, запускают написанный скрипт. Результатом работы скрипта могут быть небольшие вычисления, создание новых записей в справочнике, новых объектов, изменение статусов, изменение значений реквизитов, их блокировка и т.д.

Триггеры работают через интеграционное API ADVANTA. ⇒ Всё, что можно сделать через API, триггер может запустить в системе.

Как это выглядит в интерфейсе модуля триггеров:

← К оглавлению

Интерфейс →

Установка модуля триггеров

anonymous@undisclosed.example.com (Anonymous) — Fri, 22 Mar 2024 10:25:16 +0000

Установка модуля триггеров

Инструкция по установке модуля триггеров версии 16.Х в ОС Windows
Инструкция по установке модуля триггеров версии 17.Х и выше в ОС Windows | в ОС Linux

← К оглавлению

Интерфейс

anonymous@undisclosed.example.com (Anonymous) — Mon, 22 Aug 2022 10:11:38 +0000

Интерфейс

Модуль триггеров состоит из

обработчика (Engine)
сайта со своим адресом и интерфейсом.

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

Начиная с версии модуля триггеров 17.Х появились 3 компонента:

Движок исполнения
Сайт для настройки
Агент, который следит за состоянием движков исполнения и перезапускает их при необходимости

Авторизация на сайте возможна с учетной записи Администратора Системы.

Главная страница сайта состоит из 4 блоков:

Управление триггерами
Мониторинг триггеров
Импорт
История изменений

Элементы в горизонтальном меню сайта

Информация о версии модуля триггеров и дате старта (перезагрузки) его обработчика
ФИО пользователя, под которым осуществлен вход
Статус, отображающий состояние обработчика модуля триггеров в виде кругового индикатора
Кнопки play / pause для приостановки или возобновления работы обработчика

Страница "Управление триггерами"

Содержит:

Перечень всех созданных триггеров
Фильтр по параметрам и состоянию триггерам
Кнопку «Начать экспорт» - экспорт настроек опубликованной активной версии указанных триггеров в файл формата *.json.
Кнопка создания нового триггера . О создании нового триггера читайте здесь.

Созданные триггеры можно отфильтровать по:

названию
тэгам
автору
временному периоду создания / публикации (дата указывается в формате ДД.ММ.ГГГГ)
номеру в очереди
среднему времени исполнения
состоянию триггера

Страница "Мониторинг триггеров"

Содержит:

Перечень всех произошедших задач (действий) по обработке возникших в Системе событий, созданных на сайте триггерами
Фильтр по названию триггера, названию события, состоянию задачи или дате начала ее выполнения

Подробнее про мониторинг триггеров - здесь.

События мониторинга можно отфильтровать по:

названию триггера
событию (подробнее о событиях тут)
номеру задачи
тэгам
временному периоду (дата указывается в формате ДД/ММ/ГГГГ)
параметру и его значению
состоянию задачи

Страница "Импорт"

Содержит:
интерфейс для загрузки файла *.json.

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

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

Экспорт и импорт триггеров в формате *.json можно использовать для бэкапа триггеров, а также для переноса готовых триггеров из тестовой среды на прод.

Страница "История изменений"

Cодержит:

логи изменений триггеров
фильтр

Можно отфильтровать логи по:

названию фильтра
пользователю, который внес изменения
временному периоду (дата указывается в формате ДД/ММ/ГГГГ)

← К оглавлению

Создание триггера →

Библиотека триггеров

anonymous@undisclosed.example.com (Anonymous) — Tue, 10 Oct 2023 12:20:09 +0000

Библиотека триггеров

Подраздел

* Сценарий 1 * Сценарий 2

Библиотека сценариев Цифрового помощника

anonymous@undisclosed.example.com (Anonymous) — Sun, 30 Mar 2025 20:16:40 +0000

Библиотека сценариев Цифрового помощника

Мы собрали и описали наиболее часто используемые нашими клиентами алгоритмы автоматизации.

Рассылка отчетов и уведомлений

Автоматизация рутинных операций

Ролевые операции

Экспертные подсказки

Дополнительные сценарии Цифрового помощника могут быть разработаны индивидуально под потребности Заказчика.

Другие возможные сценарии использования Цифрового помощника

Мониторинг триггеров

anonymous@undisclosed.example.com (Anonymous) — Mon, 22 Aug 2022 10:14:46 +0000

Мониторинг триггеров

Модуль триггеров протоколирует каждую сработку каждого триггера с определенным статусом.

Интерфейс

Страница «Мониторинг триггеров» содержит перечень всех произошедших задач (действий) по обработке возникших в Системе событий, созданных на сайте триггерами.
Каждая задача отображает:

Статус в виде иконки
Дату и время начала выполнения
Название триггера, который обработал событие
Название обработанного события
Время обработки
Кнопку «Перезапустить задачу» для повторной обработки события триггером

В окно «Объект события» выводятся параметры события и их значения.

В окно «Лог» (лог выполнения задачи) выводятся все промежуточные данные, которые были спроектированы при написании триггера.

Приницпы

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

Настоятельно рекомендуется выводить в лог работы триггера полученные промежуточные данные, а также результаты выполнения методов API, т. к. это может потребоваться позже, в случае проверки, почему триггер сработал так, а не иначе. Чем подробнее будет лог, тем проще потом искать отклонения.

TriggerConsole.WriteLine(string text); - метод для вывода строки текста в протокол выполнения триггера. Текст будет доступен для просмотра в мониторинге сработок триггеров.

← К оглавлению

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

Создание триггера

anonymous@undisclosed.example.com (Anonymous) — Thu, 01 Feb 2024 11:41:23 +0000

Создание триггера

Триггер в ADVANTA содержит указание, когда он должен сработать, набор проверок, когда нужно выполнить набор действий, и сам набор действий.
Кнопка создания триггера расположена в разделе «Управление триггерами».

Страница создания нового триггера

Содержит следующие поля:
1. Название
2. Описание
3. Теги — используются для дальнейшего поиска триггера в списке на странице «Управление триггерами»
4. Таймаут, сек
5. Выпадающий список «Порядок обработки событий» с 3 вариантами:

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

6. Переключатель «Выполнять повторно при сбое».
7. Выпадающий список «События» – перечень всех событий, которые генерирует Система при выполнений каких либо действий в ней. Исчерпывающий перечень событий на которые можно создать триггер.
8. Окно «Условие» – окно для записи, отображения и изменения кода C#.
В данном окне необходимо написать код условия, который должен возвращать либо значение false, либо значение true. Необходимо вернуть false, если скрипт выполнять не требуется.

9. Окно «Скрипт» – окно для записи, отображения и изменения кода C#.
В данном окне необходимо написать код основной логики (действий) триггера, который будет выполняться при выполнении Условия.
10. Кнопки «Опубликовать» и «Удалить».

Немного о создании триггеров в целом

Половина работы триггера: это понять, на какие события он должен реагировать.

Фильтрация событий проходит в несколько этапов с помощью 3 основных инструментов, которые дополняют друг друга.

Простой фильтр на события, и связанные с ними объекты, который есть прямо в интерфейсе модуля триггеров в выпадающем списке.
LINQ-запрос(ы) - используются (при необходимости) в фильтрации событий и в самих скриптах. Подробнее о настройке LINQ-запросов - здесь.
Дополнительная логика, прописанная в окне «Условие» для последней тонкой фильтрации событий.

В Системе можно создать источник данных LINQ и задать ему референсный ключ, чтобы в дальнейшем по нему вызвать этот источник в Условии триггера или в самом Скрипте.

Вызов API в триггерах

Триггеры работают через интеграционное API ADVANTA ⇒ Всё, что можно сделать через API, триггер может сделать в системе.

Перед вызовом API нужно везде указывать await, иначе произойдет инициация кода вызова без ожидания результата.

Создание нового объекта - пример:

var newItem = new Api.Projects.CreateProjectDataContract
{
    // some code ...
};
 
// create new Item using ADVANTA API
var  newItemID = await Api.Projects.CreateProjectAsync(newItem);

Триггер по мере необходимости создает SOAP-клиенты для взаимодействия с SOAP API (иначе пришлось бы перед каждым вызовом API создавать нужные SOAP-клиенты).
По завершению триггера все открытые триггером SOAP-клиенты закрываются.

Если не дождаться через await вызова API, то может произойти завершение работы триггера раньше, чем завершится вызов.
В итоге произойдет ошибка при вызове.

Локальные функции

Если требуется определить собственную локальную функцию/процедуру для использования в скрипте триггера, то ее описание должно быть сделано с использованием префикса async в следующем формате

async Task<string> MyFunctionName()
{
   // your code ...
   return result;
}

где вместо string необходимо указать тип переменной, которая будет возвращаться из локальной функции.

Если возвращать из функции ничего не требуется, то определение функции будет в формате:

async Task MyFunctionName()
{
   // your code ...
}

Для вызова созданной таким образом локальной функции/процедуры внутри скрипта триггера, рекомендуется использовать префикс await для ожидания ее завершения.

var result = await MyFunctionName();

Пример объявления локальной функции и ее вызова:

async Task CreateLog(string Text) 
{
    TriggerConsole.WriteLine(Text);
    await System.Threading.Tasks.Task.Delay(1000);
}
 
for(int i = 0; i < 10; i++) 
{
    await CreateLog(i.ToString());
}

Встроенные переменные

Context.ApplicationId - ID приложения Адванты, если настроено
Context.EventId - ID сообщения в шине
Context.EventSentTime - Время отправки сообщения из системы
Context.Host - Адрес системы, по которому она установлена
Context.PersonId - ID пользователя вызвавшего появление события
Context.PrincipalId - ID внутреннего пользователя системы (обычно не используется)
Context.SessionId - ID сессии, от которой модуль триггеров работает в системе. Нужен для передачи в API методы

Event - Содержит параметры события, на которое сделан триггер.
Контекстно определяется тем событием, на которое написан триггер.
В общем случае разные типы событий содержит разный набор полей.

← К оглавлению

Мониторинг→

Уведомления от триггеров в интерфейсе

anonymous@undisclosed.example.com (Anonymous) — Mon, 22 Aug 2022 10:17:13 +0000

Уведомления от триггеров в интерфейсе

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

Функциональность требует обязательно предварительной настройки! Она не появляется при обновлении системы «из коробки».

Все уведомления от триггеров отображаются под колокольчиком в горизонтальном меню:

По клику на колокольчик выводится список уведомление, которые вы можете вручную скрыть:

Текст внутри триггера формирует тот, кто это уведомление настраивает через интерфейс настройки триггеров. Это полностью кастомное решение для каждой инсталляции ADVANTA.

Идея уведомлений первоначально родилась как инструмент, который бы рассказал пользователю о том, что «под капотом» сделал триггер после его действия.
Например, вы закрыли дискуссию, в которой были указаны специфичные реквизиты. Триггер сработал на это событие разворачиванием нового проекта с заданными параметрами. С позиции пользователя – это абсолютно неочевидное действие. И именно для того, чтобы избавиться от неопределённости и проинформировать придумали этот тип уведомлений.

Но на самом деле уведомления могут работать и оповещать пользователей по тем сценариям, которые нужны именно вам в вашем бизнес-процессе.

Как настроить кастомные уведомления

Триггеры работают через интеграционное API, и для уведомлений есть отдельный API-метод: SendMessage с параметрами

SessionID
PersonIDList – список GUID пользователей получателей сообщения
Message – html для отображения сообщения
MessageType – тип сообщения:
- 0 - Информационное
- 1 – Важное сообщение

Настраивайте триггеры с этим методом – и события, которые вы «скормите» этому методу, будут выводиться у указанных пользователей в горизонтальном меню.

← К оглавлению

Демо работы триггеров →

Перенос модуля Триггеров с ОС Windows на ОС Linux

anonymous@undisclosed.example.com (Anonymous) — Thu, 26 Sep 2024 05:14:20 +0000

Перенос модуля Триггеров с ОС Windows на ОС Linux

В первую очередь необходимо подготовить сервер с «чистой» установкой модуля Триггеров на ОС Linux.

Инструкция по первичной установке модуля Триггеров в ОС Linux.

Возможно несколько комбинаций переноса модуля триггеров:

база данных модуля Триггеров не меняется (СУБД остается на том же сервере MS SQL/PostgreSQL), а осуществляется только перенос модуля Триггеров расположен с сервера на ОС Windows на сервер с ОС Linux;
и модуль триггеров, и его база данных перемещаются на ОС Linux (либо наоборот на ОС Windows);
когда тип СУБД (MS SQL/PostgreSQL) не меняется, но сервер базы данных переносится с ОС Windows на ОС Linux.

Перенос модуля Триггеров (когда сервер БД не изменяется)

Остановить модуль Триггеров, который установлен на ОС Windows, – все его компоненты: Сайт, Движок и Агент. Отключить их автоматический запуск при перезагрузке сервера.
Сделать резервную копию текущей БД триггеров (на случай отката).
На сервер с «чистой» установкой Триггеров в ОС Linux перенести настройки с модуля Триггеров, установленного на сервере с ОС Windows (конфигурационный файл с параметрами приложения и подключениями к БД).
При необходимости, скорректировать в конфигурационном файле параметры (в первую очередь - пути к рабочим каталогам и доменные имена), для корректной работы Триггеров на сервере с ОС Linux. Рекомендуется открыть инструкции по развёртыванию модуля Триггеров на ОС Linux и на ОС Windows и выполнить сравнение параметров, т.к. у них есть небольшие отличия.
Проверить подключение установленного на ОС Linux модуля триггеров к ранее используемой БД модуля триггеров на MS SQL/PostgreSQL.
Проверить настройки компонента «Агент» в среде ОС Linux, чтобы они содержали корректный путь к компоненту «Движок» для его запуска.
Запустить на сервере с ОС Linux компоненты модуля Триггеров, сначала «Сайт» и затем «Агент», который автоматически запустит «Движок».

Полный перенос модуля Триггеров (вместе с БД)

Процедура миграции содержимого служебной БД модуля триггеров не предусмотрена.

Зайти в веб-панель управления текущим модулем триггеров
В разделе «Управление триггерами» в правом верхнем углу нажать кнопку «Начать экспорт» и выбрать все сценарии триггеров, которые необходимо перенести на ОС Linux, и по кнопке «Экспортировать» (в шапке раздела) сохранить настроенные сценарии в текстовый файл в формате .json.
Полностью остановить работу модуля триггеров, установленного на ОС Windows. Отключить автоматический запуск компонентов модуля Триггеров при перезагрузке сервера.
Сделать резервную копию БД триггеров (для возможности отката).
Развернуть модуль триггеров на ОС Linux и новую БД на MS SQL/PostgreSQL.
Запустить компоненты «Сайт» и «Агент»
Импортировать из файла .json все ранее сохраненные триггеры через раздел «Импорт» веб-панели управления модулем Триггеров в ОС Linux.

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

Перенос только сервера БД

Сделать резервную копию БД триггеров и остановить модуль триггеров, который установлен на ОС Windows.
Восстановить резервную копию БД модуля триггеров на ОС Linux.
В конфигурационном файле appsettings.json прописать новый путь к БД модуля триггеров.

Возможные сценарии использования Триггеров

anonymous@undisclosed.example.com (Anonymous) — Sun, 30 Mar 2025 20:17:19 +0000

Возможные сценарии использования Триггеров

Поддержка инициации проектов

Поддержка планирования проектов

Поддержка реализации проектов

Поддержка регулярного менеджмента

Поддержка согласований и принятия решений

Поддержка управления финансами

Уведомления и предупреждения

Блокировка данных от внесения изменений

Информирование ТОП-менеджера о статусе проектов

Поддержка работы с документами

Библиотека примеров настроенных сценариев

Что такое Цифровой помощник (триггеры) в ADVANTA

Технические требования для модуля Триггеры

anonymous@undisclosed.example.com (Anonymous) — Thu, 11 Sep 2025 10:15:42 +0000

Технические требования для модуля Триггеры

Триггеры – это кроссплатформенный модуль. Можно поставить на Windows Server или на Linux. Может использовать как базу MS SQL или PostgreSQL.

Требования к ПО на сервере

IIS 8.5
Windows server 2019 и выше
Один из вариантов СУБД:
- MSSQL (тестировалось на версии 2016 Express Edition+, минимальная версия MSSQL 2012) + Microsoft SQL Server Management Studio (SSMS) соответствующей версии
- PostgreSql версии 13+ (возможна установка на более раннюю версию Postgres, но тогда потребуется вносить правки в код)
Элемент ненумерованного списка.net 6 hosting bundle (с версии 17.25 и выше, до версии 17.22 включительно достаточно .net 5)

Требования к производительности сервера

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

Триггеры состоят из 2 частей:

Веб интерфейс
База данных

	Веб интерфейс	База данных
Требования к месту на жестком диске	100мб	Зависит от количества триггеров, частоты их использования. От 100мб
Требования к оперативной памяти	1Гб	1Гб
Требования к процессору	1-2 ядра	1-2 ядра
Где может быть запущено	IIS (windows 2019) 8.5.	Windows, Linux MS SQL Server 2019 или выше postgresql версии не ниже 10+ Версия SQLServer, на которой должна быть запущена ADVANTA – 2008R2 с последним сервис паком обновлений. Без обновлений может не работать.
Минимальные требования	Windows server 2019	Windows, Linux (работоспособность проверялась на Ubuntu 18)

Исходя из текущего опыта эксплуатации¹⁾, оптимальный вариант:

Веб-интерфейс запускается на том же сервере, где и стоит ADVANTA. В этом случае не понадобится никаких изменений в инфраструктуре.
База данных на том же сервере, где расположена основная база данных системы.
Если версия SQL не соответствует минимальной необходимой для триггеров (2012), то оптимальным вариантом будет установка на сервер баз данных PostgreSQL. В отдельном сервере нет необходимости.

← К оглавлению

Инструкции по установке модуля триггеров →

¹⁾

май 2020

Цифровой помощник

anonymous@undisclosed.example.com (Anonymous) — Fri, 24 Jan 2025 11:28:04 +0000

Цифровой помощник

Цифровой помощник (ранее «Триггеры») – это отдельный модуль, который общается с системой по интеграционной шине и запускает выполнение запрограммированного сценария по событию, по действию пользователя или по расписанию.

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

Библиотека сценариев Цифрового помощника

Дополнительные возможности использования

Теория: что такое триггеры и когда начать автоматизировать

Как работают триггеры

Запуск триггера по таймеру

Уведомления от триггеров

Персонализированные команды над объектами

Технические требования

Описание обновлений версий модуля Триггеров

Инструкции

Установка модуля

Обновление модуля

Перевод с ОС Windows на ОС Linux

Перенос на СУБД другого типа

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

anonymous@undisclosed.example.com (Anonymous) — Tue, 25 Feb 2025 15:00:44 +0000

Подписка на события таймера и создание регулярного таймера

Таймер, на который смотрит триггер, позволяет обрабатывать события типа «Если через X часов не произошло что-то, то делать предусмотренное действие».
Т.е. можно проверить через некоторое время, выполнилось ли нужное условие, или нет.

Также таймер пригодится, если нужно вызывать с какой-то периодичностью скрипт, не привязанный к объектам системы, а в рамках общей логики.

Управление событиями таймера

ADVANTA → «Администрирование» → «Дополнительные сервисы» → «Расписание пользовательских бизнес-операций».

«Код операции» – числовой код операции
«Название операции» – из справочника бизнес операций, отображается как гиперссылка на страницу редактирования / удаления соответствующей записи о таймере.
«Расписание» – расписание, по которому срабатывает таймер. Например: «Еженедельно, каждый пн, пт, каждую N неделю, в XX:YY», или «Периодически раз в 2:00».
«Последняя сработка» – дата и время последней генерации соответствующего события, если оно наступало.
Если событие еще не наступило, то пусто.

По любой колонке можно эту таблицу отсортировать.

При нажатии на «Добавить», отображается окно

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

Справочник бизнес операций

При вызове по ссылке «Справочник бизнес операций» из формы «Управление событиями таймера», открывается форма с таблицей:

«Код операции» – Уникальное числовое значение, при вставке заполняется автоматически, как максимум по значениям этого поля + 1. Передается вместе с событием в виде параметра.
«Название» – Текстовое название операции.

При нажатии на кнопку «+ Добавить», отображается поле для ввода названия бизнес операции (как при редактировании), но изначально пустое.

После заполнения и сохранения:

операция сохраняется,
ей присваивается новый код – порядковый номер сохранённой бизнес-операции.

Связанные API методы

InsertTimerEvent

Cохраняет в очереди один вызов.

Параметры метода:

SessionID	ID сессии пользователя
CallTime	обязательный параметр типа DateTime в котором содержится дата и время, когда необходимо послать сообщение на шину.
ObjectID	GUID объекта, идентификатор, смысл которого будет известен при создании логики обработки, может быть идентификатором объекта дерева, записи справочника, пользователя и т.п. параметр не обязательный, если он не требуется, то вместо него должен допускаться null
OperationCode	обязательный целочисленный параметр с кодом операции. Код должен быть зарегистрирован в справочнике кодов операций, если его там нет, то ошибка «Код операции не зарегистрирован»
Parameters	объект типа JSON, в котором вызывающий может сохранить дополнительные параметры, которые будут необходимы при последующей обработке.

Метод не возвращает ничего если завершение успешно. Если не успешно, то вызывает исключение.

CheckTimerEvent

Проверяет, есть ли заданный вызов в очереди среди будущих и еще не сработавших элементов очереди.

Параметры метода:

SessionID	ID сессии пользователя
OperationCode	обязательный целочисленный параметр с кодом операции
ObjectID	GUID объекта. Не обязательный параметр. Если он передан, ищутся сохраненные в очереди записи с точным совпадением на GUID и код операции. Если параметр null, то необходимо искать в очереди записи только с кодом операции и ObjectID = null.

Возвращать метод должен список, содержащий удовлетворяющие условию поиска элементы очереди с параметрами (CallTime, Parameters), в том числе может быть пустой список, если поиск успешен, если поиск не успешен, то вызывает исключение.

Генерация событий в шину по подписке

При наступлении времени, когда должно быть отправлено в шину событие, в зарегистрированных через метод InsertTimerEvent и не обработанных еще на момент наступления заданного времени, генерируется отправка в шину события типа «Подписка на таймер», с параметрами, сохраненными в нем при подписке:

OperationCode
ObjectID
Parameters

Подписка отмечается как исполненная.

Генерация событий в шину по регулярному таймеру

При наступлении времени, когда должно быть отправлено событие, согласно таблице настроек, в шину отправляется событие типа «Таймер», которое содержит параметры:

OperationCode

Одновременно должно быть сохранено время последней сработки.

← К оглавлению

Уведомления →

Обновление версии модуля Триггеров

anonymous@undisclosed.example.com (Anonymous) — Tue, 15 Oct 2024 10:24:06 +0000

Обновление версии модуля Триггеров

Инструкция по обновлению версии актуальна для модуля Триггеров как на ОС Windows, так и на ОС Linux.

Шаги обновления версии модуля Цифровой помощник (Триггеры):

Прекратить вносить любые изменения в настройке модуля Триггеров - необходимо обеспечить выход из панели настройки Триггеров всех пользователей.
Остановить модуль Триггеров – все его компоненты в следующей последовательности: «Сайт», «Агент» и «Движок». По возможности, остановить СУБД модуля Триггеров. Отключить их автоматический запуск при перезагрузке сервера.
Сделать резервную копию папки с текущей версией модуля триггеров и резервную копию Базы данных Триггеров (на случай отката).
Распаковать новый дистрибутив модуля триггеров: либо в новую папку (предпочтительно), либо в ту же папку, где располагалась предыдущая версия модуля Триггеров.
Из резервной копии конфигурационных файлов *.json «Сайта», «Агента» и «Движка» текущей версии модуля Триггеров перенести в конфигурационные файлы новой версии нужные параметры (ConnectionString и др.). Также необходимо отдельно настроить новые параметры, которые появились в конфигурационных файлах обновленной версии модуля Триггеров.
Запустить сервис СУБД (если был отключен) и компоненты модуля Триггеров в следующем порядке: сначала «Сайт» и затем «Агент», который автоматически запустит «Движок».

Если новая версия модуля Триггеров установлена в другую папку, то необходимо проверить, что в конфигурационных файлах компонентов модуля Триггеров (Сайт, Движок и Агент) параметры и пути к файлам заполнены правильно.

Wiki [3.x] product:triggers

Что такое Триггеры

Что такое Триггеры

Как именно триггеры покрывают бизнес-процессы

Когда начинать автоматизировать?

Ожидания VS Реальность

Будьте аккуратны!

Кейсы и сценарии

Перевод этапа жизненного цикла

Автоматическая запись в справочник

Кейс: Инициация проекта

Настраиваемые команды над объектами

Настраиваемые команды над объектами

Как создать команду?

Параметры настраиваемой команды

Использование настроенной команды

Что можно сделать?

Кейсы

Перенос модуля Триггеров на СУБД другого типа

Перенос модуля Триггеров на СУБД другого типа

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

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

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

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

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

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

Принцип работы триггеров

Принцип работы триггеров

Где интерфейс настройки триггеров?

Отфильтровать

Отреагировать

Установка модуля триггеров

Установка модуля триггеров

Интерфейс

Интерфейс

Элементы в горизонтальном меню сайта

Страница "Управление триггерами"

Страница "Мониторинг триггеров"

Страница "Импорт"

Страница "История изменений"

Библиотека триггеров

Библиотека триггеров

Подраздел

Библиотека сценариев Цифрового помощника

Библиотека сценариев Цифрового помощника

**Рассылка отчетов и уведомлений**

**Автоматизация рутинных операций**

**Ролевые операции**

**Экспертные подсказки**

Мониторинг триггеров

Мониторинг триггеров

Интерфейс

Приницпы

Создание триггера

Создание триггера

Страница создания нового триггера

Немного о создании триггеров в целом

Вызов API в триггерах

Локальные функции

Встроенные переменные

Уведомления от триггеров в интерфейсе

Уведомления от триггеров в интерфейсе

Как настроить кастомные уведомления

Перенос модуля Триггеров с ОС Windows на ОС Linux

Перенос модуля Триггеров с ОС Windows на ОС Linux

Перенос модуля Триггеров (когда сервер БД не изменяется)

Полный перенос модуля Триггеров (вместе с БД)

Перенос только сервера БД

Возможные сценарии использования Триггеров

Возможные сценарии использования Триггеров

Технические требования для модуля Триггеры

Технические требования для модуля Триггеры

Требования к ПО на сервере

Требования к производительности сервера

Цифровой помощник

Цифровой помощник

Инструкции

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

Подписка на события таймера и создание регулярного таймера

Управление событиями таймера

Например:

Пример 2:

Рассылка отчетов и уведомлений

Автоматизация рутинных операций

Ролевые операции

Экспертные подсказки