Описание работы с пакетом действий в новом интерфейсе администрирования (для версий 2.261 Лира и выше) |
|---|
Пакеты действий создаются и редактируются из категории (вкладка Smart) или раздела Общие SMART.
|
|---|
Некоторые действия могут выполняться корректно только в контексте конкретной категории. Такие действия недоступны при создании пакетов действий из раздела "Вы можете создать пакет, сразу привязав его к событию, или без привязки к событию.
Чтобы создать новый пакет действий, привязанный к событию, создайте новую привязку к нужному событию и затем из привязки нажмите кнопку Создать. Вы можете выбрать один из уже созданных пакетов в выпадающем списке, а чтобы изменить его, нажмите кнопку Редактировать.
Создание смарт-пакета, привязанного к событию
Чтобы создать новый пакет действий без привязки к событию, нажмите кнопку Создать пакет в разделе "Пакеты действий". Чтобы отредактировать уже существующий пакет, кликните мышью по его названию.
Создание смарт-пакета без привязки к событию
Откроется окно редактирования смарт-пакета. В окне указывается название пакета и настраиваются действия, которые будут последовательно выполнятся при запуске пакета. Изменить порядок действий в пакете можно, перетаскивая строки мышкой.
В поле "Описание пакета" вводится произвольный текст, описывающий логику пакета.
Окно редактирования смарт-пакета
|
|---|
|
|---|
Смарт-действия существуют только в составе пакета действий.
Создание и редактирование смарт-действия
Чтобы создать новое смарт-действие в пакете, в окне редактирования пакета нажмите кнопку Создать. Чтобы отредактировать настроенное ранее действие, кликните по кнопке 
в начале строки.
Создание/редактирование смарт-действия в пакете
Откроется окно создания и редактирования смарт-действия. Все реализованные в системе смарт-действия перечислены в выпадающем списке и распределены по смысловым блокам.
Список доступных смарт-действий
Вы можете выбрать нужное смарт-действие, просматривая весь список, или найти его по слову в названии — для этого начните набирать слово, и система подскажет возможные варианты.
Поиск смарт-действия по слову в названии
После выбора смарт-действия в окне редактирования отобразится список его параметров.
Окно создания и редактирования смарт-действия
Практически в каждом из возможных параметров система предлагает выбрать один из вариантов:
Значение |
Описание |
|
|---|---|---|
Значение |
Справа от параметра появляется поле для ввода фиксированного значения параметра нужного типа. Если значение имеет тип "Булево" (то есть может принимать значение "истина" или "ложь"), рядом с таким полем отображается флажок, который может быть включен или выключен |
|
Smart/TSQL |
Появляется возможность выбрать одно из сохраненных ранее смарт-выражений (из выпадающего списка), при необходимости изменить его (кнопка
|
|
Lua-скрипт |
Появляется возможность выбрать один из сохраненных ранее Lua-скриптов (из выпадающего списка), при необходимости изменить его (кнопка
|
|
Оставить пустым |
Если параметр необязательный, то значение ему не будет присвоено |
|
Текущая задача |
Доступно для параметров типа Задача. В этом случае действие будет выполнено в той же задаче, в которой происходит событие |
) или создать новое (кнопка По умолчанию действия выполняются в той же задаче, из которой вызываются. Если же действие должно быть выполнено в другой задаче (например, из родительской задачи нужно изменить значение ДП в подчиненной задаче), то в поле "Задача" необходимо указать ID целевой задачи. Если смарт-выражение в поле "Задача" возвращает несколько задач, то смарт-действие будет выполнено в каждой из них.
Если действия выполняются от имени какого-то пользователя, то этот пользователь должен обладать соответствующими правами. В противном случае при выполнении смарт-действия возникнет ошибка. Поэтому если есть возможность, действия следует выполнять от имени специального пользователя — системного робота, который обладает максимальными правами (в Общих настройках приложения этот пользователь указывается в поле "Диспетчер задач").
При выполнении некоторых смарт-действий можно писать "тихий" комментарий. Такой комментарий не имеет адресатов и не увеличивает счетчик индикатора непрочитанных комментариев у подписчиков задачи.
В параметрах, отмеченных знаком *, значение должно быть указано обязательно!
Автогенерация описания логики смарт-пакета
Для удобства работы со смарт-пакетами, содержащими несколько действий, в "Первой Форме" реализован механизм автогенерации описания логики, реализованной в пакете. При добавлении каждого действия вы можете отметить один или несколько параметров, определяющих суть действия (флажок "Превью"), и при сохранении смарт-действия по этим параметрам будет сгенерирован текст.
Автоматически сгенерированное описание смарт-действия в пакете
Автогенерация описаний смарт-действий, входящих в пакет, не изменяет поле описания самого пакета — это поле формируется вручную и может содержать произвольный текст.
Произвольное описание смарт-пакета
Описание смарт-действий, входящих в пакет, отображается также во всплывающем окне при наведении указателя мыши на название смарт-пакета в области привязки пакета в событию.
Описание смарт-пакета во всплывающем окне
Передача параметров между смарт-действиями
Некоторые смарт-действия возвращают результаты, эти результаты записываются в переменные. В описании таких смарт-действий присутствует фраза "(возвращает ХХХ)", где ХХХ — тип результата. Если в пакете есть такие смарт-действия, то в следующих смарт-действиях при редактировании смарт-выражений в дереве сущностей присутствует пункт "Переменные", в котором можно обратиться к результатам предыдущих смарт-действий
Обращение к результату предыдущего смарт-действия
Циклические смарт-пакеты
Если действия в пакете должны выполняться несколько раз для разных объектов, для пакета нужно включить признак циклического выполнения.
Циклический смарт-пакет
Для циклического пакета отображаются две дополнительные настройки:
•Список итерируемых объектов — список объектов, над которыми должен выполняться пакет. Список задается смарт-выражением, которое возвращает строку с ID объектов, перечисленными через запятую.
•Условие прерывания цикла — смарт-выражение с условием. Когда условие выполняется, цикл прерывается.
Каждому циклу неявным образом присваивается индекс итерации (счетчик повторов), который доступен в рамках смарт-пакета, вместе с текущим значением итератора (элемента списка итерируемых объектов).
Переменные циклического смарт-пакета
|
|---|
|
|---|
Выполнение циклического пакета
Логика работы:
•Вычисляется список итерируемых объектов и запускается цикл, перебирающий эти объекты;
•Значение текущего объекта из списка и индекс итерации передаются во все смарт-выражения в действиях пакета;
•Выполнение прекращается, когда пакет выполнен для всех объектов списка или когда выполнено условие прерывания цикла.
