Тема
Интеграции с трекерами
DoQA позволяет установить связь с трекерами, чтобы заводить баг-репорты из интерфейса приложения. Подключённую интеграцию с Jira Server или YouTrack можно использовать ещё и как источник требований.
В разделе «Интеграции» собраны подключения к трекерам (описаны на этой странице) и к системам CI/CD (см. Интеграции с CI/CD). Одна и та же система может присутствовать в обоих видах и подключается для каждого отдельно. Сейчас так работает GitLab.
Чтобы заводить баг-репорты из интерфейса TMS, выполните следующие шаги:
- Свяжите DoQA с вашим трекером
- Настройте связь проекта в DoQA с проектом в трекере
- Чтобы статус и приоритет баг-репорта в DoQA обновлялись автоматически при изменении связанного баг-репорта в трекере, настройте обратную интеграцию (если используете Jira Cloud, Jira Server, Bitrix24, YouTrack, GitLab, Kaiten или YandexTracker). Redmine обратную интеграцию не поддерживает.
Создание связи между DoQA и трекером
Доступны интеграции с Jira Server, Jira Cloud, YouTrack, Yandex Tracker, Redmine, Bitrix24, GitLab и Kaiten.
Раздел «Подключения» → «Интеграции» виден тем, у кого есть право integration.view, подключать, менять, проверять и отключать системы можно с integration.manage. Без права управления параметры подключений доступны только для чтения. Привязывать проект к трекеру может тот, у кого есть право tracker.manage на проекте (оно входит в роль «Тест-лид»).
Каталог подключений
Подключения организации собраны в одном списке: проекты и пространства выбирают из него. Вкладки списка: «Все», «Трекеры», «CI», «Требования», «С ошибками». Для каждого подключения видны тип, адрес, статус проверки («Успешно», «Ошибка», «Не проверялось») и где оно используется.
- Нажмите «Подключить» и выберите систему в каталоге. Уже подключённая система помечена «Подключено».
- Введите адрес и учётные данные. Набор полей зависит от трекера и описан на его странице.
- Нажмите «Проверить подключение», чтобы сверить параметры до сохранения: пока не нажата «Подключить», ничего не сохраняется.
- Нажмите «Подключить». Сервер проверяет учётные данные. Если проверка не прошла, подключение создаётся, но с ошибкой: откройте его, исправьте параметры и проверьте снова.
Страница подключения содержит вкладки «Параметры» (секреты не показываются, заменить значение можно кнопкой «Заменить»), «Использование» (проекты, пространства, прогоны, расписания, привязки репозиториев, токены проектов) и «Аудит». Для нового адреса нужен новый токен: сохранённый на другой хост не отправляется.
Отключение
Перед отключением DoQA показывает последствия: какие проекты перестанут создавать баг-репорты в трекере (их привязки будут удалены, ссылки созданных багов останутся), сколько расписаний перестанет работать, сколько привязок репозиториев и токенов проектов будет удалено. Прошлые прогоны остаются в истории.
Адрес вебхука и секрет
Обратная интеграция получает события трекера на адрес вебхука DoQA.
| Адрес | Особенности |
|---|---|
https://domain.doqa.app/api/integrations/<трекер>/webhook | Прежний адрес. Продолжает работать, настройки в трекерах менять не нужно. Для подключения должна существовать запись, иначе ответ 404 |
https://domain.doqa.app/api/integrations/<трекер>/webhook/r/<секрет> | Новый необязательный адрес с секретом подключения. Секрет у каждого подключения свой, запрос без верного секрета отклоняется |
Для обоих адресов DoQA не доверяет содержимому запроса: данные задачи он заново читает из API трекера с сохранёнными учётными данными. Секрет получает администратор с правом integration.manage вместе с готовым адресом в данных подключения (поле webhookUrl в API списка подключений). Подставляйте новый адрес при настройке вебхука в трекере, если нужно закрыть адрес секретом. Значения <трекер>: bitrix, gitlab, jira-cloud, jira-server, kaiten, yandex-tracker, youtrack.
Настройки интеграции проекта
Для каждого проекта можно настроить свои параметры интеграции.
- Откройте проект в разделе «Проекты» → вкладка «Трекер». Если подключённых трекеров нет, подключите его в разделе интеграций: вкладка предложит перейти туда или попросить администратора.
- Выберите трекер. Чтобы использовать другой трекер, сначала отключите текущий.
- Выберите проект в трекере и в поле «Тип» - тип создаваемых задач. Поле выбора проекта зависит от трекера: для Yandex Tracker вместо проекта выбирается «Очередь», для Kaiten - «Пространство / доска». Для Jira Server, если у проекта есть доски, добавляется поле «Доска».
- Сопоставьте статусы DoQA («Открыт», «В работе», «Тестирование», «Закрыт») и приоритеты DoQA («Низкий», «Средний», «Высокий») со значениями трекера. Для Kaiten сопоставление приоритетов недоступно: сопоставляются только статусы, а приоритет DoQA проставляется через собственное свойство карточки (см. Kaiten).
- Сохраните настройки.
После этого станет доступным создание баг-репортов в трекере задач через интерфейс DoQA. «Отключить трекер…» убирает привязку проекта, само подключение остаётся в разделе интеграций.
Требования из трекера
Связь с трекером используется не только для заведения баг-репортов: из трекера можно загружать требования. Требования загружаются только из Jira Server и YouTrack. Для остальных трекеров эта возможность недоступна. Настройка выполняется отдельно, на вкладке «Коннектор требований» в настройках пространства, см. Коннектор требований.