Tfs WorkItem Overwrite Processor

Reapply field mappings after a migration. Does not migrate Work Items, only reapplies changes to field mappings.

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

Reapply field mappings after a migration. Does not migrate Work Items, only reapplies changes to field mappings.

top

Options

Parameter Type Description Default Value
Enabled Boolean If set to true then the processor will run. Set to false and the processor will not run. missing XML code comments
FilterWorkItemsThatAlreadyExistInTarget Boolean This loads all of the work items already saved to the Target and removes them from the Source work item list prior to commencing the run. While this may take some time in large data sets it reduces the time of the overall migration significantly if you need to restart. true
PauseAfterEachWorkItem Boolean Pause after each work item is migrated Not specified
SourceName String This is the IEndpoint that will be used as the source of the Migration. Can be null for a write only processor. missing XML code comments
TargetName String This is the IEndpoint that will be used as the Target of the Migration. Can be null for a read only processor. missing XML code comments
WIQLQuery String A work item query based on WIQL to select only important work items. To migrate all leave this empty. See WIQL Query Bits AND [Microsoft.VSTS.Common.ClosedDate] = '' AND [System.WorkItemType] NOT IN ('Test Suite', 'Test Plan','Shared Steps','Shared Parameter','Feedback Request')
WorkItemCreateRetryLimit Int32 beta If set to a number greater than 0 work items that fail to save will retry after a number of seconds equal to the retry count. This allows for periodic network glitches not to end the process. 5
WorkItemIDs IList A list of work items to import []
top

Samples

top

Sample

Sample 

There is no sample, but you can check the classic below for a general feel.
top

Defaults

Defaults 

There are no defaults! Check the sample for options!
top

Classic

Classic 

{
  "$type": "TfsWorkItemOverwriteProcessorOptions",
  "Enabled": false,
  "WorkItemIDs": null,
  "WIQLQuery": "SELECT [System.Id] FROM WorkItems WHERE [System.TeamProject] = @TeamProject AND [@ReflectedWorkItemIdField] = ''  AND [System.WorkItemType] NOT IN ('Test Suite', 'Test Plan','Shared Steps','Shared Parameter','Feedback Request') ORDER BY [System.ChangedDate] desc",
  "FilterWorkItemsThatAlreadyExistInTarget": false,
  "PauseAfterEachWorkItem": false,
  "WorkItemCreateRetryLimit": 0,
  "SourceName": null,
  "TargetName": null
}
top

Metadata

Metadata

Class Name
TfsWorkItemOverwriteProcessor
Status
Preview
Processing Target
Work Items
Type
Processors
Previous Tfs WorkItem Overwrite Areas As Tags Processor
Next WorkItem Tracking Processor
Project Information
Azure DevOps Marketplace
Visual Studio Marketplace Stars View Extension
YouTube Channel
Youtube Subscribers Youtube Views
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