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

Интеграция с 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. Перейдите в раздел Администрирование → Интеграции.

  3. Нажмите + Добавить интеграцию в правом верхнем углу страницы.

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

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

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

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

  7. Нажмите Добавить интеграцию.

Получение 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. Перейдите в раздел Настройки → Интеграции.
  3. Найдите интеграцию Zephyr Scale и нажмите Добавить интеграцию.
  4. Введите имя пользователя учетной записи, которая использовалась для создания API-токенов.
  5. Введите API-токен Jira и токен доступа Zephyr Scale, которые вы создали ранее.
  6. Нажмите Добавить интеграцию.

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

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

Создание конфигураций экспорта​

  1. Откройте ваш проект в ТестОпс.
  2. Перейдите в раздел Настройки → Интеграции.
  3. Нажмите на ранее добавленную интеграцию Zephyr Scale.
  4. Нажмите на вкладку Синхронизация с TMS вверху.

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

Чтобы создать новую конфигурацию экспорта, нажмите Создать.

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

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

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

Нажмите Отправить, чтобы завершить создание конфигурации.

Важно

Синхронизация с TMS автоматически отключится, если учетные данные для подключения по API недействительны или были отозваны. Чтобы возобновить синхронизацию, введите актуальные учетные данные.

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

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

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

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

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

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

Вы можете создать несколько маппингов.

Обратите внимание, что вам нужно указать идентификаторы статусов ТестОпс, а не их названия.

Чтобы найти идентификаторы:

  1. Войдите в ТестОпс как администратор.
  2. Перейдите в раздел Администрирование → Статусы. Вы можете найти идентификатор слева от статуса.

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