Справочник по XML-элементам конфигурации процесса

Мақала
02/23/2023
Оқу үшін 21 минут

Azure DevOps Server 2022 - Azure DevOps Server 2019 | TFS 2018

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

Элементы конфигурации определяют типы рабочих элементов (WIT), столбцы по умолчанию, поля, используемые средствами, и другие элементы. Основные конфигурации определяют, какие элементы будут отображаться для невыполненной работы портфеля, продуктов и спринтов, определяя разделы PortfolioBacklog, RequirementBacklog и TaskBacklog XML-файла определения конфигурации процесса. Кроме того, конфигурация процесса определяет сопоставление рабочего процесса категории состояния и состояния для всех типов WIT, которым требуется сопоставление.

XML-элементы конфигурации процессов

Сводные сведения о том, что можно настроить с помощью пользовательского интерфейса, см. в разделах Настройка отслеживания работы, Добавление команд и настройка их средств Scrum и Kanban.

Области, которые можно настроить с помощью ProcessConfiguration:

Журналы невыполненных работ	Типы рабочих элементов (WIT)	Другие средства
- Настройка панели быстрого добавления - Определение столбцов по умолчанию - Сопоставление категорий состояний для категории WIT - Установка количества элементов доски задач - Задать выходные дни (Scrum)¹ - Задать значение по умолчанию Показывать ошибки в невыполненной работе¹ - Установка скрытых невыполненных работ по умолчанию¹	- Указание цвета WIT - Укажите цвет состояния рабочего процесса² - Укажите значок WIT³	- Назначение полей средств Agile - Сопоставление категорий состояний для конкретного средства - Указание свойств

Примечание

Элементы, отмеченные звездочкой, задают значение по умолчанию для проекта. Эти элементы можно изменить для каждой команды с помощью параметров команды.
Поддерживается для размещенного XML и локального XML для TFS 2015.2 или более поздней версии.
Поддерживается для размещенного XML и локального XML для TFS 2017.2 или более поздней версии.

Важно!

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

Обновление конфигурации процесса

Примечание

Чтобы получить доступ к последней версии шаблонов процессов, установите последнюю версию TFS и скачайте шаблоны с помощью диспетчера шаблонов процессов.

Чтобы обновить конфигурацию процесса для проекта, экспортируйте XML-файл определения, измените его, а затем импортируйте файл. Эти файлы можно экспортировать путем экспорта процесса или файла определения конфигурации процесса.

Обновление и проверка изменений

Совет

С помощью witadmin можно импортировать и экспортировать файлы определений. Другие средства, которые можно использовать, включают редактор процессов (требуется, чтобы у вас была установлена версия Visual Studio). Установите редактор шаблонов процессов TFS из Visual Studio Marketplace. Эту версию редактора процессов можно использовать для изменения форм рабочих элементов старого стиля. Его нельзя использовать для редактирования форм, связанных с новыми веб-формами.

Вы также можете использовать диспетчер командных проектов TFS, клиент с открытым кодом, доступный в GitHub.

Настройка невыполненной работы

Можно настроить следующие элементы для невыполненной работы портфеля, продукта и спринта.

Сопоставления категорий состояний. Сопоставление состояний рабочего процесса с категориями состояний (ранее называлось метасостояние). Эти сопоставления поддерживают отображение всех средств планирования Agile, включая канбан-доску и доску задач.
Панель быстрого добавления. Укажите поля WIT и рабочих элементов, которые отображаются для быстрого добавления элементов в невыполненную работу.

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

Страницы невыполненной работы настраиваются в разделах XML, показанных в следующем примере.

<PortfolioBacklogs>
      <PortfolioBacklog category="Microsoft.EpicCategory" pluralName="Epics" singularName="Epic" workItemCountLimit="1000">
. . . 
      </PortfolioBacklog>
      <PortfolioBacklog category="Microsoft.FeatureCategory" pluralName="Features" singularName="Feature" parent="Microsoft.EpicCategory" workItemCountLimit="1000">
. . . 
      </PortfolioBacklog>
</PortfolioBacklogs>
<RequirementBacklog category="Microsoft.RequirementCategory" pluralName="Stories" singularName="User Story" workItemCountLimit="1000">
. . . 
</RequirementBacklog>
<TaskBacklog category="Microsoft.TaskCategory" pluralName="Tasks" singularName="Task" workItemCountLimit="1000">
. . . 
</TaskBacklog>

Примечание

В зависимости от процесса, связанного с файлом ProcessConfiguration (Agile, Scrum или CMMI), pluralName для RequirementCategory будет соответствовать Stories (Agile), Backlog Items (Scrum) или Requirements (CMMI). Все три похожи: они описывают ценность для клиента и выполняемую работу.

Синтаксис элементов PortfolioBacklogs

Элемент

Описание

PortfolioBacklogs

Необязательный элемент. Элемент-контейнер для невыполненной работы портфеля.

PortfolioBacklog

Необязательный элемент. До 5 экземпляров.

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

<PortfolioBacklog category="PortfolioCategory" parent="ParentCategory"  
pluralName="PluralName" singularName="SingleName" workItemCountLimit="MaximumLimit>  
<States> . . . </States>  
<Columns> . . . </Columns>  
<AddPanel> . . . </ AddPanel>  
</PortfolioBacklog >

Присвойте значения атрибутам согласно следующему описанию.

category: укажите имя категории, определенной в файле определения категорий для проекта, содержащего WIT, которые будут связаны с этим типом невыполненной работы.
parent. Укажите имя категории, представляющей невыполненную работу родительского портфеля в иерархии.
pluralName. Укажите метку множественного числа, используемую при ссылке на WIT, связанные с этим типом невыполненной работы. Например, истории, цели, инициативы или эпопеи.
singularName: укажите метку единственного числа, используемую при ссылке на WIT, связанные с этим типом невыполненной работы. Например, история, цель, инициатива или эпопея.
workItemCountLimit: укажите целое число. Значение по умолчанию — 1000. Число отображаемых элементов на страницах невыполненной работы и досках ограничивается этим значением.

RequirementBacklog

Обязательный. Только один экземпляр.

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

<RequirementBacklog category="RequirementCategory"  
pluralName="PluralName" singularName="SingleName"   
workItemCountLimit="MaximumLimit" >  
<States> . . . </States>
<Columns> . . . </Columns>
<AddPanel> . . . </ AddPanel>
</RequirementBacklog >

TaskBacklog

Обязательный. Только один экземпляр.

Элемент Container, используемый для настройки макета невыполненной работы по спринту.

<TaskBacklog category="Microsoft.TaskCategory" pluralName="Tasks" 
singularName="Task workItemCountLimit="MaximumLimit">
. . . 
</TaskBacklog >

Примечания по реализации

По умолчанию для невыполненной работы существует ограничение в 1000 рабочих элементов. Это ограничение можно изменить, указав значение атрибута workItemCountLimit .
Значения, присвоенные CategoryName , должны соответствовать группе категорий, определенной для проекта. Группы категорий указываются в файле определения для параметра Категории.
Невыполненная работа по портфелям используется для упорядочения невыполненной работы, просмотра свертывания элементов невыполненной работы на более низких уровнях и для просмотра хода выполнения в нескольких командах. Новые и обновленные проекты содержат два уровня невыполненной работы в портфеле: Функции и Epics. Можно добавить до трех дополнительных уровней. Только невыполненная работа портфеля верхнего уровня не указывает родительскую категорию.
Невыполненная работа по продукту соответствует вашему плану проекта, плану, который планирует реализовать ваша команда. В ней перечисляются рабочие элементы, типы которых принадлежат к категории "Требования". Чтобы управлять wit, отличающимся от тех, которые предоставляются проектом по умолчанию, можно добавить WIT в категорию "Требования" и сопоставить состояния рабочего процесса с категориями состояний.
Невыполненная работа по спринту или итерации отображает как набор требований, которые вы и ваша команда выполнили в определенном цикле спринта, так и задачи, связанные с этими требованиями. Задачи необходимо связать с требованиями, используя тип связи "родитель-потомок". Поскольку типы рабочих элементов, отображаемые на этих страницах, соответствуют типам, отображаемым в невыполненной работе по продукту, основная часть действий по настройке, выполняемых для невыполненной работы по продукту, состоит в определении функциональности невыполненной работы спринта.

Сопоставление состояний рабочего процесса категории WIT с категориями состояний

Несколько WIT требуют, чтобы их состояния рабочего процесса сопоставлялись с категорией состояний. Состояния рабочего процесса определяют, как рабочий элемент переходит от первой активации или создания в состояние закрытия или завершения. Например, состояния, определенные для элемента невыполненной работы по продукту Scrum, определяют переход от четырех состояний от New, Approved, Committed до Done, а также включают пятое состояние Удалено для учета состояния, удаленного из невыполненной работы без реализации. Состояния рабочего процесса связаны с атрибутом value .

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

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

<RequirementBacklog category="Microsoft.RequirementCategory" pluralName="Backlog items" singularName="Backlog item">
      <States>
      <State value="New" type="Proposed" />
      <State value="Approved" type="Proposed" />
      <State value="Committed" type="InProgress" />
      <State value="Done" type="Complete" />
      </States>
 . . .
</RequirementBacklog>

Существует три группы категорий состояний: Agile, Bug и Feedback. В следующей таблице описывается сопоставление атрибутов и значений.

Синтаксис элементов States (категория WIT)

Элемент

Описание

Состояние

Обязательный. Назначает состояние рабочего процесса категории состояния.

<State value="ValueName" type="TypeName" />

Допустимые значения valueName соответствуют значению, присвоенному STATE в разделе WORKFLOW этих значений WIT, назначенных группе категорий.

Допустимые значения typeName соответствуют одному из следующих перечисленных значений:

Гибкая разработка: используется для всех типов рабочих элементов.
Предлагаемое: указывает рабочие элементы, которые являются новыми, еще не зафиксированными или еще не обрабатываются.
InProgress: указывает рабочие элементы, которые были зафиксированы или над которыми активно работают.
Завершено: указывает реализованные рабочие элементы. Чтобы канбан-доска была допустимой, ровно одно состояние рабочего процесса должно быть сопоставлено с категорией Состояние завершено . Если необходимо представить дополнительные состояния рабочего процесса, их можно сопоставить с категорией Разрешенные состояния.
После перехода рабочего процесса в состояние, связанное с метасостоянием Complete , связанный рабочий элемент будет выходить из списка невыполненных работ по продукту. Однако он будет по-прежнему указан в последнем столбце на канбан-доске.

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

Примечание

Категорию Состояние Разрешено можно назначить только состоянию рабочего процесса, указанному в элементе BugWorkItems .

Отзыв: используется только для типов рабочих элементов, сгруппированных в категориях «Запрос на отзыв» и «Ответ на отзыв». Запрошено, Получено, Проверено и Отклонено.

Состояния

Задает коллекцию элементов State , которые связывают состояния рабочего процесса WIT с категориями состояний.

Обязательный элемент для следующих родительских элементов:

BugWorkItems
PortfolioBacklog
RequirementBacklog
TaskBacklog
TestPlanWorkItems
TestSuiteWorkIteMs
FeedbackRequestWorkItems
FeedbackResponseWorkItems

Установка столбцов по умолчанию

Укажите поля, которые нужно отображать в каждой невыполненной работы в разделе Столбцы . Изменения, внесенные в диалоговом окне Параметры столбца , сохраняются до тех пор, пока вы не измените их снова.

Столбцы и последовательность по умолчанию для страницы невыполненной работы

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

<Columns>
      <Column refname="Microsoft.VSTS.Common.Priority" width="400" />
      <Column refname="System.Title" width="400" />
      <Column refname="System.State" width="100" />
      <Column refname="Microsoft.VSTS.Scheduling.Effort" width="50" />
      <Column refname="System.IterationPath" width="200" />
</Columns>

Синтаксис для элементов Columns

Элемент

Описание

Столбцы

Задает коллекцию элементов Column . Обязательный элемент для элементов невыполненной работы: PortfolioBacklog, RequirementBacklog и TaskBacklog.

Столбец

Указывает поле для отображения в виде столбца в невыполненной работе.

<Column refname="FieldReferenceName"  width="FieldWidth" />

Заголовки столбцов доски задач

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

Настройка панели быстрого добавления

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

Панель невыполненной работы, к которой добавлено поле

На панели отображаются только поля, включенные в раздел ПОЛЯ определения WIT для выбранного WIT. Например, если выбрать WIT ошибки, отображается только Название, так как бизнес-значение не определено для ошибок. Чтобы добавить еще один элемент WIT на панель, добавьте его в категорию "Требования", как описано в разделе Добавление типа рабочего элемента в невыполненную работу и доску.

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

<AddPanel>
      <Fields>
      <Field refname="System.Title" />
      </Fields>
</AddPanel>

Синтаксис для элементов AddPanel

Элемент

Описание

AddPanel

Элемент container, используемый для указания возможности быстрого добавления, — полей, отображаемых в области панели, где определены новые элементы невыполненной работы.

Fields

Задает коллекцию элементов Field .

Поле

Задает поле рабочего элемента для отображения на панели для невыполненной работы по продукту.

<Field refname="FieldReferenceName"/>

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

Задание количества рабочих элементов на доске задач

Чтобы не снижалась производительность, для доски задач введено ограничение на отображение максимум 1000 рабочих элементов. При открытии доски задач все рабочие элементы загружаются в кэш. Ограничение количества рабочих элементов может сократить время загрузки. Это ограничение можно изменить, указав значение атрибута workItemCountLimit элемента TaskBacklog .

Например, можно уменьшить ограничение, указав workItemCountLimit="800":

<TaskBacklog category="Microsoft.TaskCategory" pluralName="Tasks" singularName="Task" workItemCountLimit="800" >
. . .
</TaskBacklog>

Сопоставление категорий состояний для типов рабочих элементов для конкретных инструментов

Сопоставления категорий состояния определяются для дополнительных категорий WIT. Для шаблона процессов Scrum они включают сопоставления для категорий запросов и ответов на отзыв. Для шаблонов процессов MSF Agile и CMMI они также содержат сопоставления для категории ошибок. (Scrum включает ошибки в категорию требований и, следовательно, определяет сопоставления категорий состояний в разделе RequirementBacklog .)

<FeedbackRequestWorkItems category="Microsoft.FeedbackRequestCategory" pluralName="Feedback Requests" singularName="Feedback Request">
      <States>
      <State value="Active" type="InProgress" />
      <State value="Closed" type="Complete" />
      </States>
</FeedbackRequestWorkItems>
<FeedbackResponseWorkItems category="Microsoft.FeedbackResponseCategory" pluralName="Feedback Responses" singularName="Feedback Response">
      <States>
      <State value="Active" type="InProgress" />
      <State value="Closed" type="Complete" />
      </States>
</FeedbackResponseWorkItems>

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

Синтаксис для элементов сопоставления категорий состояния для конкретного средства

Элемент

Описание

BugWorkItems

Необязательный элемент. Элемент Container, определяющий сопоставления категорий состояния для типов рабочих элементов, назначенных категории ошибок. Помимо того, как эти сопоставления используются при отображении средств Agile, они также управляют тем, как функция "Моя работа" в Team Explorer обновляет состояние ошибки по мере перемещения ошибок разработчиками с помощью "Моя работа". Дополнительные сведения см. в статье Проверка кода (TFVC).

<BugWorkItems category="CategoryName"  
pluralName="PluralName" singularName="SingleName">
<States>
. . .
</States>
</BugWorkItems>

FeedbackRequestWorkItems

Обязательный. Не настраивайте. Элемент container, определяющий сопоставления категорий состояния для типов рабочих элементов, назначенных категории запроса обратной связи.

<FeedbackResponseWorkItems category="CategoryName"  
pluralName="PluralName" singularName="SingleName">
<States>
. . .
</States>
</FeedbackRequestWorkItems>

FeedbackResponseWorkItems

Обязательный элемент. Не настраивайте. Элемент container, определяющий сопоставления категорий состояния для типов рабочих элементов, назначенных категории ответа обратной связи.

<FeedbackResponseWorkItems category="CategoryName"  
pluralName="PluralName" singularName="SingleName">
<States>
. . .
</States>
</FeedbackResponseWorkItems>```

TestPlanWorkItems

Требуется только при настройке состояния рабочего процесса для плана тестирования и поддержке подключений к проекту из версий Диспетчера тестов, установленных с Visual Studio 2013.2 или более ранних версий.

Элемент Container, определяющий сопоставления категорий состояния для типов рабочих элементов, назначенных категории плана тестирования. Пример:

<TestPlanWorkItems category="Microsoft.TestPlanCategory"  
pluralName="Test Plans" singularName="Test Plan">
<States>
<State type="InProgress" value="Design" />
<State type="InProgress" value="Testing" />
<State type="Complete" value="Signed Off" />
</States>
</TestPlanWorkItems>

TestSuiteWorkIteMs

Требуется только при настройке состояния рабочего процесса для набора тестов и поддержке подключений к проекту из версий Диспетчера тестов, установленных с Visual Studio 2013.2 или более ранних версий.

Элемент Container, определяющий сопоставления категорий состояния для типов рабочих элементов, назначенных категории набора тестов. Пример:

<TestSuiteWorkItems  
category="Microsoft.TestSuiteCategory"  
pluralName="Test Suites" singularName="Test Suite">
<States>
<State type="Proposed" value="Authoring" />
<State type="InProgress" value="Testing" />
<State type="Complete" value="Completed" />
</States>
</TestSuiteWorkItems>

Примечание

Доступность компонентов: Чтобы сопоставить категории состояний для TestPlanWorkItems или TestSuiteWorkItems, необходимо обновить сервер уровня приложений до TFS 2013.3 или более поздней версии. После этого можно настраивать состояния рабочего процесса для плана тестирования и наборов тестов. Дополнительные сведения см. в разделе План тестирования и функции набора тестов.

Назначение полей средств Agile

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

Например, если вы измените назначенный refname на type="Activity" , то следует включить то же поле в определение WIT, назначенное категории задачи, которая собирает сведения о действии.

<TypeFields>
    <TypeField refname="System.AreaPath" type="Team" />
    <TypeField refname="Microsoft.VSTS.Scheduling.RemainingWork" type="RemainingWork" format="format h" />
    <TypeField refname=" Microsoft.VSTS.Common.BacklogPriority" type="Order" />
    <TypeField refname="Microsoft.VSTS.Scheduling.Effort" type="Effort" />
    <TypeField refname="Microsoft.VSTS.Common.Activity" type="Activity" />
    <TypeField refname="Microsoft.VSTS.Feedback.ApplicationStartInformation" type="ApplicationStartInformation" />
    <TypeField refname="Microsoft.VSTS.Feedback.ApplicationLaunchInstructions" type="ApplicationLaunchInstructions" />
    <TypeField refname="Microsoft.VSTS.Feedback.ApplicationType" type="ApplicationType">
        <TypeFieldValues>
            <TypeFieldValue value="Web application" type="WebApp" />
            <TypeFieldValue value="Remote machine" type="RemoteMachine" />
            <TypeFieldValue value="Client application" type="ClientApp" />
        </TypeFieldValues>
    </TypeField>
</TypeFields>

Синтаксис для элементов TypeFields

Элемент

Описание

TypeFields

Обязательный. Задает коллекцию элементов TypeField .

TypeField

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

<TypeField refname="FieldReferenceName"  
type="NameOfType" [format="{0} TimeUnitString"] / >

Укажите формат только в том случае, если type="RemainingWork". Вы можете указать любую текстовую строку для TimeUnitString , которая будет отображаться на столбцах емкости текущей невыполненной работы по спринту и на доске задач.

Для средств Agile

Действие: используется для поддержки функции емкости по активности. Укажите поле, используемое в типе рабочего элемента, назначенном категории задач.

Примечание

Значения, отображаемые средством Capacity, отражают объединение всех значений, определенных для поля во всех проектах в экземпляре коллекции проектов. Таким образом, чтобы ограничить значения, отображаемые для емкости спринта, необходимо обеспечить совпадение значений во всех проектах для поля, назначенного параметру type="Activity".

Усилия: используется для вычисления скорости команды. Укажите поле, используемое в типе рабочего элемента, назначенном категории требований, применяемой для фиксации расчетного объема трудозатрат, баллов истории или объема работы, которая должна быть выполнена по элементу невыполненной работы.
Order: используется для определения порядка сортировки элементов на невыполненных работах и досках. Система перечисляет рабочие элементы на странице в порядке возрастания, как определено данным полем для этого типа.

Примечание

Элементы можно перемещать, перетаскивая их вверх или вниз списка в невыполненной работе или на доске. При перемещении элементов фоновый процесс обновляет поле, назначенное объекту type="Order".

Оставшаяся работа: используется для вычисления оставшихся трудоемких работ и диаграмм сгорания. Укажите поле, используемое в типе рабочего элемента, назначенном категории задач, применяемой для фиксации часов, дней и других единиц измерения оставшейся работы.
Значение, указанное в параметре format , используется в невыполненных работах и досках задач в спринте, где бы ни сообщалось о оставшихся работах. Например, при создании отчетов о производительности в зависимости от активности или производительности на члена команды или рядом с заголовком столбца для состояний задачи на доске задач.
В поле TimeUnitString укажите любую текстовую строку, которая будет использоваться для отражения значения времени, например часы или дни.
Например, допустимы все приведенные ниже значения:
format="{0} h"
format="{0} hours"
format="hours {0}"
format="time {0}"
Команда. Используется для связывания невыполненной работы с командой. Значение по умолчанию — System.AreaPath. Чтобы отделить команды от путей к областям, можно указать другое поле, как описано в разделе Использование полей команды вместо путей к областям для групп поддержки.
Для формы запроса на отзыв

Примечание

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

ApplicationStartInformation: используется для записи пути к выполнению приложения.
ApplicationLaunchInstructions: используется для записи инструкций по запуску.
ApplicationType: используется для записи типа приложения. Перечисленные типы соответствуют разрешенным значениям, указанным в определении типа рабочего элемента для запроса на отзыв.

TypeFieldValues

Требуется для TypeFieldValue , если type="ApplicationType". Указывает коллекцию элементов TypeFieldValue , которые используются в форме запроса обратной связи.

TypeFieldValue

Обязательный элемент. Не настраивайте. Задает имя типа приложения для отображения в форме запроса на отзыв.

<TypeFieldValue value="ApplicationTypeName" type="TypeApp"/>

Назначения по умолчанию соответствуют разрешенным значениям, указанным в определении типа для формы запроса на отзыв.

<TypeFieldValues>
<TypeFieldValue value="Web application" type="WebApp" />
<TypeFieldValue value="Remote machine" type="RemoteMachine" />
<TypeFieldValue value="Client application" type="ClientApp" />
</TypeFieldValues>

Примечания по реализации

При изменении поля в разделе TypeFields необходимо внести соответствующее изменение в определение WIT. Например, если изменить поля, назначенные для записи трудозатрат, то следует внести те же изменения в определения WIT для элемента невыполненной работы продукта и ошибки (для Scrum).
Вы можете найти имя ссылки для поля, используя этот индекс.

Установка нерабочих дней

Нерабочие дни удаляются из расчетов, выполняемых средством планирования емкости , и диаграммами сгорания. В процессах по умолчанию — Agile, Scrum или CMMI — суббота и воскресенье указываются как нерабочие дни. После создания проекта каждая команда может задать свои нерабочие дни.

<Weekends>
   <DayOfWeek>Saturday</DayOfWeek>
   <DayOfWeek>Sunday</DayOfWeek>
</Weekends>

Синтаксис для элементов Weekends

Элемент

Описание

DayOfWeek

Обязательный дочерний элемент элемента Weekends .

Указывает день недели, соответствующий нерабочему дню.

<DayOfWeek>NameOfADay</DayOfWeek>

Допустимые имена соответствуют английским дням недели: воскресенье, понедельник, вторник, среда, четверг, пятница и суббота.

Примечание

День недели необходимо указывать на английском языке независимо от установленного языка локального развертывания TFS.

выходные дни;

Необязательный элемент. Элемент-контейнер, используемый для указания нерабочих дней.

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

Изменение цвета для типа рабочего элемента

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

В шаблоне процесса Scrum определяются указанные ниже назначения цветов. Аналогичные назначения выполняются для шаблонов Agile и CMMI.

<WorkItemColors>
      <WorkItemColor primary="FF009CCC" secondary="FFD6ECF2" name="ProductBacklogItem" />
      <WorkItemColor primary="FF773B93" secondary="FFEEE2F2" name="Feature" />
   <WorkItemColor primary="FFFF7B00" secondary="FFFFD7B5" name="Epic" />
      <WorkItemColor primary="FFF2CB1D" secondary="FFF6F5D2" name="Task" />
      <WorkItemColor primary="FFCC293D" secondary="FFFAEAE5" name="Bug" />
      <WorkItemColor primary="FFFF9D00" secondary="FFFCEECF" name="Code Review Request" />
      <WorkItemColor primary="FFFF9D00" secondary="FFFCEECF" name="Code Review Response" />
      <WorkItemColor primary="FFFF9D00" secondary="FFFCEECF" name="Feedback Request" />
      <WorkItemColor primary="FFFF9D00" secondary="FFFCEECF" name="Feedback Response" />
      <WorkItemColor primary="FFFF9D00" secondary="FFFCEECF" name="Impediment" />
      <WorkItemColor primary="FFFF9D00" secondary="FFFCEECF" name="Shared Step" />
      <WorkItemColor primary="FFFF9D00" secondary="FFFCEECF" name="Test Case" />
   <WorkItemColor primary="FFFF9D00" secondary="FFFCEECF" name="Test Plan" />
   <WorkItemColor primary="FFFF9D00" secondary="FFFCEECF" name="Test Suite" />
   <WorkItemColor primary="FFFF9D00" secondary="FFFCEECF" name="Shared Parameter" />
</WorkItemColors>

Синтаксис для элементов WorkItemColors

Элемент

Описание

WorkItemColors

Необязательный элемент. Элемент-контейнер для указания цветов для типов рабочих элементов.

WorkItemColor

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

При указании цвета всегда префикс шестизначного шестнадцатеричного кода цвета с помощью FF , который указывает, что цвет должен быть полностью видимым.

<WorkItemColor primary="HexColorCode" secondary="HexColorCode"  
name="witName" />

Указание свойств и поведения

Первые два свойства, которые можно задать, BugsBehavior и HiddenBacklogs задать значение по умолчанию для проекта. Однако каждая команда может изменить поведение с помощью параметров команды. Третье свойство StateColors определяет цвета, связанные с состояниями рабочего процесса для всех типов WIT. Заданные значения используются для всех команд в проекте.

Пример Properties конфигурации:

 <Properties>  
      <Property name="BugsBehavior" value="AsTasks" />  
      <Property name="HiddenBacklogs" value="Microsoft.EpicCategory" />  
      <Property name="StateColors" value="Active=#FF00FF00,Resolved=#FFFF0000" />
      <Property name="WorkItemTypeIcons" value="Epic=Icon_Crown,Feature=Icon_Trophy,User Story=icon_book,
        Task=icon_clipboard,Bug=icon_insect,Issue=icon_traffic_cone,
        Test Plan=icon_test_plan,Test Suite=icon_test_suite,Test Case=icon_test_case,Shared Steps=icon_test_step,
        Shared Parameter=icon_test_parameter" />  
  </Properties>

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

Свойство HiddenBacklogs определяет, какие невыполненная работа или невыполненная работа портфеля отображаются по умолчанию. По умолчанию отображается только невыполненная работа по продукту и один уровень невыполненной работы портфеля — список невыполненных работ по функциям. Команды могут определить, нужно ли активировать невыполненную работу Epics или внести другие изменения. Дополнительные сведения см. в разделах Упорядочение невыполненной работы и Активация уровней невыполненной работы для команды.

Синтаксис для элементов Properties

Элемент

Описание

Свойства

Необязательный элемент. Элемент-контейнер для указания свойств и вариантов поведения по умолчанию.

Свойство

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

Допустимые имена свойств:

BugsBehavior задает значение по умолчанию для параметра Показывать ошибки на невыполненной работе и доске. Допустимые значения соответствуют:
AsRequirements — ошибки появляются на невыполненных работах и на досках, аналогичных требованиям (по умолчанию для процесса Scrum).
AsTasks — ошибки появляются на невыполненных работах и досках, аналогичных задачам (по умолчанию для процессов Agile и CMMI).
Выкл . — ошибки не отображаются в невыполненных работах или на досках
HiddenBacklogs указывает невыполненную работу, которая по умолчанию неактивна.
StateColors задает значения цвета для состояний рабочего процесса. (Требуется TFS 2017 или более поздней версии)
Значение свойства представляет собой разделенный запятыми список имен состояний и шестнадцатеричных цветов. Префикс шестизначного шестнадцатеричного кода цвета с помощью FF, который указывает, что цвет должен быть полностью видимым.
<Property name="StateColors" value="stateName1=color1, stateName2=color2,..." />

Примечание

Доступность компонентов: Вы можете указать цвета состояния рабочего процесса, если используется размещенный XML- или для локального XML-кода вы обновили TFS 2015.2 или более поздней версии.
Дополнительные сведения см. в следующем разделе Указание цветов состояния рабочего процесса.

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

<Property name="WorkItemTypeIcons" 
value="Epic=Icon_Crown,Feature=Icon_Trophy,  
User Story=icon_book,Task=icon_clipboard,Bug=icon_insect,  
Issue=icon_traffic_cone,Test Plan=icon_test_plan,Test Suite=icon_test_suite,  
Test Case=icon_test_beaker,Shared Steps=icon_test_step,Shared Parameter=icon_test_parameter" />

Примечание

Доступность компонентов: Вы можете настроить значки, используемые для типов рабочих элементов, если используется размещенный XML-код или для локального XML-кода вы обновили до TFS 2017.2 или более поздней версии.

Указание цветов состояния рабочего процесса

Примечание

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

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

Форма рабочего элемента (веб-портал, см . раздел Новый интерфейс рабочего элемента)
Элемент управления "Ссылки на форму рабочего элемента" (веб-портал, см. справочник по XML-элементам LinksControlOptions)
Карточки, отображаемые на канбан-доске и досках задач (параметры см. в разделе Настройка карточек)
Все невыполненная работа (добавление состояния с помощью параметров столбца)
Результаты запроса (добавление состояния с помощью параметров столбца)

Ниже показано, как он отображается в форме рабочего элемента:

Заголовок формы рабочего элемента ошибки, показан цвет состояния

Примечание

Цвета не отображаются в формах рабочих элементов клиента или в старом элементе управления "Ссылки" в клиентской форме.

Подробности:

Необходимо указать цвет в виде восьмизначного шестнадцатеричного значения, аналогичного используемому для цвета, определенного для WIT.
Чтобы добавить или изменить цвета, просто повторно импортируйте конфигурацию процесса с обновленным свойством.
Цвета состояния определяются по имени во всех типах рабочих элементов, т. е. не существует способа, чтобы "Активный" был одним цветом для пользовательской истории и другим цветом для ошибки
Несопоставленные цвета по умолчанию во время выполнения на основе сопоставления мета-состояний
Для состояний без определения цвета и сопоставления мета-состояний будет отображаться пустой круг.

Указание значков WIT

Примечание

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

icon_airplane, icon_asterisk, icon_book, icon_car, icon_chart, icon_chat_bubble, icon_check_box, icon_clipboard, icon_code_response, icon_code_review icon_palette, icon_crown, icon_database_storage, icon_diamond, icon_flame, icon_gavel, icon_gear, icon_gift, icon_government, icon_headphone icon_insect, icon_key, icon_list, icon_megaphone, icon_paint_brush icon_parachute, icon_response, icon_review, icon_ribbon, icon_sticky_note icon_star, icon_test_beaker, icon_test_parameter, icon_test_plan, icon_test_step, icon_test_suite, icon_traffic_cone icon_trophy

Примечание

Значки, отмеченные звездочкой, поддерживаются в Azure DevOps Services и TFS 2017.3 и более поздних версиях.

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

Например, здесь вы увидите представление списка...

Веб-портал, список рабочих элементов со значками

и, здесь значок отображается в форме рабочего элемента.

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

Если вы добавили пользовательский WIT и хотите добавить его в невыполненную работу или на доску задач, это возможно. Вы просто не можете, чтобы они отображались в обоих местах. Узнайте, как это сделать, из статьи Добавление типов рабочих элементов в невыполненную работу и доски.

Справочник по XML-элементам конфигурации процесса

Обновление конфигурации процесса

Настройка невыполненной работы

Синтаксис элементов PortfolioBacklogs

Примечания по реализации

Сопоставление состояний рабочего процесса категории WIT с категориями состояний

Синтаксис элементов States (категория WIT)

Установка столбцов по умолчанию

Синтаксис для элементов Columns

Настройка панели быстрого добавления

Синтаксис для элементов AddPanel

Задание количества рабочих элементов на доске задач

Сопоставление категорий состояний для типов рабочих элементов для конкретных инструментов

Синтаксис для элементов сопоставления категорий состояния для конкретного средства

Назначение полей средств Agile

Синтаксис для элементов TypeFields

Примечания по реализации

Установка нерабочих дней

Синтаксис для элементов Weekends

Изменение цвета для типа рабочего элемента

Синтаксис для элементов WorkItemColors

Указание свойств и поведения

Синтаксис для элементов Properties

Указание цветов состояния рабочего процесса

Указание значков WIT

Қосымша ресурстар

Қосымша ресурстар

Справочник по XML-элементам конфигурации процесса

Обновление конфигурации процесса

Настройка невыполненной работы

Синтаксис элементов PortfolioBacklogs

Примечания по реализации

Сопоставление состояний рабочего процесса категории WIT с категориями состояний

Синтаксис элементов States (категория WIT)

Установка столбцов по умолчанию

Синтаксис для элементов Columns

Настройка панели быстрого добавления

Синтаксис для элементов AddPanel

Задание количества рабочих элементов на доске задач

Сопоставление категорий состояний для типов рабочих элементов для конкретных инструментов

Синтаксис для элементов сопоставления категорий состояния для конкретного средства

Назначение полей средств Agile

Синтаксис для элементов TypeFields

Примечания по реализации

Установка нерабочих дней

Синтаксис для элементов Weekends

Изменение цвета для типа рабочего элемента

Синтаксис для элементов WorkItemColors

Указание свойств и поведения

Синтаксис для элементов Properties

Указание цветов состояния рабочего процесса

Указание значков WIT

Похожие статьи

Қосымша ресурстар

Қосымша ресурстар