Using System Fields

All work item types share a set of predefined fields, some of which are marked as reportable. To allow for meaningful cross-team project reports and queries, you should use as many of these fields as possible that make sense for your work item type. This also makes your work item type more portable between Team Foundation servers.

The following system fields are supported:

Field Name

Reference Name

Type

Description

Default Reportable Field Value

Area Path

System.AreaPath

TreePath

The area of the work item. Note that the TreePath field type cannot be used for any other fields or user-defined fields

Dimension

AreaID

System.AreaId

Integer

The unique ID of the area to which this work item belongs.

Assigned To

System.AssignedTo

String

The user ID of the owner of the work item.

Dimension

AttachedFileCount

System.AttachedFileCount

Integer

The number of file attachments.

Authorized As

System.AuthorizedAs

String

The user account name of the authenticated user who did the last change.

Changed By

System.ChangedBy

String

Editable string for the person who last modified the work item.

Dimension

Changed Date

System.ChangedDate

DateTime

Date and time that the current revision was overwritten by a new revision.

Dimension

Created By

System.CreatedBy

String

The person who first created the work item.

Dimension

Created Date

System.CreatedDate

DateTime

Date and time the work item was first created.

Dimension

Description

System.Description

PlainText

The long description of a work item.

ExternalLinkCount

System.ExternalLinkCount

Integer

The number of links from this work item to non-work item artifacts registered by using the Team Foundation Linking Core Service.

History

System.History

History

The appendable history of a work item.

HyperLinkCount

System.HyperLinkCount

Integer

The number of hyperlinks.

ID

System.Id

Integer

The unique ID of the work item. Work item IDs are unique across all team projects and work items on a Team Foundation Server.

Dimension

Iteration Path

System.IterationPath

TreePath

The iteration of the work item. Note that the TreePath field type cannot be used for any other fields or user-defined fields

Dimension

IterationID

System.IterationId

Integer

The unique ID of the iteration to which this work item belongs.

Node Name

System.NodeName

String

The name of the parent node to which this work item belongs.

Reason

System.Reason

String

The reason the work item is in the current state. Values are specific to the state. The Reason field supports only the HELPTEXT and READONLY rule types.

Dimension

RelatedLinkCount

System.RelatedLinkCount

Integer

The number of links from this work item to other work items.

Rev

System.Rev

Integer

The historical revision of each work item.

Dimension

Revised Date

System.RevisedDate

DateTime

Date and time that the work item was revised.

State

System.State

String

Current state of the work item. The valid values for state are specific for each work item type. The State field supports only the HELPTEXT and READONLY rule types.

Dimension

Team Project

System.TeamProject

String

The team project to which this work item belongs.

Dimension

Title

System.Title

String

Short description of the bug used to differentiate it in a list.

Dimension

Work Item Type

System.WorkItemType

String

The name of the work item type of this work item.

Dimension

See Also

Concepts

Field Types

Field Names

Field Reference Names