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

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), в котором нужно добавить настраиваемое поле.

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

   

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

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

   

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

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

   В следующем примере мы добавим целочисленное поле с меткой Customer Ticket.

   

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

   

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

   В следующем примере мы добавим поле "Билет клиента" в новую группу, названную "Ориентированность на клиента."

   

   Примечание.

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

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

7. После завершения изменений откройте рабочий элемент настраиваемого типа для просмотра обновлений.

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

   

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

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

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

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

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

   

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

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

   

2. (Необязательно) Укажите необходимые или стандартные значения и выберите, где поле отображается в форме.

   

Добавить поле идентификатора

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

Выберите ", а затем имя поля, тип удостоверения и дополнительное описание.

(Необязательно) Укажите необходимые или стандартные значения и выберите, где поле отображается в форме.

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

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

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

   

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

   

4. (Необязательно) Укажите необходимые или стандартные значения и выберите, где поле отображается в форме.

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

1. Выберите WIT, к которому хотите добавить поле, а затем выберите Новое поле.

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

   

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

   

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

   Примечание.

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

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

Существующие поля соответствуют любому наследуемому полю и настраиваемому полю, определенному в коллекции. После добавления настраиваемого поля в один 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. Введите имя поля, как показано в следующем примере, и подтвердите, выбрав поле "Удалить рабочий элемент".

   

Связанный контент

Примечание.

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

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