Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
You can specify multiple types of lists for a single field. This topic defines how the resulting list of items is determined.
The following descriptions use these conventions:
All values for an ALLOWEDVALUES list are identified as {set A}.
All values for a SUGGESTEDVALUES list are identified as {set S}.
All values for a PROHIBITEDVALUES list are identified as {set P}.
Valid Value Determination
The valid values allowed for a field are obtained by subtracting {set P} from {set A}. If {set A} has no entries, {set A} is considered to be all possible values. This is because no allowed values have been defined; everything is allowed except those values specifically identified in {set P}.
{Set S} plays no role in determining valid values for a field, but it does help determine the values that display in the drop-down list.
Populating a Drop-Down List with List Values
The following rules use the content of the ALLOWEDVALUES, SUGGESTEDVALUES, and PROHIBITEDVALUES sets to determine the values that populate a drop-down list.
If {set S} AND {set A} have no entries
Result: Empty list
If {set S} has entries and {set A} has no entries
Result: The values are obtained by subtracting {set P} from {set S}
If {set S} AND {set A} have entries
Result: The list of values are obtained by:
a. Intersecting {set A} with {set S} to get {intermediate set I}
b. Subtracting {set P} from {intermediate set I}
If {set S} has no entries and {set A} has entries
Result: The list of values are obtained by subtracting {set P} from {set A}
Specifying Multiple Lists
If you specify multiple <ALLOWEDVALUE> sets at a particular point in time (for example, a work item type-wide <ALLOWEDVALUE> set plus a state-scoped <ALLOWEDVALUE> set), the intersection of these multiple sets is used as the final set, {set A}.
If you specify multiple <SUGGESTEDVALUES> sets or <PROHIBITEDVALUES> sets, the union of each of these multiple sets is taken as the final set, {set S} or {set P}, respectively.