Кастомные поля

Кастомные поля — это произвольные пары «ключ-значение», которые вы можете добавлять к вашим тест-кейсам. Как и в случае с тегами, смысл названия поля и его значения будет зависеть от того проекта, в котором это поле используется.

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

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

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

1. В роли администратора создайте кастомное поле.
2. В роли администратора или владельца проекта добавьте кастомное поле в проект.
3. В роли владельца проекта или автора тестов отредактируйте значения для тест-кейсов вручную или автоматически.

Системные поля

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

• Epic, Feature и Story — используются по умолчанию для дерева Features;
• Suite — используется по умолчанию для дерева Suites;
• Component — по умолчанию не используется, но часто применяется в пользовательских деревьях и фильтрах.

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

ТестОпс создает маппинги для системных полей автоматически. Эти маппинги совпадают с теми значениями, которые используются в большинстве адаптеров Allure.

Создание кастомных полей

Перед тем, как вы начнете использовать кастомное поле в конкретном проекте, его должен создать администратор вашего инстанса ТестОпс. На этом этапе определяется только название кастомного поля.

Чтобы создать новое кастомное поле:

1. Перейдите в раздел Администрирование → Кастомные поля.

2. Нажмите + Поле.

3. Введите название поля.

4. Выберите тип поля: Одиночный выбор или Множественный выбор, и нажмите Создать.

   Примечание

   После создания кастомного поля нельзя изменить его тип.

Чтобы переименовать или удалить существующее кастомное поле, используйте значки в правом верхнем углу.

Добавление кастомных полей в проект

После того, как администратор создаст кастомное поле, добавьте его в проект. Это может сделать владелец проекта в настройках проекта или администратор инстанса ТестОпс в панели администрирования.

1. Перейдите в раздел Администрирование → Кастомные поля.
2. Выберите поле, которое вы хотите добавить в проект.
3. Нажмите Добавить к проектам.
4. В появившемся окне выберите проекты, в которые нужно добавить выбранное поле, и нажмите Добавить.
5. При необходимости нажмите ⋯ рядом с названием проекта и активируйте параметр Обязательное поле с помощью переключателя.

Примечание

Параметр Обязательное поле означает, что пользователю необходимо указать значение для настраиваемого кастомного поля в каждом тест-кейсе. Обязательное поле всегда отображается в деталях тест-кейса, и если оно не заполнено, появится надпись «Нет значений».

Установка значений кастомных полей

Установите значение кастомного поля одним из следующих способов:

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

Совет

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

Установка значения вручную для одного или нескольких тест-кейсов

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

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

2. Откройте тест-кейс.

3. В правой части экрана найдите блок Кастомные поля и нажмите на значок карандаша.

4. В появившемся окне укажите значения для кастомных полей.

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

   

5. Нажмите Отправить, чтобы сохранить изменения.

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

• ТестОпс добавит указанные значения в каждый выбранный тест-кейс.
• Существующие значения изменены не будут.

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

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

Установка значений вручную с помощью деревьев

Деревья — функциональная возможность ТестОпс, позволяющая работать с кастомными полями тест-кейсов так же просто, как с папками.

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

Более подробную информацию о работе с деревьями можно найти в разделе Деревья.

Установка значений автоматически

1. Перейдите в раздел Настройки → Кастомные поля.

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

3. Нажмите Новый маппинг.

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

5. Используйте этот ключ в вашем коде для установки значений кастомного поля.

   Пример на Java:

   @Test
   public void testAuthentication() {
     Allure.label("component", "Core");
     Allure.label("version", "1.23");
     // ...
   }

   Использование ключей маппинга зависит от используемого языка и фреймворка. Вы можете найти больше информации об этом в справочнике адаптера Allure, который вы используете.

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

Изменение политики обновления метаданных

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

1. Откройте ваш проект.
2. Перейдите в раздел Настройки → Обновление метаданных.
3. Нажмите + Создать.
4. В поле Поле выберите custom_field.
5. В поле Политика выберите from_test_case.
6. Нажмите Отправить.