Интеграция с Яндекс Трекером

Интеграция с Яндекс Трекером позволяет настроить автоматическую отправку комментария к задаче, если она упоминается в коммите или запросе на слияния. Кроме того, интеграция позволяет автоматически изменять статус упомянутой задачи.

Создание интеграции с Яндекс Трекером

Для создания интеграции необходимо перейти в настройки проекта в раздел Интеграции и нажать кнопку Создать возле интеграции с Яндекс Трекером.

Установка соединения

URL-адрес веб-страницы - URL, по которому доступен Яндекс Трекер. По умолчанию имеет значение https://api.tracker.yandex.net/
Oauth отладочный токен Яндекс Трекер - Временный токен доступа, создаваемый в интерфейсе разработчика.
X-Cloud-Org-ID организации - Уникальный идентификатор организации (облака) в Яндекс Облаке.

Для проверки установленного соединения есть соответствующая кнопка

Триггеры

В данном разделе выбираются события - коммит или запрос на слияние, после которых срабатывает интеграция. Для работы интеграции можно упоминать задачу как в виде полной ссылки (например, https://tracker.yandex.ru/GF-1), так и в виде только префикса (например, GF-1). Упоминать задачи в запросе на слияния можно в заголовке или описании. Кроме того, интеграция будет реагировать на изменение статуса запроса на слияние.

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

Включить комментарии. Интеграция автоматически создаст комментарий в задаче с описанием события, в котором данная задача была упомянута. Для выбора полноты комментария присутствуют опции Стандартные комментарии и Расширенные комментарии.
Переводить задачи Яндекс Трекера в их финальное состояние. Интеграция автоматически переведет статус задачи в финальный после выполнения запроса на слияние, в котором упоминается задача. Для изменения статуса необходимо в описании запроса добавить "Закрывает <задача>". Вместо <задача> необходимо указать номер задачи, подходящий под регулярное выражение, указанное в поле Префикс для проблем в Яндекс.Трекер. Для изменения статуса нескольких задач необходимо добавить указанную строку для каждой задачи отдельно. Настройка ID финального состояния позволит указать конкретный ID статуса.
Резолюция для закрытия задачи Яндекс.Трекер. Позволяет указать резолюцию для закрытия задачи.

Сопоставление задач в Яндекс Трекере

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

Регулярное выражение для задач в Яндекс.Трекер. Необязательное поле. Сопоставление ключей задач Яндекс.Трекер с регулярными выражениями, соответствующие синтаксису RE2. Данное регулярное выражение используется для перевода задач в статус финального состояния (по указанному ранее ID). По умолчанию используется регулярное выражение по ключевым словам Закрыть, Закрывает, Исправить, Исправляет, Closes. Например, слияние Запроса на слияние с фразой в описании Закрывает GF-123 переведет задачу в указанное финальное состояние.
Префикс для задач в Яндекс.Трекер. Обязательное поле, в котором необходимо указать префикс задач Яндекс.Трекер в виде ПРЕФИКС#, упоминание которых в коммитах или запросах на слияние, будет вызывать срабатывание интеграции. Например, GF# будет срабатывать на упоминание задач в виде ... GF-123 и оставлять комментарий об упоминании задачи в GitFlic.

Ограничение на число интеграций

Максимальное количество интеграций для каждого проекта 1