Импорт

Импорт тест-кейсов и чек-листов

Кнопка «Импорт» находится на панели действий над таблицей в разделах «Кейсы» и «Чек-листы». Она видна только пользователям с правом на редактирование раздела — см. Права доступа к проектам.

Выбор источника импорта

В окне импорта в поле «Источник:» выберите один из вариантов:

• «DoQA» (выбран по умолчанию) — файл, ранее выгруженный из DoQA через экспорт.
• «Test IT» — файл экспорта из TMS Test IT.
• «Шаблон» — пустой шаблон DoQA, заполненный вручную.
• «Zephyr» — файл экспорта из TMS Zephyr.

Источник «Zephyr» есть только в разделе «Кейсы»: для чек-листов доступны «DoQA», «Test IT» и «Шаблон».

Шаблон для импорта

Выберите источник «Шаблон» и нажмите на кнопку «Скачать шаблон». В зависимости от раздела скачается файл template_case.xlsx или template_checklist.xlsx.

В качестве шаблона можно использовать и выгруженный из DoQA файл: «Шаблон» и «DoQA» — это один и тот же формат.

Правила заполнения выводятся в окне в блоке «Внимание!»:

• ничего не меняйте в структуре файла: не перемещайте столбцы, не переименовывайте столбцы, не меняйте формат ячейки;
• не используйте символы табуляции и разрывы строк внутри ячейки.

Процесс импорта

1. Выберите или перетащите в окно импорта файл. Принимается один файл формата .xlsx размером не больше 10 МБ.
2. Нажмите кнопку «Загрузить». Во время загрузки в окне отображается имя файла и прогресс-бар с процентами.

В одно пространство одновременно можно загружать только один файл. Если импорт в это пространство уже запустил другой пользователь, вместо области загрузки появится сообщение «Импорт невозможен так как в данное пространство уже загружается файл».

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

• Папки — по колонке Path. Недостающие папки создаются.
• Теги — по колонке Keys. Недостающие ключи и теги создаются.
• Вложения — по колонке Attachments, только для источников «DoQA» и «Шаблон». Из файлов Test IT и Zephyr вложения не переносятся.

Совет

При импорте из Zephyr теги попадают в ключ с названием «Импорт zephyr»: ищите их в тегах под этим ключом.

Общие шаги при импорте тест-кейсов и чек-листов не создаются: они переносятся только при импорте проекта из Test IT.

Результаты импорта

• Импорт прошёл успешно. У файла отображается статус «Загрузка прошла успешно». Нажмите «Готово», чтобы закрыть окно, или «Загрузить новый файл», чтобы выбрать следующий файл.
• Файл не соответствует шаблону. У файла отображается статус «Ошибка», а под ним — что именно не так и в какой строке, например: «В файле в строке 8 обнаружены некоторые ошибки. Исправьте ошибки в файле и загрузите его снова.» Исправьте файл и загрузите его заново.
• Ошибка при обработке. Если сбой произошёл уже после загрузки, во время обработки файла, откроется окно «Ошибка!» с текстом «При загрузке файла возникла ошибка, попробуйте обратиться в поддержку, либо загрузите другой файл.» и кнопками «Перейти к форме обратной связи» и «Загрузить новый файл».

Импорт проекта

DoQA импортирует проекты из TMS Qase и TMS Test IT. Перейдите на страницу «Проекты», нажмите на кнопку меню одного из проектов и выберите пункт «Импорт». Меню проекта доступно пользователям с правами на администрирование проекта.

Выберите источник и файл, затем подтвердите действие:

• «Qase» — файл экспорта .json;
• «Test IT» — архив .zip.

Принимается один файл размером не больше 50 МБ.

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

Перенос проекта из Test IT

Архив выгрузки Test IT переносится по такой схеме:

Test IT	DoQA
Проект	Рабочее пространство в выбранном проекте DoQA с именем «{имя проекта Test IT} #{ID пространства}» и описанием проекта из Test IT. Если в архиве несколько проектов, каждый становится отдельным пространством
Раздел	Папка. В дереве тест-кейсов создаются только разделы с кейсами, в дереве чек-листов — только разделы с чек-листами
Тест-кейс	Тест-кейс со шагами, ожидаемым результатом и тестовыми данными
Чек-лист	Чек-лист. Ожидаемый результат и тестовые данные шага дописываются в текст проверки под заголовками «Ожидаемый результат» и «Тестовые данные»
Общий шаг	Общий шаг пространства
Предусловия и постусловия кейса и его раздела	Поля «Предусловия» и «Постусловия» кейса: сначала условия раздела, потом кейса. У чек-листа полей условий нет: его собственные условия остаются обычными проверками, условия раздела к чек-листу не применяются
Комментарий к шагу	В кейсе — в «Тестовых данных» шага с пометкой «Комментарий:»
Приоритет	Приоритет DoQA. Highest становится «Высокий», Lowest — «Низкий», исходное значение сохраняется тегом «Приоритет Test IT: …»
Признак автоматизации	Тег «Автоматизирован: Автоматизирован» или «Автоматизирован: Не автоматизирован»
Тег	Тег. Каждый тег Test IT переносится одним тегом
Тест-план	Тег «Тест-план Test IT: {имя плана}» у каждого кейса и чек-листа из набора плана
Пользовательский атрибут, включённый в проекте	Атрибут проекта: строковый — строкой, дата — датой, список — списком, флажок — списком «Да» / «Нет». Атрибут с тем же именем и типом, что уже есть в проекте, используется повторно; с тем же именем, но другим типом — создаётся с суффиксом «(Test IT)»
Параметры и итерации кейса	Параметры кейса со стратегией «Линейное сопоставление». Упоминания параметров в тексте кейса становятся ссылками на параметры DoQA
Ссылки рабочего элемента (требования, дефекты, задачи, репозиторий)	Блок «Ссылки из Test IT» в конце описания. Связей с трекером такие ссылки не создают
Комментарий рабочего элемента	Комментарий к кейсу или чек-листу от имени пользователя, который запустил импорт, с пометкой «Из Test IT, {дата}». Упоминаний и уведомлений такие комментарии не создают
Вложение	Вложение кейса или чек-листа; изображения в тексте переносятся вместе с текстом

Не переносятся:

• удалённые в Test IT кейсы и чек-листы;
• автотесты, прогоны и их результаты, пользователи и права;
• вебхуки, дашборды и сохранённые фильтры: аналогов в DoQA у них нет;
• атрибуты типа «Пользователь» (в архиве Test IT нет имён пользователей), атрибуты неподдерживаемых типов и атрибуты сверх лимита в 30 атрибутов на проект;
• параметры кейса, если значение параметра повторяется в итерациях: DoQA не может воспроизвести такой набор итераций точно, и кейс импортируется без параметров. Параметры, заданные на общем шаге, а не на самом кейсе, тоже не переносятся;
• вложения больше 50 МБ и вложения без расширения файла.

Отчёт об импорте

Если часть данных перенести как есть не удалось, по окончании импорта открывается окно «Отчёт об импорте» с текстом «Импорт завершён, но часть данных из источника перенести как есть не удалось:». Ниже перечислено, что и в каком количестве не перенесено или перенесено с изменениями, например «Удалённые элементы пропущены: 2» или «Итерации кейсов не удалось воспроизвести точно: 4». Для пропущенных вложений показываются имена файлов.

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