Для чего нужен раздел
Подключите трекер, чтобы загрузить задачи и использовать их в планировании. Для Jira нужны email Atlassian, API-токен и адрес сервера; для Linear — API-ключ; для Azure DevOps — персональный токен с правом чтения задач.
Когда использовать
- Когда нужно связать задачи с кодом, которым их сделали.
- Перед выбором задач для инициативы в «Планировании».
- Когда для классификации затрат нужны типы и другие данные задач.
Первые шаги
- 1Выпустите токен с правом чтения проектов и задач.
- 2Для Jira укажите почту Atlassian и URL вашего инстанса, для Linear — персональный API-ключ, для Azure DevOps — токен с правом чтения рабочих элементов.
- 3Запустите первую синхронизацию и проверьте её статус и число проектов.
- 4Убедитесь в разделе «Задачи», что ключи задач сопоставляются с ветками и пулл-реквестами.
Настройки
| Настройка | Что делает | Как настроить | Типичная ошибка |
|---|---|---|---|
| URL сервера | Задаёт основной адрес вашего трекера. | Скопируйте основной адрес установки вместе с https://, без пути к конкретной задаче или API. | Указать адрес страницы задачи или API вместо основного адреса трекера. |
| Права API-токена | Определяют, какие проекты и задачи можно прочитать. | Достаточно чтения проектов и задач. Ничего здесь не пишет обратно в ваш трекер. | Ограничить токен одним проектом и ожидать загрузки остальных. |
Пример использования
Ситуация: В «Задачах» видны тикеты одного проекта, хотя команда работает в трёх.
- 1Посмотрите число проектов, указанное у подключения после последней синхронизации.
- 2Проверьте в самом трекере, что у токена есть доступ ко всем трём проектам.
- 3При необходимости выдайте доступ к нужным проектам, обновите подключение и запустите синхронизацию повторно.
Что станет понятно: В разделе задач появились данные всех проектов, к которым вы предоставили доступ.
Частые вопросы
Почему задачи не связываются с коммитами?
Проверьте ключ задачи в имени ветки, сообщении коммита или заголовке пулл-реквеста. Без него связь может не появиться, даже когда оба подключения работают.
Пишет ли интеграция что-нибудь обратно в трекер?
Нет. Эти подключения работают только на чтение.
Почему статус синхронизации показывает ошибку?
Обычно истёк токен, сменился адрес инстанса или на стороне трекера отобрали права. На карточке подключения видно время и статус последней синхронизации.
Практические советы
- Договоритесь, где указывать ключ задачи, и проверьте связь на одном примере после синхронизации.
- Свежая задача может появиться с задержкой. Проверьте последнее обновление трекера или запустите синхронизацию вручную.