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