Using Iteration and Area Maps - I'm Confused...

[BBurnett76]

I am trying to use the iteration and area maps to map everything that is missing but it doesn't appear to be working how I thought it would.

Currently I am getting errors stating that I have missing areas and iterations. I just want to map all iterations and areas to the project name node as the project that I am creating is purely or testing and will get blown away so effectively this information is not required.

My area and iteration maps in my WorkItemMigrationConfig section of the configuration.json config is:

  "SkipRevisionWithInvalidIterationPath": false,
  "SkipRevisionWithInvalidAreaPath": false,
  "PrefixProjectToNodes": true,
  "NodeBasePaths": null,
  "AreaMaps": {
	  "^Source Project" : "Target Project"
  },
  "IterationMaps": {
  "^Source Project" : "Target Project"		  
  }

My understanding is that the regex that I have will match anything starting with "Source Project" and replace is with "Target Process" effectively removing any actual iterations or sub areas. e.g. "Source Project\Area 1" will get mapped to "Target Project" and "Source Project\PI1\Sprint 2" will be mapped to "Target Project". The Target Project area path and iteration are created and do exist in the target project but I still get the "!! There are MISSING Area or Iteration Paths" message.

Is my understanding flawed, config wrong or is it just not working? Any help would be appreciated.

Version installed is 15.0.4...

[MrHinsh]

The mapping from Source to target is built in.

If there are other missing Area or iterations then you need to explicitly map them.

[MrHinsh]

Then you need to follow the instructions in the error message!

#1846

[BBurnett76]

I have do so but it doesn't appear to be working ..

[08:30:25 WRN] [v15.0.4] MISSING Area: sourcePath=MineStar Edge\Pit Supervisor, targetPath=null, anchored=False, IDs=81879
[08:30:25 WRN] [v15.0.4] MISSING Area: sourcePath=MineStar Edge\Pit Supervisor\Chennai Office, targetPath=null, anchored=False, IDs=81879
[08:30:25 WRN] [v15.0.4] MISSING Iteration: sourcePath=MineStar Edge\2021.3, targetPath=null, anchored=False, IDs=81879
[08:30:25 WRN] [v15.0.4] MISSING Iteration: sourcePath=MineStar Edge\2021.Q4, targetPath=null, anchored=False, IDs=81879
[08:30:25 WRN] [v15.0.4] MISSING Iteration: sourcePath=MineStar Edge, targetPath=null, anchored=False, IDs=81879
[08:30:25 WRN] [v15.0.4] MISSING Iteration: sourcePath=MineStar Edge\2022.Q2, targetPath=null, anchored=False, IDs=81879
[08:30:25 WRN] [v15.0.4] MISSING Iteration: sourcePath=MineStar Edge\PI2, targetPath=null, anchored=False, IDs=81879

And config:

  "PrefixProjectToNodes": true,
  "CreateMissingNodes": true,
  "NodeBasePaths": null,
  "AreaMaps": {
	  "^MineStar Edge([\\\\]?.*)$": "Office Req Tool Eval MR"
  },
  "IterationMaps": {
	  "^MineStar Edge([\\\\]?.*)$": "Office Req Tool Eval MR"		  
  }

"Office Req Tool Eval MR" is my target process and the base nodes have been created by the tool.

[BBurnett76]

After throwing this through a debug I determined that the configuration that I had was not being loaded in. I added TfsNodeStructureOptions to the commonEnricher sections with the appropriate mappings and it started working. I tried adding the UseCommonNodeStructureConfig: false to the WorkItemMigrationConfig but this didn't seem to have any effect. Not sure why the area and iteration maps are not being loaded in from the WorkItemMigrationConfig ... will see if I can work this out later.

[MrHinsh]

Where did you find examles that do not use TfsNodeStructureOptions. I'll work to get them removed or updated

These values were removed from WorkItemMigrationConfig over 6 months ago and do not work there.

I can't find any instances of UseCommonNodeStructureConfig referenced anywhere on the internet, or in our documentation.

[BBurnett76]

I was using your video located here: https://www.youtube.com/watch?v=Qt1Ywu_KLrc and I couldn't see any other examples in api