Добавление полей и управление ими (процесс наследования)

Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019

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

Список всех полей, определенных для вашей организации, который включает все поля, определенные для системных и унаследованных процессов, см. в разделе "Просмотр полей и атрибутов рабочих элементов".

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

Необходимые компоненты

Рекомендации по настройке Azure Boards в соответствии с конкретными бизнес-требованиями см. в статье о настройке и настройке Azure Boards.

• Требование организации. Убедитесь, что у вас есть организация в Azure DevOps.

• Разрешения:

  • Быть членом группы "Администраторы коллекции проектов".
  • У вас есть разрешения на уровне коллекции, такие как создание процесса, удаление процесса, изменение процесса или удаление поля из организации, для которых задано значение Allow.
  • Эти разрешения позволяют изменять процессы и поля в организации.

Открытие параметров процесса организации

1. Войдите в свою организацию (https://dev.azure.com/{yourorganization}).

2. Выберите Параметры организации.

   

3. Выберите Обработать.

   

Примечание.

При настройке унаследованного процесса все проекты, использующие этот процесс, автоматически отражают настройки. Чтобы обеспечить плавный переход, рекомендуется создать тестовый процесс и проект, который позволяет протестировать настройки перед их реализацией на уровне организации. Дополнительные сведения см. в разделе "Создание унаследованных процессов и управление ими".

Пользовательские имена полей

При добавлении настраиваемого поля в наследуемый процесс Azure DevOps назначает префикс ссылочного имени с помощью Custom , а затем имя поля с удаленными пробелами. Например, вы добавляете поле с именем DevOps Triage, имя ссылки — Custom.DevOpsTriage. Пробелы не допускаются в имени ссылки.

Добавление настраиваемого поля

Вы можете добавить поля и указать группу и страницу, где они должны отображаться. Кроме того, после добавления поля его можно перетащить на страницу, чтобы переместить его размещение в форме. Если у вас есть несколько полей, которые нужно добавить на настраиваемую страницу или группу, сначала добавьте эти страницы или группы , а затем добавьте поля.

Примечание.

Каждый процесс может определять до 1024 полей, включая наследуемые системой поля. Вы можете добавлять только поля на странице в форме. Не удается добавить поле в серую область в форме, в которой находятся поля "Назначенный кому", "Состояние" и "Причина".

1. На странице "Процесс " выбранного наследуемого процесса выберите тип рабочего элемента, в который нужно добавить настраиваемое поле.

   Здесь мы выбираем ошибку WIT. Обратите внимание на ссылки на вкладку "Навигация", позволяющие вернуться на страницу "Все процессы " и "MyAgile ".

   

   Если новое поле и другие параметры отключены, у вас нет необходимых разрешений для изменения процесса. См. раздел Настройка разрешений и доступа для отслеживания работы. Настройка унаследованного процесса.

2. Выбрав WIT, выберите новое поле.

   

3. Назовите поле и выберите тип поля из одного из поддерживаемых типов данных. При необходимости добавьте описание.

   Примечание.

   Необходимо указать имя поля, уникальное в организации. Настраиваемое поле, определенное для одного процесса, не может совпадать с именем, определенным для другого процесса. Дополнительные сведения о именах полей см. в разделе "Что такое поле?" Как используются имена полей?

   Здесь мы добавим целочисленное поле "Билет клиента".

   

4. (Необязательно) На вкладке "Параметры" укажите, является ли поле обязательным и укажите значение по умолчанию. Или оставьте значения пустыми. Чтобы сохранить рабочий элемент, пользователи должны указать значение для поля. При создании рабочего элемента, а также при каждом открытии рабочего элемента и пустом поле устанавливается значение по умолчанию.

   

5. (Необязательно) На вкладке "Макет" можно ввести другую метку формы, отличную от имени поля. Кроме того, можно выбрать страницу и группу, в которой поле отображается в форме.

   Здесь мы добавим поле "Билет клиента" в новую группу с меткой "Фокус клиента".

   

   Примечание.

   Хотя вы можете изменить метку формы, необходимо использовать имя поля при добавлении полей в карточки (Доска, панель задач) или создание запросов на основе поля.

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

7. Завершив внесение всех изменений, откройте рабочий элемент выбранного типа.

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

   

Добавление списка выбора

Ограничения для отслеживания хода выполнения работы, процесса и проекта

Вы можете добавить новое поле и определить список выбора или настроить список выбора унаследованного поля.

Примечание.

Каждая организация или коллекция могут определять до 2048 списков выбора. Каждый список выбора может содержать до 2048 элементов. Элементы списка выбора должны быть 256 или меньше символов. Если вы хотите добавить зависимые списки выбора, см . каскадные списки.

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

   

   Чтобы удалить элемент в списке, выделите элемент и щелкните значок удаления.

   Чтобы изменить список выбора унаследованного поля, нажмите кнопку "Изменить ", чтобы изменить поле. На вкладке "Определение" можно выбрать "Добавить значение".

   

2. (Необязательно) Перейдите на вкладку "Параметры" , чтобы определить поле по мере необходимости, указать значение по умолчанию или разрешить пользователям вводить собственные значения.

   

3. (Необязательно) См. предыдущий шаг 5 , чтобы указать, где нужно, чтобы поле отображалось в форме (вкладка "Макет ").

Добавление поля удостоверения

Используйте поле на основе удостоверений, чтобы добавить поле, аналогичное полю "Назначенный кому". Поля на основе удостоверений работают так же, как и поле "Назначенный кому", предоставляя функцию выбора удостоверений и поиска удостоверений. Когда организация управляет пользователями с помощью идентификатора Microsoft Entra или Active Directory, система синхронизирует поля на основе удостоверений с именами, определенными в этих каталогах.

1. Сначала выберите новое поле, а затем имя поля, тип удостоверения и описание.

   

2. (Необязательно) См. предыдущий шаг 5 , чтобы указать, где нужно, чтобы поле отображалось в форме (вкладка "Макет").

Добавление форматированного текста, поля HTML

1. Как и раньше, выберите WIT, к которому нужно добавить поле, а затем выберите новое поле.

2. Выберите текст (несколько строк) в качестве типа. Здесь мы помечаем поле как запрос клиента для записи комментариев клиентов для запросов на функции продукта.

   

3. Поле добавляется в первый столбец во всех системных полях с форматированным текстом, но перед элементом управления "Обсуждение".

   

Добавление поля флажка

1. Как и раньше, выберите WIT, к которому нужно добавить поле, а затем нажмите кнопку "Создать".

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

   

3. (Необязательно) Откройте вкладку "Параметры" и укажите, следует ли использовать поле.

   

4. По умолчанию поле добавляется в последнюю группу, определенную во втором столбце. Откройте вкладку "Макет", чтобы перетащить поле в другую группу в форме.

   Примечание.

   Поле отображается как флажок в форме рабочего элемента. Установите флажок, чтобы указать значение True. Если поле отображается на доске или в области задач, значения полей отображения True и False (не флажок).

Добавление существующего поля в другой WIT

Существующие поля соответствуют любому наследуемому полю и настраиваемому полю, определенному в коллекции. После добавления настраиваемого поля в один WIT вы можете добавить его другим пользователям из меню формы. Кроме того, можно добавить поле, определенное для одного процесса, в рабочий тип элемента в другом процессе. Откройте тип рабочего элемента и выберите существующее поле.

Чтобы найти описания любого системного поля рабочего элемента, см . индекс поля рабочего элемента.

Здесь мы добавим поле "Билет клиента" в WIT пользовательской истории.

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

Переназначка поля

Переименование поля или изменение типа поля не поддерживается. Однако на вкладке "Макет" можно изменить метку, которая отображается в форме рабочего элемента. При выборе поля в запросе необходимо выбрать имя поля, а не метку поля.

Здесь мы переназначаем поле "Билет клиента" на номер билета.

Изменение текста справки по описанию

Текст справки по описанию отображается при наведении указателя мыши на поле в форме рабочего элемента. Вы можете определить другой текст справки для одинаковых полей для разных типов рабочих элементов. Изменение поддерживается как для настраиваемых полей, так и для унаследованных полей. Обратите внимание, что реализация отличается в зависимости от типа поля.

• Для унаследованных полей: текст справки описания можно определить по-разному для каждого типа и процесса рабочего элемента.
• Для настраиваемых полей: текст справки по описанию отображается одинаково для поля во всех типах рабочих элементов и во всех процессах.

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

Здесь мы изменим поле "Точки истории" для истории пользователя.

Отображение, скрытие или удаление поля

Вы можете отобразить или скрыть любое поле или настраиваемый элемент управления, отображаемые в форме. Если вы хотите восстановить поле в форме позже, вы можете отменить скрытие этих действий от параметра Delete , который удаляет поле из организации.

Примечание.

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

При удалении настраиваемого поля из макета он сохраняется в хранилище данных, но удаляется из журнала. Его можно просмотреть из результатов запроса. Если вы добавите поле обратно в форму, журнал для него восстанавливается. Чтобы удалить настраиваемое поле из коллекции проектов, см . раздел "Удалить поле".

Скрытие поля или пользовательского элемента управления

1. Откройте контекстное меню для поля или элемента управления и выберите " Скрыть из макета".

   

2. Чтобы добавить скрытое поле или элемент управления в форму, выберите "Показать на макете".

Удаление настраиваемого поля из формы

1. Выберите "Удалить " из контекстного меню поля, которое вы хотите удалить.

   

2. Убедитесь, что вы хотите удалить поле.

   

3. Чтобы добавить настраиваемое поле, которое было удалено, выберите новое поле и выберите "Использовать существующее поле".

Возврат поля для предустановки по умолчанию

Вы можете отменить изменения, внесенные в унаследованное поле. На странице "Макет " измененного типа рабочего элемента выберите параметр "Восстановить " для поля.

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

С помощью модели процесса наследования можно удалять только пользовательские поля. Не удается удалить поля, определенные для системных процессов по умолчанию.

При удалении поля удаляются все данные, связанные с этим полем, включая исторические значения. После удаления можно восстановить только поле и восстановить данные с помощью полей — обновить REST API.

Примечание.

Рекомендуется удалять только те поля, которые не используются. Вы можете определить поля, которые не используются, выполнив команду witadmin listfields . Дополнительные сведения см. в разделе "Управление полями рабочих элементов" (witadmin).
Кроме того, если аналитика включена для вашей организации или коллекции, вы можете запросить аналитику, в которой пользовательское поле используется со следующим синтаксисом:

https://analytics.dev.azure.com/{OrganizationName}/_odata/v4.0-preview/WorkItemTypeFields?$filter=FieldReferenceName eq {CustomFieldReferenceName}&$select=WorkItemType

1. Поле удаляется на странице "Все процессы>"

   

   Чтобы удалить поля, необходимо быть членом группы "Администраторы коллекции проектов" или предоставить явные разрешения на удаление поля из учетной записи.

2. Чтобы завершить операцию удаления, необходимо ввести имя поля, как показано ниже.

   

Связанные статьи

Примечание.

Просмотрите изменения, внесенные в унаследованный процесс через журнал аудита. Дополнительные сведения см. в статьях "Доступ", "Экспорт" и "Фильтрация журналов аудита".

• Просмотр полей и атрибутов рабочих элементов
• Добавление или изменение типа пользовательского рабочего элемента
• Настройка макета веб-сайта
• Настройка проекта с помощью унаследованного процесса
• Настройка карточек на досках
• Отображение ошибок в невыполненной работе и на досках
• Ограничения для отслеживания хода выполнения работы, процесса и проекта

Если вы работаете с планами тестирования или тестовых вариантов, ознакомьтесь со следующими статьями:

• Создание тестового плана
• Создание тестовых случаев вручную