Define User Lists, Pick Lists, and Global Lists

You can enumerate a set of field values for a pick list, or drop-down menu, that appears in a work item form within a Team Foundation client. You can specify different types of lists, which are also referred to as pick lists, and you can combine lists, restrict to whom a list applies, and set conditions on when a list appears on the work item form.

You can define to support the following objectives:

  • Simple pick lists that apply to a single field within a work item type, or global lists that you can use across many work item types and team projects within a project collection. See Define Pick Lists.

    By using global lists, you can minimize the work that is required to update a list that multiple types of work items share. See Define Global Lists.

  • Specify allowed, suggested, or prohibited values within either a pick list or global list. You can achieve different types of lists by combining the ALLOWEDVALUES, SUGGESTEDVALUES, and PROHIBITEDVALUES elements in a list definition. See Use List Types in Combination

  • Combine lists, restrict to whom a list applies, and set conditions on when a list appears on the work item form.

  • Control whether a distribution list is expanded to show its individual members or a list is filtered by using the optional expanditems and filteritems. attributes. See Expand List Items and Exclude Groups from Lists

Specify pick lists only for fields whose data type corresponds to Integer or String.

Define the lists that appear in the drop-down menus for the following fields in other ways than by defining a pick list, as indicated:

  • Area Path or Iteration Path fields: Add area and iteration paths from the administration page for vstsweb. See Create and Modify Areas and Iterations,

  • State and Reason fields: Define the set of States and Reasons in the WORKFLOW section of the work item type. See Design the Workflow.

See Also

Concepts

Working with Work Item Fields

Customize Project Tracking Data, Forms, Workflow, and Other Objects