Интеграция с Jira Cloud

  • Для этого раздела мы подготовили видео:

Внимание

Интеграция с Next Genopen in new window проектами (проекты, управляемые командой) не поддерживается.

Подготовка Jira

Перед созданием интеграции внутри системы Test IT вам необходимо настроить пользовательские поля и новые типы задач в Jira Cloud.

Создание пользовательских полей

  1. Используя аккаунт Jira с правами на создание полей или аккаунт администратора, перейдите в Настройки проекта > Задачи > Поля.
  2. В выпадающем меню Действия нажмите Редактировать поля.
  3. В колонке слева выберите раздел Пользовательские поля. В открывшемся окне нажмите Создать пользовательское поле. В открывшемся окне выберите раздел Стандартные.
  4. В разделе Тип поля выберите Абзац.
  5. Создайте поле:
  • hiddenSteps — используется для корректного рендеринга контента из Test IT, отображаемого в Jira.
  1. Вы автоматически переместитесь в раздел Задачи. Примените созданные поля ко всем экранам, использующимся в проекте, который вы хотите интегрировать с Test IT, поставив напротив них флажки. Нажмите Обновить.

Создание задач типа TestCase

  1. Перейдите в настройки системы Jira Cloud.
  2. В открывшемся меню выберите Задачи.
  3. В открывшемся окне убедитесь, что вы находитесь в разделе Типы задач, а затем нажмите Добавить тип задачи.
  4. В открывшемся окне назовите новый тип задачи TestCase и убедитесь, что в разделе Тип поставлен флажок Стандартный тип задачи. Данный тип задач необходим при создании дубликатов тест-кейсов в Jira.
  5. Нажмите Добавить.
  6. Откройте проект, который хотите интегрировать с Test IT. Перейдите в Настройки проекта > Задачи > Типы.
  7. В колонке слева выберите раздел Схемы типов задач.
  8. Откройте меню действий для схемы задач проекта и нажмите Редактировать.
  9. Перетащите созданный тип задачи из поля Доступно в поле Типы задач для текущей схемы.
  10. Нажмите Сохранить.

Проверьте новый тип задачи

Убедитесь, что новый тип задачи присутствует во всех необходимых схемах, иначе дублирование работать не будет.

Получение токена Jira Cloud

  1. Нажмите на значок профиля и выберите в открывшемся меню Настройки профиля.
  2. Перейдите в раздел Безопасность.
  3. В открывшейся секции Приватный токен нажмите Сгенерировать.
  4. В открывшемся окне подтвердите действие.

Система сгенерирует токен API, который вы можете копировать и использовать как пароль для интеграции с системой Test IT.

Создание интеграции с Test IT

Требуется переменная FRONTEND_URL

Для корректной работы интеграции с Jira нужно задать в .env-файле переменную FRONTEND_URL.

  1. Используя аккаунт с ролью администратора, перейдите в раздел Администрирование и выберите вкладку Интеграции.
  2. Нажмите Создать. Создание интеграции с багтрекером в Test IT TMS Откроется окно Новое подключение.
  3. В меню Сервис для интеграции выберите Jira, затем выберите тип установки: Cloud.
  4. Заполните данные для подключения:
    • Имя интеграции
    • URL вашей системы Jira с протоколом и портом
    • Логин аккаунта Jira с правами администратора
    • Токен API для Jira Cloud, сгенерированный ранее
  5. Нажмите Сохранить. Система Test IT автоматически протестирует интеграцию и в случае успешного тестирования сохранит ее.

Внимание

Полное подключение новой интеграции на стороне Jira может занять некоторое время (до нескольких часов после создания интеграции).

Интеграцию с Jira в дальнейшем можно использовать для подключения проекта Test IT к Jira.

Проверка работы интеграции

  1. Создайте тестовый проект.
  2. Добавьте в него пользователей.
  3. Подключите проект к созданной интеграции с Jira.
  4. Создайте тест-кейс.
  5. Перейдите в раздел Тест-планы. Создайте новый тест-план и откройте в нем вкладку Выполнение.
  6. Откройте созданный тест-кейс и поставьте ему результат Провален. В нижней части карточки тест-кейса должна появиться кнопка Сохранить и создать баг.
  7. Нажмите Сохранить и создать баг и выберите проект для создания бага. Откроется окно создания дефекта в Jira. Убедитесь, что поле Description содержит информацию о тест-кейсе.
  8. Нажмите Create. В описании дефекта должно появиться следующее:
    • Ссылка на тест-кейс в поле Test Case.
    • Ссылка на результат теста, для которого создавался баг, в поле Test Result. Проверка работы интеграции в Test IT TMS
  9. Перейдите по ссылке в поле Test Result. Должен открыться результат теста, для которого вы создавали баг. В поле Ссылки должна появиться ссылка на созданный вами баг. Проверьте ее.
  10. Перейдите в раздел Тесты.
  11. Откройте созданный тест-кейс. В правой части карточки тест-кейса должно появиться поле Копия теста в Jira со ссылкой на дубликат тест-кейса.
  12. Перейдите по ссылке. В открывшемся дубликате теста должны отображаться те же шаги, что и в созданном тест-кейсе. Последний результат прохождения каждого шага должен отображаться в таблице в поле Last Result. Проверка интеграции Test IT TMS с Jira Cloud, дубликат тест-кейса

Если все шаги выше пройдены успешно, ваша интеграция успешно настроена.

Обновлено: