Кастомные поля
Кастомные поля — это произвольные пары «ключ-значение», которые вы можете добавлять к вашим тест-кейсам. Как и в случае с тегами, смысл названия поля и его значения будет зависеть от того проекта, в котором это поле используется.
Основная цель кастомных полей — помочь фильтровать и группировать тест-кейсы. Вы можете использовать кастомные поля для:
- группировки тест-кейсов по определенным значениям в деревьях;
- поиска тест-кейсов с помощью фильтров;
- фильтрации тест-кейсов с помощью AQL-запросов (например, при создании тест-планов).
Чтобы создать кастомное поле и начать его использовать:
- В роли администратора создайте кастомное поле.
- В роли администратора или владельца проекта добавьте кастомное поле в проект.
- В роли администратора или владельца проекта добавьте глобальные или проектные значения кастомных полей.
- В роли владельца проекта или автора тестов отредактируйте значения для тест-кейсов вручную или автоматически.
Системные поля
При создании проекта ТестОпс автоматически добавляет в него набор системных полей:
- Epic, Feature и Story — используются по умолчанию для дерева Features;
- Suite — используется по умолчанию для дерева Suites;
- Component — по умолчанию не используется, но часто применяется в пользовательских деревьях и фильтрах.
Системные поля нельзя удалить из проекта, но вы можете добавить или удалить маппинги для любого поля (см. Установка значений автоматически).
ТестОпс создает маппинги для системных полей автоматически. Эти маппинги совпадают с теми значениями, которые используются в большинстве адаптеров Allure.
Создание кастомных полей
Перед тем, как вы начнете использовать кастомное поле в конкретном проекте, его должен создать администратор вашего инстанса ТестОпс.
Чтобы создать новое кастомное поле:
Перейдите в раздел Администрирование → Кастомные поля.
Нажмите + Поле.
Введите название поля.
Выберите тип поля: Одиночный выбор или Множественный выбор, и нажмите Создать.
Примечание
После создания кастомного поля нельзя изменить его тип.
Чтобы переименовать или удалить существующее кастомное поле, в правом верхнем углу нажмите ⋯
и выберите необходимое действие.
Добавление кастомных полей в проект
После того, как администратор создаст кастомное поле, добавьте его в проект. Это может сделать владелец проекта в настройках проекта или администратор инстанса ТестОпс в панели администрирования.
- Перейдите в раздел Администрирование → Кастомные поля.
- Выберите поле, которое вы хотите добавить в проект.
- Перейдите на вкладку Проекты.
- Нажмите Добавить к проектам.
- В появившемся окне выберите проекты, в которые нужно добавить выбранное поле, и нажмите Добавить.
Обязательное поле
Обязательное поле — это параметр, при котором пользователь должен указывать значение кастомного поля в каждом тест-кейсе проекта.
Параметр Обязательное поле для кастомного поля может установить:
- администратор инстанса — для всех проектов, в которых добавлено это кастомное поле, или для каждого проекта отдельно;
- владелец проекта — только для своего проекта.
- Перейдите в раздел Администрирование → Кастомные поля.
- Нажмите на кастомное поле, которое вы хотите сделать обязательным.
- Нажмите
⋯
в правом верхнем углу или перейдите на вкладку Проекты и нажмите⋯
рядом с названием проекта. - Включите переключатель Обязательное поле.
Важно
Владелец проекта не может отключить параметр Обязательное поле, активированный администратором.
Особенности обязательного поля:
- Обязательное поле всегда отображается в деталях тест-кейса.
- Если обязательное поле не заполнено, появляется сообщение «Нет значений».
- Пользователь не может сохранить изменения в настройках кастомных полей, пока не заполнит все обязательные поля.
Добавление значений кастомных полей
Есть два вида значений кастомных полей:
- глобальное значение — создается администратором инстанса и доступно во всех проектах, в которых используется соответствующее кастомное поле;
- проектное значение — создается владельцем проекта и доступно только в этом проекте.
- Перейдите в раздел Администрирование → Кастомные поля.
- Нажмите на кастомное поле, для которого хотите добавить значение.
- На вкладке Глобальные значения нажмите + Значение.
- Заполните поле Название и при необходимости активируйте параметр Значение по умолчанию.
- Нажмите Создать.
Администратор инстанса может преобразовать проектные значения в глобальные. Для этого:
- Перейдите в раздел Администрирование → Кастомные поля.
- Выберите поле, значение которого хотите сделать глобальным.
- Перейдите на вкладку Проектные значения.
- Нажмите
⋯
рядом со значением и выберите Сделать глобальным.
Блокировка значений
Блокировка значений — это параметр, при котором пользователь может выбирать в кастомных полях только предопределенные глобальные и проектные значения.
Параметр Блокировка значений для кастомного поля может установить:
- администратор инстанса — для всех проектов, в которых добавлено это поле, или для каждого проекта отдельно;
- владелец проекта — только для своего проекта.
Важно
Невозможно установить параметр Блокировка значений для пустого поля.
- Перейдите в раздел Администрирование → Кастомные поля.
- Нажмите на кастомное поле, значения которого вы хотите заблокировать.
- Нажмите
⋯
в правом верхнем углу или перейдите на вкладку Проекты и нажмите⋯
рядом с названием проекта. - Включите переключатель Блокировка значений.
Важно
Если администратор инстанса включил параметр Блокировка значений для кастомного поля, владелец проекта не может:
- отключить этот параметр в настройках проекта;
- создать новые значения для этого кастомного поля.
Значение по умолчанию
Глобальное или проектное значение кастомного поля можно установить как Значение по умолчанию — оно будет присваиваться автоматически новым тест-кейсам в проектах, в которых используется это кастомное поле.
Значение по умолчанию может установить владелец проекта в настройках проекта или администратор инстанса ТестОпс в панели администрирования.
- Перейдите в раздел Администрирование → Кастомные поля.
- Нажмите на кастомное поле, значение которого хотите сделать значением по умолчанию.
- На вкладке Глобальные значения нажмите
⋯
рядом с названием глобального значения и нажмите Использовать по умолчанию.
Важно
Проектное значение по умолчанию приоритетнее глобального. Если на уровне проекта нет значения по умолчанию, используется глобальное значение по умолчанию.
Объединение значений
Администратор может объединить в панели администрирования одно или несколько проектных значений:
- с существующим глобальным значением;
- в новое глобальное значение.
Владелец проекта может объединить в настройках проекта одно или несколько проектных значений:
- с существующим глобальным значением;
- с существующим проектным значением;
- в новое проектное значение.
Важно
Вы не можете объединять значение кастомного поля, для которого установлен параметр Блокировка значений, с другими значениями.
- Перейдите в раздел Администрирование → Кастомные поля.
- Нажмите на кастомное поле, значение которого хотите объединить.
- Перейдите на вкладку Проектные значения.
- Рядом с названием нужного значения нажмите
⋯
→ Объединить. - Выполните одно из действий:
- Выберите название существующего глобального значения из списка и нажмите Да, объединить.
- Нажмите Новое глобальное значение и создайте новое глобальное значение поля для объединения.
Установка значений кастомных полей в тест-кейсах
Установите значение кастомного поля для тест-кейса одним из следующих способов:
- вручную для одного или нескольких тест-кейсов (поддерживается по умолчанию для ручного тестирования; может быть настроено для автоматизированного тестирования);
- вручную с помощью дерева тест-кейсов (поддерживается как для ручного, так и для автоматизированного тестирования);
- автоматически (поддерживается только для автоматизированного тестирования).
Совет
Чтобы менять значения кастомных полей вручную для автоматизированных тест-кейсов, измените политику обновления метаданных вашего проекта.
Установка значения вручную для одного или нескольких тест-кейсов
Чтобы добавить значение кастомного поля к тест-кейсу:
Перейдите в раздел Тест-кейсы вашего проекта.
Откройте тест-кейс.
В правой части экрана найдите блок Кастомные поля и нажмите на значок карандаша.
В появившемся окне укажите значения кастомных полей.
В левой части окна найдите название нужного кастомного поля и укажите для него одно или несколько значений в поле Значение напротив.
Нажмите Отправить, чтобы сохранить изменения.
Чтобы добавить значения кастомных полей сразу к нескольким тест-кейсам, используйте пункт Добавить метаданные в меню групповых операций. В результате:
- ТестОпс добавит указанные значения в каждый выбранный тест-кейс.
- Существующие значения изменены не будут.
Чтобы удалить значения кастомных полей сразу из нескольких тест-кейсов, используйте пункт Удалить метаданные в меню групповых операций. В результате:
- ТестОпс удалит значения кастомных полей только из тех тест-кейсов, в которых есть выбранное значение.
- Другие значения изменены не будут.
Установка значений вручную с помощью деревьев
Деревья — функциональная возможность ТестОпс, позволяющая работать с кастомными полями тест-кейсов так же просто, как с папками.
Каждая папка в дереве — набор тест-кейсов, сгруппированных по значению кастомного поля. Вы можете перетаскивать тест-кейсы из одной папки в другую, менять значение кастомного поля у всех тест-кейсов в группе, создавать новые тест-кейсы сразу с нужным значением кастомного поля и т. д.
Более подробную информацию о работе с деревьями можно найти в разделе Деревья.
Установка значений автоматически
Перейдите в раздел Настройки → Кастомные поля.
Выберите кастомное поле, значение которого должно загружаться из результатов тестов.
Нажмите Новый маппинг.
В появившемся окне введите ключ маппинга, который вы будете использовать в вашем коде, и нажмите Создать.
Используйте этот ключ в вашем коде для установки значений кастомного поля.
Пример на Java:
java@Test public void testAuthentication() { Allure.label("component", "Core"); Allure.label("version", "1.23"); // ... }
Использование ключей маппинга зависит от используемого языка и фреймворка. Вы можете найти больше информации об этом в справочнике адаптера Allure, который вы используете.
После того, как вы настроите все маппинги и укажете все нужные значения в коде, создайте новый запуск и закройте его, чтобы применить внесенные изменения.
Изменение политики обновления метаданных
Чтобы менять значения кастомных полей для автоматизированных тест-кейсов через интерфейс ТестОпс, а не указывать их в результатах тестов, измените политику обновления метаданных, настроив игнорирование значений кастомных полей из результатов тестов:
- Откройте ваш проект.
- Перейдите в раздел Настройки → Обновление метаданных.
- Нажмите + Создать.
- В поле Поле выберите custom_field.
- В поле Политика выберите from_test_case.
- Нажмите Отправить.