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

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

Внимание

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

Подготовка Jira

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

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

1. Используя аккаунт Jira с правами на создание полей или аккаунт администратора, перейдите в Настройки проекта > Задачи > Поля.
2. В выпадающем меню Действия нажмите Редактировать поля.
3. В колонке слева выберите раздел Пользовательские поля. В открывшемся окне нажмите Создать пользовательское поле. В открывшемся окне выберите раздел Стандартные.
4. В разделе Тип поля выберите Абзац.
5. Создайте поле:
   • 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. В открывшейся секции Приватный токен нажмите Сгенерировать.
4. В открывшемся окне подтвердите действие.

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

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

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

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

1. Используя аккаунт с ролью администратора, перейдите в раздел Администрирование и выберите вкладку Интеграции.
2. Нажмите Создать. Откроется окно Новое подключение.
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.
9. Перейдите по ссылке в поле Test Result. Должен открыться результат теста, для которого вы создавали дефект. В поле Ссылки должна появиться ссылка на созданный вами дефект. Проверьте ее.
10. Перейдите в раздел Тесты.
11. Откройте созданный тест-кейс. В правой части карточки тест-кейса должно появиться поле Копия теста в Jira со ссылкой на дубликат тест-кейса.
12. Перейдите по ссылке. В открывшемся дубликате теста должны отображаться те же шаги, что и в созданном тест-кейсе. Последний результат прохождения каждого шага должен отображаться в таблице в поле Last Result.

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