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

Интеграция с 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", как будет показано на шаге 1.4.

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

Настройка интеграции

Чтобы настроить интеграцию с YouTrack:

1. При необходимости создайте токен в YouTrack.

2. На уровне инстанса ТестОпс добавьте интеграцию с YouTrack, указав:

   • название интеграции;
   • URL-адрес YouTrack.

3. На уровне инстанса или проекта ТестОпс включите добавленную интеграцию для проекта, указав учетные данные или созданный токен из YouTrack.

4. Настройте маппинг задач в ТестОпс.

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

Примечание

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

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

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

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

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

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

5. Нажмите Create, затем нажмите Copy token, чтобы скопировать токена в буфер обмена.

   Cохраните токен в безопасном месте, он понадобится для настройки интеграции в проекте ТестОпс.

2. Добавьте интеграцию с YouTrack в ТестОпс

1. Перейдите в ваш инстанс ТестОпс.

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

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

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

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

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

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

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

3. Включите интеграцию для проекта ТестОпс

Чтобы включить интеграцию в нужном проекте ТестОпс, воспользуйтесь одним из способов:

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

2. В списке настроенных интеграций найдите и откройте вашу интеграцию с YouTrack.

3. Перейдите на вкладку Проекты.

4. Справа от поля поиска нажмите +.

5. В выпадающем списке Проект выберите нужный проект ТестОпс.

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

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

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

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

4. Настройте маппинг задач в ТестОпс

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

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

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

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

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

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

Удаление интеграции

Вы можете удалить интеграцию с YouTrack двумя способами — на уровне всего инстанса ТестОпс (через раздел Администрирование) или на уровне отдельного проекта (через настройки проекта).

Важно

Последствия удаления интеграции:

• Удаление на уровне инстанса — все связи с задачами YouTrack, которые относятся к интеграции, будут удалены из сущностей ТестОпс. Это действие необратимо — восстановить удаленные ссылки будет невозможно.

• Удаление на уровне проекта — все связи с задачами YouTrack, которые относятся к интеграции, будут сохранены в сущностях ТестОпс, но вы не сможете создавать новые связи для этого проекта.

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

2. В списке настроенных интеграций найдите и откройте вашу интеграцию с YouTrack.

3. Перейдите на вкладку Проекты и убедитесь, что интеграция не используется в проектах ТестОпс.

   Если интеграция подключена к проектам, удалите ее из них. Для этого напротив названия каждого проекта нажмите иконку корзины → Удалять.

4. Перейдите на вкладку Конфигурация.

5. Нажмите Удалить интеграцию.

6. Нажмите Удалить.