Why are my WIT Links not migrating? Q&A-43 Part II

This blog post is a continuation from the post Why are my WIT Links not migrating? Q&A-43 and covers another scenario reported by our support engineers, where links are not migrating automatically (as expected).

Generally, when migrating between Team Projects based on a process template such as MSF for Agile Software Development, MSF for CMMI Process Improvement or Microsoft Visual Studio Scrum, or similar process template the migration of links just works.

In the following scenario, however, where we migrate from a Team Project based on the Conchango Scrum process template to a Team Project based on the MSF for Agile Software Development we encounter yet another scenario where the red question mark appears in the diagram (as below) to indicate that a link has gone missing.

… why?

The reason for this anomaly is that there are custom link types in the Conchango Scrum Process Template, which the TFS Integration Tools are unaware of and therefore need additional configuration settings. You can get the Linktype out of the wit definition and put that on the appropriate source side, in this case Left.

The configuration extract example is as follows:

        <LinkTypeMapping LeftMigrationSourceUniqueId=”…leftsourceguid…” 
                         RightMigrationSourceUniqueId=”…rightsourceguid…” />

Rerunning the migration using a session configuration with the link type mapping, as above, results in a happier migration results which include the link between the work items as shown below.

Another example, pulled from one of the ClearQuest configuration files from the readiness package, shows the same concept when migrating from Clear Quest to a Team project based on the MSF for CMMI Process Improvement process template:

        <LinkTypeMapping LeftMigrationSourceUniqueId=”…leftsourceguid…”
        <!– Request to Task(s) –>
        <LinkTypeMapping LeftMigrationSourceUniqueId=””…leftsourceguid…”
        <!– Request to Requirement(s) –>
        <LinkTypeMapping LeftMigrationSourceUniqueId=””…leftsourceguid…”
        <!– Request to StakeHolderRequest(s) –>
        <LinkTypeMapping LeftMigrationSourceUniqueId=””…leftsourceguid…”
        <!– Task(s) to Request –>
        <LinkTypeMapping LeftMigrationSourceUniqueId=””…leftsourceguid…”

The configuration guide that is included with the tooling will be updated accordingly in the next release.

Comments (6)

  1. Vaccano says:

    Good Stuff!  I made a custom tool to convert all the links to the right kind of links, but it looks like I needn't have done that.

    I want to do this with my next migration.  But I am a bit confused.  I see "..leftsourceguid…" and "…rightsourceguid…".  What are those?  Where do I get them? Or are they any old GUID?

  2. The …leftsourceguid… and …rightsourceguid… are placeholders for the GUIDs which represent the migration source. For example if you open the default ClearQuest.xml configuration template that ships with the tooling, you can scroll to the bottom to see an example of the LinkTypeMappings and a reference back to the Source configuration GUID, i.e.       <MigrationSource InternalUniqueId="BB2BD2C6-92B5-4817-AB51-A087B6532F0D" FriendlyName="CQ source" … which is at the beginning of the configuration file.

    Does this make sense?

  3. Gavin S says:

    This should allow a bit more fain-grained control..  We are moving from a system where everything is related to everything.  I'd like to specify that the related link between PBI -> SBI should become "Implemented By" while the related relationship between PBI -> bug remains related..  etc..  Is this possible?

  4. Manish Jain says:

    Thank you Willy!!! Where should I place <LinkTypeMappings>? Should I place <LinkTypeMappings> below  <ValueMaps />?




                 <Settings />


                   <!– Map only Bug to Bug

                   <WorkItemType LeftWorkItemTypeName="Bug" RightWorkItemTypeName="Bug" fieldMap="@@ALL@@" />





                 <ValueMaps />

  5. Manish Jain says:

    I found answer to earlier question: It's under Linking section: For e.g.


         <CustomSettings />


           <LinkTypeMapping LeftMigrationSourceUniqueId="d7916626-92d6-42e4-afb8-55c838b3aa8e"






  6. Justin65 says:

    This helps a lot but I can't seem to find the right "LinkType".

    I think I figured out my left source type (Microsoft.TeamFoundation.Migration.TFS.LinkType.WorkItemToWorkItem) but when I use "System.LinkTypes.Hierarchy" on the right side, I seem to get the opposite relation I want to get. (User Stories get a first "Parent" task and then raise an error because they only can have one parent).

    I must be very close to the solution but what would be the right type to map "childs" instead of "parents".

    <LinkTypeMapping LeftMigrationSourceUniqueId="205c034a-47a3-405d-af6c-09ecd26c5d8f"



                            RightLinkType="System.LinkTypes.Hierarchy"  />


    Any advice would be really appreciated!

    Thanks a lot,


Skip to main content