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

Возможности интеграции

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

• Проверка соединения.

  • ТестОпс может проверить валидность предоставленных учетных данных.
  • Разрешения в этом случае не проверяются.

• Синхронизация задач.

• Получение списка задач.

  • ТестОпс может получать и фильтровать список задач из таск-трекера на основе данных, введенных пользователем.

• Создание задач.

  • Задачи могут быть созданы из дефектов.

• Экспорт запуска.

  • Если запуск связан с какой-либо задачей, то ссылка на этот запуск будет добавлена в указанную задачу в виде комментария.

Для интеграции с 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. Добавьте имя сервиса (например, 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 (обратите внимание, что срок действия токена — 1 год).

   

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

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

   

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

   

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

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

Краткий обзор

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

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

Важно

Вам нужно иметь права администратора для настройки инстанса ТестОпс на глобальном уровне.

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

2. В правом верхнем углу нажмите + Добавить интеграцию.

3. Найдите Yandex Tracker.

4. Нажмите на логотип Yandex Tracker.

5. Укажите название для интеграции.

6. Укажите URL-адрес для Yandex Tracker (в большинстве случаев это https://tracker.yandex.com).

7. ТестОпс будет использовать API-эндпоинт по умолчанию (https://api.tracker.yandex.net), если оставить поле Endpoint пустым. См. https://cloud.yandex.com/en/docs/tracker/concepts/access.

   В большинстве случаев вам не нужно указывать этот параметр.

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

Добавьте Yandex Tracker в ваш проект

Важно

Вам нужно быть владельцем проекта для настройки этих параметров.

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

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

3. Найдите интеграцию Yandex Tracker, которую хотите добавить.

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

5. В появившемся окне введите учетные данные:

   • ID организации (можно найти по ссылке https://tracker.yandex.com/settings);
   • OAuth2-токен (описан в самом начале этой статьи).

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

7. Нажмите Добавить интеграцию, чтобы сохранить настройки.

После этого вы можете использовать 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-токен.