Интеграция с Yandex Tracker

Интеграция с Yandex Tracker позволяет:

• связывать сущности ТестОпс (тест-кейсы, запуски, результаты тестов, дефекты, карантин) с задачами Yandex Tracker (см. Ссылки на задачи из таск-трекеров);
• создавать задачи Yandex Tracker через интерфейс открытого дефекта в ТестОпс (см. Связывание дефектов с задачами);
• получать ссылки на связанные запуски из ТестОпс в задачах Yandex Tracker.

Примечание

Чтобы настроить или удалить любую интеграцию ТестОпс с внешней системой, необходима глобальная роль «Администратор» в инстансе ТестОпс и, как правило, права администратора инстанса внешней системы.

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

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

1. Создайте OAuth2-токен в Яндекс.
2. Подключите интеграцию с Yandex Tracker на уровне инстанса ТестОпс.
3. Добавьте настроенное подключение к Yandex Tracker в проект ТестОпс.

1. Создайте OAuth2-токен в Яндекс

Чтобы использовать Yandex Tracker, вам нужно аутентифицироваться на стороне Яндекс.

Создание параметров аутентификации описано в официальной документации Yandex Cloud.

https://cloud.yandex.com/en/docs/tracker/concepts/access

Сначала вам нужно аутентифицироваться на https://yandex.com/dev/:

1. Откройте https://oauth.yandex.com/client/new.

2. Добавьте имя сервиса (например, TestOpsIntegration).

3. Выберите Which platform is the app required for? и нажмите Insert URL for development.

   

4. В разделе Data access в поле Permission name:

   • введите ключевое слово tracker и выберите разрешения:
     • Read from tracker;
     • Write in tracker.
   • введите ключевое слово cloud и выберите разрешение Cloud authentication.

5. Для пункта Link to website выберите Insert URL for development и нажмите Create app.

   

6. Вы будете перенаправлены на страницу созданного приложения, на которой вам нужно скопировать ClientID.

   

7. Перейдите по ссылке https://oauth.yandex.com/authorize?response_type=token&client_id=application_ID, где application_ID — ваш текущий ClientID из предыдущего шага.

8. Подтвердите авторизацию, если требуется.

   

9. Теперь ваш OAuth2-токен создан и активирован.

   

   Скопируйте и сохраните токен в безопасном месте, он понадобится для подключения интеграции с Yandex Tracker в ТестОпс.

2. Подключите интеграцию с Yandex Tracker на уровне инстанса ТестОпс

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

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

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

4. В списке доступных интеграций выберите Yandex Tracker.

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

   • Название подключения — введите название, которое поможет вам распознать интеграцию (например, Yandex Tracker production).

   • Endpoint — введите URL-адрес вашего инстанса Yandex Tracker (в большинстве случаев это https://tracker.yandex.com).

   • Endpoint для вызовов API — введите URL-адрес Yandex Tracker API:

     • Для облачной версии Yandex Tracker (tracker.yandex.com) убедитесь, что указано https://api.tracker.yandex.net. Подробнее см. https://cloud.yandex.com/en/docs/tracker/concepts/access.
     • Для серверной версии Yandex Tracker введите собственный endpoint.

   • Тип учетных данных — нажмите на выпадающий список и выберите тип учетных данных Yandex Tracker, который будет поддерживать интеграция:

     • Все (глобальные и проектные) — интеграция может работать как с глобальными, так и с проектными учетными данными;
     • Только глобальные — интеграция может работать только с глобальными учетными данными;
     • Только проектные — интеграция может работать только с проектными учетными данными.

     Примечание

     Подробнее о поддерживаемых типах учетных данных см. Интеграции с внешними системами → Глобальные и проектные учетные данные

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

7. Если интеграция может работать с глобальными учетными данными Yandex Tracker, в секции Глобальные учетные данные на вкладке OAuth2-токен:

   1. Введите ID организации нужной учетной записи в Yandex Tracker (подробнее см. Получить идентификатор организации в официальной документации Yandex Tracker).
   2. Введите OAuth2-токен, который вы сохранили на шаге 1.

8. Нажмите Добавить подключение.

3. Добавьте настроенное подключение к Yandex Tracker в проект ТестОпс

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

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

2. В списке настроенных интеграций найдите и откройте интеграцию с Yandex Tracker.

3. В списке настроенных подключений найдите и откройте ваше подключение к Yandex Tracker.

4. Нажмите Добавить в проект.

5. В списке доступных проектов выберите нужный проект ТестОпс.

6. Если интеграция может работать и с глобальными, и с проектными учетными данными Yandex Tracker, в поле Тип учетных данных нажмите на выпадающий список и выберите вариант, который будет использоваться в проекте:

   • Проектные — использовать проектные учетные данные для подключения к Yandex Tracker;
   • Глобальные — использовать глобальные учетные данные для подключения к Yandex Tracker.

7. Если интеграция будет работать с проектными учетными данными Yandex Tracker, в секции Проектные учетные данные на вкладке OAuth2-токен:

   1. Введите ID организации нужной учетной записи в Yandex Tracker (подробнее см. Получить идентификатор организации в официальной документации Yandex Tracker).
   2. Введите OAuth2-токен, который вы сохранили на шаге 1.

8. Нажмите Добавить в проект.

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

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

Важно

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

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

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

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

2. В списке настроенных интеграций найдите и откройте интеграцию с Yandex Tracker.

3. В списке настроенных подключений найдите ваше подключение к Yandex Tracker и убедитесь, что оно не используется в проектах ТестОпс.

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

4. Напротив нужного подключения к Yandex Tracker нажмите ⋯ → Удалить → Да, удалить.

Устранение неполадок

Не устанавливается тестовое соединение («Insufficient scope for this Yandex.passport account»)

Если при попытке установить тестовое соединение возникает ошибка «Insufficient scope for this Yandex.passport account. Yandex.passport account lacks», перейдите в созданное приложение на стороне Яндекс:

1. Убедитесь, что в разделе Data access выбрано разрешение Сloud authentification.
2. Пересоздайте OAuth2-токен.