Azure DevOps Migration Tools

v15.2.0

Azure DevOps Migration Tools allow you to migrate Teams, Backlogs, Tasks, Test Cases, and Plans & Suits from one Project to another in Azure DevOps / TFS both within the same Organisation, and between Organisations.

Home
 › 
Learn
 › 
Overview
 › 
Reference
 › 
V1
 › 
Processors
Overview

Processors

Article

  

3 minutes to read

  

2024-09-06 09:35:04 +0100

We provide a number of Processors that can be used to migrate diferent sorts of data. These processors are the original traditional processors.

Name Status Target Usage
CreateTeamFolders alpha Shared Queries

Creates folders in Sared Queries for each Team

ExportProfilePictureFromADContext alpha Profiles

Downloads corporate images and updates TFS/Azure DevOps profiles

ExportTeamList missng XML code comments missng XML code comments

missng XML code comments

ExportUsersForMapping missng XML code comments missng XML code comments

missng XML code comments

ExportUsersForMappingContext ready Work Items

ExportUsersForMappingContext is a tool used to create a starter mapping file for users between the source and target systems. Use ExportUsersForMappingConfig to configure.

FakeProcessor missng XML code comments missng XML code comments

Note: this is only for internal usage. Don’t use this in your configurations.

FixGitCommitLinks missng XML code comments missng XML code comments

missng XML code comments

ImportProfilePictureContext alpha Profiles

Downloads corporate images and updates TFS/Azure DevOps profiles

TeamMigrationContext preview Teams

Migrates Teams and Team Settings: This should be run after NodeStructuresMigrationConfig and before all other processors.

TestConfigurationsMigrationContext Beta Suites & Plans

This processor can migrate test configuration. This should be run before LinkMigrationConfig.

TestPlansAndSuitesMigrationContext Beta Suites & Plans

Rebuilds Suits and plans for Test Cases migrated using the WorkItemMigration

TestVariablesMigrationContext Beta Suites & Plans

This processor can migrate test variables that are defined in the test plans / suites. This must run before TestPlansAndSuitesMigrationConfig.

WorkItemBulkEditProcessor missng XML code comments WorkItem

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.

WorkItemDelete ready WorkItem

The WorkItemDelete processor allows you to delete any amount of work items that meet the query. DANGER: This is not a recoverable action and should be use with extream caution.

WorkItemMigrationContext ready Work Items

WorkItemMigrationConfig is the main processor used to Migrate Work Items, Links, and Attachments. Use WorkItemMigrationConfig to configure.

WorkItemPostProcessingContext preview Work Items

Reapply field mappings after a migration. Does not migtate Work Items, only reapplied changes to filed mappings.

WorkItemQueryMigrationContext preview Shared Queries

This processor can migrate queries for work items. Only shared queries are included. Personal queries can’t migrate with this tool.

WorkItemUpdateAreasAsTagsContext Beta Work Item

A common issue with older TFS/Azure DevOps instances is the proliferation of Area Paths. With the use of Area Path for Teams and the addition of the Node Name column option these extensive tag hierarchies should instad be moved to tags.

Processor Options

All processors have a minimum set of options that are required to run.

Minimum Options to run

The Enabled options is common to all processors.

     {
      "$type": "ProcessorConfig",
      "Enabled": true,
    }
Project Details
Chocolatey GitHub release Build on VSTS

Getting Support

Open Source Support

Question & Discussion - The first place to look for usage, configuration, and general help.

Professional Support

We provide training, ad-hoc support, and full service migrations through Azure DevOps Migration Services

In this article