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

Возможности

Следующие возможности доступны для интеграции с Yandex Tracker:

• Тестирование соединения
  • ТестОпс может проверить действительность предоставленных учетных данных
  • Разрешения не могут быть проверены
• Операция синхронизации задач
• Операция предложения задач
  • ТестОпс может получать и фильтровать список задач из трекера на основе данных, введенных пользователем
• Операция создания задач
  • Задачи могут быть созданы из дефектов
• Операция экспорта запуска
  • Если запуск связан с какой-либо задачей, то ссылка на этот запуск будет добавлена в указанную задачу в виде комментария

Есть 2 шага, которые вам нужно выполнить для интеграции с Yandex Tracker:

1. Создать OAuth2 токен на стороне Yandex Cloud
2. Добавить интеграцию на стороне ТестОпс

Создание OAuth2 токена на стороне Yandex

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

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

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

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

1. Откройте https://oauth.yandex.com/client/new
2. Добавьте имя сервиса

• например AllureIntegration

3. Выберите "Для какой платформы требуется приложение?" и нажмите "Вставить URL для разработки"

4. Прокрутите до Доступ к данным, введите "tracker" и выберите разрешения из списка Чтение из трекера и Запись в трекер

5. Далее, для пункта Ссылка на сайт выберите Вставить URL для разработки и нажмите Создать приложение

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

7. Далее, вам нужно создать и перейти по ссылке:

https://oauth.yandex.com/authorize?response_type=token&client_id=application_ID

где application_ID - ваш текущий ClientID из пункта 5

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

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

Добавление интеграции на стороне ТестОпс

Общее описание включения интеграции описано в разделе Интеграции.

Резюме интеграции

1. Создайте (получите/сгенерируйте/как угодно) секреты (учетные данные) на внешней системе для использования их API.
2. Добавьте необходимую интеграцию на глобальном уровне ТестОпс (вам нужно быть администратором или иметь администратора рядом).
3. Добавьте необходимую интеграцию на уровне проекта и предоставьте учетные данные (секреты), которые вы получили на шаге 1.

Глобальный уровень

Важно

Вам нужно иметь полномочия ROLE_ADMIN, чтобы настроить экземпляр ТестОпс на глобальном уровне.

1. Перейдите в меню пользователя > Администрирование > Интеграции
2. В правом верхнем углу нажмите Добавить интеграцию
3. Найдите Yandex Tracker
4. Нажмите на баннер Yandex Tracker
5. Укажите имя интеграции
6. Укажите URL для Yandex Tracker (скорее всего это будет https://tracker.yandex.com).
7. ТестОпс будет использовать конечную точку API по умолчанию, см. https://cloud.yandex.com/en/docs/tracker/concepts/access как https://api.tracker.yandex.net как Конечная точка, если оставить это поле пустым.
   • не обновляйте этот параметр, если ваш экземпляр не является очень особенным.
8. Завершите, нажав Добавить интеграцию.

Добавление Yandex Tracker в ваш проект

Важно

Вам нужно быть Владельцем проекта, чтобы настроить эти параметры.

1. Перейдите в настройки проекта.
2. Перейдите в раздел Интеграция
3. Найдите интеграцию Yandex Tracker, которую хотите добавить.
4. Нажмите Добавить интеграцию.
5. В модальном окне введите учетные данные – ID организации (можно найти, перейдя по ссылке https://tracker.yandex.com/settings)
   • OAuth2 токен (описан в самом начале этой статьи)
6. Нажмите Тестировать соединение
7. Завершите настройки интеграции, нажав на Добавить интеграцию.

Вот и все, теперь вы можете использовать Yandex Tracker.