Yandex Cloud
  • Сервисы
  • Решения
  • Почему Yandex Cloud
  • Сообщество
  • Тарифы
  • Документация
  • Связаться с нами
Подключиться
Language / Region
Проект Яндекса
© 2023 ООО «Яндекс.Облако»
Yandex Tracker
  • Начало работы
  • Практические руководства
  • Концепции
  • Настроить очередь
  • Работать с задачами
  • Структурировать задачи
  • Проекты
  • Инструменты гибкой разработки
  • Доски задач (бета)
  • Найти задачи
  • Уведомления и подписки
  • Статистика и дашборды
  • Автоматизация и шаблоны
    • Обзор
    • Триггеры
    • Автодействия
    • Макросы
    • Шаблоны
    • Шаблоны рабочих процессов
    • Переменные
    • Использовать форму как шаблон для создания задач
  • Настроить SLA для задач
  • Интеграция с другими сервисами
  • Инструменты разработчика
  • Мобильное приложение Tracker
  • Правила тарификации
  • Справочник API
  • Вопросы и ответы
  • История изменений
  • Служба поддержки
  1. Автоматизация и шаблоны
  2. Переменные

Переменные

Статья создана
Yandex Cloud
  • Добавить переменную
  • Типы переменных
    • Атрибуты пользователей
    • Дополнительные параметры задачи
    • Локальные поля
    • Модификаторы даты и времени
    • Модификаторы JSON

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

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

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

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

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

    Примечание

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

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

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

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

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

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

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

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

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

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

Примечание

Логины, которые содержат только цифры, могут быть неправильно интерпретированы при выполнении запросов к Tracker. В таком случае при возникновении ошибки рекомендуется использовать атрибут uid вместо login.

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

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

Переменная Значение
{{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]

Важно

Tracker поддерживает передачу значений в формате JSON для простых типов полей, которые имеют формат строк, чисел, а также массивов строк и чисел. Тип поля "Объект" не поддерживается: например, переменная {{issue.author.json}} работать не будет. Вместо нее можно использовать переменную для получения простого атрибута поля: {{issue.author.login.json}}.

Была ли статья полезна?

Language / Region
Проект Яндекса
© 2023 ООО «Яндекс.Облако»
В этой статье:
  • Добавить переменную
  • Типы переменных
  • Атрибуты пользователей
  • Дополнительные параметры задачи
  • Локальные поля
  • Модификаторы даты и времени
  • Модификаторы JSON