By using global workflow, you can minimize the work that is required to define and update work item fields and global lists that many types of work items and team projects share. With global workflow, you can define and update fields and global lists that apply to all types of work items in a team project or a team project collection.
If you want only to manage global lists for a collection, see
Global Workflow Syntax Structure
You define the global workflow by using the GLOBALWORKFLOW element, which supports FIELDS (Definition) or GLOBALLISTS elements as children, but not both.
Specify FIELDS:
 Copy Code | |
|---|---|
<?xml version="1.0" encoding="utf-8"?> <GLOBALWORKFLOW> <FIELDS> <FIELD> . . . </FIELD> </FIELDS> </GLOBALWORKFLOW> | |
Specify GLOBALLISTS:
| Copy Code | |
|---|---|
<?xml version="1.0" encoding="utf-8"?> <GLOBALWORKFLOW> <GLOBALLISTS> <GLOBALLIST> . . . </GLOBALLIST> </GLOBALLISTS> </GLOBALWORKFLOW> | |
FIELD (Definition) Element
You use the following syntax to define the data fields within a global workflow. This syntax shows the FIELD (Definition) element format and all optional child elements. For more information, see
 Note |
|---|
You cannot specify the HELPTEXT element for a field that you define in a global workflow. |
| Copy Code | |
|---|---|
<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 and LISTITEM Child Elements
The following table describes the GLOBALLIST and LISTITEM elements. You specify these elements as child elements of the GLOBALWORKFLOW element. You can use these elements to enumerate a list of values that appears to the user as a pick list or a drop-down menu of items. For more information, see
Element | Description and Syntax | ||||
|---|---|---|---|---|---|
GLOBALIST | Defines a set of LISTITEM elements that are stored for a team project collection or a team project. globalListName: A string of text that contains between 1 and 255 characters.
GLOBALLIST is a required child element of the GLOBALLISTS element. | ||||
LISTITEM | Defines a valid value that appears in the list.
LISTITEM is a required child element of GLOBALLIST. | ||||
See Also
Concepts
Other Resources
