Интеграция с YouTrack

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

Создание интеграции с YouTrack

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

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

URL-адрес веб-страницы - URL, по которому доступен YouTrack, например https://youtrack.example.com
URL-адрес API YouTrack - URL, по которому доступен API YouTrack, например https://youtrack.api.com. Если оставить данное поле пустым, то будет использоваться значение URL-адрес веб-страницы.
Перманентный токен YouTrack - постоянный токен пользователя YouTrack, от лица которого будет срабатывать интеграция. В качестве области доступа необходимо указать YouTrack и YouTrack Administration.
Для проверки установленного соединения есть соответствующая кнопка

Триггеры

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

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

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

!!! "info" Поиск ID финального состояния в YouTrack YouTrack генерирует индивидуальные ID для каждого статуса в новом проекте, чтобы найти его, необходимо отправить на REST-API запрос на получения информации о статусах. Используйте данный GET запрос. В качестве авторизации используется заголовок "Authorization": "Bearer {perm-token}" {{youtrack_url}}/api/admin/projects/GF/customFields?fields=id,name,fieldType(name),bundle(values(id,name,isResolved))]

Сопоставление задач в YouTrack

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

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

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

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