Test IT

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

Внимание

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

Подготовка Jira

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

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

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

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

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

Важно

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

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

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

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

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

Важно

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

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

Внимание

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

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

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

  1. Создайте тестовый проект.

  2. Добавьте в него пользователей.

  3. Подключите проект к созданной интеграции с Jira.

  4. Создайте тест-кейс.

  5. Перейдите в раздел Тест-планы. Создайте новый тест-план и откройте в нем вкладку Выполнение.

  6. Откройте созданный тест-кейс и поставьте ему результат Провален. В нижней части карточки тест-кейса должна появиться кнопка Сохранить и создать баг.

  7. Нажмите Сохранит и создать баг и выберите проект для создания бага. Откроется окно создания дефекта в Jira. Убедитесь, что:

    • Поле Description содержит информацию о тест-кейсе.
    • Поле testResultId содержит ID результата, для которого создается баг.

  8. Нажмите Create.

    В описании дефекта должно появиться следующее:

    • Ссылка на тест-кейс в поле Test Case.
    • Ссылка на результат теста, для которого создавался баг, в поле Test Result.

  9. Перейдите по ссылке в поле Test Result. Должен открыться результат теста, для которого вы создавали баг. В поле Ссылки должна появиться ссылка на созданный вами баг. Проверьте ее.

  10. Перейдите в раздел Тесты.

  11. Откройте созданный тест-кейс. В правой части карточки тест-кейса должно появиться поле Копия теста в Jira со ссылкой на дубликат тест-кейса.

  12. Перейдите по ссылке. В открывшемся дубликате теста должны отображаться те же шаги, что и в созданном тест-кейсе. Последний результат прохождения каждого шага должен отображаться в таблице в поле Last Result.

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

Смотрите также