X
23Mar

Migrating Work Items from 1 Team Project to another Team Project in VSTS

Hi ya'll, in this post I am gonna show you how to migrate work items from 1 Team Project (TP) to another TP in VSTS using the vsts work item migrator tool. WiMigrator is a command line tool designed to Migrate work items from one VSTS/TFS project to another.

In order to do so, below are the list of prerequisites.

  • VSTS Account
  • VSTS Work Item Migration tool, you can download it from [here](https://github.com/Microsoft/vsts-work-item-migrator)

Step 1: Prepare work items to migrate in VSTS

1. Locate the work items to be migrated from your source TP. In this example, let us consider the source TP by the name WISource.

    src_wiq

2.  We have 2000+ work items to be migrated as shown below.

     src_wiq1

3.  Download the migration tool and locate the file sample-configuration.json which is located in the path vsts-work-item-migrator-master\WiMigrator.

     configuration

 

Step 2: Configure the JSON

In this step, let us configure the JSON file required to migrate the work items.

1. Open the sample-configuration.json and modify the below highlighted sections as shown below-

  • Source account detials are as follows:

           account: fully qualified url for the source account for example https://YOUR_VSTS_ACCOUNT.visualstudio.com

           project: The name of the Team Project to migrate from

           access-token: The personal access token to use when accessing the account. This requires work item read permissions to all work items that are expected to be migrated

  • Target account details are as follows:

            account: fully qualified url for the target account for example https://YOUR_VSTS_ACCOUNT.visualstudio.com

            project: The name of the Team Project to migrate to

           access-token: The personal access token to use when accessing the account.

           query: the name of the query to use for identifying work items to migrate. Must be a flat query.

           skip-work-items-with-missing-area-path: Set this value to true. When the value is true, will skip the work item if the area path does not exist in the target account.

           skip-work-items-with-missing-area-path: Set this value to true. When true, will skip the work item if the iteration path does not exist in the target account.

  •  Email Notifications: By default the value is set to true, since in this post we are only concentrating on migration we would be setting the value to false as we do not want the notifications to be sent.

         configurationsetting...

 

2. Once the settings are done, save the changes.

Step3: Validate

WiMigrator checks the consistency by validating the metadata between the source and target project.

1. Launch the commandline from the downloaded path and run the below command to validate.

    dotnet run -v sample-configuration.json

   cmdlinequery1

2. Upon the command execution, you will be notified with a successful message to go ahead and proceed with the migration. If not you may have to recheck the settings in the configuration file and re validate.

   validate_msg

 

Step4: Migrate

Now that we have validated successfully in the above step, let us proceed with the migration.

1. Run the below command in order to migrate the work items.

   dotnet run -m sample-configuration.json

   migrate

2. Upon the command execution, you will be notified with a successful message of work items migrated.

   migration_msg

 

Step 5: Verify

Now that the migration is successful, verify by navigating to the target Team Project in your VSTS. You will see 2000+ work items being migrated.

trgt_wiq

 

Happy migrating

Related

How to Set Up Selenium WebDriver in Visual Studio Enterprise 2015?

Pre-requisite : Visual Studio Enterprise 2015 application should be installed into the system.Create...

Read More >

Uses of MS Dynamics NAV Query Object

Query is a new object in Microsoft Dynamics NAV 2013 that a programmer can use to define a set of da...

Read More >

Webinar - The process of version migration from older versions of Navision to NAV 2013 R2

Please watch LIVE RECORDING Video of the webinar session below which took place on 5th Jun...

Read More >

Sonar Integration with TFS for Java Projects

 Sonar Integration with JAVA.1.Download sonar-3.7 and sonar-runner-2.3*** unzip folders and cop...

Read More >

VSTS Rollup Service - How to use

          Hi All, Here i'm going to explain How VST...

Read More >

Understanding how to create and Install Windows Services in C#.Net

Windows Service in C#:This article is about how to create a Windows Service in C# .net using Visual ...

Read More >

Windows 8 Shortcut Keys -Useful

HotkeysPressing the Windows key and some specific keys can make you life easier. Here are some usefu...

Read More >

Threading

Multi-taskingIt is a concept of performing multiple tasks over a certain period of time by executing...

Read More >

Microsoft Dynamics ERP & CRM Solutions

Canarys has been a prominent Microsoft Dynamics NAV partner since the inception of the practice. We ...

Read More >

Building an Outlook 2010 Add In Using C#.NET With Visual Studio 2010

How to build an outlook 2010 Add In using C#.Net and Visual Studio 2010?In this post, I’l...

Read More >

Share

Try DevOpSmartBoard Ultimate complete Azure DevOps End-to end reporting tool

Sign Up

  • Recent
  • Popular
  • Tag
Tags
Monthly Archive
Subscribe
Name

Text/HTML
Text/HTML
Contact Us
  • *
  • *