Перейти к основному содержимому

Интеграция с 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-сертификат, установите флажок Отключить проверку сертификата.

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

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

Примечание

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

  1. В YouTrack нажмите на свой аватар и перейдите в Профиль.

  2. Перейдите на вкладку Безопасность аккаунта.

  3. В разделе Токены нажмите Новый токен.

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

    • Имя токена — имя, которое поможет вам распознать токен, например, “Токен для ТестОпс”.
    • Область действия — “YouTrack”.

  5. Нажмите Создать, затем нажмите Копировать токен.

    Новый токен будет скопирован в ваш буфер обмена.

    Вам понадобится этот токен на следующем шаге.

3. Добавить учетные данные YouTrack в ТестОпс​

  1. В ТестОпс перейдите на страницу проекта.

  2. В меню слева нажмите Настройки → Интеграции.

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

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

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

    Проверьте правильность учетных данных

    Нажмите Тестировать соединение. Через несколько мгновений должно появиться сообщение “Соединение установлено”.

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

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

  1. В ТестОпс перейдите на страницу проекта.

  2. В меню слева нажмите Настройки → Задачи.

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

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

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

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