Tfs WorkItem Bulk Edit Processor

This processor allows you to make changes in place where we load from the Target and update the Target. This is used for bulk updates with the most common reason being a process template change.

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

This processor allows you to make changes in place where we load from the Target and update the Target. This is used for bulk updates with the most common reason being a process template change.

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
WhatIf Boolean Gets or sets a value indicating whether to run in “what if” mode without making actual changes to work items. Not specified
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": "TfsWorkItemBulkEditProcessorOptions",
  "Enabled": false,
  "WhatIf": false,
  "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",
  "WorkItemIDs": null,
  "FilterWorkItemsThatAlreadyExistInTarget": false,
  "PauseAfterEachWorkItem": false,
  "WorkItemCreateRetryLimit": 0,
  "SourceName": null,
  "TargetName": null
}
top

Metadata

Metadata

Class Name
TfsWorkItemBulkEditProcessor
Status
Missing XML Code Comments
Processing Target
WorkItem
Type
Processors
Previous Tfs Test Variables Migration Processor
Next Tfs WorkItem Delete 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