TRANSITION - XML-элемент

Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 — TFS 2013

Важно!

Эта статья относится к настройке проекта для локальных моделей процессов XML. Общие сведения о моделях процессов см. в статье Настройка отслеживания работы.

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

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

Синтаксис

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

Элементы и атрибуты

В следующих разделах описаны атрибуты, дочерние и родительские элементы.

Атрибуты

Атрибут Описание
from Обязательный. Имя состояния, из которого переходит рабочий элемент.
to Обязательный. Имя состояния, в которое переходит рабочий элемент.
for атрибутTransition .

Необязательный элемент. Имя пользователя или группы, которым разрешено выполнять переход.
not атрибутTransition .

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

Примечание

Правила, использующие for атрибуты и, not не поддерживаются в Azure DevOps Services.

Дочерние элементы

Элемент Описание
ДЕЙСТВИЯ Необязательный элемент. Определяет коллекцию ACTION элементов, которые определяют строку действия, которую можно использовать при вызове WorkItem.GetNextState метода для получения состояния рабочего элемента после действия.
НИЖЕ Обязательный. Коллекция DEFAULTREASONREASON элементов и, определяющих допустимые причины, по которым рабочий элемент может завершить переход.
FIELDS (рабочий процесс) Необязательный элемент. Коллекция FIELD элементов рабочего процесса, которые ссылаются на определения полей, определенные для типа рабочего элемента.

Родительские элементы

Элемент Описание
МЕЖДУ Обязательный. Коллекция TRANSITION элементов, определяющих допустимые переходы состояния для типа рабочего элемента.

Комментарии

TRANSITION — обязательный дочерний элемент элемента TRANSITIONS.

Необходимо определить ровно один переход, чтобы переместить рабочий элемент из Nothing ( from = "") в именованное состояние, например "активный". Этот переход определяет состояние по умолчанию для нового рабочего элемента.

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

Кроме того, при необходимости можно использовать атрибуты for и not в элементе перехода рабочего процесса, чтобы уточнить, кто и кто не может выполнить переход. При этом denies имеет приоритет над allows . Если не указан ни один из этих атрибутов, любой пользователь может изменить рабочий элемент.

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

Пример определения причин

В следующем примере определяются причины для перехода с активного на разрешенное состояние рабочего процесса.

<TRANSITION from="Active" to="Resolved">  
   . . .  
   <REASONS>  
      <DEFAULTREASON value="Fixed"/>  
      <REASON value="Deferred"/>  
      <REASON value="Duplicate"/>  
      <REASON value="As Designed"/>  
      <REASON value="Unable to Reproduce"/>  
      <REASON value="Obsolete"/>  
   </REASONS>  
   . . .  
</TRANSITION>  

Пример ограничения перехода

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

<TRANSITION from="Resolved" to="Complete" for="[project]\AllTesters" not="[project]\NewTesters">  
</TRANSITION>  

Автоматическое завершение рабочих элементов с запросами на включение внесенных изменений

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

Примечание

Доступность функций. параметр " завершить связывание связанных рабочих элементов после слияния " доступен в TFS 2018 и более поздних версиях.

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