Импорт тест-кейсов из файлов в формате CSV

Тест-кейсы можно импортировать в ТестОпс из других систем управления тестированием (TMS), из документов Microsoft Excel и Google Sheets. Для импорта используется формат CSV.

Перед импортом вы можете увидеть пример того, как будет импортирован тест-кейс, используя предпросмотр.

Этапы импорта файла c тест-кейсами в формате CSV

1. Подготовьте файл с тест-кейсами в формате CSV

В сторонней TMS, Microsoft Excel или Google Sheets создайте файл с необходимыми тестовыми данными в формате CSV.

2. Импортируйте файл с тест-кейсами в формате CSV

1. Перейдите в раздел Тест-кейсы.

2. Над списком тест-кейсов в правом верхнем углу нажмите Импорт.

3. Выберите файл в формате CSV для загрузки, используя проводник вашей операционной системы или перетащив файл в соответствующее поле интерфейса.

4. Нажмите Отправить.

5. Выберите настройки парсинга для дальнейшего маппинга данных:

   • Показывать заголовки — поставьте галочку, если первая строка файла в формате CSV содержит заголовки.
   • Автоопределение формата — поставьте галочку, чтобы автоматически определить символы разделения, экранирования и цитат, используемые в файле в формате CSV.

   Примечание

   Если автоопределение формата отключено, вы можете вручную указать настройки парсинга, заполнив поля:

   • Символ-разделитель для парсинга CSV-файла — введите символ для разделения столбцов в файле CSV (по умолчанию запятая ,).
   • Экранирующий символ для служебных символов — введите символ для экранирования специальных символов (по умолчанию двойные прямые кавычки ").
   • Символ для цитат — введите символ для цитирования (по умолчанию двойные прямые кавычки ").

6. Нажмите Получить из файла.

Когда чтение файла завершится, в секции Выберите маппинг появится выбор метаданных тест-кейсов, для которых необходимо настроить маппинг со значениями из файла в формате CSV.

Если файл был обработан неверно, вы можете изменить настройки парсинга и нажать Обновить парсинг.

3. Настройте маппинг метаданных тест-кейсов со значениями из файла в формате CSV

В секции Выберите маппинг для каждого столбца из файла в формате CSV будут отображены:

• в текстовой строке:

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

  Например, Колонка 2 - «name»: Проверка окна авторизации.

• в поле Поле — тип метаданных тест-кейсов, в который будут импортированы значения из текущего столбца (например, тип метаданных Полное имя).

  Примечание

  Если столбец в файле в формате CSV содержит информацию, которую не нужно импортировать (пустые значения или значения, специфичные для другой системы), в поле Поле выберите пункт Не обрабатывать.

Если названия столбцов из файла в формате CSV совпадают с системными названиями метаданных в тест-кейсах, ТестОпс определит маппинг между ними автоматически. В остальных случаях вам необходимо настроить маппинг вручную.

Доступные виды маппинга

ТестОпс поддерживает три вида маппинга при импорте тест-кейсов:

• Маппинг простых метаданных — используется для метаданных, в которых значение задается напрямую из файла в формате CSV, без дополнительных параметров или вложенной структуры.

  Простые метаданные: название тест-кейса, полное имя, описание, предусловие и ожидаемый результат.

• Маппинг метаданных типа «ключ-значение» — используется для метаданных, в которых каждая запись состоит из пары: название параметра и его значения.

  Метаданные типа «ключ-значение»: кастомные поля, задачи из таск-трекеров, роли участников команды, параметры тест-кейса, ссылки на тест-кейсы в TMS, внешние ссылки.

• Маппинг сложных метаданных — используется для метаданных, поддерживающих списки и вложенную структуру.

  Сложные метаданные: теги, сценарий.

Маппинг простых метаданных

Совет

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

Чтобы выполнить маппинг простого типа метаданных:

1. В секции Выберите маппинг найдите данные из файла в формате CSV, относящихся к типу простых метаданных.
2. В поле Поле нажмите на выпадающий список и выберите тип метаданных тест-кейсов, в который должно быть загружено текущее значение столбца.

Внимание

Не выполняйте маппинг для столбца allure_id из файла в формате CSV — убедитесь, что в поле Поле выбран пункт Не обрабатывать.

Столбец allure_id содержит уникальные ID тест-кейсов из базы данных ТестОпс. Маппинг для этого столбца используется только при импорте тест-кейсов, ранее экспортированных из того же проекта ТестОпс. Если маппинг отсутствует, ТестОпс создаст новые тест-кейсы.

Важно

Название — обязательный тип метаданных тест-кейсов. Если маппинг для типа метаданных Название не задан или хотя бы один тест-кейс не содержит значения в этом столбце, импорт тест-кейсов будет невозможен.

Маппинг метаданных типа «ключ-значение»

Чтобы выполнить маппинг метаданных типа «ключ-значение»:

1. В секции Выберите маппинг найдите данные из файла в формате CSV, относящихся к типу метаданных «ключ-значение».

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

3. В соседнем поле выберите значение типа метаданных («ключ»).

4. При необходимости в поле Разделитель введите символ, который используется для разделения значений в файле в формате CSV, если их указано несколько.

   При сложной схеме разделения вы можете установить галочку напротив Регулярное выражение и ввести регулярное выражение, описывающее способ разделения значений. Подробнее о регулярных выражениях см. Часто задаваемые вопросы → Какой синтаксис регулярных выражений поддерживает ТестОпс?

Маппинг сложных метаданных

Маппинг сценария тест-кейса

Сценарий тест-кейса — это сложный тип метаданных, который может содержать несколько шагов, подшагов, вложений и ожидаемых результатов.

При импорте сценария из файла в формате CSV ТестОпс использует специальный формат с ключевыми словами для обозначения типов шагов:

• [step N] — обычный шаг сценария, где N — номер шага (например, [step 1], [step 2.1]).
• [attachment N] — вложение, где N — номер вложения (например, [attachment 1.2]).
• [shared N] — общий шаг, где N — номер общего шага (например, [shared 2]). После ключевого слова указывается ID общего шага и его название: [shared 2] Shared step [69203]: Название общего шага.
• [expected N] — контейнер с ожидаемым результатом шага, где N — номер ожидаемого результата (например, [expected 1.3]).
• [expected.step N] — шаг внутри ожидаемого результата, где N — номер шага (например, [expected.step 1.3.1]).
• [expected.attachment N] — вложение внутри ожидаемого результата, где N — номер вложения (например, [expected.attachment 2.1.1.2]).

Вложенность шагов определяется количеством символов табуляции (\t) в начале строки. Каждый уровень табуляции создает новый уровень вложенности.

Важно

Сценарий в файле CSV должен быть оформлен в соответствии с форматом выше. Если сценарий оформлен иначе, приведите его к требуемому формату перед импортом.

Пример сценария в формате CSV

[step 1] Открыть страницу авторизации
	[step 1.1] Ввести логин
	[step 1.2] Ввести пароль
	[attachment 1.3] Attachment [35719]
	[expected 1.4] Ожидаемый результат
		[expected.step 1.4.1] Отображается главная страница
[step 2] Нажать кнопку «Войти»
	[step 2.1] Проверить авторизацию
[shared 3] Shared step [69203]: Общий шаг проверки
	[step 3.1] Выполнить проверку
		[expected 3.1.1] Ожидаемый результат
			[expected.step 3.1.1.1] Проверка выполнена успешно
			[expected.attachment 3.1.1.2] Attachment [17684]

Чтобы выполнить маппинг для сценария тест-кейса:

1. В секции Выберите маппинг найдите данные из файла в формате CSV, относящихся к сценарию тест-кейса.
2. В поле Поле нажмите на выпадающий список и выберите тип метаданных Сценарий, в который должно быть загружено текущее значение столбца.

Маппинг тегов тест-кейса

Другой пример сложного поля — теги тест-кейса. Если их несколько, значения будут разделены в CSV-файле определенным символом (например, запятой).

Чтобы выполнить маппинг для тегов тест-кейса:

1. В секции Выберите маппинг найдите данные из файла в формате CSV, относящихся к тегам тест-кейса.

2. В поле Поле нажмите на выпадающий список и выберите тип метаданных Тег, в который должно быть загружено текущее значение столбца.

3. В поле Префикс тега введите текст, который будет добавляться к каждому тегу при импорте — например, чтобы различать группы тегов по источнику данных или типу тестов.

4. При необходимости в поле Разделитель введите символ, который используется для разделения значений в файле в формате CSV, если их указано несколько.

   При сложной схеме разделения вы можете установить галочку напротив Регулярное выражение и ввести регулярное выражение, описывающее способ разделения значений. Подробнее о регулярных выражениях см. Часто задаваемые вопросы → Какой синтаксис регулярных выражений поддерживает ТестОпс?

4. Просмотрите пример импортируемого тест-кейса

После настройки маппинга метаданных тест-кейсов вы можете просмотреть пример того, как будут импортированы тест-кейсы из вашего файла в формате CSV:

1. В нижней части секции Импортировать тест-кейсы нажмите Показать превью.

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

2. Проверьте, что все метаданные импортируются корректно, и при необходимости вернитесь к настройке маппинга.

5. Завершите импорт файла с тест-кейсами в формате CSV

После проверки результатов предпросмотра:

1. В правом нижнем углу нажмите Импортировать.

2. В открывшемся окне выберите значения, которые будут применены к новым тест-кейсам (ранее не существовавшим в ТестОпс):

   • Test Layer — тестовый слой;
   • Workflow — воркфлоу;
   • Status — статус из выбранного воркфлоу.

3. Нажмите Отправить.

Все значения из файла в формате CSV будут сконвертированы в тест-кейсы ТестОпс на основе настроек маппинга, которые вы указали.

Устранение неполадок

Импорт завершился ошибкой с кодом 400 (тест-кейсы с указанными ID не найдены)

Если во время импорта возникла ошибка 400 (тест-кейсы с указанными ID не найдены), это означает, что в импортируемых данных указано одно или несколько недопустимых значений для ID тест-кейса (в столбце allure_id).

Чтобы убрать ошибку:

1. В секции Выберите маппинг найдите данные столбца allure_id из файла в формате CSV.
2. В поле Поле нажмите на выпадающий список и выберите Не обрабатывать.