Импорт тест-кейсов из файлов в формате 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.

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

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

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

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

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

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

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

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

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

  Примечание

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

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

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

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

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

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

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

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

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

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

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

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

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

Внимание

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

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

Важно

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

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

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

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

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

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

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

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

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

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

Важно

При чтении значения для сценария тест-кейса ТестОпс использует правила:

• Перевод строки (\n) создает новый шаг сценария.
• Если новая строка начинается с символа табуляции (\t), ТестОпс обработает ее как подшаг для предыдущего шага.

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

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

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

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

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

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

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

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

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

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

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

После того как в секции Выберите маппинг вы настроили маппинг метаданных тест-кейсов и значений из файла в формате CSV:

1. Нажмите Показать превью, чтобы посмотреть пример импортированного тест-кейса.

2. Если вас устраивают результаты предварительного просмотра, в правом нижнем углу нажмите Импортировать.

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

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

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

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

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

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

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

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

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