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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

   Примечание

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

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

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

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

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

Обязательное поле

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

Параметр Обязательное поле для кастомного поля может установить:

• администратор инстанса — для всех проектов, в которых добавлено это кастомное поле, или для каждого проекта отдельно;
• владелец проекта — только для своего проекта.

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

Важно

Владелец проекта не может отключить параметр Обязательное поле, активированный администратором.

Особенности обязательного поля:

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

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

Есть два вида значений кастомных полей:

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

1. Перейдите в раздел Администрирование → Кастомные поля.
2. Нажмите на кастомное поле, для которого хотите добавить значение.
3. На вкладке Глобальные значения нажмите + Значение.
4. Заполните поле Название и при необходимости активируйте параметр Значение по умолчанию.
5. Нажмите Создать.

Администратор инстанса может преобразовать проектные значения в глобальные. Для этого:

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

Блокировка значений

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

Параметр Блокировка значений для кастомного поля может установить:

• администратор инстанса — для всех проектов, в которых добавлено это поле, или для каждого проекта отдельно;
• владелец проекта — только для своего проекта.

Важно

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

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

Важно

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

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

Значение по умолчанию

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

Значение по умолчанию может установить владелец проекта в настройках проекта или администратор инстанса ТестОпс в панели администрирования.

1. Перейдите в раздел Администрирование → Кастомные поля.
2. Нажмите на кастомное поле, значение которого хотите сделать значением по умолчанию.
3. На вкладке Глобальные значения нажмите ⋯ рядом с названием глобального значения и нажмите Использовать по умолчанию.

Важно

Проектное значение по умолчанию приоритетнее глобального. Если на уровне проекта нет значения по умолчанию, используется глобальное значение по умолчанию.

Объединение значений

Администратор может объединить в панели администрирования одно или несколько проектных значений:

• с существующим глобальным значением;
• в новое глобальное значение.

Владелец проекта может объединить в настройках проекта одно или несколько проектных значений:

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

Важно

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

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. Перейдите на вкладку Маппинг.
5. Нажмите иконку настроек справа от + Маппинг и выберите источник метаданных Тест-кейс.