Миграция из Zephyr Squad
Вы можете автоматически перенести вашу тестовую документацию из Zephyr Squad в Test IT.
Учитывайте форму поставки (облачная или серверная)
Ссылки на скачивание экспортера, параметры выгрузки тестов и команда для запуска экспортера для серверной (Server) и облачной (Cloud) поставок различаются.
В процессе миграции переносятся следующие данные:
- Тест-кейсы
- Шаги тестов
- Вложения тестов*
- Ссылки
*В облачной версии Zephyr Squad возможны проблемы с миграцией вложений из шагов тестов.
Миграция протестирована на версиях:
- Серверная поставка: Jira Server 9.0.0 - 9.14.1; Jira Data Center 9.0.0 - 9.14.1
- Облачная поставка: Zephyr Squad 1.3.25-AC Cloud
Миграция тестовой документации включает в себя:
- Подготовку (загрузку экспортера и импортера Test IT)
- Выгрузку тестов из Zephyr Squad
- Загрузку тестов в Test IT c помощью импортера
Подробнее: Миграция в Test IT: возможности и процесс.
Подготовка
- Скачайте экспортер на странице GitHub Test IT. Выберите файл для вашей версии поставки:
- Для серверной поставки — с названием ZephyrSquadServerExporter
- Для облачной поставки — с названием ZephyrSquadExporter
Выберите экспортер для своей операционной системы. Сохраните экспортер в отдельной папке.
- Для серверной поставки — с названием ZephyrSquadServerExporter
- Скачайте импортер на странице GitHub Test IT. Выберите импортер для своей операционной системы и версии Test IT. Если импортер у вас уже есть (например, вы производили миграцию из других TMS), пропустите этот шаг. Сохраните импортер в отдельной папке.
Выгрузка тестов из Zephyr Squad
Используйте экспортер для своей операционной системы
Для различных операционных систем требуется свой экспортер. Выберите инструкцию по миграции тестов для своей системы в соответствующей вкладке.
- Создайте конфигурационный файл
zephyr.config.jsonи сохраните его в папке с экспортером. Настройте соединение в файлеzephyr.config.json. Пример настройки соединения в конфигурационном файле:- Для серверной поставки вы можете настроить соединение с помощью токена или с помощью логина и пароля.
- Пример настройки соединения в конфигурационном файле с помощью токена:
{ "resultPath": "/Users/user01/Documents/importer", "zephyr": { "url": "Link to your JIRA instance", "token": "MDc2MjIxNjVzNjg40OkJCA43J4AfsIRBXomRs8bKw81+D", "projectKey": "PK" } } - Пример настройки соединения в конфигурационном файле с помощью логина и пароля:Значения параметров:
{ "resultPath": "/Users/user01/Documents/importer", "zephyr": { "url": "Link to your JIRA instance", "login": "user", "password": "pass", "projectKey": "PK" } }resultPath— директория папки, в которой будут сохранены файлы с тестовой документациейzephyr.url— URL сервера Zephyr с названием организацииzephyr.token— ключ (токен) доступа на сервер Jirazephyr.login— ваш логин для входа на сервер Jirazephyr.password— ваш пароль для входа на сервер Jirazephyr.projectKey— ключ к проекту на сервер Jira
- Пример настройки соединения в конфигурационном файле с помощью токена:
- Для облачной поставки:Значения параметров:
{ "resultPath": "/Users/user01/Documents/importer", "zephyr": { "url": "https://prod-api.zephyr4jiracloud.com/", "accessKey": "MmEwMjd4OWYtNGMxMC0zYjhkLWExMmUtNTZjYmY0OTE0MGExIDcxMjAyMCUzQTNjOWYwMzJkLWVlZWEtNGRjMC04NjIyLTliMGY2ODQzZWMzNCBVU0VSX0RFRkFVTFRfTkFNRQ", "secretKey": "GkxCBle-7ib1mBOf9Oeiy8HZjJDw4ESnTZzYh3rz1Og", "accountId": "712021:3c9f032d-eeea-4dc0-8622-9b0f6843ec34", "projectId": 10000, "projectName": "ProjectName" } }resultPath— директория папки, в которой будут сохранены файлы с тестовой документациейzephyr.url— URL сервера Zephyr с названием организацииzephyr.accessKey— ключ доступа на сервер Zephyrzephyr.secretKey— секретный ключ доступа на сервер Zephyrzephyr.accountId— идентификатор (ID) аккаунта для доступа на сервер Zephyrzephyr.projectId— идентификатор проекта на сервере Zephyrzephyr.projectName— название проекта на сервере Zephyr
- Для серверной поставки вы можете настроить соединение с помощью токена или с помощью логина и пароля.
- Выдайте разрешение на запуск экспортера на вашем устройстве Mac или Linux.
- Запустите экспортер с помощью команды:
- Для серверной поставки:
sudo chmod +x .\ZephyrSquadServerExporter{OS}-{version_number} .\ZephyrSquadServerExporter{OS}-{version_number} - Для облачной поставки:
sudo chmod +x ./ZephyrSquadExporter{OS}-{version_number} ./ZephyrSquadExporter{OS}-{version_number}
ZephyrSquadServerExporter{OS}-{version_number}(для серверной версии) илиZephyrSquadExporter{OS}-{version_number}(для облачной версии) укажите имя файла экспортера, скачанного с Git. Как правило, имя файла содержит название операционной системы и версию экспортера.
Дождитесь окончания экспорта. - Для серверной поставки:
- По окончании экспорта убедитесь, что экспортируемые файлы находятся в директории, указанной в параметре
resultPath. В случае ошибки миграции устраните проблему самостоятельно или свяжитесь с технической поддержкой (support@yoonion.ru).
- Создайте конфигурационный файл
zephyr.config.jsonи сохраните его в папке с экспортером. Настройте соединение в файлеzephyr.config.json. Пример настройки соединения в конфигурационном файле:- Для серверной поставки вы можете настроить соединение с помощью токена или с помощью логина и пароля.
- Пример настройки соединения в конфигурационном файле с помощью токена:
{ "resultPath": "/Users/user01/Documents/importer", "zephyr": { "url": "Link to your JIRA instance", "token": "MDc2MjIxNjVzNjg40OkJCA43J4AfsIRBXomRs8bKw81+D", "projectKey": "PK" } } - Пример настройки соединения в конфигурационном файле с помощью логина и пароля:Значения параметров:
{ "resultPath": "/Users/user01/Documents/importer", "zephyr": { "url": "Link to your JIRA instance", "login": "user", "password": "pass", "projectKey": "PK" } }resultPath— директория папки, в которой будут сохранены файлы с тестовой документациейzephyr.url— URL сервера Zephyr с названием организацииzephyr.token— ключ (токен) доступа на сервер Jirazephyr.login— ваш логин для входа на сервер Jirazephyr.password— ваш пароль для входа на сервер Jirazephyr.projectKey— ключ к проекту на сервер Jira
- Пример настройки соединения в конфигурационном файле с помощью токена:
- Для облачной поставки:Значения параметров:
{ "resultPath": "/Users/user01/Documents/importer", "zephyr": { "url": "https://prod-api.zephyr4jiracloud.com/", "accessKey": "MmEwMjd4OWYtNGMxMC0zYjhkLWExMmUtNTZjYmY0OTE0MGExIDcxMjAyMCUzQTNjOWYwMzJkLWVlZWEtNGRjMC04NjIyLTliMGY2ODQzZWMzNCBVU0VSX0RFRkFVTFRfTkFNRQ", "secretKey": "GkxCBle-7ib1mBOf9Oeiy8HZjJDw4ESnTZzYh3rz1Og", "accountId": "712021:3c9f032d-eeea-4dc0-8622-9b0f6843ec34", "projectId": 10000, "projectName": "ProjectName" } }resultPath— директория папки, в которой будут сохранены файлы с тестовой документациейzephyr.url— URL сервера Zephyr с названием организацииzephyr.accessKey— ключ доступа на сервер Zephyrzephyr.secretKey— секретный ключ доступа на сервер Zephyrzephyr.accountId— идентификатор (ID) аккаунта для доступа на сервер Zephyrzephyr.projectId— идентификатор проекта на сервере Zephyrzephyr.projectName— название проекта на сервере Zephyr
- Для серверной поставки вы можете настроить соединение с помощью токена или с помощью логина и пароля.
- Запустите
.exe-файл экспортера. - По окончании экспорта убедитесь, что экспортируемые файлы находятся в директории, указанной в параметре
resultPath. В случае ошибки миграции устраните проблему самостоятельно или свяжитесь с технической поддержкой (support@yoonion.ru).
Загрузка тестов в Test IT
- Чтобы загрузить тестовые данные в Test IT с помощью импортера, воспользуйтесь инструкцией.