Поделиться через

Справочник по всем XML-элементам WORKFLOW

  • Статья

Информацию данного раздела можно использовать в качестве краткого справочника по всем элементам и основным атрибутам, управляющим рабочим процессом для типа рабочего элемента. Эти элементы указываются в элементе-контейнере WORKFLOW, который является вторым основным разделом определения типа рабочего элемента. С помощью дочерних элементов STATES и TRANSITIONS задаются различные состояния, которые пользователь может указать для типа рабочего элемента, и переходы, разрешенные между состояниями. Дополнительные сведения об определении этих элементов см. в разделе Change the workflow for a work item type.

Для изменения рабочего процесса необходимо изменить определение типа рабочего элемента. См. раздел Изменение или добавление пользовательского типа рабочего элемента (WIT).

Пример элемента WORKFLOW

В следующем примере показана общая структура элемента WORKFLOW. Все состояния, которые пользователь может сначала указать для типа рабочего элемента, задаются в контейнере STATES. Далее необходимо указать все разрешенные переходы из одного состояния в другое. Каждое состояние соответствует элементу STATE, а каждый переход соответствует элементу TRANSITION. Внутри каждого элемента-контейнера STATES и TRANSITIONS можно определить состояния и переходы в любой желаемой последовательности.

Для каждого перехода задается набор причин изменения состояния рабочего элемента, включая причину по умолчанию. Вы можете назначить значения для каждого состояния, перехода или причины, а также определить условия для значений одного или нескольких полей с помощью элемента FIELD (рабочий процесс). Кроме того, можно активировать выполнение действия во время перехода, указав элемент ACTION.

<WORKFLOW>
<STATES>
  <STATE value="Active">
    <FIELDS> . . . </FIELDS>
  </STATE>
  <STATE value="Resolved">
    <FIELDS> . . . </FIELDS>
  </STATE>
  <STATE value="Closed" />
</STATES>
<TRANSITIONS>
  <TRANSITION from="" to="Active">
    <REASONS>
      <DEFAULTREASON value="New" />
    </REASONS>
    <FIELDS> . . . </FIELDS>
  </TRANSITION>
  <TRANSITION from="Active" to="Resolved">
    <REASONS> . . . </REASONS>
    <FIELDS> . . . </FIELDS>
    <ACTIONS > . . . </ACTIONS >
</TRANSITION>
<TRANSITION from="Resolved" to="Closed">
    <REASONS> . . . </REASONS>
    <FIELDS> . . . </FIELDS>
    <ACTIONS > . . . </ACTIONS >
</TRANSITION>
<TRANSITION from="Resolved" to="Active">
    <REASONS> . . . </REASONS>
    <FIELDS> . . . </FIELDS>
</TRANSITION>
<TRANSITION from="Active" to="Closed ">
    <REASONS> . . . </REASONS>
    <FIELDS> . . . </FIELDS>
</TRANSITION>
<TRANSITION from="Closed" to="Active">
    <REASONS> . . . </REASONS>
    <FIELDS> . . . </FIELDS>
</TRANSITION>
</TRANSITIONS>
</WORKFLOW>

Структура синтаксиса

С помощью элементов, которые описаны в следующей таблице, можно указать, в какие состояния член команды может устанавливать рабочий элемент определенного типа. В разделе WORKFLOW определения сначала задаются состояния, а затем переходы. Дополнительные сведения см. в разделе Change the workflow for a work item type.

Элемент

Описание и синтаксис

Обязательный?

ACTION

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

<ACTION value="NameOfAction" />

Дополнительные сведения см. в разделе Автоматизация назначений полей на основе состояния, перехода или причины.

Необязательный

ACTIONS

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

<ACTIONS>
   <ACTION>. . . </ACTION>
</ACTIONS>

Необязательный

DEFAULTREASON

Определяет наиболее распространенную причину изменения членом команды одного конкретного состояния рабочего элемента на другое конкретное состояние.

<DEFAULTREASON value="ValueOfDefaultReason">
   <FIELDS>. . . </FIELDS>
</DEFAULTREASON>

Обязательный

FIELD

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

<FIELD refname="FieldReferenceName">
   <ALLOWEDVALUES> . . . </ALLOWEDVALUES>
   <ALLOWEXISTINGVALUE />
   <CANNOTLOSEVALUE />
   <COPY />
   <DEFAULT />
   <EMPTY />
   <FROZEN />
   <MATCH />
   <NOTSAMEAS />
   <PROHIBITEDVALUES /> . . . </PROHIBITEDVALUES>
   <READONLY />
   <SERVERDEFAULT />
   <SUGGESTEDVALUES /> . . . </SUGGESTEDVALUES>
   <VALIDUSER />
   <WHEN>> . . . </WHEN>
   <WHENNOT> . . . </WHENNOT>
   <WHENCHANGED> . . . </WHENCHANGED>
   <WHENNOTCHANGED> . . . </WHENNOTCHANGED>
<FIELD>

Дополнительные сведения см. в разделе Справочник по элементам FIELD (рабочий процесс).

Необязательный

FIELDS

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

<FIELDS>
   <FIELD . . . </FIELD>
</FIELDS>

Необязательный

REASON

Определяет дополнительное объяснение для причины изменения членом команды состояния рабочего элемента.

<REASON value="NameOfReason">
   <FIELDS>. . . </FIELDS>
</REASON>

Необязательный

REASONS

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

<REASONS>
   <DEFAULTREASON>. . . </DEFAULTREASON>
   <REASON>. . . </REASON>
</REASONS>

STATE

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

<STATE value="NameOfState">
  <FIELDS>. . . </FIELDS>
</STATE>

Обязательный

STATES

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

<STATES>
   <STATE>. . . </STATE>
</STATES>

Обязательный

TRANSITION

Указывает допустимое продвижение или возвращение из одного состояния в другое для рабочих элементов определенного типа.

<TRANSITION from="NameOfStartingState" 
   to="NameOfEndingState" 
   for="UserOrGroupName"
   not="UserOrGroupName">
   <ACTIONS>. . . </ACTIONS>
   <REASONS>. . . </REASONS>
   <FIELDS>. . . </FIELDS>
</TRANSITION>

Дополнительные сведения см. в разделе Элемент TRANSITION.

Обязательный

TRANSITIONS

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

<TRANSITIONS>
    <TRANSITION>. . . </TRANSITION>
</TRANSITIONS>

Обязательный

WORKFLOW

Указывает коллекцию элементов-контейнеров STATES и TRANSITIONS, которые вместе определяют рабочий процесс для типа рабочего элемента.

<WORKFLOW>
   <STATES>. . . </STATES>
   <TRANSITIONS>. . . </TRANSITIONS>
</WORKFLOW>

Обязательный

См. также

Ссылки

Справочник по элементам FIELD (рабочий процесс)

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

Change the workflow for a work item type