Yandex Tracker

Для подключения интеграции с Yandex Tracker выполните следующие шаги:

1. Создайте OAuth-приложение в Яндексе. Перейдите на https://oauth.yandex.ru/client/new/ и заполните:

• Название вашего сервиса — DoQA
• Платформы приложения — «Веб-сервисы»
• Redirect URI — по шаблону https://domain.doqa.app/api/integrations/yandex-tracker/verification-code
• Доступ к данным — tracker:write и tracker:read

Эти же значения DoQA показывает прямо в форме подключения, с иконками копирования; Redirect URI подставляется под адрес вашего стенда автоматически.

2. Создайте приложение и скопируйте его Client ID и Client secret.

3. Введите в форме подключения следующие данные:

• «ClientID»
• «Client secret»
• «Заголовок организации» — X-Org-ID или X-Cloud-Org-ID
• «ID» — идентификатор организации, его можно посмотреть на https://tracker.yandex.ru/admin/orgs

Примечание: Если у вас только организация Yandex Cloud Organization, используйте заголовок X-Cloud-Org-ID, если только Яндекс 360 для бизнеса или оба типа организаций — X-Org-ID.

4. Когда вы заполните поля и подтвердите создание интеграции, откроется страница Яндекса. Там нужно авторизоваться под учётными данными пользователя, у которого есть доступ к проекту в Яндекс Трекере.

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

DoQA позволяет настраивать обратную интеграцию с Yandex Tracker, чтобы при изменении статуса или приоритета баг-репорта в трекере автоматически обновлялись соответствующие поля в связанном баг-репорте в DoQA.

Для настройки обратной интеграции выполните следующие шаги:

1. В Yandex Tracker перейти в раздел «Очереди»

2. Нажать на «Настройки очереди»

3. Слева выбрать «Автоматизация»

4. Нажать на кнопку «Создать» → «Триггер»

5. Заполнить условия.

• Выбрать: Задача, Описание, Приоритет и Статус
• Отметить значение «ИЛИ»

6. Заполнить раздел «Выполнить действие»:

• метод POST
• URL системы по шаблону https://domain.doqa.app/api/integrations/yandex-tracker/webhook
• тип содержимого application/json
• email и password в теле запроса

Тело запроса:

{
    "email": "user@example.com",
    "password": "password",
    "type": "yandexTracker",
    "issueId": "{{issue.key}}",
    "queue": "{{issue.queue.key}}",
    "updated": "{{currentDateTime}}",
    "priority": "{{issue.priority}}",
    "state": "{{issue.status}}",
    "summary": "{{issue.summary}}",
    "description": "{{issue.description}}"
}

Yandex Tracker как источник требований

Подключённую интеграцию с Yandex Tracker можно использовать как источник требований: требованиями становятся задачи выбранной очереди. Настройка выполняется на вкладке «Коннектор требований» в настройках пространства, см. Коннектор требований.

Готовить поля в Яндекс Трекере заранее не нужно. В коннекторе для «Поля для ID кейсов» и «Поля статуса покрытия» выберите «Создать автоматически»: после сохранения DoQA сама создаст в очереди локальные поля «Связанные кейсы DOQA» и «Статус покрытия DOQA» и заполнит маппинг статусов. Можно выбрать и уже существующие локальные поля очереди.

Вебхук тоже создаётся автоматически: DoQA добавляет в очередь триггер «DoQA requirements sync», который срабатывает при изменении поля статуса покрытия. Этот триггер не связан с триггером обратной интеграции баг-репортов выше.

Права токена

Чтобы создать поля и триггер, владельцу OAuth-токена интеграции нужны права на настройки очереди и её локальные поля. Без права «Настройки очереди» коннектор покажет статус «Требуется ручная настройка» и инструкцию для ручного создания триггера, см. Коннектор требований.