Интеграция с 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, введите tracker и выберите разрешения из списка Read from tracker и Write in tracker.

   

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.