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

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

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

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

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

Предварительные условия

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

Категория	Требования
разрешения	— Для создания, удаления или изменения процесса: член группы администраторов коллекции проектов или наличие определенных разрешений на уровне коллекции, таких как "Создание процесса", "Удаление процесса", "Редактирование процесса"или "Удаление поля из организации", установленные на "Разрешить". Дополнительные сведения см. в разделе Настройка разрешений и доступа для отслеживания работы, настройка унаследованного процесса. — Чтобы обновить доски: администратор команды или участник группы администраторов проектов.
Доступ	- Даже если у вас есть базовый или более низкий доступ, вы все равно можете изменить процесс, если кто-то дает вам разрешения на это. — Чтобы обновить и изменить тип существующих рабочих элементов, необходимо быть членом проекта.
модель процесса проекта	— Иметь модель процесса наследования для коллекции проектов, содержащей проект. — При переносе данных в Azure DevOps Services используйте Службу импорта баз данных Team Foundation Server.
знания	Знакомство с настройкой и моделями процессов.

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

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 ID или Active Directory, система синхронизирует поля, основанные на идентификаторах, с именами, заданными в этих каталогах.

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

   

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

Добавьте поле с поддержкой форматированного текста HTML

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

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

   

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

   

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

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

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

   

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

   

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

   Примечание.

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

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

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

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

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

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

Переименование поля

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

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

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

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

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

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

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

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

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

Примечание.

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

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

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

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

   

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

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

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

   

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

   

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

Вернуть поле к значениям по умолчанию.

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

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

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

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

Примечание.

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

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

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

   

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

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

   

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

Примечание.

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

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

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

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