Инструкция

Миграция из TestRail

Миграция из 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Примечание
ПроектНовый проектСоздаётся при запуске задания
Набор тестовКорневой набор тестовПо одному корневому набору для каждого набора 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, RUNNING, PAUSED, COMPLETED, FAILED или CANCELLED.
  • Текущий этап.
  • Счётчики завершённых, пропущенных и неудачных операций по типам элементов.
  • Последние сбои отдельных элементов.

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

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

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

Ограничения

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

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

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

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

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

Версия 1.1.1 · Последнее изменение 2026-09-11

Страница не помогла?