--- metadata: - name: generator content: Diplodoc Platform v5.54.2 - property: og:type content: article - property: article:section content: Автоматизации - property: og:title content: Как настроить действие триггера - property: article:tag content: Техническая инструкция alternate: - https://yandex.ru/support/tracker/en/user/set-action.md - https://yandex.ru/support/tracker/ru/user/set-action.md - href: ru/user/set-action.md type: text/markdown title: Markdown version - href: ../llms.txt type: text/markdown title: llms.txt title: Как настроить действие триггера в Яндекс Трекере description: Из статьи вы узнаете, как можно настроить действие триггера. --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/support/tracker/ru/llms.txt # Как настроить действие триггера В разделе ![](../_assets/svg/arrow-icon-for-autoaction.svg) **Выполнить действия** настройте одно или несколько действий: - ![](../_assets/svg/check-in-round.svg) [**Изменить статус задачи**](#change-status) - ![](../_assets/svg/add-task.svg) [**Создать задачу**](#create-issue) - ![](../_assets/svg/icon-card.svg) [**Изменить значение поля**](#change-field-value) - ![](../_assets/svg/add-to-sprint.svg) [**Добавить задачу в активный спринт**](#add-to-sprint) - ![](../_assets/svg/move-task.svg)] [**Переместить задачу**](#sec_move) - ![](../_assets/svg/comment.svg) [**Добавить комментарий к задаче**](#create-comment) - ![](../_assets/svg/create-checklist.svg) [**Создать чеклист**](#create-checklist) - ![](../_assets/svg/value.svg) [**Вычислить значение**](#calculate-value) - ![](../_assets/svg/query-language.svg) [**HTTP-запрос**](#create-http) В один триггер можно добавить не более 10 действий. ## Изменить статус задачи {#change-status} Задайте новый статус задачи. Доступные статусы определяются настройками [рабочего процесса](https://yandex.ru/support/tracker/ru/manager/workflow-status-edit.md). {% note warning "" %} Триггер выполняет действия от имени пользователя, чье изменение задачи запустило триггер (кроме действия [HTTP-запрос](#create-http) — оно выполняется от имени владельца указанного в нем токена). Чтобы переход в статус сработал: - Если для перехода в статус [настроены условия](https://yandex.ru/support/tracker/ru/manager/workflow-action-edit.md#conditions), ограничивающие права пользователей на изменение статуса, убедитесь, что у пользователя, который запускает триггер, есть необходимые права. - Если для перехода в статус [настроен экран перехода](https://yandex.ru/support/tracker/ru/manager/workflow-action-edit.md#set-transition), проверьте, что в нем отсутствуют обязательные для заполнения поля, или заполните их предыдущими действиями триггера. {% endnote %} ## Создать задачу {#create-issue} Можно настроить триггер, который автоматически создает задачу при выполнении заданных условий. Например, с помощью триггера можно создавать задачу на тестирование, когда программист заканчивает разработку новой возможности и переводит задачу в статус **Разрешен**. {% note info "" %} Новая задача не будет создана, если триггер будет запущен в задаче, которая сама была создана автоматически с помощью триггера или [автодействия](https://yandex.ru/support/tracker/ru/user/ticket-schedule.md). {% endnote %} Чтобы настроить создание задачи: 1. Заполните поля шаблона новой задачи: - Укажите очередь, в которой будет автоматически создана задача. - Задайте параметры задачи и нажмите кнопку **Сохранить**. 1. Чтобы автором созданной задачи был [Робот сервиса Трекер](*robot), включите опцию **Создавать задачи от имени робота**. Убедитесь, что у робота есть права на создание задач в выбранной очереди. Если эта опция выключена, автором задачи будет пользователь, действие которого запустило триггер. В этом случае задача будет создана, только если у пользователя есть права на создание задач в выбранной очереди. 1. Чтобы связать автоматически созданную задачу с задачей, в которой сработал триггер, включите опцию **Связать с задачей, которая запустила триггер**. Вы можете настроить автоматическое создание нескольких задач. ## Изменить значение поля {#change-field-value} Задайте один или несколько новых параметров задачи: 1. Нажмите кнопку ![](../_assets/svg/add-icon.svg) **Добавить параметр** и выберите параметр задачи. {% note tip "" %} Чтобы найти [локальное поле очереди](https://yandex.ru/support/tracker/ru/local-fields.md), перед названием поля введите ключ очереди, где вы настраиваете автоматизацию, и точку (например, `DEVS.Тестировщик`). {% endnote %} 1. Выберите действие: **Действие** | **Описание** ----- | ----- **Установить значение** | Присвоить параметру заданное значение. **Очистить поле** | Удалить значение параметра. **Добавить в список** | Добавить еще одно значение параметра (для параметров, которые могут содержать несколько значений). **Удалить из списка** | Убрать один из параметров (для параметров, которые могут содержать несколько значений). 1. Укажите новое значение параметра. {% note warning "" %} Значение поля **Родительский тикет** нельзя изменить с помощью автоматического действия. {% endnote %} ## Добавить задачу в активный спринт {#add-to-sprint} Укажите название [доски с бэклогом и спринтами](https://yandex.ru/support/tracker/ru/manager/agile.md), куда будет добавлена задача. ## Переместить задачу {#sec_move} Укажите очередь, в которую будет перенесена задача. Задача будет перенесена, только если у пользователя, запустившего триггер, есть права на создание задач в выбранной очереди. ## Добавить комментарий к задаче {#create-comment} Напишите текст комментария, который будет добавлен к задаче. Вы можете подставить в комментарий [значения полей задачи](https://yandex.ru/support/tracker/ru/user/vars.md). Для этого нажмите кнопку ![](../_assets/console-icons/issues.svg) **Переменные** и выберите одно или несколько значений. В поле комментария появится конструкция вида `{{issue.<ключ_поля>}}`. Комментарий будет отправлен от имени пользователя, запустившего триггер. Если вы хотите, чтобы автором комментария отображался [робот](*robot), включите опцию **Отправлять от имени робота**. ## Создать чеклист {#create-checklist} Создайте [чеклист](https://yandex.ru/support/tracker/ru/user/checklist.md), который будет добавлен к задаче. {% note info "" %} Действие не сработает, если в задаче уже есть чеклист. {% endnote %} Чтобы настроить чеклист: 1. Нажмите ![](../_assets/svg/add-icon.svg) **Добавить пункт**. Вы можете добавить один или несколько пунктов. 1. Введите описание пункта. При необходимости укажите исполнителя и дедлайн. 1. Нажмите **Сохранить**. ## Вычислить значение {#calculate-value} Вы можете настроить поле, значение которого вычисляется автоматически на основе значений других полей задачи. Чтобы автоматически вычислять значение поля: 1. Задайте формулу для вычисления значения: - С помощью кнопки ![](../_assets/console-icons/issues.svg) **Добавить переменную** добавьте в формулу поля с числовыми значениями. В формулу будет подставлена [конструкция](https://yandex.ru/support/tracker/ru/user/vars.md) вида `{{issue.<ключ_поля>}}`. Если нужного поля нет в Трекере, вы можете [создать его](https://yandex.ru/support/tracker/ru/user/create-param.md). - Используйте символы математических операций сложения `+`, вычитания `-`, умножения `*`, деления `/`. - Чтобы задать приоритет операций, используйте скобки. - Для вычисления полей, содержащих дату, можно использовать выражения с функцией `today()`. Например, функция `today()+3d` отобразит дату, которая будет через 3 дня от текущей. 1. Нажмите кнопку **Выбрать поле** и задайте поле, в которое будет записано вычисленное значение. {% note info "" %} Если выбранное поле поддерживает только целые числа, значение будет округлено. {% endnote %} Пример использования функции можно найти в разделе [Добавить в поле текущую дату](https://yandex.ru/support/tracker/ru/manager/trigger-examples.md#today). ## HTTP-запрос {#create-http} HTTP-запросы можно использовать для обращения к API других сервисов и настройки интеграций с ними. HTTP-запросы из разных триггеров выполняются асинхронно. Порядок выполнения запросов не гарантирован. Чтобы при срабатывании автоматизации отправлять HTTP-запрос: 1. Выберите метод HTTP-запроса. 1. Укажите полный адрес ресурса, по которому будет отправлен запрос (по стандарту [RFC 3986](https://tools.ietf.org/html/rfc3986)). Например: `http://example.org/newfolder/newfile`. 1. Выберите способ авторизации: - **NoAuth** — без авторизации. - **Basic** — требуется логин и пароль (стандарт [RFC 2617](https://tools.ietf.org/html/rfc2617)). - **OAuth 2.0** — требуются [токен](*token), заголовок авторизации и тип токена (стандарт [RFC 6749](https://tools.ietf.org/html/rfc6749)). 1. При выборе типов авторизации **Basic** или **OAuth 2.0** введите данные для авторизации. Данные авторизации (логин, пароль, токен, заголовок авторизации, тип токена) передаются в соответствующих полях и не требуют повторного указания в заголовках. 1. Введите тело запроса. По умолчанию тело запроса отображается в формате JSON: с подсветкой синтаксиса и отступами. Чтобы отключить форматирование, в переключателе над полем с телом запроса выберите **text/plain** вместо **application/json**. В тело запроса можно подставлять [значения полей задачи](https://yandex.ru/support/tracker/ru/user/vars.md) или пользовательские переменные. Для этого справа от поля ввода нажмите кнопку ![](../_assets/console-icons/issues.svg) и выберите имя поля или переменной. В тело запроса будет подставлена конструкция вида `{{<имя_переменной>}}`. {% note info "" %} Также вы можете подставить переменные в адрес ресурса и значение заголовка. {% endnote %} 1. Введите заголовки и их значения. 1. При необходимости добавьте новые переменные для использования в теле запроса или заголовках. Например, вы можете добавить ключ аутентификации или другую секретную информацию. {% note info "" %} После того как вы сохраните триггер, значение переменной будет скрыто, его нельзя будет посмотреть. {% endnote %} Когда срабатывает автоматизация, Трекер отправляет HTTP-запрос. В ответ ожидается любой код состояния HTTP. [Список кодов состояния](https://ru.wikipedia.org/wiki/Список_кодов_состояния_HTTP) Если ответ не пришел в течение 10 секунд или получен ответ с кодом 500, запрос будет отправлен повторно. Для каждого запроса выполнятся не более 5 попыток с экспоненциальной задержкой, начиная с 10 секунд. #### Примеры настройки HTTP-запросов {#http-examples} - [Отправка уведомлений из Трекера в мессенджеры](https://yandex.ru/support/tracker/ru/messenger.md) - [Создание и обновление чеклиста в задаче](https://yandex.ru/support/tracker/ru/manager/trigger-examples.md#checklist) - [Создание задачи со значениями полей из родительской задачи](https://yandex.ru/support/tracker/ru/manager/trigger-examples.md#create-ticket-with-params) - [Обновление статуса, приоритета и добавление комментария в связанных задачах](https://yandex.ru/support/tracker/ru/manager/trigger-examples.md#update-related-tasks) ## {#r} [*robot]: Робот — это служебный аккаунт, от имени которого Трекер может выполнять автоматические действия в задачах. [*token]: Токен — это секретный ключ для доступа к API. Он подтверждает пользователя или приложение, поэтому его нельзя передавать другим.