Интеграция с TestRail

Интеграция с TestRail — это односторонняя интеграция (только экспорт), которая регулярно отправляет данные о тест-кейсах и запусках в указанный инстанс TestRail. Интеграция поддерживает Allure Query Language для выбора данных, подлежащих экспорту, т.е. вы можете копировать только тест-кейсы с определенным тегом.

Важно

ТестОпс поддерживает экспорт только в проекты TestRail, которые используют несколько тестовых наборов. См. Проекты и их типы в документации TestRail, чтобы изменить тип вашего проекта, если это необходимо.

1. Включение базовой синхронизации

1.1. Включение API в TestRail

1. В TestRail перейдите в Administration → Site Settings → API.
2. Поставьте галочки Enable API и Enable session authentication for API.
3. Нажмите Save Settings.

1.2. Создание API-ключа в TestRail

1. В TestRail нажмите на ваше имя в правом верхнем углу и выберите My Settings.

2. Перейдите на вкладку API Keys.

3. Нажмите Add Key.

4. В появившемся окне введите название, которое поможет вам распознать API-ключ, например, «Ключ для ТестОпс».

5. Нажмите Generate Key.

   Созданный ключ отобразится в окне. Выберите и скопируйте его.

   Этот ключ понадобится вам на одном из следующих шагов.

6. Нажмите Add Key, затем Save Settings, чтобы сохранить созданный ключ.

1.3. Добавление сервера TestRail в ТестОпс

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

2. Перейдите в раздел Администрирование → Интеграции.

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

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

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

   • Название — название, которое поможет вам распознать сервер TestRail, например, TestRail production.
   • Endpoint — URL-адрес сервера TestRail, например, https://example.testrail.io/.
   • TestRail version — 6.7 or later.

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

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

1.4. Добавление интеграции TestRail в проект ТестОпс

1. Откройте ваш проект в ТестОпс.

2. Перейдите в раздел Настройки → Интеграции.

3. В разделе Доступные интеграции найдите интеграцию TestRail и нажмите Добавить интеграцию рядом с ней.

4. В появившемся окне заполните поля:

   • Username — адрес электронной почты, который вы используете для входа в TestRail.
   • API key — API-ключ, который вы получили на шаге 1.2.
   Совет

   Проверьте правильность учетных данных

   Нажмите Test connection. Через несколько секунд должно появиться сообщение «Соединение установлено».

5. Нажмите Добавить интеграцию, чтобы сохранить настройки и закрыть окно.

1.5. Получение необходимых данных из проекта TestRail

Все тест-кейсы, экспортированные из ТестОпс, будут размещены в одном разделе одного тестового набора в TestRail. На этом шаге вы узнаете идентификаторы тестового набора и раздела, которые вам нужно будет указать в ТестОпс для корректной работы интеграции.

1. В панели управления TestRail нажмите на проект, в который вы хотите включить экспорт.

   Запомните название проекта. Это название понадобится на следующем шаге для поля Project.

   

2. Перейдите на вкладку Test Suites & Cases.

   Нажмите на тестовый набор, в который вы хотите включить экспорт. При необходимости вы можете создать новый тестовый набор.

   Обратите внимание на идентификатор рядом с заголовком. Это Suite ID, который вам понадобится на следующем шаге.

   

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

   Обратите внимание на параметр group_id, который появится в адресной строке веб-браузера. Это Section ID, который вам понадобится на следующем шаге.

   

1.6. Включение синхронизации

1. Откройте ваш проект в ТестОпс.

2. Перейдите в раздел Настройки → Интеграции.

3. Нажмите на интеграцию, которую вы добавили на шаге 1.4.

4. На вкладке Синхронизация с TMS нажмите Создать.

5. Укажите Project, Suite ID и Section ID, которые вы получили на предыдущем шаге. Используйте только числовые части идентификаторов, например, «S29» должно быть указано как «29».

6. Укажите, какие данные ТестОпс должен экспортировать в TestRail:

   • Фильтр по тест-кейсам — AQL-запрос для выбора тест-кейсов, которые будут синхронизированы, например, automation = false. Оставьте пустым, чтобы синхронизировать все тест-кейсы.
   • Фильтр по запускам — AQL-запрос для выбора запусков, которые будут синхронизированы, например, name ~= "Release". Оставьте пустым, чтобы синхронизировать все запуски.
   • Отключить экспорт — поставьте галочку, чтобы полностью отключить интеграцию TestRail.
   • Отключить создание тест-кейсов — поставьте галочку, чтобы отключить экспорт информации о новых тест-кейсах.
   • Отключить синхронизацию запусков — поставьте галочку, чтобы отключить экспорт информации о запусках тестов.

7. Нажмите Отправить, чтобы применить изменения.

Важно

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

2. Настройка сопоставления полей

Некоторые из экспортируемых полей тест-кейсов не стандартизированы в TestRail, а именно:

• описание,
• предусловие,
• ожидаемый результат,
• сценарий.

Вы можете создать поля в TestRail и указать их названия в ТестОпс.

2.1. Создание пользовательских полей в TestRail

1. В TestRail перейдите в Administration → Customizations.

   Должен появиться список Case Fields.

2. Для каждого поля, которое вы хотите экспортировать в TestRail:

   1. Нажмите Add Field.

   2. В появившейся форме заполните поля:

      • Label — метка, под которой поле должно отображаться в деталях тест-кейса в TestRail. Например, “Description”, “Precondition”, “Expected” и т. д.
      • System Name — уникальный идентификатор поля. Он будет использоваться ТестОпс при экспорте поля. Например, “description”, “preconds”, “expected” и т. д.
      • Type — Steps для поля, которое будет хранить сценарий теста как отдельные шаги. Text для всех остальных полей. Если вы предпочитаете экспортировать сценарий в виде простого текста, выберите Text для всех полей.

   3. В нижней части формы нажмите Add Projects & Options.

      В появившемся окне перейдите на вкладку Selected Projects, выберите These options apply to the following projects only и поставьте галочку для вашего проекта. Затем нажмите OK, чтобы закрыть окно.

   4. Нажмите Add Field, чтобы закрыть форму и применить изменения.

2.2. Настройка сопоставления в ТестОпс

1. Откройте ваш проект в ТестОпс.
2. Перейдите в раздел Настройки → Интеграции.
3. Нажмите на интеграцию, которую вы добавили на шаге 1.4.
4. На вкладке Синхронизация с TMS нажмите Создать.
5. Для каждого поля, которое вы хотите экспортировать в TestRail, введите префикс custom_, за которым следует идентификатор, который вы указали как System Name в TestRail на шаге 2.1.
6. Нажмите Отправить, чтобы применить изменения.

3. Настройка сопоставления статусов

И ТестОпс, и TestRail имеют настраиваемые системы статусов тестов. При настройке синхронизации рекомендуется создать в TestRail тот же набор статусов, который у вас есть в воркфлоу ТестОпс, а затем сопоставить их друг с другом.

3.1. Получение статусов из ТестОпс

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

2. Перейдите в раздел Администрирование → Статусы.

3. Запомните идентификатор каждого статуса. Эти идентификаторы понадобятся вам на шаге 3.3.

   

3.2. Добавление пользовательских статусов в TestRail

1. В TestRail перейдите в Administration → Customizations.

   Должен появиться список Case Fields.

2. Нажмите Add Field, чтобы создать новое поле, которое будет хранить статус тест-кейса. В качестве альтернативы вы можете использовать существующее поле типа Dropdown.

3. В появившейся форме заполните поля:

   • Label — метка, под которой поле должно отображаться в деталях тест-кейса в TestRail, например "Status".
   • System Name — уникальный идентификатор поля, например, "status". Он будет использоваться ТестОпс при экспорте поля.
   • Type — Dropdown.

4. В нижней части формы нажмите Add Projects & Options.

   Должно появиться окно с вкладками Options и Selected Projects.

5. На вкладке Options введите идентификаторы и названия статусов, которые вы хотите добавить в TestRail. Идентификаторы должны быть положительными числами и уникальными. Каждая строка должна содержать один идентификатор и одно название, разделенные запятой и пробелом.

   Запомните идентификатор каждого статуса. Эти идентификаторы понадобятся вам на шаге 3.3.

   

6. На вкладке Selected Projects выберите These options apply to the following projects only и поставьте галочку для вашего проекта.

7. Нажмите OK, чтобы закрыть окно. Затем нажмите Add Field, чтобы закрыть форму и применить изменения.

3.3. Настройка сопоставления

1. Откройте ваш проект в ТестОпс.

2. Перейдите в раздел Настройки → Интеграции.

3. Нажмите на интеграцию, которую вы добавили на шаге 1.4.

4. На вкладке Синхронизация с TMS нажмите Создать.

5. В разделе Status Mapping заполните поля:

   • Field name — системное имя поля, которое вы настроили в TestRail на шаге 3.2.
   • Default value — введите префикс custom_, за которым следует идентификатор статуса в TestRail. Это значение будет использоваться, когда нет другого применимого сопоставления.

6. Для каждого статуса, который у вас есть в воркфлоу ТестОпс, нажмите Добавить и заполните поля:

   • Source ID — идентификатор статуса в ТестОпс, который вы нашли на шаге 3.1.
   • Target ID — идентификатор статуса в TestRail, который вы указали на шаге 3.2.

7. Нажмите Отправить, чтобы применить изменения.