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

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

  • Статья

Azure DevOps Services

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

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

Существует два способа управления настраиваемыми полями— с помощью 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 , предоставляющий массив настраиваемых полей. Для каждого поля можно найти его идентификатор, имя, тип и область. Вы также можете жестко закодировать тип, если вы знаете тип настраиваемого поля заданного имени.