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

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

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

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. В поле Поле нажмите на выпадающий список и выберите Не обрабатывать.