Интеграция с YouTrack
Интеграция с YouTrack позволяет:
- связывать сущности ТестОпс (тест-кейсы, запуски, результаты тестов, дефекты, карантин) с задачами YouTrack (см. Ссылки на задачи из таск-трекеров);
- создавать задачи YouTrack через интерфейс открытого дефекта в ТестОпс (см. Связывание дефектов с задачами);
- просматривать связанные тест-кейсы из ТестОпс в задачах YouTrack.
Примечание
Чтобы настроить или удалить любую интеграцию ТестОпс с внешней системой, необходима глобальная роль «Администратор» в инстансе ТестОпс и, как правило, права администратора инстанса внешней системы.
Чтобы добавлять ссылки на задачи YouTrack в тест-кейсы вручную, инстанс YouTrack должен быть доступен с сервера ТестОпс.
Настройка интеграции и подключений с YouTrack
Чтобы настроить интеграцию с YouTrack:
- Создайте токен в YouTrack.
- Подключите интеграцию с YouTrack на уровне инстанса ТестОпс.
- Добавьте настроенное подключение к YouTrack в проект ТестОпс.
- Настройте маппинг задач в ТестОпс.
1. Создайте токен в YouTrack
Примечание
Пропустите этот шаг, если вы планируете использовать свое имя пользователя и пароль из YouTrack в качестве учетных данных для интеграции.
Перейдите в ваш инстанс YouTrack.
Нажмите на ваш аватар и перейдите в раздел Profile → вкладка Account Security.
В разделе Tokens нажмите New 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.
Нажмите Добавить подключение.
В разделе Администрирование → Интеграции появится интеграция с YouTrack с одним автоматически созданным подключением.
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.
- Напротив нужного подключения к YouTrack нажмите
⋯→ Удалить → Да, удалить.
Подключение перестанет работать в вашем проекте.
Удаление подключения на уровне инстанса
Важно
Последствия удаления всех подключений из интеграции с YouTrack на уровне инстанса:
- Подключения и интеграция с YouTrack будут полностью удалены.
- Все связи с задачами YouTrack, которые относятся к интеграции, будут удалены из сущностей ТестОпс. Это действие необратимо — восстановить удаленные ссылки будет невозможно.
Чтобы удалить подключение на уровне инстанса:
- В ТестОпс перейдите в раздел Администрирование → Интеграции.
- В списке настроенных интеграций найдите и откройте интеграцию с YouTrack.
- В списке настроенных подключений откройте карточку нужного подключения и напротив названия каждого проекта нажмите
⋯→ Удалить из проекта → Да, удалить. - Нажмите Назад в интеграцию, чтобы вернуться к списку подключений.
- Напротив нужного подключения к YouTrack нажмите
⋯→ Удалить → Да, удалить.
Подключение перестанет работать во всех проектах инстанса.

