Справочник по XML-элементам конфигурации процесса
Конфигурация процессов определяет конфигурацию по умолчанию и функциональные возможности, к которым ваши команды могут обращаться при помощи средств планирования Agile. Эти средства, которые доступны из веб-портала, включают невыполненную работу по продукту, невыполненную работу спринта, канбан-доску и доску задач. Эти средства становятся доступными при создании командного проекта в Visual Studio Online или в локальном развертывании Team Foundation Server (TFS).
Элементы конфигурации определяют типы рабочих элементов (WIT), столбцы по умолчанию, поля, используемые средствами, и другие элементы. Основные конфигурации определяют, какие элементы будут отображаться для невыполненной работы портфеля, продукта и спринта, путем определения разделов PortfolioBacklog, RequirementBacklog и TaskBacklog XML-файла определения конфигурации процесса. Кроме того, конфигурация процесса определяет сопоставления состояний рабочих процессов метасостояниям для всех типов рабочих элементов (WIT), требующих сопоставления.
Configure and customize Agile tools for a team project содержит общие сведения о том, какие элементы можно настроить через пользовательский интерфейс и что требует настройки путем определения в файле ProcessConfiguration.
Области, которые можно настраивать с помощью ProcessConfiguration:
Настройка невыполненной работы
|
|
Чтобы обновить конфигурацию процесса, экспортируйте файл определения XML, отредактируйте его и затем импортируйте. Для witadminимпорта и экспорта файла используется команда командной строки .
Примечание
Примеры синтаксиса, показанные в этом разделе, соответствуют назначениям по умолчанию, определенным в шаблоне процесса Scrum.Для получения последней версии шаблонов процесса установите последнюю версию Team Foundation Server и загрузите шаблоны с помощью диспетчера шаблонов процессов.
Настройка невыполненной работы
Можно настроить следующие элементы для невыполненной работы портфеля, продукта и спринта.
Сопоставления метасостояний: сопоставление состояний рабочих процессов метасостояниям. Эти сопоставления поддерживают отображение всех средств планирования Agile, включая канбан-доску и доску задач.
Панель быстрого добавления: укажите типы и поля рабочих элементов, которые отображаются для быстрого добавления элементов на страницу невыполненной работы.
Чтобы изменить типы рабочих элементов, которые считаются элементами или задачами невыполненной работы, добавьте их в соответствующую категорию. Пример см. в разделе Добавление ошибок на страницу доски задач или невыполненной работы.
Поля столбцов: определите поля по умолчанию и последовательность столбцов.
Страницы невыполненной работы настраиваются в разделах 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>
Элемент |
Описание |
---|---|
PortfolioBacklogs |
Необязательно. Элемент-контейнер для невыполненной работы портфеля. |
PortfolioBacklog |
Необязательно. До 5 экземпляров. Элемент-контейнер, определяющий сопоставления метасостояний, столбцы по умолчанию и панель быстрого добавления для невыполненной работы портфеля.
Присвойте значения атрибутам согласно следующему описанию.
|
RequirementBacklog |
Обязательный. Только один экземпляр. Элемент-контейнер, определяющий сопоставления метасостояний, столбцы по умолчанию и панель быстрого добавления для невыполненной работы по продукту. На странице невыполненной работы по продукту отображаются все активные элементы невыполненной работы команды.
|
TaskBacklog |
Обязательный. Только один экземпляр. Элемент-контейнер, используемый для настройки макета невыполненных работ спринта.
|
Примечания по реализации
По умолчанию для невыполненной работы существует ограничение в 1000 рабочих элементов. Это ограничение можно изменить, задав значение для атрибута workItemCountLimit.
Значения, присваиваемые элементу CategoryName, должны соответствовать группе категорий, определенной для командного проекта. Группы категорий указываются в файле определений для категорий.
Страницы невыполненной работы портфеля используются для организации невыполненной работы, просмотра сведений элементов невыполненной работы на более низких уровнях и хода выполнения работ в нескольких командах. Новые и обновленные командные проекты содержат два уровня невыполненной работы портфеля: компоненты и ситуации. Можно добавить до трех дополнительных уровней. Родительская категория не указывается только для невыполненной работы портфеля верхнего уровня.
Примечание
Для выполнения некоторых функций невыполненной работы портфеля требуется расширенный доступ.
Невыполненная работа по продукту соответствует плану проекта, в котором описано то, что команда планирует выполнить. В ней перечисляются рабочие элементы, типы которых принадлежат к категории "Требования". Чтобы управлять типами рабочих элементов, которые отличаются от предоставляемых командным проектом по умолчанию, можно добавить типы рабочих элементов в категорию требований и сопоставить состояния рабочего процесса метасостояниям.
Невыполненная работа спринта или итерации содержит набор требований, заявленных вами и вашей командой в конкретном цикле спринта, и задачи, связанные с этими требованиями. Задачи необходимо связать с требованиями, используя тип связи "родитель-потомок". Поскольку типы рабочих элементов, отображаемые на этих страницах, соответствуют типам, отображаемым в невыполненной работе по продукту, основная часть действий по настройке, выполняемых для невыполненной работы по продукту, состоит в определении функциональности невыполненной работы спринта.
Сопоставление состояний рабочих процессов метасостояниям
Для большинства типов рабочих элементов требуется сопоставление их состояний рабочего процесса метасостоянию. Состояния рабочего процесса определяют, как рабочий элемент переходит от первой активации или создания в состояние закрытия или завершения. Например, состояния, определенные для элемента невыполненной работы по продукту в Scrum, задают последовательность изменения четырех состояний — от Создать, Утверждено, Зафиксировано до Готово, — а также включают пятое состояние Удалено для учета состояния, удаленного из невыполненной работы без реализации.
Метасостояния, с другой стороны, определяют обработку каждого состояния рабочего процесса средствами гибкого планирования (Agile). Основные метасостояния, используемые доской невыполненной работы и задач, —Proposed, InProgress и Complete.
Благодаря сопоставлению каждого состояния рабочего процесса метасостоянию фоновые операции, выполняемые для отображения невыполненной работы и досок задач, знают, как правильно интерпретировать состояние каждого рабочего элемента. Например, для невыполненной работы по продукту в 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 >
Существует три категории метасостояний: «Гибкая разработка», «Ошибка» и «Отзыв». В следующей таблице описывается сопоставление атрибутов и значений.
Элемент |
Описание |
---|---|
State |
Обязательный. Назначает состояние рабочего процесса метасостоянию.
Допустимые значения TypeName соответствуют значению, присвоенному элементу STATE в разделе WORKFLOW типов рабочих элементов, назначенных группе категорий. Допустимые значения ValueName соответствуют одному из следующих значений.
|
States |
Определяет коллекцию элементов State, связывающих состояния рабочего процесса рабочих элементов с метасостояниями. Обязательный элемент для следующих родительских элементов:
|
Настройка столбцов и последовательности столбцов по умолчанию
Укажите поля, которые требуется выводить на экране в каждой невыполненной работе в разделе Columns. Изменения, внесенные с помощью диалогового окна Параметры столбцов, сохраняются до последующего внесения изменений.
Здесь представлена конфигурация по умолчанию, определенная в шаблоне процесса 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 |
Указывает поле для отображения в виде столбца в невыполненной работе.
|
Заголовки столбцов доски задач
Заголовки столбцов, отображаемые на доске задач, соответствуют состояниям рабочего процесса, присвоенным типу рабочего элемента по умолчанию, назначенному категории задач. Последовательность столбцов соответствует естественным переходам рабочего процесса из одного состояния в другое, слева направо. Чтобы изменить структуру столбцов, измените рабочий процесс для типа рабочего элемента, назначенного категории задач. Состояния рабочего процесса, определенные для типа задачи по умолчанию в категории задач, необходимо назначить допустимому метасостоянию согласно описанию в разделе Сопоставление метастояний для категории типов рабочих элементов.
Настройка панели быстрого добавления
На любую панель быстрого добавления можно добавлять поля. В приведенном ниже примере на панель невыполненной работы по продукту добавляется поле Ценность для бизнеса.
На этой панели отображаются только поля, включенные в раздел FIELDS определения типа рабочего элемента для выбранного типа. Например, при выборе типа рабочего элемента "ошибка" отображается только название, поскольку "ценность для бизнеса" для ошибок не определена. Чтобы добавить на панель другой тип рабочего элемента, добавьте его в категорию требований согласно описанию, приведенному здесь.
Приведенный ниже код соответствует назначениям по умолчанию, определенным в шаблонах процессов Visual Studio Scrum и MSF для гибкой разработки.
<AddPanel>
<Fields>
<Field refname="System.Title" />
</Fields>
</AddPanel>
Элемент |
Описание |
---|---|
AddPanel |
Элемент-контейнер, используемый для задания взаимодействия "быстрое добавление", т. е. полей для отображения в области панели, в которой определяются новые элементы невыполненной работы. |
Fields |
Задает коллекцию элементов Field. |
Field |
Задает поле рабочего элемента для отображения на панели для невыполненной работы по продукту.
Это же поле должно отображаться в формах рабочих элементов всех типов, содержащихся в категории невыполненной работы. |
Изменение числа рабочих элементов, которые могут отображаться на доске задач
Чтобы не снижалась производительность, для доски задач введено ограничение на отображение максимум 1000 рабочих элементов. При открытии доски задач все рабочие элементы загружаются в кэш. Ограничение количества рабочих элементов может сократить время загрузки. Это ограничение можно изменить, указав значение для атрибута workItemCountLimit элемента TaskBacklog.
Например, можно уменьшить значение ограничения, добавив параметр workItemCountLimit="800":
<TaskBacklog category="Microsoft.TaskCategory" pluralName="Tasks" singularName="Task" workItemCountLimit="800" >
. . .
</TaskBacklog>
Сопоставление метасостояний типов рабочих элементов для конкретного инструмента
Сопоставления метасостояний определяются для дополнительных категорий типов рабочих элементов. Для шаблона процессов 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>
В приведенной ниже таблице перечислены дополнительные элементы, используемые для определения сопоставлений метасостояний типов рабочих элементов для конкретного инструмента. Сведения о присвоении значений и типов фактического состояния см. в разделе Сопоставление метасостояний для категории типов рабочих элементов. Значение CategoryName должно соответствовать категории, определенной для командного проекта.
Элемент |
Описание |
---|---|
BugWorkItems |
Необязательно. Элемент-контейнер, определяющий сопоставления метасостояний для типов рабочих элементов, назначенных категории ошибок. Помимо того, что эти сопоставления используются при отображении средств гибкого планирования, они также управляют тем, как функция Моя работа в Team Explorer обновляет состояние ошибок при их перемещении разработчиками с помощью этой функции. Дополнительные сведения см. в разделе Один день из жизни разработчика ALM: написание нового кода для пользовательской истории.
|
FeedbackRequestWorkItems |
Обязательный. Не настраивайте. Элемент-контейнер, определяющий сопоставления метасостояний для типов рабочих элементов, назначенных категории запросов на отзыв.
|
FeedbackResponseWorkItems |
Обязательный. Не настраивайте. Элемент-контейнер, определяющий сопоставления метасостояний для типов рабочих элементов, назначенных категории ответов на отзыв.
|
TestPlanWorkItems |
Требуется только, если вы настраивали состояния рабочего процесса для плана тестирования и поддерживаете подключения к командному проекту из версии Test Manager, установленной в Visual Studio 2013.2 или более ранних версий. Элемент-контейнер, определяющий сопоставления метасостояний для типов рабочих элементов, назначенных категории плана тестирования. Пример:
|
TestSuiteWorkItems |
Требуется только, если вы настраивали состояния рабочего процесса для наборов тестов и поддерживаете подключения к командному проекту из версии Test Manager, установленной в Visual Studio 2013.2 или более ранних версий. Элемент-контейнер, определяющий сопоставления метасостояний для типов рабочих элементов, назначенных категории наборов тестов. Примеры.
|
Для сопоставления метасостояний TestPlanWorkItems или TestSuiteWorkItems необходимо обновить сервер уровня приложения до версии TFS 2013.3. После этого можно настраивать состояния рабочего процесса для плана тестирования и наборов тестов.
Дополнительные сведения см. в разделе Импорт и экспорт конфигурации процесса.
Назначение полей, используемых в средствах гибкого планирования и диаграммах
Поля рабочих элементов, используемых при расчете производительности, скорости, создании диаграмм сгорания и прогнозе, можно изменять. Любое изменение, вносимое в одно из назначений по умолчанию, должно соответствовать изменению, внесенному в тип рабочего элемента, используемый для определения и сбора сведений для этого значения.
Например, при изменении поля refname, назначенного параметру type="Activity", это поле необходимо включить в определение типа рабочего элемента, назначенное категории задач, в которой собираются сведения о действиях.
<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 |
Обязательный. Задает коллекцию элементов TypeField. |
TypeField |
Обязательный. Задает ссылочное имя поля, значение которого поддерживает тип действия для функциональной области. Указываемые поля должны соответствовать полям, используемым в типах рабочих элементов, применяемых для сбора данных о функциях.
Укажите формат, только если type="RemainingWork". Для TimeUnitString можно задать любую текстовую строку, которую требуется отображать на диаграммах производительности в текущей невыполненной работе спринта и на доске задач. Для средств Agile
Для формы запроса на отзыв Примечание Назначения по умолчанию, сделанные для указанных ниже элементов TypeField, изменять не требуется.Эти назначения соответствуют полям, используемым для сбора соответствующих сведений в типе рабочего элемента, назначенном категории запроса отзыва.
|
TypeFieldValues |
Обязательный элемент для TypeFieldValue при type="ApplicationType". Определяет коллекцию элементов TypeFieldValue, используемых в форме запроса на отзыв. |
TypeFieldValue |
Обязательный. Не настраивайте. Задает имя типа приложения для отображения в форме запроса на отзыв.
Назначения по умолчанию соответствуют разрешенным значениям, указанным в определении типа для формы запроса на отзыв.
|
Примечания по реализации
При изменении этого поля в разделе TypeFields необходимо внести соответствующее изменение в определении типа рабочего элемента. Например, при изменении полей, назначенных для фиксации работы Effort, необходимо внести такое же изменение в определениях типов рабочих элементов для элемента невыполненной работы по продукту и ошибки (для Scrum).
Поиск ссылочного имени поля можно осуществлять с помощью указателя.
Назначение нерабочих дней
Нерабочие дни удаляются из вычислений, выполненных средством планирования производительности и диаграмм сгорания. По умолчанию в процессах Visual Studio Online и шаблонах процессов TFS в качестве нерабочих дней указаны суббота и воскресенье. Создав командный проект, каждая команда может настроить собственные нерабочие дни.
<Weekends>
<DayOfWeek>Saturday</DayOfWeek>
<DayOfWeek>Sunday</DayOfWeek>
</Weekends>
Элемент |
Описание |
---|---|
DayOfWeek |
Обязательный дочерний элемент элемента Weekends. Указывает день недели, соответствующий нерабочему дню.
Допустимые имена соответствуют английским дням недели: Sunday, Monday, Tuesday, Wednesday, Thursday, Friday и Saturday. Примечание День недели необходимо указывать на английском языке независимо от установленного языка локального развертывания TFS. |
Weekends |
Необязательно. Элемент-контейнер, используемый для указания нерабочих дней. Нерабочие дни следует указывать, когда их требуется учитывать при расчете производительности и создании диаграмм сгорания. |
Изменение цвета для типа рабочего элемента
При просмотре результатов запроса или невыполненной работы можно сразу различать типы рабочих элементов по назначенным им цветам.
В шаблоне процесса 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 |
Необязательно. Элемент-контейнер для указания цветов для типов рабочих элементов. |
WorkItemColor |
Задает цвета, используемые для отображения типа рабочего элемента на веб-портале. Основной цвет используется при отображении списков, а дополнительный — при отображении досок, например доски задач и канбан-доски.
|
Указание свойств и поведения
Существует только одно свойство, которое можно указать в данный момент. Свойство BugsBehavior определяет конфигурацию по умолчанию, задающую способ отображения ошибок и других типов рабочих элементов в невыполненной работе и на досках. По сути можно настроить обработку ошибок как требований или задач или заблокировать их отображение в невыполненной работе и на досках. Создав командный проект, каждая команда может настроить нужное поведение.
<Properties>
<Property name="BugsBehavior" value="AsTasks" />
<Property name="HiddenBacklogs" value="Microsoft.EpicCategory" />
</Properties>
Элемент |
Описание |
---|---|
Properties |
Необязательно. Элемент-контейнер для указания свойств и вариантов поведения по умолчанию. |
Property |
Указывает назначение по умолчанию для новых или существующих команд при обновлении командного проекта с добавлением новых функций. Команды могут выбрать нужное поведение в параметрах команды. BugsBehavior задает значение по умолчанию для отображения ошибок в невыполненной работе или на досках. HiddenBacklogs указывает категорию невыполненной работы, которая неактивна для команды. Допустимые значения для BugsBehavior:
|
Вопросы и ответы
Вопрос. Как настроить другие функции средств гибкой разработки (Agile)?
Ответ. Некоторые настройки можно выполнить через пользовательский интерфейс. В других случаях необходимо изменять конфигурацию процесса или других объектов командного проекта. Общие сведения см. в разделе Configure and customize Agile tools for a team project.
Вопрос. Можно ли добавлять и изменять типы рабочих элементов, отображаемых на доске задач или странице невыполненной работы по продукту?
Ответ. Если вы добавили настраиваемый тип рабочего элемента, его можно добавить на страницу невыполненной работы или доску задач. Невозможно только обеспечить его отображение в обоих местах. Подробнее см. в разделе Добавление типов рабочих элементов в списки невыполненных работ или доски задач.