Перейти к основному содержимому

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

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

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

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

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

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

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

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

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

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

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

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

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

  1. Нажмите на ваш аватар и перейдите в раздел Администрирование → Кастомные поля.
  2. Нажмите Новое поле.
  3. Введите название поля и нажмите Создать.

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

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

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

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

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

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

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

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

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

  2. Выберите тест-кейс.

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

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

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

    Все кастомные поля отображаются в окне.

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

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

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

  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, который вы используете.

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