Интеграция с YouTrack
Интеграция с YouTrack позволяет:
- связывать сущности ТестОпс (тест-кейсы, запуски, результаты тестов, дефекты, карантин) с задачами YouTrack (см. Ссылки на задачи из таск-трекеров);
- создавать задачи YouTrack через интерфейс открытого дефекта в ТестОпс (см. Связывание дефектов с задачами).
Примечание
Чтобы настроить или удалить любую интеграцию ТестОпс с внешней системой, необходима глобальная роль «Администратор» в инстансе ТестОпс и, как правило, права администратора инстанса внешней системы.
Чтобы добавить ссылку на задачу в тест-кейс вручную, YouTrack должен быть доступен с сервера ТестОпс.
Настройка интеграции
Чтобы настроить интеграцию с YouTrack:
- При необходимости создайте токен в YouTrack.
- Подключите интеграцию с YouTrack на уровне инстанса ТестОпс.
- Добавьте настроенное подключение к YouTrack в проект ТестОпс.
- Настройте маппинг задач в ТестОпс.
1. Создайте токен в YouTrack
Примечание
Пропустите этот шаг, если в интеграции с YouTrack вы планируете использовать имя пользователя и пароль в качестве учетных данных.
В YouTrack нажмите на ваш аватар и перейдите в раздел Profile.
Перейдите на вкладку Account Security.
В разделе Tokens нажмите New token.
Заполните поля:
- Token Name — введите название, которое поможет вам распознать интеграцию (например, Токен для ТестОпс).
- Scope — выберите YouTrack.
Нажмите Create, затем нажмите Copy token, чтобы скопировать токена в буфер обмена.
Cохраните токен в безопасном месте, он понадобится для подключения интеграции с YouTrack в ТестОпс.
2. Подключите интеграцию с YouTrack на уровне инстанса ТестОпс
Перейдите в ваш инстанс ТестОпс.
Перейдите в раздел Администрирование → Интеграции.
Нажмите Добавить интеграцию.
В списке доступных интеграций выберите YouTrack.
Заполните поля:
Название подключения — введите название, которое поможет вам распознать интеграцию (например, YouTrack production).
Endpoint — введите URL-адрес вашего инстанса YouTrack (например, https://example.youtrack.cloud/).
Тип учетных данных — нажмите на выпадающий список и выберите тип учетных данных YouTrack, который будет поддерживать интеграция:
- Все (глобальные и проектные) — интеграция может работать как с глобальными, так и с проектными учетными данными;
- Только глобальные — интеграция может работать только с глобальными учетными данными;
- Только проектные — интеграция может работать только с проектными учетными данными.
Примечание
Подробнее о поддерживаемых типах учетных данных см. Интеграции с внешними системами → Глобальные и проектные учетные данные
Если ваш инстанс YouTrack использует самоподписанный SSL-сертификат, уберите галочку напротив Проверка SSL-сертификата.
Если интеграция может работать с глобальными учетными данными YouTrack, в секции Глобальные учетные данные:
- Введите имя пользователя нужной учетной записи в YouTrack.
- Введите пароль нужной учетной записи в YouTrack или токен, который вы сохранили на шаге 1.
Нажмите Добавить подключение.
3. Добавьте настроенное подключение к YouTrack в проект ТестОпс
Чтобы добавить настроенное подключение к YouTrack в нужный проект ТестОпс, воспользуйтесь одним из способов:
В ТестОпс перейдите в раздел Администрирование → Интеграции.
В списке настроенных интеграций найдите и откройте интеграцию с YouTrack.
В списке настроенных подключений найдите и откройте ваше подключение к YouTrack.
Нажмите Добавить в проект.
В списке доступных проектов выберите нужный проект ТестОпс.
Если интеграция может работать и с глобальными, и с проектными учетными данными YouTrack, в поле Тип учетных данных нажмите на выпадающий список и выберите вариант, который будет использоваться в проекте:
- Проектные — использовать проектные учетные данные для подключения к YouTrack;
- Глобальные — использовать глобальные учетные данные для подключения к YouTrack.
Если интеграция будет работать с проектными учетными данными YouTrack, в секции Проектные учетные данные:
- Введите имя пользователя нужной учетной записи в YouTrack.
- Введите пароль нужной учетной записи в YouTrack или токен, который вы сохранили на шаге 1.
Нажмите Добавить в проект.
4. Настройте маппинг задач в ТестОпс
Откройте ваш проект ТестОпс.
Перейдите в раздел Настройки → Задачи из баг-трекера.
Нажмите + Создать.
Заполните поля:
- Ключ — введите короткий идентификатор интеграции, который вы собираетесь использовать при написании тестов (например, youtrack).
- Баг-трекер — нажмите на выпадающий список и выберите название подключения к YouTrack, которое вы добавили на шаге 2.
Нажмите Отправить.
Совет
Вы можете использовать созданный ключ для автоматической привязки тест-кейсов ТестОпс к задачам YouTrack. Для этого в коде теста укажите ключ с помощью адаптера Allure Report для вашего тестового фреймворка:
ts
import { test } from "@playwright/test";
import { allure } from "allure-playwright";
test("Some test", async ({ page }) => {
allure.label("youtrack", "BUG-123");
// ...
});Этот код свяжет тест с задачей «BUG-123» в таск-трекере «youtrack», используя маппинг, который вы создали на предыдущем шаге.
Обратите внимание, что хотя приведенный выше пример работает, в реальном проекте рекомендуется каждый раз использовать оберточную функцию вместо указания ключа с помощью allure.label(). Подробнее см. в документации Allure Report для вашего тестового фреймворка.
Удаление интеграции
Вы можете удалить интеграцию с YouTrack двумя способами — на уровне всего инстанса ТестОпс (через раздел Администрирование) или на уровне отдельного проекта (через настройки проекта).
Важно
Последствия удаления интеграции:
Удаление на уровне инстанса — все связи с задачами YouTrack, которые относятся к интеграции, будут удалены из сущностей ТестОпс. Это действие необратимо — восстановить удаленные ссылки будет невозможно.
Удаление на уровне проекта — все связи с задачами YouTrack, которые относятся к интеграции, будут сохранены в сущностях ТестОпс, но вы не сможете создавать новые связи для этого проекта.
В ТестОпс перейдите в раздел Администрирование → Интеграции.
В списке настроенных интеграций найдите и откройте интеграцию с YouTrack.
В списке настроенных подключений найдите ваше подключение к YouTrack и убедитесь, что оно не используется в проектах ТестОпс.
Если интеграция подключена к проектам, удалите ее из них. Для этого откройте карточку подключения к YouTrack и напротив названия каждого проекта нажмите
⋯→ Удалить из проекта → Да, удалить.Напротив нужного подключения к YouTrack нажмите
⋯→ Удалить → Да, удалить.

