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

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

Важно!

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

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

Если вы хотите управлять только глобальными списками для коллекции, см. раздел Справочник по XML-элементам глобаллист.

Структура синтаксиса глобального рабочего процесса

Глобальный рабочий процесс определяется с помощью GLOBALWORKFLOW элемента, который поддерживает поля (определения) или глобаллистс как дочерние элементы, но не оба.

Укажите поля:

<?xml version="1.0" encoding="utf-8"?>  
<GLOBALWORKFLOW>  
      <FIELDS>   
      <FIELD> . . . </FIELD>  
      </FIELDS>  
</GLOBALWORKFLOW>  

Укажите глобаллистс:

<?xml version="1.0" encoding="utf-8"?>  
<GLOBALWORKFLOW>  
      <GLOBALLISTS>   
      <GLOBALLIST> . . . </GLOBALLIST>  
      </GLOBALLISTS>  
</GLOBALWORKFLOW>  

Элемент FIELD (Definition)

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

Примечание

Нельзя указать элемент HELPTEXT для поля, определяемого в глобальном рабочем процессе.

<FIELD name="fieldDisplayName" refname="fieldReferenceName" type="String | Integer | Double | DateTime | PlainText | HTML | History | TreePath | GUID "  
syncnamechanges="true | false" reportingname="reportingDisplayName" reportingrefname="reportingReferenceName"  
reportable="Dimension | Detail | Measure" formula="avg" >  
      <ALLOWEDVALUES> . . . </ALLOWEDVALUES>  
      <ALLOWEXISTINGVALUE />  
      <CANNOTLOSEVALUE />  
      <COPY />  
      <DEFAULT />  
      <EMPTY />  
      <FROZEN />      <MATCH />  
      <NOTSAMEAS />  
      <PROHIBITEDVALUES /> . . . </PROHIBITEDVALUES>  
      <READONLY />  
      <REQUIRED />  
      <SERVERDEFAULT />  
      <SUGGESTEDVALUES /> . . . </SUGGESTEDVALUES>  
      <VALIDUSER />  
      <WHEN>> . . . </WHEN>  
      <WHENNOT> . . . </WHENNOT>  
      <WHENCHANGED> . . . </WHENCHANGED>  
      <WHENNOTCHANGED> . . . </WHENNOTCHANGED>  
</FIELD>  

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

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

Элемент Описание и синтаксис
глобалист Определяет набор элементов ListItem , которые хранятся для коллекции проектов или проекта.

глобаллистнаме: строка текста, содержащая от 1 до 255 символов.

<GLOBALLIST name="глобаллистнаме">

<LISTITEM> . . . </LISTITEM>

</GLOBALLIST>

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

<LISTITEM value="listName" />

ListItem является обязательным дочерним элементом глобаллист.