Tfs Work Item Link Tool

Tool for migrating work item links and relationships between work items, including shared steps and parameters for test cases.

Last updated: June 25, 2025 | Edit this page | Discuss this page

Tool for migrating work item links and relationships between work items, including shared steps and parameters for test cases.

top

Options

Parameter Type Description Default Value
Enabled Boolean If set to true then the tool will run. Set to false and the processor will not run. missing XML code comments
FilterIfLinkCountMatches Boolean Skip validating links if the number of links in the source and the target matches! missing XML code comments
SaveAfterEachLinkIsAdded Boolean Save the work item after each link is added. This will slow the migration as it will cause many saves to the TFS database. Not specified
top

Samples

top

Sample

Sample

{
  "MigrationTools": {
    "Version": "16.0",
    "CommonTools": {
      "TfsWorkItemLinkTool": {
        "Enabled": "True",
        "FilterIfLinkCountMatches": "True",
        "SaveAfterEachLinkIsAdded": "False"
      }
    }
  }
}
top

Defaults

Defaults

{
  "MigrationTools": {
    "Version": "16.0",
    "CommonTools": {
      "TfsWorkItemLinkTool": {
        "Enabled": "True",
        "FilterIfLinkCountMatches": "True",
        "SaveAfterEachLinkIsAdded": "False"
      }
    }
  }
}
top

Classic

Classic

{
  "$type": "TfsWorkItemLinkToolOptions",
  "Enabled": true,
  "FilterIfLinkCountMatches": true,
  "SaveAfterEachLinkIsAdded": false
}
top

Metadata

Project Information
Azure DevOps Marketplace
YouTube Channel
Maintainer

Created and maintained by Martin Hinshelwood of nkdagility.com

Documentation Versions
Production Azure DevOps Migration Tools Release Version
Preview Azure DevOps Migration Tools Preview Version
Getting Support
Community Support
Questions & Discussions

The first place to look for usage, configuration, and general help.

Commercial Support

We provide training, ad-hoc support, and full service migrations through our professional services.

Azure DevOps Migration Services
Documentation