Интеграция с Xray
Xray — это плагин для управления тестированием в Jira. ТестОпс предоставляет одностороннюю интеграцию (только экспорт), которая отправляет информацию о тест-кейсах в Xray, чтобы создать и обновить задачу Jira для каждого тест-кейса. Интеграция поддерживает Allure Query Language для выбора данных для экспорта, т.е. вы можете копировать только тест-кейсы с определенным тегом.
Примечание
Чтобы настроить или удалить интеграцию в ТестОпс, вы должны иметь доступ к разделам:
- Администрирование — необходимы права администратора инстанса;
- Настройки в конкретном проекте — необходима роль владельца этого проекта.
Настройка интеграции
Чтобы настроить интеграцию с Xray:
Создайте API-токены в Jira и Xray.
На уровне инстанса ТестОпс добавьте интеграцию с Xray, указав:
- название интеграции;
- URL-адрес Jira.
На уровне инстанса или проекта ТестОпс включите добавленную интеграцию для проекта, указав учетные данные из Jira.
Включите синхронизацию между задачами Xray и тест-кейсами ТестОпс.
1. Создайте API-токены в Jira и Xray
1.1. Создайте API-токен в Jira
Пропустите этот шаг, если вы планируете использовать свое имя пользователя и пароль в качестве учетных данных для Jira.
В Jira нажмите на ваш аватар и перейдите в Profile.
В меню слева нажмите Personal Access Tokens.
Нажмите Create token.
Заполните поля:
- Token Name — название, которое поможет вам распознать токен, например, Токен для ТестОпс.
- Expiry date — срок действия токена. После указанной даты интеграция перестанет работать. Чтобы возобновить ее работу, вам нужно будет создать новый токен. Чтобы создать бессрочный токен, снимите галочку Automatic expiry.
Нажмите Create.
Новый токен станет временно видимым. Скопируйте и сохраните токен в безопасном месте, он понадобится для настройки интеграции в проекте ТестОпс.
1.2. Создайте API-токен в Xray
Если вы используете Xray для Jira Data Center, вам не нужно создавать дополнительный API-токен на этом шаге.
2. Настройте интеграцию
2.1. Добавьте интеграцию с Xray в ТестОпс
Перейдите в ваш инстанс ТестОпс.
Перейдите в раздел Администрирование → Интеграции.
Нажмите + Добавить интеграцию в правом верхнем углу.
В списке доступных интеграций выберите:
- Xray Test Management for Jira — если вы используете Jira Data Center;
- Xray Test Management for Jira Cloud — если вы используете Jira Software Cloud.
Заполните поля:
- Название — название, которое поможет вам распознать интеграцию, например, Xray production.
- Endpoint — URL-адрес вашего инстанса Jira, например, https://example.atlassian.net/.
Нажмите Добавить интеграцию.
2.2. Включите интеграцию для проекта ТестОпс
Чтобы включить интеграцию в нужном проекте ТестОпс воспользуйтесь одним из двух способов ниже:
Перейдите в раздел Администрирование → Интеграции.
В списке настроенных интеграций найдите и откройте вашу интеграцию с Xray.
Перейдите на вкладку Проекты.
Нажмите + справа от поля поиска.
В выпадающем списке Проект выберите нужный проект.
В появившемся окне введите учетные данные для подключения к Jira.
Jira Data Center (пароль)
На вкладке basic введите имя пользователя и пароль учетной записи в Jira.
Jira Data Center (токен)
На вкладке token введите токен, который вы сохранили на шаге 1.1.
Нажмите Проверить соединение. Если учетные данные верны, через несколько секунд появится сообщение «Соединение установлено».
Нажмите Добавить интеграцию, чтобы сохранить настройки.
3. Включите синхронизацию между Xray и ТестОпс
Перейдите в ваш проект в ТестОпс.
Перейдите в раздел Настройки → Интеграции.
В разделе Доступные интеграции найдите и откройте вашу интеграцию с Xray.
На вкладке Синхронизация с TMS нажмите Создать.
В выпадающем списке Project выберите проект Jira, в который ТестОпс должен отправлять данные о запуске тестов.
Укажите, какие данные ТестОпс должен экспортировать в Xray:
- Фильтр по тест-кейсам — AQL-запрос для выбора тест-кейсов, которые будут синхронизированы, например,
automation = false. Оставьте пустым, чтобы синхронизировать все тест-кейсы. - Фильтр по запускам — AQL-запрос для выбора запусков, которые будут синхронизированы, например,
name ~= "Release". Оставьте пустым, чтобы синхронизировать все запуски. - Отключить экспорт — поставьте галочку, чтобы полностью отключить интеграцию Xray.
- Отключить создание тест-кейсов — поставьте галочку, чтобы отключить экспорт информации о новых тест-кейсах.
- Отключить синхронизацию запусков — поставьте галочку, чтобы отключить экспорт информации о запусках тестов.
- Фильтр по тест-кейсам — AQL-запрос для выбора тест-кейсов, которые будут синхронизированы, например,
Нажмите Отправить, чтобы применить изменения.
Важно
Синхронизация с TMS автоматически отключится, если учетные данные для доступа по API недействительны, были отозваны или имеют недостаточный уровень доступа. Чтобы возобновить синхронизацию, введите актуальные учетные данные с достаточным уровнем доступа.
Удаление интеграции
Вы можете удалить интеграцию с Xray двумя способами — на уровне всего инстанса ТестОпс или на уровне отдельного проекта.
Важно
Последствия удаления интеграции:
Удаление на уровне инстанса — все связи с тест-кейсами Xray, которые относятся к интеграции, будут удалены из сущностей ТестОпс. Это действие необратимо — восстановить удалённые ссылки будет невозможно.
Удаление на уровне проекта — все связи с тест-кейсами Xray, которые относятся к интеграции, будут сохранены в сущностях ТестОпс, но вы не сможете создавать новые связи для этого проекта. Дополнительно в проекте будет отключена синхронизация с Xray.
Чтобы удалить интеграцию на уровне инстанса ТестОпс, предварительно удалите ее из проектов, в которых она используется.
- Перейдите в раздел Администрирование → Интеграции.
- В списке настроенных интеграций найдите и откройте вашу интеграцию с Xray.
- На вкладке Конфигурация нажмите Удалить интеграцию.
- Нажмите Удалить.