Группировка по кастомным полям

Группировка по кастомным полям — функциональная возможность ТестОпс, которая позволяет группировать тест-кейсы и результаты тестов в категории, используя значения кастомных полей. Древовидная структура на основе кастомных полей — это динамическая и автоматизированная альтернатива статическим папкам.

Например, если вы сгруппируете тест-кейсы по кастомному полю Feature, вы можете получить следующее представление:

Тест-кейсы и результаты тестов можно группировать по нескольким кастомным полям, создавая вложенную группировку (например, сначала по полю Suite, затем по полю Feature).

Ключевые преимущества группировки по кастомным полям:

• Автоматизация и динамичность — древовидная структура обновляется автоматически при изменении значения кастомного поля у тест-кейса.
• Гибкость и единый источник данных — один тест-кейс может отображаться сразу в нескольких категориях древовидной структуры без необходимости создавать его копии.
• Устойчивость к изменениям — удаление или изменение тест-кейса не разрушает структуру группировки по кастомным полям. Новые тест-кейсы с соответствующими метаданными автоматически занимают правильное место в группировке по кастомным полям.

Создание группировки по кастомным полям

Чтобы создать новую группировку по кастомным полям:

1. Перейдите в раздел Настройки → Группировка по кастомным полям.
2. Нажмите + Создать.
3. В поле Название введите название для новой группировки по кастомным полям.
4. В поле Путь нажмите Добавить, чтобы добавить новую категорию.
5. Выберите кастомное поле для категории.
6. Нажмите Добавить, чтобы создать вложенную категорию, если это необходимо.
7. Чтобы сохранить изменения и создать группировку по кастомным полям, нажмите Отправить.

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

1. Перейдите в раздел Тест-кейсы.
2. В верхнем левом углу нажмите Папки (или название группировки по кастомным полям).
3. В выпадающем списке выберите нужную группировку по кастомным полям.

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

Изменение категории в древовидной структуре

Группировки по кастомным полям позволяют быстро изменять значения кастомных полей тест-кейсов.

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

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

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

3. Выберите нужные тест-кейсы в списке одним из способов:

   • поставьте галочки напротив тест-кейсов;
   • удерживая Ctrl (Windows) / Command (macOS), нажмите на названия тест-кейсов.

4. В нижней части экрана в панели массовых операций нажмите ⋯ → Добавить метаданные.

5. Нажмите Значения кастомных полей.

6. Выберите нужное кастомное поле и его значение.

7. Нажмите Добавить.

Совет

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

Если категории с нужным значением не существует, вы можете создать ее, нажав кнопку в нижней части экрана рядом с + Тест-кейс.

Чтобы изменить значение кастомного поля у всех тест-кейсов категории на новое:

1. Наведите курсор на название категории.

2. Справа от названия категории нажмите ⋯ → Переименовать.

   Совет

   Вы также можете дважды нажать на название категории, чтобы активировать поле для ввода нового значения.

3. Введите новое значение для кастомного поля и нажмите Enter.

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

Важно

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

• создавать категории тест-кейсов с новыми значениями этого поля;
• менять названия существующих категорий тест-кейсов для этого поля.

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

Массовые операции с тест-кейсами и результатами тестов в категории древовидной структуры

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

Клонирование тест-кейсов из категории древовидной структуры

При клонировании тест-кейсов из категории древовидной структуры:

• в текущий проект — склонированные тест-кейсы добавятся в текущую категорию;
• в другой проект — вместе со склонированными тест-кейсами будет добавлена структура вложенных категорий.

Перемещение тест-кейсов из категории древовидной структуры в другой проект

При перемещении тест-кейсов из категории древовидной структуры в другой проект ТестОпс анализирует структуру исходного проекта и при необходимости повторяет ее в целевом проекте:

• Если структура совпадает — тест-кейсы добавятся в существующую категорию.
• Если структура не совпадает — тест-кейсы добавятся в новую категорию в соответствии с исходным проектом.

Разворачивание и сворачивание категорий древовидной структуры на одном уровне вложенности

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

Чтобы развернуть категории тест-кейсов на одном уровне вложенности:

1. Перейдите в раздел Тест-кейсы.
2. Убедитесь, что в левом верхнем углу выбрано нужная группировка по кастомным полям.
3. Наведите курсор на название любой свернутой категории нужного уровня вложенности.
4. Справа от названия категории нажмите ⋯ → Развернуть все рядом.

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

1. Перейдите в раздел Тест-кейсы.
2. Убедитесь, что в левом верхнем углу выбрано нужная группировка по кастомным полям.
3. Наведите курсор на название любой развернутой категории нужного уровня вложенности.
4. Справа от названия категории нажмите ⋯ → Свернуть все рядом.

Похожим образом вы можете развернуть и свернуть категории результатов тестов в разделе Запуски.

Совет

Вы также можете развернуть или свернуть категории, удерживая Alt (Windows) / Option (macOS) и нажав на название любой категории нужного уровня вложенности.

Фокусирование на категории древовидной структуры

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

Для этого:

1. Перейдите в раздел Тест-кейсы.
2. Наведите курсор на название категории.
3. Справа от названия категории нажмите ⋯.
4. Выберите пункт Сфокусироваться.

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

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

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

Важно

Начиная с версии ТестОпс 5.25 (сборка 525u01) фича-флаг «Новое дерево тест-кейсов» отключен и недоступен для использования. Эта инструкция применима только для миграции на версии ТестОпс 5.11–5.24.

Настоятельно рекомендуем обновить ТестОпс до версии 5.25 (сборка 525u01) или выше, так как поддержка инструментов миграции будет прекращена в ближайших релизах.

В версиях ТестОпс 5.11–5.24 включена миграция деревьев тест-кейсов на новую структуру данных.

Если возникают проблемы с отображением деревьев, созданных в более ранних версиях ТестОпс, можно:

• Отредактировать настройки дерева в разделе Настройки → Деревья. Попробуйте переименовать дерево или добавить дополнительный уровень группировки, сохранить изменения, затем вернуть прежнее название и убрать добавленный уровень группировки. После сохранения изменений в настройках дерева начнется миграция данных на новую структуру, после окончания миграции дерево будет отображаться в разделе Тест-кейсы.

• Воспользоваться API для миграции деревьев на новую структуру:

  Важно

  Запустить миграцию деревьев тест-кейсов на новую структуру данных с помощью API могут только пользователи с глобальной ролью «Администратор» или проектной ролью «Владелец проекта» в текущем проекте.

  • Чтобы мигрировать данные всех деревьев внутри проекта, выполните запрос POST /api/project/{projectId}/test-case/tree/migration, где {projectId} — идентификатор проекта, в рамках которого необходимо мигрировать данные деревьев.
  • Чтобы мигрировать данные отдельного дерева внутри проекта, выполните запрос POST /api/project/{projectId}/test-case/tree/{treeId}/migration, где:
    • {projectId} — идентификатор проекта в рамках, которого необходимо мигрировать данные деревьев,
    • {treeId} — идентификатор дерева, данные которого необходимо мигрировать на новую структуру.