Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Azure DevOps Server | Azure DevOps Server 2022
Каждый проект включает набор типов рабочих элементов, определенных его процессом: Agile, Basic, Scrum или CMMI. Используйте типы рабочих элементов для отслеживания различных типов работы. Измените существующие типы или добавьте пользовательские, чтобы они соответствовали требованиям отслеживания команды и рабочему процессу.
Заметка
Эта статья относится к локальной модели xml-процессов. Сведения о Azure DevOps Services или коллекциях, использующих модель наследуемого процесса, см. в разделе "Добавление типов рабочих элементов и управление ими".
Ниже перечислены распространенные причины настройки типа рабочего элемента:
- Добавление или изменение полей или правил полей
- Изменение рабочего процесса (состояния, причины, переходы)
- Настройка макета формы рабочего элемента
Чтобы изменить только поля, см. статью "Добавление или изменение поля".
Типы рабочих элементов можно настроить с помощью XML-файла определения, определения конфигурации процесса или средства командной строки witadmin . В следующих списках показано, что можно сделать с каждым подходом.
Определение типа рабочего элемента
- Добавление или изменение поля
- Добавление или изменение типа рабочего элемента
- Изменение рабочего процесса
- Изменить форму рабочего элемента
Определение конфигурации процесса
- Укажите цвет типа рабочего элемента
- Укажите значок типа рабочего элемента
- Укажите цвет состояния рабочего процесса
- Добавление или удаление типа рабочего элемента из невыполненной работы или доски задач
- Добавление пользовательского типа рабочего элемента в бэклог или доску
- Добавить бэклог портфеля
Изменение командной строки
- Список типов рабочих элементов
- Деактивировать или отключить тип рабочего элемента
- Переименовать тип рабочего элемента
- Удаление типа рабочего элемента
Необходимые условия
| Категория | Требования |
|---|---|
| Разрешения | — Для вывода списка типов рабочих элементов: разрешение Просмотр информации на уровне проекта должно быть установлено на Разрешить. — Чтобы добавить или настроить тип рабочего элемента: член группы Project Collection Administrators или разрешение Изменение процесса установлено в Разрешить. |
Чтобы быть добавленным в качестве администратора, см. раздел Изменение разрешений на уровне коллекции проектов.
Изменение типов рабочих элементов влияет на существующие рабочие элементы
В следующей таблице приводится сводка влияния на существующие рабочие элементы при изменении полей или определений типов рабочих элементов.
| Действие | Влияние на существующие рабочие элементы |
|---|---|
| Удаление полей из типа рабочего элемента | Данные для удаленных полей остаются в хранилище данных. Однако поля больше не отображаются в определении типа рабочего элемента, поэтому новые данные не могут быть введены. |
| Переименование поля | Данные для переименованного поля остаются в хранилище данных под новым понятным именем. |
| Удаление полей | Данные для удаленных полей удаляются из хранилища данных. |
| Переименование типа рабочего элемента | Все данные остаются неизменными под новым именем. |
| Удаление типа рабочего элемента | Все данные для рабочих элементов, созданных с использованием удаленного типа рабочего элемента, окончательно удаляются без возможности восстановления. |
Чтобы полностью удалить поля из хранилища данных, используйте witadmin deletefield средство командной строки.
Импорт и экспорт файлов определения типов рабочих элементов
Заметка
Если вы используете модель процесса хостируемой XML, импортируйте и экспортируйте шаблон процесса, используемый проектом. Дополнительные сведения см. в разделе Настройкавеб-формы отслеживания рабочих элементов.
Если у вас нет прав администратора для вашего проекта, получите их.
- Откройте окно командной строки в соответствии с инструкциями, приведенными в witAdmin: Настройка и управление объектами для отслеживания работы. Например:
Экспортируйте файл определения типа рабочего элемента, в котором нужно изменить или добавить поле. Укажите имя типа рабочего элемента и имя файла.
witadmin exportwitd /collection:CollectionURL /p:ProjectName /n:TypeName /f:"DirectoryPath/FileName.xml"Примером CollectionURL является
http://MyServer:8080/tfs/TeamProjectCollectionName.Измените файл.
Импортируйте файл определения.
witadmin importwitd /collection:CollectionURL /p:ProjectName /f:"DirectoryPath/FileName.xml"Откройте веб-портал или обновите страницу, чтобы просмотреть изменения.
Дополнительные сведения об использовании
witadminсм. в импорте, экспорте и управлении типами рабочих элементов.
Добавление или изменение типа рабочего элемента
Чтобы добавить пользовательский тип рабочего элемента или изменить существующий, определите или измените XML-файл определения, а затем импортируйте его в проект на основе используемой модели процесса. Файл определения содержит три основных раздела: FIELDS, WORKFLOW и FORM.
Самый простой способ добавить новый рабочий элемент — скопировать существующий и изменить файл определения.
Добавление или изменение поля, правила поля, метки или пустого текста
Добавьте любое поле, которое вы хотите использовать для отслеживания данных в файл определения. Эта инструкция применяется ко всем полям, кроме системных (полям, имя ссылки которых начинается с System.). Все системные поля определяются для всех типов рабочих элементов, независимо от того, включены ли они в определение типа рабочего элемента. Дополнительные сведения о каждом поле см. в разделе "Индекс поля рабочего элемента".
Добавьте поля и правила полей в раздел FIELDS . Чтобы поле отображалось в форме рабочего элемента, добавьте его в раздел FORM определения.
Например, чтобы добавить идентификатор рабочего элемента в форму, укажите следующий синтаксис XML в разделе FORM.
<Control FieldName="System.ID" Type="FieldControl" Label="ID" LabelPosition="Left" />
Дополнительные сведения об определении полей см. в разделе "Добавление или изменение поля".
Изменение рабочего процесса
Разделы STATE и REASON в рабочем процессе указывают значения списка выбора в полях "Состояние и причина ". Эти разделы отслеживают состояние рабочих элементов. В разделе TRANSITIONS указаны допустимые переходы между состояниями, как показано на следующей схеме. Вы указываете как прямые, так и обратные переходы.
Измените рабочий процесс, чтобы выполнить следующие задачи:
- Добавление или удаление состояния, причины или перехода.
- Укажите значение поля для применения во время изменения состояния, причины или перехода.
- Укажите настраиваемое действие ACTION для автоматизации назначения полей при изменении состояния, причины или перехода.
При настройке рабочего процесса выполните следующие два шага.
изменить рабочий процесс определения типа рабочего элемента.
-
Этот второй шаг требуется при изменении рабочего процесса для типа рабочего элемента, который отображается на странице средства Agile. Эти типы рабочих элементов относятся к категориям "Требование" или "Задача".
Правила поля рабочего процесса
Правила полей можно применять при изменении состояния, указании причины или во время перехода рабочего процесса.
Например, добавив правило EMPTY, когда состояние установлено на "Активный", вы можете автоматически обнулить поля "Дата закрытия" и "Кто закрыл" и сделать их доступными только для чтения. Это правило полезно при повторной активации рабочего элемента из закрытого состояния.
<STATE value="Active">
<FIELDS>
. . .
<FIELD refname="Microsoft.VSTS.Common.ClosedDate"><EMPTY/></FIELD>
<FIELD refname="Microsoft.VSTS.Common.ClosedBy"><EMPTY/></FIELD>
</FIELDS>
</STATE>
Примените правила поля рабочего процесса для выполнения следующих действий:
- Уточните, какие значения может принимать поле, указав CANNOTLOSEVALUE, EMPTY, FROZEN, NOTSAMEAS, READONLY и REQUIRED.
- Скопируйте значение в поле с помощью COPY, DEFAULT и SERVERDEFAULT.
- Ограничение того, кто может изменить поле.
- Принудительное сопоставление шаблонов в строковом поле с помощью MATCH.
- Условно применять правила на основе значений в других полях с помощью WHEN, WHENNOT, WHENCHANGED и WHENNOTCHANGED.
- Ограничить применение правил для конкретных пользователей или групп. Большинство правил поддерживают атрибуты для или не, чтобы указать, к кому правило применяется или не применяется.
Дополнительные сведения о применении правил полей рабочего процесса см. в справочнике по элементам FIELD (Workflow) и Правила иоценки правил.
Настройка формы рабочего элемента
На следующем снимке экрана показаны наиболее распространенные элементы на формах рабочих элементов. Все из них можно настроить, кроме области заголовка и элементов управления формами. Элементы, используемые для настройки формы, зависят от того, включена ли новая форма.
Настройте форму для выполнения следующих задач:
- Добавление или изменение поля
- Изменение метки поля
- переупорядочение полей
- Добавление группы или страницы
- Добавить пользовательский элемент управления, группу или страницу
- Добавление информационного текста или гиперссылок
- Внедрение HTML-текста или отображение динамических отчетов
- Добавление страницы управления ссылками
Добавление или удаление типа рабочего элемента из невыполненной работы или доски задач
Средства планирования Agile — список требований продукта, список спринта и страницы доски задач — отображают специфические типы рабочих элементов на основе шаблона процесса, который используется для создания вашего проекта. На этих страницах можно добавлять или удалять типы рабочих элементов. Например, если в проекте используются типы рабочих элементов Scrum, элементы невыполненной работы продукта и ошибки отображаются на страницах невыполненной работы. Однако, если в проекте используется шаблон Agile, CMMI или другой процесс, ошибки не отображаются в перечне невыполненных работ или на доске задач.
Сведения о добавлении или удалении типов рабочих элементов из невыполненной работы или доски задач см. в статье "Добавление типа рабочего элемента в невыполненную работу и доска". Сведения о добавлении нового типа рабочего элемента для поддержки невыполненной работы портфеля см. в статье Добавление уровня невыполненной работы портфеля.
Изменение цвета, значка или цвета состояния рабочего процесса типа рабочего элемента
На веб-портале рабочие элементы отображаются в результатах запроса и на страницах невыполненной работы и доски инструментов Agile. Чтобы изменить цвет или значок, связанный с существующим типом рабочего элемента, или добавить цвет нового типа рабочего элемента, измените конфигурацию процесса. Чтобы изменить цвет состояния рабочего процесса, измените конфигурацию процесса.
Изменение типа существующего рабочего элемента
Сведения о функциях, доступных на основе платформы, см. в разделе «Массовый перенос рабочих элементов» и изменение типа рабочего элемента.
Деактивация или отключение типа рабочего элемента
Чтобы ограничить создание определенного типа рабочего элемента группой пользователей, добавьте тип рабочего элемента в группу скрытых категорий , чтобы запретить большинству участников создавать его. Чтобы предоставить доступ к определенной группе пользователей, создайте гиперссылку на шаблон , открывающий форму рабочего элемента, и поделитесь этой ссылкой с участниками группы, которым нужно создать ее.
Заметка
Не удается добавить правила полей, чтобы ограничить рабочий процесс, так как нельзя применять правила к системным полям.
Удаление типа рабочего элемента
Чтобы запретить членам группы использовать определенный тип рабочего элемента для создания рабочего элемента, удалите его из проекта.
При использовании witadmin destroywitdвы окончательно удалите все рабочие элементы, созданные с этим типом рабочего элемента, и сам тип рабочего элемента.
Например, если ваша команда не использует "Препятствие", удалите тип рабочего элемента с меткой "Препятствие" из проекта веб-сайта Fabrikam.
witadmin destroywitd /collection:"http://FabrikamPrime:8080/tfs/DefaultCollection" /p:"Fabrikam Web Site" /n:"Impediment"
При удалении типа рабочего элемента, относящееся к категории, обновите определение категорий для проекта, чтобы отразить удаление. Дополнительные сведения см. в разделе Импорт, экспорт и управление типами рабочих элементов и Импорт и экспорт категорий.
Переименование типа рабочего элемента
Чтобы переименовать существующий тип рабочего элемента, используйте witadmin renamewitd. Например, можно переименовать рабочий элемент с меткой "Элемент качества обслуживания" в "Соглашение об обслуживании".
witadmin renamewitd /collection:"http://FabrikamPrime:8080/tfs/DefaultCollection" /p:"Fabrikam Web Site" /n:"QoS Item" /new:"Service Agreement"
При переименовании типа рабочего элемента, который принадлежит категории, обновите определение категорий для проекта, чтобы отразить новое имя. Невыполненные задачи и доски не работают, пока вы не обновите определение категорий.
Дополнительные сведения см. в разделе Импорт, экспорт и управление типами рабочих элементов и Импорт и экспорт категорий.