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

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

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

Ссылки на скачивание экспортера, параметры выгрузки тестов и команда для запуска экспортера для серверной (Data Center) и облачной (Cloud) поставок различаются.

В процессе миграции переносятся следующие данные:

  • Тест-кейсы
  • Шаги тестов
  • Вложения тестов*
  • Секции
  • Ссылки
  • Архивные тест-кейсы

*В облачной версии Zephyr Scale возможны проблемы с миграцией вложений тестов.

Миграция протестирована на версиях:

  • Серверная поставка: Zephyr Scale Data Center 7.0.1
  • Облачная поставка: Zephyr Scale 1.0.62-AC Cloud

Миграция тестовой документации включает в себя:

Подробнее: Миграция в Test IT: возможности и процесс.

Подготовка

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

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

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

Для различных операционных систем требуется свой экспортер. В этой инструкции содержатся шаги для различных систем (шаги 2—3)

Серверная версия
  1. Создайте конфигурационный файл zephyr.config.json и сохраните его в папке с экспортером. Настройте соединение в файле zephyr.config.json.
    Вы можете настроить соединение с помощью токена или с помощью логина и пароля. Также доступна возможность частичного экспорта, позволяющая пернести крупные проекты в несколько итераций.
    • Пример настройки соединения в конфигурационном файле с помощью токена:
      {
  "resultPath": "/Users/user01/Documents/importer",
  "zephyr": {
    "url": "Link to your JIRA instance",
    "exportArchived": true,
    "confluence": "URL of your Confluence server",
    "token": "MDc2MjIxNjVzNjg40OkJCA43J4AfsIRBXomRs8bKw81+D",
    "confluenceToken": "MDc2MjIxNjVzNjg40OkJCA43J4AfsIRBXomRs8bKw81+D",
    "projectKey": "PK"         
    }
 }
    • Пример настройки соединения в конфигурационном файле с помощью логина и пароля:
      {
  "resultPath": "/Users/user01/Documents/importer",
  "zephyr": {
    "url": "Link to your JIRA instance",
    "exportArchived": true,
    "confluence": "https://confluence.instance.ru",
    "login": "user",
    "password": "pass",
    "confluenceLogin": "User",
    "confluencePassword": "pass",
    "projectKey": "PK"         
    }
 }
      Значения параметров:
      • resultPath — директория папки, в которой будут сохранены файлы с тестовой документацией
      • zephyr.url — URL сервера Zephyr с названием организации
      • zephyr.exportArchived — экспорт архивных тест-кейсов
      • zephyr.confluence — URL сервера Confluencе.
      • zephyr.token — ключ (токен) доступа на сервер Jira
      • zephyr.login — ваш логин для входа на сервер Jira
      • zephyr.password — ваш пароль для входа на сервер Jira
      • zephyr.confluenceToken — токен доступа к API Confluence
      • zephyr.confluenceLogin — логин сервера Confluence
      • zephyr.confluencePassword — пароль сервера Confluence
      • zephyr.projectKey — ключ проекта на сервере Zephyr
        Параметры zephyr.confluence, zephyr.confluenceToken, zephyr.confluenceLoginи zephyr.confluencePassword используются, когда необходимо перенести ссылки из Confluence. Для частичного экспорта используются дополнительные параметры.
  2. Если вы используете macOS или Linux: Выдайте разрешение на запуск экспортера на вашем устройстве Mac или Linux.
  3. Запустите экспортер:
    • Для Windows: Запустите .exe-файл экспортера и дождитесь окончания экспорта.
    • Для macOS или Linux: Используйте команду:
      sudo chmod +x ./ZephyrScaleServerExporter{OS}-{version_number}
./ZephyrScaleServerExporter{OS}-{version_number}
      В команде вместо ZephyrScaleServerExporter{OS}-{version_number} укажите имя файла экспортера, скачанного с Git. Как правило, имя файла содержит название операционной системы и версию экспортера.
      Дождитесь окончания экспорта.
  4. По окончании экспорта убедитесь, что экспортируемые файлы находятся в директории, указанной в параметре resultPath. В случае ошибки миграции устраните проблему самостоятельно или свяжитесь с технической поддержкой (support@yoonion.ru).

Частичный экспорт и объединение частей проекта

Функции частичного экспорта (Partial export) и объединения частей проекта (Merge functionality for batches) опциональны и используются для миграции крупных проектов по частям, чтобы перенести проект в несколько итераций и избежать простоев в работе. Эти функции применяются последовательно: проект экспортируется по частям, затем эти части объединяются.

  1. Для частичного экспорта добавьте в конфигурационный файл блок:

    {
  "zephyr": {
    "partial": true,
    "partialFolderName": "batch",
    "count": 1000
  }
}

    Таким способом можно перенести тест-кейсы проекта в несколько итераций. Сохраненные тест-кейсы выгружаются во временный файл $"{config.Value.Zephyr.ProjectKey}-batch.txt", расположенном в папке с файлом .exe, который используется как фильтр при очередном запуске.

  2. Когда все части проекта, выгружены, объедините проект, добавив в конфигурационный файл блок:

    {
  "zephyr": {
    "merge": true
  }
}

    Объединение частей проекта происходит с учетом значений resultPathи zephyr.projectKey.

    Значения параметров:

    • partial — активация частичной выгрузки
    • partialFolderName — название папки, куда будет перенесена часть проекта
    • count — количество тест-кейсов в переносимой части проекта (batch)
    • merge — объединение частей проекта

Пример

Для переноса проекта, содержащего 50000 тест-кейсов, указывается count = 10000. Затем производится 5 итераций без изменения параметров. Тест-кейсы выгружаются в директорию resultPath/ProjectKey/batch_1, batch_2, batch_x.

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

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