Define a Custom Link Type

You can customize an existing link type or create a link type to meet your project tracking requirements. You use a link type to define the link labels, topology type, and restrictions that are used when creating relationships between work items. You can customize an existing link type or create a link type to meet your project tracking requirements.

You may want to modify or create a link type for one of the following reasons:

• Change the link labels that are used to match your team's naming conventions.

• Add a link type to track a particular relationship that is unique to your team's process.

Before you start to add or modify a link type, you should assess the link types available and how they are used in your team project. See Link Work Items and Objects to Support Traceability.

The link type is specified in a type definition XML file that you import to a team project collection. See Link Type Element Reference.

With the witadmin command-line utility, you can deactivate, delete, export, import, list, and reactivate link types. See Customizing and Managing Link Types [witadmin].

Links are added through the work item form, which contains the links control. See Link Controls, Restrictions, and Field Reference.

In addition to defining link types, you can customize the work item type definition to accept or prohibit specific links based on link type. You use the LinksControlOptions element to define the options that control what links can be added to a work item and to which work item types. Also, you can specify the default columns that you want to appear for the list of links in a work item. For more information, see Define Link Controls to Restrict Link Relationships.

See Also

Concepts

Choose Link Types to Effectively Track Your Project

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