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 27, 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

ParameterTypeDescriptionDefault Value
EnabledBooleanIf set to true then the tool will run. Set to false and the processor will not run.missing XML code comments
FilterIfLinkCountMatchesBooleanSkip validating links if the number of links in the source and the target matches!missing XML code comments
SaveAfterEachLinkIsAddedBooleanSave 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

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