--- metadata: - name: generator content: Diplodoc Platform v5.52.0 - 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/create-autoaction.md - https://yandex.ru/support/tracker/ru/user/create-autoaction.md - href: ru/user/create-autoaction.md type: text/markdown title: Markdown version - href: ../llms.txt type: text/markdown title: llms.txt --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/support/tracker/ru/llms.txt # Как настроить автоматическое обновление задач При помощи автодействий можно найти задачи, которые соответствуют определенным условиям, и автоматически изменять их параметры. Например, можно призывать ответственных в комментарии, если задача давно не обновлялась. В автодействии поиск задач запускается периодически по выбранному графику, а редактирование задачи выполняется от имени [робота](*robot). {% note warning "" %} При срабатывании автодействия обрабатываются только первые 100 задач, подходящие под заданные условия. Остальные задачи будут обработаны при следующем срабатывании автодействия. {#100issues} {% endnote %} Для настройки автодействий требуются [права доступа «Настройки очереди»](https://yandex.ru/support/tracker/ru/manager/queue-access.md). В одну очередь можно добавить не более 100 автодействий. {#access} 1. На панели слева нажмите ![](../_assets/svg/queues-ni.svg) **Очереди** и выберите очередь. {#queue} На странице очереди в правом верхнем углу нажмите ![](../_assets/svg/settings.svg) **Настройки очереди**. {#settings} 1. На странице очереди в правом верхнем углу нажмите ![](../_assets/svg/settings.svg) **Настройки очереди**. {#settings} 1. На панели слева выберите **Автоматизация**. 1. В правом верхнем углу нажмите кнопку **Создать** → **Автодействие**. 1. Выберите тип автодействия **Обновление задач**. 1. Задайте название для автодействия. Ниже названия вы можете добавить описание. 1. Настройте ![](../_assets/svg/alarm-clock-icon.svg) **График срабатывания** — периодичность автоматического обновления задач в часах или днях. Если вы хотите следить за обновлениями, включите опцию **Отправлять уведомление при каждом срабатывании**. 1. Отберите задачи, к которым будет применяться автодействие: - Чтобы автодействие выполнялось для задач, параметры которых соответствуют определенным значениям, выберите режим **Когда задача соответствует условию**. Вы можете добавить несколько условий. Автодействие сработает, если они будут выполняться одновременно. - Чтобы автодействие выполнялось для задач, которые соответствуют фильтру, выберите режим **Когда задача соответствует QL-запросу** и задайте условия в строке с помощью [языка запросов](https://yandex.ru/support/tracker/ru/user/query-filter.md). 1. В разделе ![](../_assets/svg/arrow-icon-for-autoaction.svg) **Выполнить действия** [задайте одно или несколько действий над задачей](#set-autoaction). 1. Чтобы сохранить автодействие, нажмите кнопку **Создать автодействие**. {% note info "" %} После добавления новой автоматизации она появится в списке через несколько секунд. {% endnote %} ## Настроить действие {#set-autoaction} В разделе ![](../_assets/svg/arrow-icon-for-autoaction.svg) **Выполнить действия** настройте одно или несколько действий: - ![](../_assets/svg/check-in-round.svg) [**Изменить статус задачи**](#change-status) - ![](../_assets/svg/icon-card.svg) [**Изменить значение поля**](#change-field-value) - ![](../_assets/svg/comment.svg) [**Добавить комментарий к задаче**](#create-comment) - ![](../_assets/svg/value.svg) [**Вычислить значение**](#calculate-value) - ![](../_assets/svg/query-language.svg) [**HTTP-запрос**](#create-http) ### Изменить статус задачи {#change-status} Задайте новый статус задачи. Доступные статусы определяются настройками [рабочего процесса](https://yandex.ru/support/tracker/ru/manager/workflow-status-edit.md). {% note warning "" %} Автодействие выполняет [робот](*robot) `yndx-tracker-cnt-robot@`. Чтобы робот смог изменить статус задачи: - Если для перехода в статус [настроены условия](https://yandex.ru/support/tracker/ru/manager/workflow-action-edit.md#conditions), ограничивающие права пользователей на изменение статуса, добавьте в список пользователей робота `yndx-tracker-cnt-robot@`. - Если для перехода в статус [настроен экран перехода](https://yandex.ru/support/tracker/ru/manager/workflow-action-edit.md#set-transition), проверьте, что в нем отсутствуют обязательные для заполнения поля. {% endnote %} ### Изменить значение поля {#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 %} ### Добавить комментарий к задаче {#create-comment} Напишите текст комментария, который будет добавлен к задаче. Вы можете подставить в комментарий [значения полей задачи](https://yandex.ru/support/tracker/ru/user/vars.md). Для этого нажмите кнопку ![](../_assets/console-icons/issues.svg) **Переменные** и выберите одно или несколько значений. В поле комментария появится конструкция вида `{{issue.<ключ_поля>}}`. Комментарий будет отправлен от имени пользователя, запустившего триггер. Если вы хотите, чтобы автором комментария отображался [робот](*robot), включите опцию **Отправлять от имени робота**. ### Вычислить значение {#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) ## Посмотреть историю срабатываний {#autoaction-history} Чтобы посмотреть, когда запускалось автодействие и с каким результатом, в списке автоматизаций наведите на него указатель и нажмите ![](../_assets/svg/actions.svg) → ![](../_assets/svg/history.svg) **История срабатываний**. На панели справа откроется список запусков автодействия. Для каждого запуска отображается: * Время запуска. * Количество обработанных задач и общее количество задач, соответствующих условию автодействия. Чтобы посмотреть список обработанных задач, нажмите на строку с информацией о запуске. * Прогресс обработки задач (если обработка не завершена) или результат. [*robot]: Робот — это служебный аккаунт, от имени которого Трекер может выполнять автоматические действия в задачах. [*token]: Токен — это секретный ключ для доступа к API. Он подтверждает пользователя или приложение, поэтому его нельзя передавать другим.