Как настроить действие триггера

В разделе  Выполнить действия настройте одно или несколько действий:

• Изменить статус задачи
• Создать задачу
•  Изменить значение поля
• Добавить задачу в активный спринт
• Переместить задачу
• Добавить комментарий к задаче
• Создать чеклист
• Вычислить значение
• HTTP-запрос

Изменить статус задачи

Задайте новый статус задачи. Доступные статусы определяются настройками рабочего процесса.

Создать задачу

Можно настроить триггер, который автоматически создает задачу при выполнении заданных условий. Например, с помощью триггера можно создавать задачу на тестирование, когда программист заканчивает разработку новой возможности и переводит задачу в статус Разрешен.

Чтобы настроить создание задачи:

1. Заполните поля шаблона новой задачи:

   • Укажите очередь, в которой будет автоматически создана задача.
   • Задайте параметры задачи и нажмите кнопку Сохранить.

2. Чтобы автором созданной задачи был Робот сервиса Трекер, включите опцию Создавать задачи от имени робота. Убедитесь, что у робота есть права на создание задач в выбранной очереди.

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

3. Чтобы связать автоматически созданную задачу с задачей, в которой сработал триггер, включите опцию Связать с задачей, которая запустила триггер.

Вы можете настроить автоматическое создание нескольких задач.

Изменить значение поля

Задайте один или несколько новых параметров задачи:

1. Нажмите кнопку  Добавить параметр и выберите параметр задачи.

   Чтобы найти локальное поле очереди, перед названием поля введите ключ очереди, где вы настраиваете автоматизацию, и точку (например, DEVS.Тестировщик).

2. Выберите действие:

   Действие	Описание
   Установить значение	Присвоить параметру заданное значение.
   Очистить поле	Удалить значение параметра.
   Добавить в список	Добавить еще одно значение параметра (для параметров, которые могут содержать несколько значений).
   Удалить из списка	Убрать один из параметров (для параметров, которые могут содержать несколько значений).

3. Укажите новое значение параметра.

Добавить задачу в активный спринт

Укажите название доски с бэклогом и спринтами, куда будет добавлена задача.

Переместить задачу

Укажите очередь, в которую будет перенесена задача.

Задача будет перенесена, только если у пользователя, запустившего триггер, есть права на создание задач в выбранной очереди.

Добавить комментарий к задаче

Напишите текст комментария, который будет добавлен к задаче.

Вы можете подставить в комментарий значения полей задачи. Для этого нажмите кнопку  Переменные и выберите одно или несколько значений. В поле комментария появится конструкция вида {{issue.<ключ_поля>}}.

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

Создать чеклист

Создайте чеклист, который будет добавлен к задаче.

Чтобы настроить чеклист:

1. Нажмите  Добавить пункт.
   Вы можете добавить один или несколько пунктов.

2. Введите описание пункта. При необходимости укажите исполнителя и дедлайн.

3. Нажмите Сохранить.

Вычислить значение

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

Чтобы автоматически вычислять значение поля:

1. Задайте формулу для вычисления значения:

   • С помощью кнопки  Добавить переменную добавьте в формулу поля с числовыми значениями. В формулу будет подставлена конструкция вида {{issue.<ключ_поля>}}.
     Если нужного поля нет в Трекере, вы можете создать его.
   • Используйте символы математических операций сложения +, вычитания -, умножения *, деления /.
   • Чтобы задать приоритет операций, используйте скобки.
   • Для вычисления полей, содержащих дату, можно использовать выражения с функцией today(). Например, функция today()+3d отобразит дату, которая будет через 3 дня от текущей.

2. Нажмите кнопку Выбрать поле и задайте поле, в которое будет записано вычисленное значение.

   Если выбранное поле поддерживает только целые числа, значение будет округлено.

Пример использования функции можно найти в разделе Добавить в поле текущую дату.

HTTP-запрос

HTTP-запросы можно использовать для обращения к API других сервисов и настройки интеграций с ними.

Чтобы при срабатывании автоматизации отправлять HTTP-запрос:

1. Выберите метод HTTP-запроса.

2. Укажите полный адрес ресурса, по которому будет отправлен запрос. Например: http://example.org/newfolder/newfile.

3. Выберите способ авторизации:

   • NoAuth — без авторизации.
   • Basic — требуется логин и пароль.
   • OAuth 2.0 — требуются токен, заголовок авторизации и тип токена.

4. При выборе типов авторизации Basic или OAuth 2.0 введите данные для авторизации.

   Данные авторизации (логин, пароль, токен, заголовок авторизации, тип токена) передаются в соответствующих полях и не требуют повторного указания в заголовках.

5. Введите тело запроса.

   В тело запроса можно подставлять значения полей задачи или пользовательские переменные. Для этого справа от поля ввода нажмите кнопку и выберите имя поля или переменной. В тело запроса будет подставлена конструкция вида {{<имя_переменной>}}.

   Также вы можете подставить переменные в адрес ресурса и значение заголовка.

6. Введите заголовки и их значения.

7. При необходимости добавьте новые переменные для использования в теле запроса или заголовках. Например, вы можете добавить ключ аутентификации или другую секретную информацию.

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

Когда срабатывает автоматизация, Трекер отправляет HTTP-запрос. В ответ ожидается любой код состояния HTTP.

Если ответ не пришел в течение 10 секунд или получен ответ с кодом 500, запрос будет отправлен повторно. Для каждого запроса выполнятся не более 5 попыток с экспоненциальной задержкой, начиная с 10 секунд.

Примеры настройки HTTP-запросов

• Отправка уведомлений из Трекера в мессенджеры

• Создание и обновление чеклиста в задаче

• Создание задачи со значениями полей из родительской задачи

• Обновление статуса, приоритета и добавление комментария в связанных задачах