Field List Types

You can define the values that a field can contain by specifying whether values are allowed, suggested, or prohibited. To do this, use the following three tags:

  • <ALLOWEDVALUES>   An enumerated list of values that is presented to the user as a drop-down list. Users must select one of the values on this list.

  • <SUGGESTEDVALUES>   An enumerated list of values that is presented to the user as a drop-down list. Users can select any one of the values. Users can also enter their own value which is not one of the suggestions.

  • <PROHIBITEDVALUES>   Users cannot save a work item if the field contains any prohibited values. Prohibited values are typically used when a value was previously allowed but is no longer valid.

Example

In this example, the Customer Severity field can have any one of three values, Emergency, Major, and Minor. At run time, users can select one of the values from a drop-down list.

<FIELD refname="System.Title" name="Title" type="String">
<HELPTEXT>Enter a brief description of the work item</HELPTEXT>
<REQUIRED/>
</FIELD>
<FIELD refname="MyCorp.CusSeverity" name="Customer Severity" type="String">
<HELPTEXT>Enter the severity of the problem</HELPTEXT>
    <ALLOWEDVALUES>
        <LISTITEM value="Emergency">
        <LISTITEM value="Major">
        <LISTITEM value="Minor">
    </ALLOWEDVALUES>
<DEFAULT from="value" value="Minor"/>
</FIELD>

See Also

Other Resources

Defining Field Lists