Интеллектуальные значения позволяют получать доступ и управлять практически любыми данными о задачах из Jira. Хотя они требуют небольшого обучения, они придают вашим правилам значительную силу и индивидуальность.
Что такое интеллектуальные значения?
Например, интеллектуальное значение {{now.plusDays (5)}} ссылается на текущее время и добавляет к нему 5 дней. {{issue.summary}} распечатает краткое изложение задачи.
Давайте посмотрим на небольшой пример. Предположим, вы хотите добавить комментарий к задаче о передаче и адресовать докладчику и уполномоченному по задаче, которая была передана, по имени. Все, что вам нужно сделать, это вставить правильные интеллектуальные значения в соответствующие места в вашем комментарии:
Почему фигурные скобки?
Мы используем библиотеку Mustache для интеллектуальных подстановок. Мы использовали это по соображениям безопасности, поскольку это не позволяет выполнять произвольный код. Обратной стороной является то, что синтаксис иногда может быть немного неудобным. Чтобы произвести замену, вам нужно заключить значение в "двойные фигурные скобки", например {{somevalue}}.Для ссылки на дочерние элементы вы просто используете точку, например {{issue.key}}
Как узнать, какую интеллектуальное значение использовать?
В 90% случаев вы можете просто выбрать разумное значение из доступных значений в нашем справочном руководстве.
Мы также рекомендуем прочитать следующие более подробные разделы о конкретных применениях интеллектуальных значений:
- Работа со списками
- Работа с текстом / строками
- Работа с датами
- Работа с числами
Если вам нужно применить несколько преобразований за один шаг, вы можете связать функции. Например, чтобы изменить краткое описание задачи на нижний регистр и использовать только первые 10 символов, а также добавить «!!» до конца вы можете связать их вместе как:
{{issue.summary.toLowerCase().substring(0, 10).concat("!!")}}
Доступ к полям задач
Используйте имя поля - {{issue.My custom field name}}.
Если поле является объектом, укажите значение в нем. Например, если это пользовательское поле пользователя:
{{issue.My user field.displayName}}
Имена полей не чувствительны к регистру и переводятся с использованием языковых настроек вашего субъекта правил. Если вы пытаетесь получить доступ к настраиваемым полям с переведенными именами в интеллектуальных значениях, используйте язык, установленный для вашего пользователя-субъекта правил.
Если существует несколько настраиваемых полей с одинаковым именем или именем, совпадающим с именем системного поля, вы также можете использовать идентификатор пользовательского поля.
{{issue.customfield_10001}}
См. Раздел Доступ к полям задач для получения более подробной информации.
Использование # для разделов и списков
Если вы хотите перебрать несколько элементов, используйте #, и он сделает то же самое для всего, что захватывается интеллектуальным значением. Когда вы используете #, вы всегда должны заканчивать с {{/}}, чтобы закрыть его. В приведенном ниже примере действие выводит список авторов комментариев.
{{#issue.comments}}Author: {{author.displayName}}{{/}}
Чтобы рассматривать элементы как числа, при использовании математических функций используйте {{# =}}. Например, чтобы выполнить простой расчет, чтобы добавить 100 в пользовательское поле «Сумма счета (фактуры)» ("Invoice Amount") по вашей задаче, вы можете использовать:
{{# =}} {{issue.Invoice Amount}} + 100 {{/}}
Значения по умолчанию
Если поле или значение не существует, обычно возвращается пустое значение. {{invalid reference}}
Если вам необходимо иметь значение, вы можете указать значение по умолчанию. Например, если «недопустимая ссылка» не содержит значения, вы можете напечатать «Hello world», используя {{invalid reference | Hello world}}.
По материалам Automation for Jira - Server: Smart value basics