Различия

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

--- product:triggers:button [23.12.2021 14:41] – [Как создать команду?] anna.makhneva
+++ product:triggers:button [02.09.2024 07:26] (текущий) – [Как создать команду?] ekaterina.menkhuzina
@@ Строка 1: / Строка 1: @@
-===== Персонализированные команды над объектами =====
+===== Настраиваемые команды над объектами =====
-Начиная с версии Системы //**3.24**// мы реализовали механизм, позволяющий создавать дополнительные команды над **пользовательскими** объектами без необходимости обновления Системы. \\ Такие команды вы сможете настроить по своему усмотрению.
+Начиная с версии Системы //**3.24**// мы реализовали механизм, позволяющий создавать дополнительные команды над **пользовательскими** объектами без необходимости доработки Системы. \\ Нужные команды вы сможете настроить по своему усмотрению.
 ==== Как создать команду? ====
@@ Строка 10: / Строка 10: @@
   - Заполните поля "Название команды" и "Описание", \\ <image shape="thumbnail"> {{:product:triggers:screenshot_12.png?nolink|}} </image>
   - Команда, которую создали внутри объекта, будет отображаться в виде кнопки в карточке всех объектов такого же типа в меню команд ("три точки"). \\ <image shape="thumbnail"> {{:releases:custom_triggers_for_users.png?direct&900|}} </image>
+''Начиная с версии системы 3.29'' появилась возможность также видеть и вызывать команды через [[product:objects:users:task_list:new_list|списки ]] - через иконку «три точки» объекта или через иконку «≡», если список представлен в виде таблицы.
+<image shape="thumbnail">{{ :product:objects:users:task_list:dots02.png?direct |}}</image>
+<image shape="thumbnail">{{ :product:objects:users:task_list:lines.png?direct |}}</image>
 <callout type="warning" icon="true"> **Что нужно знать про настройку команд**:\\
-К вашему экземпляру системы должен быть подключён [[product/triggers/start|модуль триггеров]].\\
+К вашему экземпляру Системы должен быть подключён [[product/triggers/start|модуль триггеров]].\\
 </callout>
-==== А что дальше? ====
-Система присваивает созданной команде уникальный идентификатор (uid). \\ Вызов команды с карточки объекта генерирует событие в шину данных с определёнными параметрами, включая uid команды, информацию о команде и об объекте, с которого вызвана команда. \\ На это событие можно подписать [[product/triggers/how_it_works|триггер]], который выполнит написанный в нем скрипт.
+==== Параметры настраиваемой команды ====
+''(доступно начиная с версии 3.27)''
+На странице настраиваемой команды в Административной панели есть возможность задать перечень групп пользователей, для которых будет доступна эта команда в меню объекта:
+<image shape="thumbnail">{{:product:triggers:2023-07-03_15-24-41.png?500|}}</image>
+\\
+Если команда создана без выбора групп пользователей, то она будет видна и доступна для вызова в меню «…» на карточках объектов данного типа у:
+  * Пользователей с лицензией «Администратор».
+  * Автора настраиваемой команды
+\\
+Если же в настройках команды указаны определенные группы пользователей, то она будет видна и доступна для вызова в меню «…» на карточках объектов данного типа у:
+  * Пользователей, которые входят в состав указанных групп (без дочерних), за исключением пользователей с лицензией "Наблюдатель". Если необходимо, чтобы пользователи из дочерних групп также имели доступ к этому пункту меню, необходимо их выбрать в настройках команды.
+  * Пользователей с лицензией «Администратор».
+  * Автора настраиваемой команды.
+\\
+Также можно настроить передаваемые при вызове команды параметров:
+<image shape="thumbnail">{{:product:triggers:2023-07-03_15-38-53.png|}}</image>
+\\
+В список параметров настраиваемой команды могут быть добавлены только реквизиты, имеющие тип:
+  * Строка (форматы: Текст, URL, E-Mail, Сетевая папка)
+  * Число (форматы: Число, Денежный, Проценты)
+  * Дата
+  * Процесс
+  * Классификатор (в т.ч. основанный на базовом объекте: Проект, Документ, Дискуссия, Пользователь, Статус объекта)
+\\
+После выбора реквизитов необходимо настроить их параметры:
+<image shape="thumbnail">{{:product:triggers:2023-07-03_15-46-46.png|}}</image>
+\\
+  * **Обязательный** - активируйте чекбокс, чтобы значение реквизита было обязательным к заполнению в окне ввода значений параметров команды при ее вызове.
+  * **Название передаваемого параметра** - название параметра, под которым в событие «Вызов настраиваемой команды по объекту» будет передано значение соответствующего реквизита.
+  * **Значение по умолчанию** - значение реквизита которое будет выбрано по умолчанию в окне ввода значений параметров команды при ее вызове.
+  * **Действия** - позволяет удалить реквизит
+\\ и затем нажать кнопку "Сохранить" в левой верхней части портлета "Параметры команды"
+==== Использование настроенной команды ====
+Система присваивает созданной команде уникальный идентификатор (guid). \\
+Вызов команды из меню карточки объекта сгенерирует событие "**Вызов настраиваемой команды по объекту**" в шину данных с определёнными параметрами, включая guid команды и guid объекта, из которого вызвана команда. \\
+На это событие можно подписать [[product/triggers/how_it_works|триггер]], который выполнит написанный в нем скрипт.
+\\
+''(доступно начиная с версии 3.27)''
+Если у настраиваемой команды заданы параметры (добавлен хотя бы один реквизит), то при ее вызове на странице объекта отображается всплывающее окно «Параметры команды»:
+{{:product:triggers:2023-07-03_16-19-02.png|}}
+\\
+В нем необходимо выбрать значения параметров и затем нажать кнопку "Выполнить".\\
+При таком сценарии, кроме  guid команды и guid объекта, из которого вызвана команда, в событие для обработки триггером будут переданы в качестве параметров и выбранные в форме значения реквизитов.
 ==== Что можно сделать? ====
 С помощью такой «кнопки» вы сможете настроить самые разные команды.\\ Например,
@@ Строка 38: / Строка 97: @@
 Логика была реализована функционалом [[product/triggers/about|модуля триггеров]] и [[product/api/list|API Системы]].
+<grid>
+<col sm="6">
+<btn block="true">[[product/triggers/start|← К оглавлению]]</btn>
+</col>
+<col sm="6">
+<btn block="true">[[/product/triggers/library|Готовые решения →]]</btn>
+</col>
+</grid>