Миграция из Zephyr Squad

Вы можете автоматически перенести вашу тестовую документацию из Zephyr Squad в Test IT. Вам потребуется учетная запись администратора Zephyr Squad для получения API-токена.

Учитывайте форму поставки (облачная или серверная)

Ссылки на скачивание экспортера, параметры выгрузки тестов и команда для запуска экспортера для серверной (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: возможности и процесс.

Подготовка

  1. Скачайте экспортер на странице GitHub Test IT. Выберите файл для вашей версии поставки:
    • Для серверной поставки — с названием ZephyrSquadServerExporter
    • Для облачной поставки — с названием ZephyrSquadExporter
      Выберите экспортер для своей операционной системы. Сохраните экспортер в отдельной папке.
  2. Скачайте импортер на странице GitHub Test IT. Если импортер у вас уже есть (например, вы производили миграцию из других TMS), пропустите этот шаг. Сохраните импортер в отдельной папке.

Выгрузка тестов из Zephyr Squad

Используйте экспортер для своей операционной системы

Для различных операционных систем требуется свой экспортер. Выберите инструкцию по миграции тестов для своей системы в соответствующей вкладке.

MacOs & Linux
  1. Создайте конфигурационный файл 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 — ключ (токен) доступа на сервер Jira
        • zephyr.login — ваш логин для входа на сервер Jira
        • zephyr.password — ваш пароль для входа на сервер Jira
        • zephyr.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 — ключ доступа на сервер Zephyr
      • zephyr.secretKey — секретный ключ доступа на сервер Zephyr
      • zephyr.accountId — идентификатор (ID) аккаунта для доступа на сервер Zephyr
      • zephyr.projectId — идентификатор проекта на сервере Zephyr
      • zephyr.projectName — название проекта на сервере Zephyr
  2. Выдайте разрешение на запуск экспортера на вашем устройстве Mac или Linux.
  3. Запустите экспортер с помощью команды:
    • Для серверной поставки:
      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. Как правило, имя файла содержит название операционной системы и версию экспортера.
    Дождитесь окончания экспорта.
  4. По окончании экспорта убедитесь, что экспортируемые файлы находятся в директории, указанной в параметре resultPath. В случае ошибки миграции устраните проблему самостоятельно или свяжитесь с технической поддержкой (support@yoonion.ru).

Загрузка тестов в Test IT

  • Чтобы загрузить тестовые данные в Test IT с помощью импортера, воспользуйтесь инструкцией.
Обновлено: