Перейти к основному содержимому

Интеграция с Zephyr Scale

Интеграция с Zephyr Scale позволяет автоматически экспортировать тест-кейсы и запуски из ТестОпс в Zephyr Scale. Вы можете использовать Allure Query Language, чтобы выбрать необходимый набор данных для экспорта.

Чтобы включить эту интеграцию, вам нужно:

  1. Добавить интеграцию Zephyr Scale в панели администрирования ТестОпс.
  2. Сгенерировать два API токена в настройках Jira.
  3. Включить интеграцию в настройках проекта ТестОпс, используя сгенерированные API токены.
  4. Создать одно или несколько правил экспорта в настройках интеграции.

Добавление новой интеграции​

ТестОпс предоставляет два отдельных типа интеграции для Zephyr Scale:

  • Zephyr Scale для Jira Data Center (самостоятельно размещаемая версия Jira)
  • Zephyr Scale Cloud для Jira Cloud

  1. Войдите в ТестОпс, используя учетную запись администратора.

  2. Нажмите на свой аватар и перейдите в Administration → Integrations.

  3. Нажмите Add integration в правом верхнем углу страницы.

  4. В появившемся окне выберите Zephyr Scale.

  5. Заполните поля:

    • Name — имя, которое поможет вам позже распознать эту интеграцию.
    • Endpoint — URL вашего экземпляра Jira Data Center.
    • Linked issue tracker — если вы хотите сохранить информацию о связанных с тест-кейсами задачах Jira при их экспорте в Zephyr Scale, выберите здесь вашу интеграцию Jira.

  6. Если ваш экземпляр Jira Data Center использует самоподписанный SSL сертификат, установите флажок Disable certificate validation.

  7. Нажмите Add integration.

Получение API токенов​

Чтобы ТестОпс мог создавать тест-кейсы в Zephyr Scale, вам нужно сгенерировать два API токена: один для Jira и один для Zephyr Scale. Кроме того, запомните имя пользователя Jira (адрес электронной почты), под которым вы вошли, оно будет использоваться позже.

API токен Jira​

  1. Перейдите в Account settings → Security → API tokens (или нажмите здесь).
  2. Нажмите Create API token.
  3. Введите метку, чтобы позже распознать этот токен, и нажмите Create.
  4. Нажмите Copy to clipboard и сохраните токен в безопасном месте.

Токен доступа Zephyr Scale​

  1. Нажмите на значок профиля Jira и выберите Zephyr Scale API Access Tokens (или перейдите по адресу https://<yourcompany>.atlassian.net/plugins/servlet/ac/com.kanoah.test-manager/api-access-tokens).
  2. Нажмите Create access token.
  3. Нажмите Copy и сохраните токен в безопасном месте.

Включение интеграции для проекта​

  1. Перейдите в настройки проекта.
  2. Выберите Integrations.
  3. Найдите интеграцию Zephyr Scale и нажмите Add integration.
  4. Введите имя пользователя учетной записи, которая использовалась для генерации API токенов.
  5. Введите API токен Jira и токен доступа Zephyr Scale, которые вы ранее сгенерировали.
  6. Нажмите Add integration.

Если вы хотите связать результаты тестов с тест-кейсами Zephyr Scale, указав идентификаторы Zephyr Scale в вашем коде, вам нужно добавить сопоставление ключей тестов в настройках вашего проекта:

  1. Перейдите в настройки проекта.
  2. Выберите Test Key.
  3. Введите имя метки, значение которой будет использоваться как идентификатор тест-кейса Zephyr Scale.
  4. Выберите интеграцию Zephyr Scale как систему управления тестами.
  5. Нажмите Submit.

Создание правила экспорта​

  1. Перейдите в настройки проекта.
  2. Выберите Integrations.
  3. Нажмите на ранее добавленную интеграцию Zephyr Scale.
  4. Нажмите на вкладку TMS Sync вверху.

Будет показан список правил экспорта, где вы можете редактировать и удалять ранее созданные правила.

Чтобы создать новое правило экспорта, нажмите Create.

В появившемся окне вы сможете выбрать проект Zephyr Scale, в который нужно экспортировать данные, и отфильтровать тест-кейсы вашего проекта ТестОпс, используя Allure Query Language, чтобы ограничить набор тест-кейсов и запусков, которые будут экспортированы:

  1. В поле Проект выберите проект Zephyr Scale, в который вы хотите экспортировать данные.
  2. В поле Test Case AQL введите AQL-запрос для выбора тест-кейсов, которые нужно экспортировать. Если оставить это поле пустым, будут экспортированы все тест-кейсы.
  3. При необходимости в поле Launches AQL введите AQL-запрос, чтобы ограничить набор запусков, которые будут экспортированы для выбранных тест-кейсов. Вы также можете полностью отключить экспорт запусков, установив флажок Disable Launches sync.

Дополнительно вы можете указать настройки маппинга для корректного сопоставления статусов тест-кейсов между ТестОпс и Zephyr Scale (подробности см. в разделе Сопоставление статусов тест-кейсов).

Когда вы закончите, нажмите кнопку Submit.

После создания правила и успешного экспорта тест-кейсов вы можете отключить экспорт новых тест-кейсов, соответствующих этому правилу, установив флажок Disable Test Case create. Если этот флажок установлен, будут экспортироваться только изменения и запуски ранее экспортированных тест-кейсов.

Чтобы отключить правило экспорта, не удаляя его, установите флажок Disable export.

Сопоставление статусов тест-кейсов​

Поскольку ТестОпс и Zephyr Scale могут использовать разные статусы для тест-кейсов, вы можете создать правила маппинга в настройках интеграции ТестОпс для их соответствия.

Каждое правило сопоставления связывает два значения: статус в ТестОпс (Source) и статус в Zephyr Scale (Target). Например, вы можете создать правило, которое связывает статус Outdated в ТестОпс со статусом Deprecated в Zephyr Scale.

Вы также можете установить значение по умолчанию, которое будет использоваться, если статус отсутствует в правилах сопоставления. Если вы укажете исходный статус, но не укажете целевой статус, статус будет удален при экспорте.

Можно добавить несколько строк, каждая из которых содержит &quot;Source ID&quot; и &quot;Target System Name&quot;.

Один нюанс заключается в том, что вам нужно указать идентификаторы статусов ТестОпс вместо их имен. Чтобы получить идентификаторы, войдите в ТестОпс как администратор, нажмите на свой аватар и перейдите в Administration → Status. Вы можете найти идентификатор слева от статуса.

Статусы и их идентификаторы перечислены в разделе «Статусы».