Документация TMS DoQA

Тема

YouTrack ​

Для подключения интеграции с YouTrack необходимо ввести:

  1. URL-адрес YouTrack

  2. YouTrack API токен

    YouTrack интеграция

Обратная интеграция с YouTrack ​

DoQA позволяет настраивать обратную интеграцию с YouTrack, чтобы при изменении статуса или приоритета баг-репорта в трекере автоматически обновлялись соответствующие поля в связанном баг-репорте в DoQA.

Для настройки обратной интеграции выполните следующие шаги:

  1. В настройках YouTrack зайти в рабочие процессы

YouTrack обратная интеграция шаг 1

  1. Выбрать «Добавить рабочий процесс» → «Загрузить zip архив».

  2. Прикрепить архив с настройками, который можно скачать по ссылке:

  3. Найти в списке рабочих процессов «Doqa» (цифра 1) и нажать «Изменить рабочий процесс» (цифра 2)

YouTrack обратная интеграция шаг 1

  1. В списке найти doqa_issue_field_changes и заполнить поля:
  • host — ссылка на вашу версию DoQA
  • email — электронный адрес, используемый в качестве логина в DoQA. Используйте учетные данные пользователя DoQA с правами на администрирование
  • password — пароль пользователя в DoQA

YouTrack обратная интеграция шаг 1

  1. После необходимо привязать рабочий процесс к проекту:
  • Зайти в рабочие процессы YouTrack
  • Выбрать Doqa, затем «Изменить список проектов» и добавить нужные проекты

YouTrack как источник требований ​

Подключённую интеграцию с YouTrack можно использовать ещё и как источник требований. Настройка выполняется на вкладке «Коннектор требований» в настройках пространства, см. Коннектор требований.

На стороне YouTrack до настройки коннектора заведите в проекте-источнике два кастомных поля и примените их к этому проекту:

  • поле для ID связанных проверок — тип «текст» (одиночное значение), например DoQA Tests. В него DoQA списком пишет ID тест-кейсов и чек-листов, связанных с требованием.
  • поле статуса покрытия — тип «перечисление» (одиночное значение), например DoQA Coverage status. Его значения сопоставляются с пятью состояниями покрытия DoQA: «Нет тестов», «Все прошли», «Не все прошли», «Не прогонялись», «Требуется актуализация».

Имена полей произвольные: нужные поля выбираются в настройках коннектора. Если поля в проекте нет, коннектор покажет статус «Поле не найдено».

Внимание

Требованиям нужен свой workflow-скрипт в YouTrack, не тот, который описан выше в разделе «Обратная интеграция с YouTrack». Архив youtrack_doqa_integration.zip и правило doqa_issue_field_changes обслуживают только синхронизацию баг-репортов; загрузку требований они не включают.

Вебхук для требований ​

  1. Сохраните коннектор требований в DoQA. В его настройках нажмите «Настройка вебхука YouTrack» (цифра 1). Сгенерируйте новый секрет (цифра 2) и скопируйте скрипт (цифра 3). URL, секрет и имя поля статуса покрытия в скрипт уже подставлены.

    Скрипт вебхука в DoQA

  2. В YouTrack откройте «Администрирование» → «Рабочие процессы» и создайте новый рабочий процесс. Привяжите его к проекту-источнику требований.

  3. Добавьте в рабочий процесс модуль «При изменении» и введите его название.

    Модуль «При изменении» в YouTrack

  4. Откройте модуль на редактирование, вставьте скопированный из DoQA скрипт и сохраните.

  5. Убедитесь, что правило включено для нужного проекта, и нажмите в DoQA «Обновить из трекера», чтобы загрузить текущие требования.