Переменные

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

Добавить переменную

1. Создайте макрос, триггер или автодействие.

2. Нажмите Добавить переменную в блоке действий триггера или автодействия. Для макроса добавьте переменную в блок сообщения.

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

   Примечание

   В списке отображаются переменные для всех полей, доступных в Tracker. Если вы выберете переменную для поля, которое не используется в очереди или в задаче, значение подставлено не будет.

Типы переменных

Имена переменных, которые соответствуют полям задачи, записываются в формате: {{issue.<ключ поля>}}. Чтобы получить определенный параметр поля задачи, используйте формат записи: {{issue.<ключ поля>.<параметр>}}.

Атрибуты пользователей

С помощью переменных по умолчанию вы можете получить имя и фамилию пользователя. Чтобы получить определенные атрибуты пользователя, укажите переменную вида {{issue.<роль>.<атрибут>}}, где <роль> — роль и название поля, в котором указан пользователь; <атрибут> — обозначение атрибута.

Роли пользователей:

• assignee — исполнитель;
• author — автор;
• followers — наблюдатели;
• access — пользователи в поле Доступ.

Атрибуты пользователей:

• login — логин;
• firstName — имя;
• lastName — фамилия;
• uid — идентификатор;
• email — адрес электронной почты.

Например, при помощи переменной {{issue.followers.email}} можно получить адреса электронной почты всех наблюдателей задачи.

Дополнительные параметры задачи

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

Переменная	Значение
{{issue.parent}}	Родительская задача
{{issue.previousStatus}}	Предыдущий статус задачи
{{issue.previousQueue}}	Предыдущая очередь задачи
{{issue.checklistDone}}	Количество выполненных пунктов чеклиста
{{issue.votes}}	Количество голосов за задачу

Локальные поля

Имена переменных, которые соответствуют локальным полям задачи, записываются в формате: {{issue.local.<ключ поля>}}.

Модификаторы даты и времени

По умолчанию дата и время передается в формате ДД месяц ГГГГ, например: 07 декабря 2021. Для записи даты и времени в других форматах используйте модификаторы:

• iso8601 — формат ISO 8601;
• unixEpoch — формат Unix Time;
• date — запись только даты для полей, в которых передается дата и время.

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

Переменная	Значение	Формат записи
{{currentDateTime.iso8601}}	Текущая дата и время в формате ISO 8601	YYYY-MM-DDThh:mm:ss.sssZ
{{currentDateTime.unixEpoch}}	Текущее время в формате Unix Time	1638735223
{{currentDateTime.date}}	Текущая дата	06 декабря 2021
{{issue.start.iso8601}}	Дата начала задачи в формате ISO 8601	YYYY-MM-DD
{{issue.start.unixEpoch}}	Время начала задачи в формате Unix Time	1638855321

Модификаторы JSON

В полях может быть записано несколько значений. Для получения или передачи значений таких полей, например, в запросах HTTP, их нужно преобразовать в формат JSON. Для этого к имени переменной добавьте .json.

Примеры записи переменных в формате JSON:

Переменная	Значение	Формат записи
{{issue.summary.json}}	Название задачи	"Название задачи"
{{issue.description.json}}	Описание задачи	"Описание"
{{issue.tags.json}}	Теги	["tag1","tag2"]
{{issue.<роль>.login.json}}	Логин пользователя (для полей author и assignee)	"ivan-ivanov"
{{issue.<роль>.uid.json}}	Идентификатор пользователя (для полей author и assignee)	1120000000211495
{{issue.<роль>.login.json}}	Логины пользователей (для полей followers и access)	["ivan-ivanov", "user3993"]
{{issue.<роль>.uid.json}}	Идентификаторы пользователей (для полей followers и access)	[1120000000211495, 1120000000011060]