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

Файлы конфигурации процесса определяют структуру и функциональность следующих функций: список невыполненных работ по продукту и скорости работы команды, невыполненная работа итерации, емкость команды и диаграммы выработки, доска задач, отзывы заинтересованного лица и моя работа.Можно экспортировать эти файлы конфигурации, AgileConfiguration и CommonConfiguration, из командного проекта или обращаться к ним из шаблона процесса, который можно загрузить из Visual Studio Team Foundation Server 2012.Структуру страниц задела работы можно настроить с помощью изменения определений, определенных в AgileConfiguration, а общие области для нескольких функций можно настроить путем изменения определений, определенных в CommonConfiguration.

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

Примечание
Сведения о том, как команда использует страницы задела работы и доски задач, см. в разделе Гибкое планирование и итерации.

Содержание раздела

• AgileConfiguration: структура и элементы синтаксиса

• CommonConfiguration: структура и элементы синтаксиса

AgileConfiguration: структура и элементы синтаксиса

Страницу задела работы можно настроить с помощью изменения элементов, содержащихся в элементе AgileProjectConfiguration.Для настройки страницы задела работы продукта нужно изменить элементы в элементе ProductBacklog, а для настройки страницы задела работы итерации измените элементы, содержащиеся внутри элементов IterationBacklog.

В следующем примере XML показана структура кода, которая определяет конфигурацию гибкого процесса, содержащуюся в файле AgileConfiguration.xml.Этот пример соответствует синтаксису по умолчанию, определенному для MSF для гибкой разработки программного обеспечения v6.0.

<?xml version="1.0" encoding="utf-8"?>
<AgileProjectConfiguration>
  <ProductBacklog>
    <Columns>
      <Column refname="System.Title" width="400" />
      <Column refname="System.State" width="100" />
      <Column refname="Microsoft.VSTS.Scheduling.StoryPoints" width="50" />
      <Column refname="System.IterationPath" width="200" />
    </Columns>
    <AddPanel>
      <Fields>
        <Field refname="System.Title" />
      </Fields>
    </AddPanel>
  </ProductBacklog>
  <IterationBacklog>
    <Columns>
      <Column refname="Microsoft.VSTS.Scheduling.StoryPoints" width="50" />
      <Column refname="System.Title" width="400" />
      <Column refname="System.State" width="100" />
      <Column refname="System.AssignedTo" width="100" />
      <Column refname="Microsoft.VSTS.Scheduling.RemainingWork" width="50" />
    </Columns>
  </IterationBacklog>
</AgileProjectConfiguration>

К началу

XML-элементы для страниц задела работы

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

Элемент	Описание и синтаксис	Примечания
AddPanel	Контейнерный элемент используется для определения взаимодействия "быстрое добавление", т.е. полей, отображаемых в области панели, в которой определены новые элементы задела работы. <AddPanel>     <Fields>        <Field . . . />        . . .    </Fields> </AddPanel>	Обязательное.Только один экземпляр. Необходимо указать как минимум один элемент Fields. Взаимодействие "быстрое добавление" отображается только на странице задела работы по продукту в Team Web Access.
Column	Указывает поле для отображения в виде столбца на странице задела работы. <Column refname="FieldReferenceName" width="FieldWidth" />	Обязательное. Для каждого столбца, который должен отобразиться на страницах, которые отображают список задела работы, необходимо указать ссылочное имя для поля, которое определено для типа рабочего элемента, связанного с элементами задела работы.Необходимо указать положительное целое число для ширины поля.
Columns	Задает коллекцию элементов Column. <Columns>    <Column . . . />    . . . </Columns>	Обязательное.Только один экземпляр для каждого родительского элемента IterationBacklog и ProductBacklog. Необходимо указать столбцы, которые должны отображаться на страницах, которые отображают список невыполненных работ по продукту или список невыполненных работ по итерации.
Field	Указывает поле для отображения на панели страницы задела работы по продукту. <Field refname=”FieldReferenceName” />	Обязательное.Один или несколько элементов внутри родительского элемента Fields. При определении рабочего элемента для добавления в невыполненную работу можно указать значение для полей, которые указаны в секции AddPanel процесса конфигурации. Конфигурация по умолчанию определяет поле Название как единственное поле для отображения, что показано в следующем образце кода: <AddPanel>    <Fields>       <Field refname="System.Title" />    </Fields> </AddPanel>
Fields	Задает коллекцию элементов Field. <Fields> <Field . . . />    . . . </Fields>	Обязательное.Только один экземпляр указывается для родительского элемента AddPanel. Можно указать поля, которые необходимо указать быстро, добавив элементы в невыполненную работу продукта.
IterationBacklog	Элемент-контейнер, используемый для настройки структуры страниц, которые отображают рабочие элементы, назначен к определенной итерации. <IterationBacklog workItemCountLimit="MaximumLimit" >    <Columns> . . . </Columns>    . . .  </IterationBacklog >	Обязательное.Только один экземпляр. Можно указать количество столбцов, ширину столбцов и поля, которые заполняют каждый столбец для тех страниц, которые отображают список элементов задела работы, назначенных итерации. По умолчанию для доски задач существует ограничение в 500 рабочих элементов.Это ограничение можно изменить, указав значение для атрибута workItemCountLimit.
ProductBacklog	Контейнерный элемент, использованный для настройки макета страницы, которая отображает список невыполненных работ по продукту и которая содержит панель для добавления рабочих элементов в невыполненную работу. <ProductBacklog>    <Columns> . . . </Columns>    <AddPanel> . . . </ AddPanel> </ProductBacklog >	Обязательное.Только один экземпляр. Можно указать количество столбцов, ширину столбцов и поля, которые заполняют каждый столбец для тех страниц, которые отображают список элементов задела работы, назначенных списку невыполненных работ по продукту.Список невыполненных работ по продукту отображает все активные элементы в невыполненной работе, включая те, которые были присвоены к итерации.

К началу

CommonConfiguration: структура и элементы синтаксиса

Страницу доски задач можно настроить с помощью элемента CommonProjectConfiguration, который поддерживает несколько дочерних элементов.TypeFields определяет поле, которое используется в типах рабочих элементов, чтобы получить конкретные сведения.Несколько других дочерних элементов, например, RequirementWorkItems, TaskWorkItems и BugWorkItems, определяют группу категорий для связывания с этими типами, на которые ссылаются конкретные функциональные области процесса конфигурации.

В следующем примере XML показана структура кода, которая определяет конфигурацию общего процесса, содержащуюся в файле CommonConfiguration.xml.Этот пример соответствует синтаксису по умолчанию, определенному для MSF для гибкой разработки программного обеспечения v6.0.

<?xml version="1.0" encoding="utf-8"?>
<CommonProjectConfiguration>
  <TypeFields>
    <TypeField refname="System.AreaPath" type="Team" />
    <TypeField refname="Microsoft.VSTS.Scheduling.RemainingWork" type="RemainingWork" format="format h" />
    <TypeField refname="Microsoft.VSTS.Common.StackRank" type="Order" />
    <TypeField refname="Microsoft.VSTS.Scheduling.StoryPoints" 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>
  <RequirementWorkItems category="Microsoft.RequirementCategory" plural="Stories">
    <States>
      <State value="New" type="Proposed" />
      <State value="Active" type="InProgress" />
      <State value="Resolved" type="InProgress" />
      <State value="Closed" type="Complete" />
    </States>
  </RequirementWorkItems>
  <TaskWorkItems category="Microsoft.TaskCategory">
    <States>
      <State value="New" type="Proposed" />
      <State value="Active" type="InProgress" />
      <State value="Closed" type="Complete" />
    </States>
  </TaskWorkItems>
  <BugWorkItems category="Microsoft.BugCategory">
   <States>
        <State value="Active" type="InProgress" />
        <State value="Resolved" type="Resolved" />
        <State value="Closed" type="Complete" />
      </States> 
  </BugWorkItems>
  <FeedbackRequestWorkItems category="Microsoft.FeedbackRequestCategory" plural="Feedback Requests">
    <States>
      <State value="Active" type="InProgress" />
      <State value="Closed" type="Complete" />
    </States>
  </FeedbackRequestWorkItems>
  <FeedbackResponseWorkItems category="Microsoft.FeedbackResponseCategory" plural="Feedback Responses">
    <States>
      <State value="Active" type="InProgress" />
      <State value="Closed" type="Complete" />
    </States>
  </FeedbackResponseWorkItems>
  <Weekends>
    <DayOfWeek>Saturday</DayOfWeek>
    <DayOfWeek>Sunday</DayOfWeek>
  </Weekends>
</CommonProjectConfiguration>

К началу

XML-элементы для общих областей

В следующей таблице описаны дочерние элементы элемента CommonProjectConfiguration.Эти элементы позволяют настраивать области, которые поддерживают страницы, которые отображаются в Team Web Access, в Team Explorer и в форме запроса обратной связи.

Важно
Значения, присвоенные CategoryName, должны соответствовать группе категории, указанной для командного проекта.Группы категорий можно указать в файле определений для категорий.Для самого последнего выпуска Visual Studio ALM были определены пять новых категорий.Дополнительные сведения см. в разделе Категории, конфигурация процесса и отключение создания определенных типов рабочих элементов.

Элемент	Описание и синтаксис	Примечания
BugWorkItems	Определяет категорию, которая соответствует рабочим элементам ошибок и связывает состояния рабочего процесса элементов задела работы с метасостояниями. <BugWorkItems category=”CategoryName”>     <States>        <State . . . />        . . .    </States> </BugWorkItems	Обязательное.CategoryName должно соответствовать категории, указанной для командного проекта.
DayOfWeek	Указывает день недели, который соответствует нерабочему дню. <DayOfWeek>NameOfADay</DayOfWeek>	Обязательный дочерний элемент элемента Weekends. Допустимые имена совпадают с английским дням недели: Sunday, Monday, Tuesday, Wednesday, Thursday, Friday и Saturday. Примечание Необходимо указать день недели на английском языке, независимо от установленного языка Team Foundation Server.
FeedbackResponseWorkItems	Определяет категорию, которая соответствует типам рабочего элемента, которые используются для перенаправления ответа обратной связи и связывает состояния рабочего процесса этих элементов с метасостояниями.	Обязательное.Нельзя настраивать. CategoryName должно соответствовать группе категорий, указанной для командного проекта.
FeedbackRequestWorkItems	Определяет категорию, которая соответствует типам рабочего элемента, которые используются для перенаправления запроса обратной связи и связывает состояния рабочего процесса этих элементов с метасостояниями.	Обязательное.Нельзя настраивать. CategoryName должно соответствовать группе категорий, указанной для командного проекта.Определите группы категорий с помощью файла Categories.xml.
RequirementWorkItems	Определяет категорию, которая соответствует элементам задела работы, таким как описания функциональности пользователей, требования и элементы задела работы по продукту и связывает состояния рабочего процесса элементов задела работы с метасостояниями. <RequirementWorkItems category="CategoryName" plural="NameOfBacklogItems" >    <States>       <State . . . />       . . .    </States> </RequirementWorkItems>	Обязательное. CategoryName должно соответствовать группе категорий, указанной для командного проекта.Определите группы категорий с помощью файла Categories.xml.
State	Присваивает состояние рабочего процесса в метасостояние.Метасостояния представляют группирование состояний рабочего процесса, которое поддерживает управление состояний рабочего процесса в доске задач или других компонентах конфигурации процесса. <State type="TypeName" value="ValueName"/>	Обязательное. Допустимые значения для TypeName соответствуют значению, присвоенному к STATE в рамках рабочего процесса, определенного для типов рабочих элементов, присутствующих в группе категорий соответственно. Допустимые значения для ValueName соответствуют одному из следующих перечисляемых значений: в рамках рабочего процесса определенного для типов рабочих элементов, присутствующих в группе категорий соответственно. Гибкая разработка: Proposed: Отображает рабочие элементы, которые являются новыми, еще не зафиксированными или еще не обработанными. InProgress: Отображает рабочие элементы, которые были зафиксированы или активно обрабатываются. Complete: Отображает рабочие элементы, которые были реализованы. Ошибка: В дополнение к гибким метасостояниям, включает метасостояние Resolved, которое указывает ошибки, которые были разрешены. Обратная связь: Requested, Received, Reviewed и Declined. Дополнительные сведения см. в разделе Состояния рабочего процесса, метасостояния и конфигурация процесса.
States	Определяет коллекцию элементов State, которые связывают состояния рабочего процесса типов рабочих элементов с метасостояниями. <States>    <State . . . />    . . . </States>	Обязательный элемент для элементов BugWorkItems, FeedbackResponseWorkItems, FeedbackRequestWorkItems, RequirementWorkItems и TaskWorkItems. Элементы State используются для присвоения состояний рабочего процесса к метасостояниям.
TaskWorkItems	Определяет категорию, которая соответствует элементам задачи и связывает состояния рабочего процесса задач с метасостояниями. <TaskWorkItems category="CategoryName">    <States>       <State . . . />       . . .    </States> </TaskWorkItems>	Обязательное. CategoryName должно соответствовать группе категорий, указанной для командного проекта.Определите группы категорий с помощью файла Categories.xml. Невыполненная работа и страницы доски перечисляют те рабочие элементы, которые соответствуют значениям состояний, указанным в элементе States.
TypeField	Задает ссылочное имя поля, значение которого ссылается для поддержки типа действия для поддерживаемой функциональной области.Необходимо указать этот элемент в элементе-контейнере TypeFields. <TypeField refname=”FieldReferenceName” type=”NameOfType” [format="{0} TimeUnitString"] / > Указание формата допустимо только при type="RemainingWork".Можно определить любую строку текста для TimeUnitString, которую необходимо отобразить на панелях вместимости на текущей странице задела работы по итерации и на доске задач.	Обязательное.Следует задать поля, которые соответствуют полям, используемым в типах рабочих элементов для получения конкретных сведений. Для страниц задела работы и доски задач: Activity: Используется для поддержки функции емкость-действием.Укажите поле, указанное для типа задач рабочего элемента, который используется для указания типа действия, которые необходимо выполнить. Effort: Указывает поле, используемое для вычисления скорости работы команды.Укажите поле, определенное для типа задела работы рабочего элемента, который используется для получения оценки усилий или относительного объема работ, которая понадобится для реализации элемента задела работы. Order: Указывает поле, используемое для определения порядка сортировки элементов задела работы для задела работы по итерации и страниц доски задач.Определите поле, которое используется для получения относительного приоритета, присвоенного элементам задела работы.Рабочие элементы перечислены на странице в порядке возрастания в соответствии с полем для данного типа. RemainingWork: Указывает поле, используемое для вычисления диаграмм "Оставшиеся трудозатраты" и "Ошибки".Укажите поля, которые используются для получения количества часов или дней, оставшихся до завершения задачи. Значение, заданное для format, применяется к невыполненной работе и доске задач там, где сообщается об оставшейся работе.Например, при сообщении о емкости-действием или емкости каждого участника команды, или следом за заголовком столбца для состояний задачи на доске задач. Для TimeUnitString укажите любую текстовую строку, которую нужно использовать для отражения значения времени, таких как часы или дни. Например, все приведенные ниже значения являются допустимыми: format="{0} h" format="{0} hours" format="hours {0}" format="time {0}" Team: Указывает поле, используемое для связывания задела работы и страниц доски задач с рабочей группой.Это поле должно оставаться заданным по умолчанию — значению System.AreaPath. Для формы запроса обратной связи: Примечание Не нужно изменять просвоения по умолчанию, выполненные для следующих элементов TypeField.Эти назначения соответствуют полям, используемым для получения соответствующих сведений в типе запроса обраной связи рабочего элемента. ApplicationStartInformation: Указывает поле, используемое для получения пути выполнения приложения. ApplicationLaunchInstructions: Указывает поле, используемое для получения инструкций запуска. ApplicationType: Указывает поле, используемое для получения типа приложения.Типы, перечисленные в соответствии с разрешенными значениями, указаны в определении типа для запроса обратной связи.
TypeFields	Задает коллекцию элементов TypeField. <TypeFields>    <TypeField . . . />    . . . </TypeFields>	Обязательное. Необходимо указать типы полей, которые требуется связать с функциями поддержки, которые отображаются в списке невыполненных работ, доске задачи и форме запроса обратной связи.
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>
TypeFieldValues	Задает коллекцию элементов TypeFieldValue. <TypeFieldValues>    <TypeFieldValue . . . />    . . . </TypeFieldValues>	Обязательный для TypeFieldValue при type="ApplicationType". Необходимо указать значения для типов полей, которые требуется отобразить на форме запроса обратной связи.
Weekends	Контейнерный элемент, используемый для определения нерабочих дней. <Weekends>    <DayOfWeek> . . . </DayOfWeek >    . . . </ Weekends >	Необязательный параметр. Укажите нерабочие дни, когда нужно учесть нерабочие дни в вычислении диаграмм емкости и выработки.

К началу

См. также

Ссылки

Управление процесса конфигурация [witadmin]

Основные понятия

Обновление обновленного командного проекта для доступа к новым функциям

Настройка страниц невыполненной работы и доски с помощью конфигурации процессов