Partager via


Link controls, restrictions, and field reference

Work item forms contain these tabs for linking: Implementation, Links, All Links and Test Cases. This topic describes the controls and data fields that are associated with creating links and hyperlinks.

For more information about how to use links, see Link work items. To add link types, see Manage link types [witadmin]. To customize the link controls and restrictions, you modify the definition of the LinksControlOptions for a work item type, see Define link controls to restrict link relationships.

Each tab has a toolbar with buttons. The links control toolbar for Team Web Access, shown here, has a subset of these controls:

Links control toolbar (Team Explorer)

Work item form link toolbar controls

These buttons become available only after you perform a specific action:

  • The button to create a work item that is linked to the open work item (Add New Linked Work Item icon) becomes available only after you save the open work item.

  • The buttons to open the list of work items in a query (Open in Query) and Open in OfficeOpen in Microsoft Office become available only when at least one work item is listed in the links control tab.

  • The buttons to open a work item (Open Work Item), edit a link (Edit link), and delete a link (Delete link) become available only after you click one or more work items listed in the links control tab.

The Storyboards links control restricts users to add links only to storyboards or network shared files. With this control, you can add a new link, open a linked item, and delete a link. Also, only the Team Web Access version displays the Start Storyboarding link within the toolbar.

Storyboards links control (Team Web Access)

Storyboard links control in Team Web Access

All tabs that support creating links between work items are implemented by using the LinksControl element on the work item form. This element controls filtering and restricting the types of work items to which you can link, the types of links that you can create, and whether you can link to work items in another team project. For more information about how to restrict links, see LinksControlOptions Elements.

Scrum process template

The Scrum process template defines the link control restrictions shown here. For descriptions of the work item types, see Visual Studio Scrum process template for Visual Studio ALM.

Tab name

Work item type

Link restrictions

All Links

Feedback Request

Feedback Response

  • No restrictions.

Links

Product Backlog Item

Bug

Impediment

Shared steps

Task

Test Case

  • No restrictions.

Links

Code Review Request

  • Allows only Parent and Child links to Code Review Response work items.

  • Excludes links to work items in other team projects.

Stories

Feedback Response

  • Allows only Related links.

  • Allows links to Bug and Product Backlog Items.

  • Excludes links to work items in other team projects.

Storyboards

Product Backlog Item

  • Allows only Storyboard links.

Tasks

Product Backlog Item

  • Allows only Child links to Tasks.

  • Excludes links to work items in other team projects.

Test Cases

Product Backlog Item

Bug

  • Allows only Tested By links.

  • Allows links only to test cases.

  • Excludes links to work items in other team projects.

Tested Backlog Items

Test case

  • Allows only Tests links.

  • Allows links to Bug and Product Backlog Items.

  • Excludes links to work items in other team projects.

Agile process template

The Agile process template defines the link control restrictions shown here. For descriptions of the work item types, see Agile process template work item types and workflow.

Tab name

Work item type

Link restrictions

All Links

User story

Bug

Feedback Request

Task

Test Case

  • No restrictions.

Implementation

User story

Task

  • Allows only Parent and Child links between user stories and tasks.

  • Excludes links to work items in other team projects.

Links

Issue

Shared steps

  • No restrictions.

Links

Code Review Request

  • Allows only Parent and Child links to Code Review Response work items.

  • Excludes links to work items in other team projects.

Stories

Feedback Response

  • Allows only Related links to user stories.

  • Excludes links to work items in other team projects.

Storyboards

User Story

  • Allows only Storyboard links.

Test Cases

User story

Bug

  • Allows only Tested By links.

  • Allows links only to test cases.

  • Excludes links to work items in other team projects.

Tested User Stories

Test case

  • Allows only Tests links.

  • Allows links only to user stories.

  • Excludes links to work items in other team projects.

CMMI process template

The CMMI process template defines the link control restrictions shown her . For descriptions of the work item types, see CMMI process template work item types and workflow.

Tab name

Work item type

Link restrictions

All Links

Requirement

Bug

Change Request

Feedback Request

Issue

Review

Risk

Shared Steps

Task

Test Case

  • No restrictions.

Implementation

Task

  • Allows only Parent and Child links between requirements and tasks.

  • Excludes links to work items in other team projects.

Links

Code Review Request

  • Allows only Parent and Child links to Code Review Response work items.

  • Excludes links to work items in other team projects.

Requirements

Change Request

  • Allows only Affects link type to link change requests to requirements.

  • Excludes links to work items in other team projects.

Stories

Feedback Response

  • Allows only Related links to requirements.

  • Excludes links to work items in other team projects.

Storyboards

Requirement

  • Allows only Storyboard links.

Test Cases

Requirement

Bug

  • Allows only Tested By links.

  • Allows links only to test cases.

  • Excludes links to work items in other team projects.

Tested Requirements

Test case

  • Allows only Tests links.

  • Allows links only to requirements.

  • Excludes links to work items in other team projects.

All lists of links display these data fields:

  • Work item ID

  • Work Item Type

  • Title

  • Assigned to

  • State

  • [Link Comment]

You can add or remove columns from the list of links, and you can customize the default columns and the column order. For more information, see LinksControlOptions Elements.

For more information about these fields, see Titles, IDs, Descriptions, and History field reference and Assignments and workflow field reference.

The following table describes the [Link Comment] data field. For information about data types and default field values, see Define and modify work item fields.

Field Name

Description

Reference Name

Data Type

Default Value for the Reportable Type Attribute

Default Value for the Index Attribute

Link Comment

Contains comments from the team member who created the link. You can configure this attribute field to appear as a column in a list of links on a work item form.

System.Links.Comment

PlainText

None

False

Additional fields that support query and reporting

Some fields do not appear on the work item forms but are tracked for each type of work item when you link them. You can use these fields to filter queries and create reports.

Field Name

Description

Reference Name

Data Type

Default Value for the Reportable Type Attribute

Default Value for the Index Attribute

External Link Count

The number of links from the work item to artifacts that are not work items and that are registered through the Team Foundation Linking Service. For more information, see this topic on the Microsoft Web site: Linking Service.

System.ExternalLinkCount

Integer

None

False

Hyperlink Count

The number of hyperlinks that are defined for the work item.

System.HyperLinkCount

Integer

None

False

Related Link Count

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

System.RelatedLinkCount

Integer

None

False

Link Description

Contains the work item type, ID, and title of the work item that is the target of the link. You can configure this link attribute field to appear as a column in a list of links on a work item form.

System.Links.Description

PlainText

None

False

The default process templates in TFS provide reports that require you to create links between specific work items.

Process template

Report

Link requirements

Scrum

Backlog Overview (Scrum)

Link PBIs and tasks (Parent-Child) and PBIs and test cases (Tested by-Tests).

Agile

Stories Overview Report (Agile)

Stories Progress Report (Agile)

Link user stories and tasks (Parent-Child) and user stories and test cases (Tested by-Tests). Link each bug to the test case that identified the code defect (Tested By) or link it to the user story (Related).

CMMI

Requirements Overview Report (CMMI)

Requirements Progress Report (CMMI)

Link requirements and tasks (Parent-Child) and requirements and test cases(Tested by-Tests). Link each bug to the test case that identified the code defect (Tested By) or link it to the requirement (Related).

See Also

Concepts

Work item field reference for Visual Studio ALM