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

Эта страница описывает, как настроить интеграцию ТестОпс с таск-трекером YouTrack. С этой интеграцией запуски ТестОпс, результаты тестов и дефекты могут иметь кликабельные ссылки на связанные задачи из YouTrack.

Поддерживаются как облачная, так и локальная версии YouTrack. Обратите внимание, что для ручного добавления задачи в тест-кейс YouTrack должен быть доступен с сервера ТестОпс.

Примечание

Для использования автоматической связи между тест-кейсами и задачами создатель теста должен указать эту связь с помощью адаптера Allure Report для своего тестового фреймворка. Пример указания связи:

import { test } from "@playwright/test";
import { allure } from "allure-playwright";

test("Some test", async ({ page }) => {
  allure.label("youtrack-prod", "BUG-123");
  // ...
});

Этот код определяет связь между тестом и задачей “BUG-123” в таск-трекере “youtrack-prod”. Чтобы сделать это фактической ссылкой в веб-интерфейсе, ТестОпс использует сопоставление задач для “youtrack-prod”, как будет описано на шаге 4.

Обратите внимание, что хотя приведенный выше пример работает, в реальном проекте мы рекомендуем создать свою собственную оберточную функцию вместо указания ключа в allure.label() каждый раз. Пожалуйста, ознакомьтесь с документацией Allure Report для вашего тестового фреймворка.

Сначала администратору нужно указать URL-адрес сервера YouTrack.

Затем владельцу проекта нужно создать токен аутентификации в YouTrack, добавить его в ТестОпс и настроить сопоставление задач.

1. Укажите URL-адрес YouTrack в ТестОпс

1. Войдите в ТестОпс, используя учетную запись администратора.

2. Перейдите в раздел Администрирование → Интеграции.

3. Нажмите + Добавить интеграцию в правом верхнем углу страницы.

4. В появившемся окне выберите YouTrack.

5. Заполните поля:

   • Название — название, которое поможет вам распознать интеграцию, например, YouTrack production.
   • Endpoint — URL-адрес инстанса YouTrack, например, https://example.youtrack.cloud/.

6. Если ваш сервер YouTrack использует самоподписанный SSL-сертификат, поставьте галочку Disable certificate validation.

7. Нажмите Добавить интеграцию.

2. Создайте токен в YouTrack

Примечание

Пропустите этот шаг, если вы планируете использовать свое имя пользователя и пароль в качестве учетных данных на следующем шаге.

1. В YouTrack нажмите на ваш аватар и перейдите в Profile.

2. Перейдите на вкладку Account Security.

3. В разделе Tokens нажмите New token.

4. Заполните поля:

   • Token Name — название, которое поможет вам распознать токен, например, «Токен для ТестОпс».
   • Scope — YouTrack.

5. Нажмите Create, затем нажмите Copy token.

   Новый токен будет скопирован в буфер обмена. Вам понадобится этот токен на следующем шаге.

3. Укажите учетные данные YouTrack в ТестОпс

1. Откройте ваш проект в ТестОпс.

2. Перейдите в раздел Настройки → Интеграции.

3. В разделе Доступные интеграции найдите интеграцию YouTrack и нажмите Добавить интеграцию рядом с ней.

4. В появившемся окне заполните поля:

   • Имя пользователя — имя пользователя, которое вы используете для входа в YouTrack.
   • Пароль — пароль, который вы используете для входа в YouTrack, или токен, который вы получили на шаге 2.

5. Нажмите Проверить соединение. Если учетные данные верны, через несколько секунд появится сообщение «Соединение установлено».

6. Нажмите Добавить интеграцию, чтобы сохранить настройки.

4. Настройте сопоставление задач

1. Откройте ваш проект в ТестОпс.

2. Перейдите в раздел Настройки → Задачи из баг-трекера.

3. Нажмите + Создать.

4. Заполните поля:

   • Ключ — короткий идентификатор интеграции, который вы собираетесь использовать при написании тестов.
   • Баг-трекер — название интеграции, которую вы добавили на шаге 1.

5. Нажмите Отправить.