Интеграция с Kaiten

Важно

Интеграция доступна начиная с ТестОпс версии 5.16.0.

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

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

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

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

Примечание

Чтобы настроить интеграцию с Kaiten, у вас должны быть права администратора инстанса ТестОпс.

1. Получите API-ключ в Kaiten

1. Перейдите в ваше пространство в Kaiten.

2. Нажмите на аватар вашего профиля и выберите PROFILE SETTINGS.

3. Перейдите в раздел Api Key.

4. Нажмите + CREATE API KEY.

5. Нажмите значок Копировать, чтобы скопировать API-ключ в буфер обмена.

   Cохраните API-ключ в безопасном месте, он понадобится для настройки интеграции в проекте ТестОпс.

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

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

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

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

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

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

   • Название — название, которое поможет вам распознать интеграцию, например, Kaiten production.
   • Endpoint — URL-адрес вашего инстанса Kaiten, например, https://example.kaiten.ru/.

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

3. Настройте интеграцию в проекте ТестОпс

Чтобы начать пользоваться интеграцией, добавьте её в нужный проект ТестОпс. Это можно сделать двумя способами: через раздел Администрирование или внутри проекта в разделе Настройки.

Настройки проекта

1. Перейдите в ваш проект в ТестОпс.
2. Перейдите в раздел Настройки → Интеграции.
3. В разделе Доступные интеграции найдите интеграцию с Kaiten и нажмите Добавить интеграцию рядом с ней.
4. В поле API key введите API-ключ, который вы сохранили ранее.
5. Нажмите Проверить соединение. Если API-ключ указан верно, через несколько секунд появится сообщение «Соединение установлено».
6. Нажмите Добавить интеграцию, чтобы сохранить настройки.

Панель администрирования

1. Перейдите в раздел Администрирование → Интеграции.
2. В списке настроенных интеграций найдите и откройте интеграцию с Kaiten.
3. Перейдите на вкладку Проекты.
4. Нажмите + справа от поля поиска.
5. В выпадающем списке Проект выберите нужный проект.
6. В поле API key введите API-ключ, который вы сохранили ранее.
7. Нажмите Проверить соединение. Если API-ключ указан верно, через несколько секунд появится сообщение «Соединение установлено».
8. Нажмите Добавить интеграцию, чтобы сохранить настройки.

4. Настройте вебхуки

Чтобы синхронизировать статусы задач Kaiten со статусами дефектов ТестОпс, настройте вебхуки.

4.1. Создайте вебхук в ТестОпс

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

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

3. Перейдите на вкладку Вебхуки.

4. Нажмите + Создать вебхук, затем нажмите Подтвердить создание.

5. Нажмите значок Копировать, чтобы скопировать токен в буфер обмена.

   Этот токен понадобится вам на следующем шаге.

4.2. Настройте вебхук в Kaiten

1. Перейдите в ваше пространство в Kaiten.
2. В сайдбаре наведите курсор на название пространства и справа от него нажмите Space settings.
3. Перейдите в раздел External webhooks.
4. В поле External webhook вставьте токен из ТестОпс, который вы скопировали ранее.
5. Включите переключатель Enabled и нажмите SAVE.