Миграция из TestRail

Импорт проекта TestRail в Complex QA через API TestRail. Импорт идёт в фоне, создаёт новый проект Complex QA; задачу можно поставить на паузу, продолжить или отменить.

Кто может: только администратор команды текущего workspace. Остальным участникам показывается отказ в доступе.

Где: /migrations/{locale} на поддомене команды (например /migrations/ru или /migrations/en).

---

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

1. Вы вошли на поддомене команды (не на служебном service-хосте).
2. В этой команде у вас роль Администратор.
3. В TestRail:
   • Admin → Site Settings → API - включите API и сохраните настройки.
   • My Settings → API Keys - создайте ключ и нажмите Save Settings (иначе ключ не заработает).
4. Импорт всегда создаёт новый проект Complex QA с именем проекта TestRail.

---

Что переносится

TestRail	Complex QA	Примечание
Project	Новый проект	Создаётся в начале задачи
Suites	Корневые test suites	Один сьют на suite TestRail
Sections	Вложенные test suites	Дерево по parent section
Cases	Test cases	Заголовок, refs, preconditions, priority, estimate
Steps	Test case steps	Только текст - см. ограничения
Runs (опционально)	Test runs	Если включён импорт runs и results
Results (опционально)	Test run results	Связь с импортированными кейсами, когда возможно

Не импортируется в этом релизе: вложения (attachments), shared steps, plans и прочие объекты только TestRail.

---

Пошагово

1. Откройте Migrations

1. Войдите в workspace команды.
2. Откройте /migrations/ru или /migrations/en.
3. Нажмите Новый импорт TestRail.

2. Подключитесь к TestRail

1. Базовый URL - только хост, например https://yourcompany.testrail.io (без /index.php и /dashboard).
2. Email - тот же логин, что в TestRail.
3. API key или пароль - значение ключа из My Settings либо пароль аккаунта.
4. Нажмите Подключить.

При ошибке 401 см. Проблемы подключения.

3. Выберите проект и запустите

1. Выберите проект TestRail в списке.
2. При необходимости оставьте включённым Импортировать runs и results.
3. Нажмите Запустить импорт.

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

4. Следите за прогрессом

На странице задачи видны:

• Статус - PENDING, RUNNING, PAUSED, COMPLETED, FAILED, CANCELLED
• Фаза - bootstrap, suites, cases, runs, results, finalize
• Счётчики - done / skipped / failed по типам сущностей
• Недавние ошибки - по сущностям, если что-то не удалось импортировать

Действия:

• Пауза / Продолжить - остановить или возобновить обработку
• Отменить - остановить задачу; сохранённые API-учётные данные очищаются
• Обновить - перезагрузить страницу со свежими счётчиками

Пока задача активна, обработка идёт в фоне. Страницу можно закрыть и вернуться из списка импортов.

5. Откройте новый проект

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

---

Ограничения и отличия

Шаги проще, чем в Complex QA

В Complex QA шаги структурированные (step_element, step_element_action и связанные поля). В TestRail шаги чаще обычный текст (content / expected или многострочное поле).

После импорта:

• Текст шага и ожидаемый результат заполняются, если TestRail их отдаёт.
• Структурные поля вроде element и action остаются пустыми.

Более богатый разбор шагов планируется позже. Сейчас ожидайте, что дерево и кейсы переносятся хорошо, а шаги выглядят проще, чем у кейсов, созданных сразу в Complex QA.

Прочие ограничения

• Нет attachments и shared steps.
• Один проект TestRail → один новый проект Complex QA на задачу.
• Защита от дублей: при продолжении импорта уже перенесённые сущности пропускаются (внутренняя карта id).
• Большие проекты занимают время; прогресс двигается порциями в фоне.

---

Проблемы подключения (HTTP 401)

Сообщение Authentication failed: invalid or missing user/password or session cookie значит, что TestRail отклонил учётные данные. Обычно помогает:

1. Включить API в Admin → Site Settings → API и сохранить.
2. После создания API key нажать Save Settings в My Settings.
3. Указать email аккаунта и значение ключа (не имя ключа).
4. Для проверки временно подставить пароль аккаунта в то же поле.
5. Указать URL только как хост.

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

---

См. также

• Типы сущностей TMS
• Проекты
• Тест-кейсы и сьюты
• Тест-раны
• Результаты тест-ранов
• Роль team admin

---

Версия	1.0
Последнее изменение	2026-07-22