7/31/2019 Querying Against Work Items

1/15

7/31/2019 Querying Against Work Items

2/15

Agenda Introduction to Work Item Queries The Structure of a Work Item Query

Work Item Query Types

2

7/31/2019 Querying Against Work Items

3/15

What Are Work Item Queries? A typical development project may contain

thousands or more of work items

You will usually work with only a small

subset of all these work items Work Item queries are the means for asking

TFS 2010 to retrieve only the work itemsthat are of interest to you

3

7/31/2019 Querying Against Work Items

4/15

Using Work Item Queries, YouCan Retrieve all tasks that are assigned toyou

Locate all bugs that have been resolved

during the last week Pinpoint all user stories that have pending

issues

4

7/31/2019 Querying Against Work Items

5/15

5

Work Item Queries - Example

7/31/2019 Querying Against Work Items

6/15

6

Work Item Queries - Example

7/31/2019 Querying Against Work Items

7/15

Where Can You Save Work ItemQueries? Work item queries can be

saved so that they areavailable for an entire

team or for an individualuser only

7

You can also save queries in .wiqfiles for easy transfer betweendifferent machines

7/31/2019 Querying Against Work Items

8/15

Work Item Query Structure Queries are composed ofclauses. Clauses contain field names, values and

queryoperators

A field name specifies which work itemfield is being matched

A value specifies the contents to which thework item fields contents are compared

A queryoperator describes how acomparison is performed between the workitem field and the value in the query

8

7/31/2019 Querying Against Work Items

9/15

Grouping of Query Clauses Multiple query clauses may be grouped

together to work as a single unit

You can group clauses using and as well asor

operators The first grouping operator determines the

relationship of the entire clause with therest of the query

9

7/31/2019 Querying Against Work Items

10/15

Work Item Query Types Work query types allow you to decide

whether to apply criteria to work item linksas well as work item field values.

10

http://blogs.msdn.com/b/syedab/archive/2010/06/10/how-to-create-and-useT-team-foundation-server-2010-queries.aspx The following work itemquery types are

supported in TFS 2010: Flat List

Tree of Work Items

Work Items and DirectLinks

7/31/2019 Querying Against Work Items

11/15

Work Item Query Types (cont.) Flat List This is the default work item

query type. It returns a list of work itemsthat match the criteria you specify for theirfields.

11

7/31/2019 Querying Against Work Items

12/15

Work Item Query Types (cont.) Tree of Work Items This query type

returns a tree of work items that matchcriteria you specify on parent and child workitems only.

12

7/31/2019 Querying Against Work Items

13/15

Work Item Query Types (cont.) Work Item and Direct Links This query

type returns a tree of work items that matchcriteria you specify on parent and child workitems, as well as on the links between them.

13

7/31/2019 Querying Against Work Items

14/15

Predefined Work Item Queries TFS 2010 supplies a number of predefined

work item queries as part of the processtemplate.

Queries are defined using .wiq files You can customize the process template to

customize existing queries or define newqueries needed by your project or

organizations development process

14

7/31/2019 Querying Against Work Items

15/15

In Conclusion, Work Item QueriesAllow You To.. Specify criteria for retrieving a subset of

work items youre interested in from all

work items in the project Take work item linkstypes into account

when specifying criteria to match

Customize your projects and/or processtemplates to contain queries of interest tothe entire team

15