Примеры использования триггеров в Tracker
- Автоматически назначать исполнителя задачи
- Автоматически призывать исполнителя задачи
- Изменять статус задачи после создания связи
- Отправлять уведомление о создании задачи из письма
- Отправлять уведомление о создании задачи через форму
- Автоматически добавлять форму в комментарии задачи
- Автоматически добавлять задачи на доску
- Отправлять уведомления в мессенджеры
- Автоматически посчитать разницу дат
- Создать подзадачу и записать в нее значения полей из родительской задачи
- Обновить статус, приоритет и добавить комментарий в связанных задачах
Рассмотрим несколько примеров использования триггеров в Tracker:
-
Как автоматически назначать исполнителя задачи в зависимости от статуса или компонента.
-
Как автоматически призывать исполнителя задачи в зависимости от статуса и значения поля.
-
Как автоматически изменять статус задачи, если к ней была добавлена связь определенного типа.
-
Как автоматически отправлять пользователю уведомление после создания задачи из обращения в службу поддержки по почте.
-
Как автоматически отправлять пользователю уведомление после создания задачи из обращения в службу поддержки через Yandex Forms.
-
Как автоматически добавлять форму в комментарии задачи.
-
Как настроить уведомления в мессенджеры через HTTP-запросы.
-
Как автоматически посчитать разницу дат в Tracker.
-
Как создать подзадачу и записать в нее значения полей из родительской задачи.
Автоматически назначать исполнителя задачи
Часто за выполнение разных этапов работы отвечают определенные сотрудники. Когда сотрудник выполняет свою часть работы, он передает задачу следующему исполнителю. Если команда ведет работу в Tracker, то каждому этапу работы соответствует статус задачи. Когда задача переходит в определенный статус, с помощью триггера можно автоматически назначать исполнителя, который отвечает за выполнение этого этапа работы.
Другой вариант организации работы — когда выделенные сотрудники отвечают за разные направления. Например, каждый сотрудник службы поддержки работает с обращениями по своему продукту. В этом случае в очереди можно настроить компоненты, которые соответствуют продуктам компании. Когда в задачу добавляется определенный компонент, с помощью триггера можно автоматически назначать исполнителя, который отвечает за работу с этим продуктом.
Настроим триггер для автоматического назначения исполнителя задачи:
-
Убедитесь, что у всех сотрудников, которые могут быть назначены исполнителями задач, есть полный доступ к Tracker.
-
Перейдите в настройки очереди и в разделе Триггеры нажмите кнопку Создать триггер.
-
Введите название триггера.
-
Задайте условия, чтобы триггер срабатывал при изменении параметров задачи «Статус» или «Компоненты»:
-
Выберите опцию Будут выполнены условия → Все.
-
Добавьте условие Событие → Задача изменилась.
-
Чтобы назначать исполнителя задачи при изменении статуса, добавьте условие Системные → Статус → стало равно и укажите статус. Доступные статусы зависят от воркфлоу, который настроен для очереди.
Чтобы назначать исполнителя задачи при изменении компонентов, добавьте условие Системные → Компоненты → стало равно и укажите компоненты.
Примечание
Триггер с таким условием сработает, только если в задаче указан один компонент.
-
-
Задайте действие триггера:
-
Добавьте действие Изменить значения в полях.
-
Выберите поле Системные → Исполнитель → Установить значение и укажите сотрудника, который должен быть назначен исполнителем при срабатывании триггера.
-
-
Сохраните триггер.
Чтобы проверить работу триггера, измените статус или компоненты у любой задачи из очереди, в которой вы настроили триггер.
Автоматически призывать исполнителя задачи
Выполнив задачу, сотрудник может забыть указать важную информацию, например, затраченное время. В этом случае можно настроить триггер, который будет автоматически призывать исполнителя, если задача закрыта и не указано затраченное время:
-
Перейдите в настройки очереди и в разделе Триггеры нажмите кнопку Создать триггер.
-
Введите название триггера.
-
Задайте условия, чтобы триггер срабатывал при закрытии задачи в случае, если поле «Затраченное время» не заполнено:
-
Выберите опцию Будут выполнены условия → Все.
-
Добавьте условие Системные → Статус → стало равно → Закрыт. Доступные статусы зависят от воркфлоу, который настроен для очереди.
-
Добавьте условие Учёт Времени → Затрачено времени → Значение поля пусто.
-
-
Задайте действия триггера:
-
Добавьте действие Добавить комментарий.
-
Нажмите и в строке Призвать пользователей из поля введите «Исполнитель».
-
Введите текст комментария, который должен увидеть исполнитель, и выберите опцию Отправлять от имени робота.
-
-
Сохраните триггер, нажав кнопку Создать.
При закрытии любой задачи, где не указано затраченное время, робот будет создавать комментарий и призывать исполнителя.
Изменять статус задачи после создания связи
Во многих проектах задачи зависят друг от друга, даже когда над ними работают разные люди. Если задача влияет на выполнение одной или нескольких других, важно оповестить коллег о возникших проблемах. Например, связать такие задачи между собой и установить тип связи Блокирующая задача.
Настроим триггер, который будет изменять статус задачи и добавлять комментарий для автора, если появилась связь Блокирующая задача:
-
Перейдите в настройки очереди и в разделе Триггеры нажмите кнопку Создать триггер.
-
Введите название триггера.
-
Задайте условия, чтобы триггер срабатывал при появлении связи Блокирующая задача:
-
Выберите опцию Будут выполнены условия → Все.
-
Добавьте условие Действие со связью → Связь создана → Блокирующая задача.
-
-
Задайте действия триггера:
-
Добавьте действие Изменить статус задачи.
-
В поле Новый статус задачи выберите статус, который будет установлен у задачи после выполнения условия. Например, Требуется информация. Доступные статусы зависят от воркфлоу, который настроен для очереди.
-
Добавьте действие Добавить комментарий.
-
Нажмите и в строке Призвать пользователей из поля введите «Автор».
-
Введите текст комментария, который должен увидеть автор задачи, и выберите опцию Отправлять от имени робота. Иначе комментарий будет отправлен от имени пользователя, который запустил действие триггера — добавил связь.
-
-
Сохраните триггер, нажав кнопку Создать.
Отправлять уведомление о создании задачи из письма
Предположим, что сотрудники службы поддержки регистрируют обращения в Tracker. Пользователи пишут в службу поддержки по почте, и на основе их писем создаются задачи в Tracker.
Настроим триггер, который после создания задачи будет оправлять пользователю письмо о том, что его обращение зарегистрировано:
Шаг 1. Настроить интеграцию с почтой
Чтобы отправлять письма из Tracker и создавать задачи из входящих писем, настройте интеграцию с почтой:
-
Настройте почтовый адрес для очереди, в которой будут создаваться задачи по обращениям пользователей.
Если добавление адреса очереди недоступно, значит у вашей организации нет домена. Домен нужен для создания почтовых ящиков и рассылок, в том числе чтобы создать адрес очереди. Домен можно бесплатно подключить в сервисе Яндекс 360 для бизнеса
. -
Настройте псевдонимы и подписи, если нужно.
-
Если пользователи не являются сотрудниками организации:
Шаг 2. Настроить триггер для отправки писем
Настройте триггер, который при создании новой задачи из письма будет отправлять пользователю уведомление по почте:
-
Перейдите в настройки очереди и в разделе Триггеры нажмите кнопку Создать триггер.
-
Введите название триггера.
-
Задайте условия, чтобы триггер срабатывал при создании новой задачи из входящего письма:
-
Выберите опцию Будут выполнены условия → Все.
-
Добавьте условие Событие → Создана задача.
-
Добавьте условие Email → Создано по письму на адрес → Равно строке и введите почтовый адрес очереди.
-
Включите опцию Игнорировать регистр на случай, если пользователь введет адрес очереди с заглавной буквы.
-
-
В качестве действия триггера задайте отправку письма:
-
Выберите действие Добавить комментарий.
-
Включите опцию Письмо.
-
В поле Кому добавьте переменную с адресом пользователя, от которого пришло обращение. Для этого выберите поле Кому, нажмите кнопку Добавить переменную и выберите Email → От.
-
Напишите текст письма. Вы можете добавить в письмо параметры задачи с помощью кнопки Добавить переменную.
-
-
Сохраните триггер.
Чтобы проверить работу триггера, отправьте письмо на почтовый адрес очереди.
Отправлять уведомление о создании задачи через форму
Предположим, что сотрудники службы поддержки регистрируют обращения в Tracker. Пользователи обращаются в службу поддержки через форму обратной связи, которая создана в сервисе Yandex Forms
Настроим триггер, который после создания задачи будет оправлять пользователю письмо о том, что его обращение зарегистрировано:
Шаг 1. Настроить интеграцию с почтой
Чтобы отправлять письма из Tracker, настройте интеграцию с почтой:
-
Настройте почтовый адрес для очереди, в которой будут создаваться задачи по обращениям пользователей.
Если добавление адреса очереди недоступно, значит у вашей организации нет домена. Домен нужен для создания почтовых ящиков и рассылок, в том числе чтобы создать адрес очереди. Домен можно бесплатно подключить в сервисе Яндекс 360 для бизнеса
. -
Настройте псевдонимы и подписи, если нужно.
-
Если пользователи не являются сотрудниками организации, разрешите отправку писем из задач на внешние адреса.
Шаг 2. Настроить форму для регистрации обращений
Чтобы создавать задачи из обращений через форму:
-
Перейдите в сервис Yandex Forms
и создайте новую форму. -
Добавьте на форму вопросы, чтобы пользователь мог сообщить информацию, которая нужна для регистрации обращения.
Чтобы узнать почтовый адрес пользователя, добавьте вопрос Почта и сделайте его обязательным.
-
Настройте для формы интеграцию с Tracker:
-
Укажите очередь и другие параметры задачи.
-
В поле Описание задачи добавьте ответы на вопросы формы.
-
Чтобы сохранить в параметрах задачи почтовый адрес пользователя, добавьте поле От и выберите Переменные → Ответ на вопрос → Почта.
-
Сохраните параметры интеграции.
-
-
Опубликуйте форму.
Шаг 3. Настроить триггер для отправки писем
Настройте триггер, который при создании новой задачи через форму будет отправлять пользователю уведомление по почте:
-
Перейдите в настройки очереди и в разделе Триггеры нажмите кнопку Создать триггер.
-
Введите название триггера.
-
Задайте условия, чтобы триггер срабатывал при создании новой задачи из входящего письма:
-
Выберите опцию Будут выполнены условия → Все.
-
Добавьте условие Событие → Создана задача.
-
Добавьте условие Email → От → Значение поля установлено.
-
-
В качестве действия триггера задайте отправку письма:
-
Выберите действие Добавить комментарий.
-
Включите опцию Письмо.
-
В поле Кому добавьте переменную с адресом пользователя, от которого пришло обращение. Для этого выберите поле Кому, нажмите кнопку Добавить переменную и выберите Email → От.
-
Напишите текст письма. Вы можете добавить в письмо параметры задачи с помощью кнопки Добавить переменную.
-
-
Сохраните триггер.
Чтобы проверить работу триггера, заполните форму, в которой вы настроили интеграцию с Tracker.
Автоматически добавлять форму в комментарии задачи
С помощью триггера в комментарии задачи можно добавлять форму с автоматическим предзаполнением полей. Для этого в текст комментария нужно добавить специальный код со ссылкой на форму. Значения в поля формы можно передавать через GET-параметры. Например, передавать параметры задачи с помощью переменных, которые доступны в триггере.
Настроим триггер, который после закрытия задачи будет добавлять форму обратной связи в комментарии и призывать исполнителя:
Шаг 1. Создать форму обратной связи
-
Перейдите в сервис Yandex Forms
и создайте форму. -
Добавьте на форму вопросы, чтобы исполнитель мог сообщить необходимую информацию.
Шаг 2. Создать триггер для добавления формы
-
Перейдите в настройки очереди и в разделе Триггеры нажмите кнопку Создать триггер.
-
Задайте условия, чтобы триггер срабатывал при закрытии задачи:
-
Выберите опцию Будут выполнены условия → Все.
-
Добавьте условие Статус → стало равно → Закрыт.
-
-
Добавьте действие Добавить комментарий.
-
В текст комментария вставьте код:
{{=<% %>=}}/iframe/(src="https://forms.yandex.ru/surveys/<идентификатор_формы>/?iframe=1&<идентификатор_вопроса>=<значение>" frameborder=0 width=500)
Где:
-
<идентификатор_формы>
— ID формы, которую необходимо добавить; -
<идентификатор_вопроса>
— идентификатор вопроса; -
<значение>
— значение, которое нужно подставить в поле формы.Чтобы передать в форму параметры задачи, в качестве значений используйте переменные: внизу окна нажмите кнопку Добавить переменную и выберите параметр задачи, затем вокруг имени переменной замените символы
{{ }}
на<% %>
.Например, чтобы передать ключ задачи, используйте значение
<%issue.key%>
. Чтобы передать логин исполнителя задачи, используйте значение<%issue.assignee.login%>
.
Пример кода, в котором в поле формы передается ключ задачи:
{{=<% %>=}}/iframe/(src="https://forms.yandex.ru/surveys/68***/?iframe=1&answer_short_text_584943=<%issue.key%>" frameborder=0 width=100% height=660px scrolling=no)
-
-
Нажмите и в строке Призвать пользователей из поля введите «Исполнитель».
-
Включите опцию Отправлять от имени робота.
-
Сохраните триггер, нажав кнопку Создать.
Шаг 3. Добавить в очередь yndx-forms-cnt-robot@
Для корректной вставки формы дайте доступ к очереди роботу yndx-forms-cnt-robot@. Подробнее о настройке доступа читайте в разделе Настроить доступ к очереди.
После закрытия задачи робот будет создавать комментарий с формой и призывать исполнителя.
Автоматически добавлять задачи на доску
На новой версии доски задач можно настроить автоматическое добавление задач по фильтру или триггеру.
Вместо триггера также можно настроить автодействие с аналогичными условием и действием. При использовании автодействия задачи, подходящие под условие, будут добавляться на доску не сразу, а с заданной периодичностью.
Важно
Триггеры и автодействия работают только для задач той очереди, в которой они настроены.
Рассмотрим пример триггера, который добавляет задачу на доску при назначении исполнителем определенного пользователя:
-
Перейдите в настройки очереди и в разделе Триггеры нажмите кнопку Создать триггер.
-
Введите название триггера.
-
Задайте условие: Исполнитель → стало равно →
<имя_пользователя>
.Примечание
Триггер с таким условием сработает также в том случае, если будет создана новая задача с указанным исполнителем.
-
Задайте действие:
-
Выберите действие Изменить значения в полях.
-
Выберите поле Доски.
-
Выберите действие Добавить к списку и укажите доску, на которую нужно добавлять задачу.
-
-
Сохраните триггер.
Отправлять уведомления в мессенджеры
Для быстрого оповещения сотрудников о важных событиях удобно использовать мессенджеры. Если у мессенджера есть API, в Tracker можно настроить триггер, который отправляет в API мессенджера HTTP-запросы при наступлении определенных событий. Например, если в очереди создается ошибка с критическим приоритетом. Что такое REST API.
Примеры настройки триггеров для отправки уведомлений в Slack и Telegram приведены в разделе Интеграция с мессенджерами.
Автоматически посчитать разницу дат
Настроим триггер для автоматического вычисления разницы между датами в Tracker:
-
Перейдите в настройки очереди и в разделе Триггеры нажмите кнопку Создать триггер.
-
Введите название триггера.
-
Выберите опцию Будут выполнены условия → Все.
-
Добавьте условие Событие → Поля формулы изменились.
-
Задайте действия триггера:
-
Добавьте значение Вычислить значение.
-
Чтобы получить значение разницы дат, выраженное в днях, в поле Формула для вычисления значения укажите:
({{issue.end.unixEpoch}}-{{issue.start.unixEpoch}})/86400000
-
Выберите Вычисляемое поле из списка
.Вы можете выбрать поле из стандартных или создать новое, например, Длительность:
-
-
Сохраните триггер, нажав кнопку Создать.
Чтобы проверить работу триггера, измените значение полей Дата начала и Дата завершения.
Создать подзадачу и записать в нее значения полей из родительской задачи
Рассмотрим пример триггера, который создает подзадачу и заполняет поля значениями из исходной задачи. С помощью триггера и Yandex Tracker API вы можете настроить автоматическое создание такой задачи:
-
Перейдите в настройки очереди и в разделе Триггеры нажмите кнопку Создать триггер.
-
Выберите условия срабатывания триггера.
-
В качестве целевого действия выберите HTTP-запрос.
-
Укажите параметры запроса. В поле Тело запроса укажите параметры создаваемой подзадачи. Для подстановки значений из исходной задачи используйте переменные:
Поле
Содержание
Метод
POST
Адрес
api.tracker.yandex.net/v2/issues
Способ авторизации
OAuth 2.0
Токен
Заголовок авторизации
Authorization
Тип токена
OAuth
Тип содержимого
application/json
Тело запроса
Пример: создать подзадачу и передать в нее поля из исходной: описание, исполнитель, наблюдатели и теги.
{ "summary": "<название_задачи>", "queue": "<ключ_очереди>", "description": {{issue.description.json}}, "links": [ { "relationship": "is subtask for", "issue": "{{issue.key}}" } ], "assignee": "{{issue.assignee.login}}", "tags": {{issue.tags.json}}, "followers": {{issue.followers.uid.json}} }
Подробнее о запросе: Создать задачу, Связать задачи.
Заголовки
Заголовок:
X-Org-ID
илиX-Cloud-Org-ID
.
Значение: Идентификатор организации. Если у вас только организация Yandex Cloud Organization, используйте заголовокX-Cloud-Org-ID
, если только Яндекс 360 для бизнеса или оба типа организаций —X-Org-ID
. Идентификатор указан в поле ID организации для API на странице настроек Tracker .Примечание
Параметры, которые вы передаете в теле запроса при помощи переменных, должны быть заполнены в исходной задаче. Иначе триггер не сработает.
-
Нажмите кнопку Создать.
Обновить статус, приоритет и добавить комментарий в связанных задачах
Рассмотрим пример триггера, который обновляет статус, приоритет и добавляет комментарий в связанных задачах. С помощью триггера и Yandex Tracker API вы можете настроить автоматическое обновление связанных задач:
-
Перейдите в настройки очереди и в разделе Триггеры нажмите кнопку Создать триггер.
-
Выберите условия срабатывания триггера.
Важно
При создании условия срабатывания триггера обратите внимание на возможность каскадного вызова в связанных задачах.
-
В качестве целевого действия выберите HTTP-запрос.
-
Укажите параметры запроса. В поле Тело запроса укажите параметры обновления в связанных задачах. Для подстановки значений из исходной задачи используйте переменные:
Поле
Содержание
Метод
POST
Адрес
api.tracker.yandex.net/v2/bulkchange/_transition
Способ авторизации
OAuth 2.0
Токен
Заголовок авторизации
Authorization
Тип токена
OAuth
Тип содержимого
application/json
Тело запроса
Пример: изменить статус, приоритет и добавить комментарий в связанных задачах.
{ "transition": "need_info", "issues": "Relates: {{issue.key}}", "values": { "comment": "<Комментарий для связанных задач>", "priority": { "key": "critical" } } }
Подробнее о запросе: Массовое изменение статуса задач.
Заголовки
Заголовок:
X-Org-ID
илиX-Cloud-Org-ID
.
Значение: Идентификатор организации. Если у вас только организация Yandex Cloud Organization, используйте заголовокX-Cloud-Org-ID
, если только Яндекс 360 для бизнеса или оба типа организаций —X-Org-ID
. Идентификатор указан в поле ID организации для API на странице настроек Tracker .Примечание
Если требуется изменить в связанных задачах только значения полей без изменения статуса, используйте запрос: Массовое редактирование задач.
Параметры, которые вы передаете в теле запроса при помощи переменных, должны быть заполнены в исходной задаче. Иначе триггер не сработает.
-
Нажмите кнопку Создать.