Поделиться через

Пользовательские поля

  • Статья

Azure DevOps Services

Использование настраиваемых полей позволяет хранить пользовательские данные в результатах тестового выполнения и (или) теста. Для одного проекта Azure DevOps может быть определено до 100 настраиваемых полей. Администратор проекта может управлять (добавить или удалить) набор настраиваемых полей.

Необходимые условия

Категория Требования
Уровни доступа — Минимум базовый доступ с разрешениями на просмотр рабочих элементов в соответствующей области пути.
— Чтобы добавить планы тестирования и наборы тестов, удалите артефакты теста и определите конфигурации тестов: базовые и тестовые планы доступ.
Или одна из следующих подписок Visual Studio:
- Предприятие
- Тест профессиональный
- платформ MSDN
разрешения — Чтобы добавить или изменить планы тестирования, наборы тестов, тестовые варианты или другие типы рабочих элементов на основе тестов: изменить рабочие элементы в этом узле разрешения на Разрешить в соответствии с соответствующим пути области.
— Чтобы изменить свойства плана тестирования, такие как параметры сборки и тестирования: Управление планами тестирования установлено на Разрешить в соответствующем пути области.
— для создания и удаления комплектов тестов, добавления и удаления тестовых случаев из комплектов тестов, изменения конфигураций тестов, связанных с комплектами тестов, а также изменения иерархии комплектов тестов (перемещение комплекта тестов): Управление комплектами тестов установить разрешение на Разрешить под соответствующим Путь области.

Дополнительные сведения см. в разделе Ручной тестовый доступ и разрешения.

Управление настраиваемыми полями

Существует два способа управления настраиваемыми полями— с помощью REST API или администратора проекта можно сделать это с помощью параметров проекта при выборе управления тестами в конвейерах. На этой странице можно добавить новое настраиваемое поле, нажав кнопку +Добавить новую .

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

Нажмите кнопку " + Добавить новую ", чтобы добавить новое настраиваемое поле. Каждое настраиваемое поле должно иметь имя, тип, настроенный и указать, к какой тип артефакта он применяется.

Снимок экрана: диалоговое окно, используемое для добавления нового настраиваемого поля.

Имя настраиваемого поля не может превышать 50 символов (пробелы, числа и специальные символы не допускаются) и должно быть уникальным в проекте. Имена являются нечувствительными к регистру, поэтому у вас не может быть одно настраиваемое поле с именем Test и другое с именем test. Параметр Type может иметь одно из следующих значений:

  • бит
  • Дата/время
  • Int
  • Тип с плавающей запятой
  • Строка
  • GUID

Существующие настраиваемые поля можно изменить (изменить только имя) или удалить.

Примечание.

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

Хранение пользовательских данных в настраиваемых полях

Пользовательские данные можно хранить в настроенных настраиваемых полях как часть создания тестового запуска или результата, либо после создания тестового запуска или результата. Оба можно сделать с помощью REST API. В будущем мы разрешим сбор пользовательских данных из файла результатов теста. Чтобы получить значения, хранящиеся в настраиваемых полях для существующего тестового запуска или результата, необходимо использовать REST API. На данный момент мы не отображаем настраиваемые поля и значения, хранящиеся в них в пользовательском интерфейсе Azure DevOps (мы добавим эту возможность в будущем).

При создании тестового запуска и (или) результата с помощью REST API и требуется сохранить пользовательские данные в существующем пользовательском поле, лучше всего отправить пользовательские данные в рамках тестового выполнения и /или создания результатов. Создание тестового вызова REST API— создание и создание результатов тестового вызова REST API — добавление.

Если тестовый запуск и (или) результат не создается с помощью REST API, но с помощью других средств сначала необходимо найти идентификацию тестового запуска или результата, для которого необходимо задать (или обновить) пользовательские данные в настраиваемых полях, а затем вызвать запуск REST API — обновление для тестового запуска и результатов REST API — обновление для результата теста.

Чтобы получить пользовательские данные из настраиваемых полей, ранее хранящихся в ходе тестового выполнения и (или) результата, сначала необходимо найти идентификацию тестового запуска или результата. Затем можно вызвать запуски REST API — запрос для тестового выполнения и результатов REST API— получить результат теста.

Пользовательские данные для настраиваемых полей отправляются или получаются в массиве. Каждый элемент этого массива содержит два свойства "fieldname" и "value", и вы можете увидеть пример этого здесь. Значение — это объект типа, который соответствует типу, настроенного для настраиваемого поля. Чтобы понять тип настраиваемого поля, можно использовать REST API , предоставляющий массив настраиваемых полей. Для каждого поля можно найти его идентификатор, имя, тип и область. Вы также можете жестко закодировать тип, если вы знаете тип настраиваемого поля заданного имени.