Миграция из TestRail ​

Миграция из TestRail переносит проект TestRail в ComplexQA через API TestRail. Фоновый импорт создаёт новый проект ComplexQA и может включать тестовые прогоны и их результаты.

Роль: администратор команды. Остальные роли видят сообщение об отказе в доступе.

Перед началом ​

1. Войдите в приложение на поддомене своей команды.
2. Убедитесь, что ваша роль в команде - Администратор.
3. В TestRail откройте Admin > Site Settings > API.
4. Включите API и сохраните настройки.
5. Откройте My Settings > API Keys.
6. Создайте ключ API и нажмите Save Settings.

Импорт всегда создаёт новый проект ComplexQA с именем проекта TestRail. Подготавливать пустой целевой проект не нужно. Если у проекта TestRail нет объявления, описание проекта в ComplexQA остаётся пустым.

Что импортируется ​

Комментарий результата пишется в заметки результата. Defects и Version - текстовые кастомные свойства результата. Elapsed - целое число в секундах на том же результате.

Кастомное свойство создаётся один раз на команду и видно во всех проектах команды для этого типа элемента. Значение лежит на карточке тест-кейса или на результате внутри прогона.

Не переносятся: вехи, поля типа «пользователь», назначенные люди, сценарии BDD, AI Automation TestRail, вложения, общие шаги и планы. Свои шаги и предусловия TestRail остаются обычными полями тест-кейса, а не кастомными свойствами.

Как запустить миграцию ​

1. Откройте /migrations/ru на поддомене своей команды.
2. Выберите Новый импорт TestRail.
3. Введите Базовый URL TestRail как адрес сервера без /index.php и /dashboard.
4. Введите адрес электронной почты аккаунта TestRail.
5. Введите значение ключа API TestRail или пароль аккаунта.
6. Нажмите Подключиться.
7. Выберите проект TestRail.
8. Опционально: включите Импортировать тестовые прогоны и результаты.
9. Нажмите Начать импорт.

ComplexQA создаёт задание и новый проект. Если активное задание уже импортирует тот же проект TestRail, ComplexQA откроет его вместо создания дубликата.

Задание остаётся в статусе PENDING, пока фоновый обработчик не возьмёт очередь. Страница команды обработчик не запускает. Если статус долго не меняется, обработку запускают в платформенной админке: пункт Управление сервером, блок Утилиты, команда migrations:process. Один запуск обрабатывает часть очереди. Пока статус не COMPLETED, запуск повторяют. Если на сервере включено расписание, части идут сами.

Как отслеживать задание ​

На странице импорта:

• Текст Куда что переносится - краткая карта полей.
• Статус: PENDING, RUNNING, PAUSED, COMPLETED, FAILED или CANCELLED, и текущий этап.
• Таблица прогресса: завершено, пропущено и ошибки. Столбец Куда открывает список тест-кейсов, список тестовых прогонов или таблицу свойств ниже. У результатов, комментариев, Defects, Version и Elapsed ссылки нет: их смотрят внутри прогона.
• Таблица Пользовательские свойства этого импорта. Ссылка открывает карточку свойства. Значения смотрите на тест-кейсе или внутри прогона.
• Последние сбои отдельных элементов.

Используйте Приостановить и Возобновить для управления обработкой. Нажмите Отменить, чтобы остановить задание и удалить сохранённые учётные данные API. Нажмите Обновить, чтобы загрузить актуальные счётчики.

Вернуться к заданию можно из списка миграций.

Когда статус изменится на COMPLETED, откройте Проекты и проверьте новый проект. Результаты откройте из карточки тестового прогона.

Ограничения ​

• Шаги TestRail остаются текстовыми. Структурированные поля step_element и step_element_action остаются пустыми.
• Вложения, общие шаги, планы и объекты из списка «не переносятся» выше не импортируются.
• Одно задание импортирует один проект TestRail в один новый проект ComplexQA.
• Возобновлённое задание пропускает элементы, уже записанные в целевой проект. Уже перенесённые тест-кейсы при повторном запуске не обновляются.
• Большой проект обрабатывается частями, а не за один запуск.
• Каталог кастомных свойств общий на команду. Новые слоты импорта появляются и в других проектах этой команды, в том числе пустыми.

Как устранить ответ HTTP 401 ​

Ответ HTTP 401 означает, что TestRail отклонил учётные данные.

1. Убедитесь, что API включён в разделе Admin > Site Settings > API.
2. Убедитесь, что после создания ключа API вы нажали Save Settings.
3. Введите адрес электронной почты аккаунта и значение ключа API, а не имя ключа.
4. Введите пароль аккаунта в то же поле, чтобы проверить возможность входа.
5. Убедитесь, что Базовый URL содержит только адрес сервера TestRail.

Не передавайте ключ API в чате или обращениях в поддержку. Отзовите раскрытый ключ и создайте новый.