List Work Items (Default Flat List) (Team Explorer Everywhere)

You can generate a list of work items when you create a Flat List of Work Items query. A flat list of work items is especially useful when you want to perform any of the following tasks:

  • Find a work item with an unknown ID.

  • Check the status or other column fields of several related work items.

  • Find work items that you want to link to other work items.

After your query is defined, you can save it to reuse later or share it with other team members. For more information, see Organize and Set Permissions on Work Item Queries (Team Explorer Everywhere).

Required Permissions

To perform these procedures, you must be a member of the Readers group or your View work items in this node permission must be set to Allow. To save a query as a team query, you must have the appropriate permissions set. For more information, see Organize and Set Permissions on Work Item Queries (Team Explorer Everywhere) and the following page on the Microsoft Web site: Team Foundation Server Permissions.

To create and run a work item query

  1. Open your team project, expand the Work Items node, right-click Team Queries or My Queries and then click New Query.

    A new flat list of work items query opens.

  2. Click * in the left-most column to add a clause to the query.

  3. Click each column in the query clause to fill in the clause. If a column has a list of accepted values, click the arrow to specify one from the list.

    For a description of the available columns, see Query Fields, Operators, Values, and Variables (Team Explorer Everywhere).

  4. On the toolbar, click Run Query.

    You can also right-click in the query and click Run Query.

  5. Confirm that the query returned the results that you expected, and change the query as needed.

  6. Repeat steps 2 through 6 until you get the results that you want. Group or ungroup clauses as needed. For more information, see Specify Query Criteria.

  7. (Optional) Click Column Options (on the toolbar or in the shortcut menu) to modify which columns appear in the results or how the results are sorted.

    You might want to sort the query results to make it easier to find your data. For more information, see Add, Remove, Reorder, and Sort Columns (Team Explorer Everywhere).

  8. (Optional) On the File menu or toolbar, click Save.

    For more information, see Save, Copy, Rename, and Delete Work Item Queries (Team Explorer Everywhere).

See Also

Tasks

View and Modify Work Items in a Tree View (Team Explorer Everywhere)

View and Modify Work Items in a Direct Links View (Team Explorer Everywhere)

Add, Remove, Reorder, and Sort Columns (Team Explorer Everywhere)

Save, Copy, Rename, and Delete Work Item Queries (Team Explorer Everywhere)

Other Resources

Query Fields, Operators, Values, and Variables (Team Explorer Everywhere)

Finding Bugs, Tasks, and Other Work Items (Team Explorer Everywhere)

Work Items and Workflow (Agile)

Work Items and Workflow (CMMI)