Azure DevOps Migration Tools

v#{GitVersion.SemVer}#

Azure DevOps Migration Tools

Overview
 › 
 › 
 › 
 › 
 › 

WorkItemUpdate

Ref

  

Less than 1 minute to read

  

2024-07-25 08:35:34 -0500

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

Options

Parameter name Type Description Default Value
Enabled Boolean missng XML code comments missng 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 false
WhatIf Boolean missng XML code comments missng 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](#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 []

Example

A basic sample for WorkItemUpdate configuration.

1
2
3
4
5
6
7
8
9
10
{
  "$type": "WorkItemUpdateConfig",
  "Enabled": false,
  "WhatIf": false,
  "WIQLQuery": "SELECT [System.Id] FROM WorkItems WHERE [System.TeamProject] = @TeamProject AND [@ReflectedWorkItemIdFieldName] = ''  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
}