Iteration/Area Mapping for missing history (old project)

[blamb21]

We are migrating from ADO to ADO (different Orgs). Target Project: "CompanyUno Migration Test" -- Source Project: "CompanyUno". CompanyUno had two projects: CompanyUno and CompanyUno Asset Management

We are having an error: Path \CompanyUno Migration Test Asset Management\Iteration is not anchored in the target project, it cannot be created

For the life of me I cannot figure out what we are missing. We had a similar issue with an Area Path we were able to resolve, but this time we are stuck. Im wondering if its related to a previous bug with spaces in the project name? It looks like its just not parsing in the names correctly in the path :/

here is what we have in the config:

{
"ChangeSetMappingFile": null,
"Source": {
"$type": "TfsTeamProjectConfig",
"Collection": "https://dev.azure.com/CompanyUno/",
"Project": "CompanyUno",
"ReflectedWorkItemIDFieldName": "Custom.ReflectedWorkItemId",
"AllowCrossProjectLinking": false,
"AuthenticationMode": "AccessToken",
"PersonalAccessToken": "xxxxxxx",
"PersonalAccessTokenVariableName": "",
"LanguageMaps": {
"AreaPath": "Area",
"IterationPath": "Iteration"
},
"CollectionName": "https://dev.azure.com/CompanyUno/"
},
"Target": {
"$type": "TfsTeamProjectConfig",
"Collection": "https://dev.azure.com/CompanyDos/",
"Project": "CompanyUno Migration Test",
"ReflectedWorkItemIDFieldName": "Custom.ReflectedWorkItemId",
"AllowCrossProjectLinking": false,
"AuthenticationMode": "AccessToken",
"PersonalAccessToken": "xxxxxx",
"PersonalAccessTokenVariableName": "",
"LanguageMaps": {
"AreaPath": "Area",
"IterationPath": "Iteration"
},
"CollectionName": "https://dev.azure.com/CompanyDos/"
},
"FieldMaps": [],
"GitRepoMapping": {},
"LogLevel": "Debug",
"CommonEnrichersConfig": [
{
"$type": "TfsNodeStructureOptions",
"Enabled": true,
"NodeBasePaths": [],
"AreaMaps": {
"^CompanyUno Asset Management$" : "CompanyUno Migration Test"
},
"IterationMaps": {
"^CompanyUno Asset Management\\Area" : "CompanyUno Migration Test\Archive\",
"^CompanyUno Asset Management\\Iteration" : "CompanyUno Migration Test\"
},
"ShouldCreateMissingRevisionPaths": true,
"ReplicateAllExistingNodes": true
}
],

Adding from log:
[20:11:09 DBG] [v15.0.4] NodeStructureEnricher.GetNewNodeName(CompanyUno Asset Management, Iteration)
[20:11:09 DBG] [v15.0.4] NodeStructureEnricher.GetNewNodeName::Mappers
[20:11:09 DBG] [v15.0.4] NodeStructureEnricher.GetNewNodeName::Mappers::^\CompanyUno Asset Management\Iteration
[20:11:09 DBG] [v15.0.4] NodeStructureEnricher.GetNewNodeName::Mappers::^\CompanyUno Asset Management\Iteration::NoMatch
[20:11:09 VRB] [v15.0.4] TfsNodeStructure:CheckForMissingPaths:GetNewNodeName::{"anchored":true,"sourcePath":"CompanyUno Asset Management","sourceSystemPath":null,"targetPath":"CompanyUno Migration Test Asset Management","targetSystemPath":null,"nodeType":"Iteration","startDate":null,"finishDate":null,"workItems":null,"sourcePathExists":false,"$type":"NodeStructureItem"}
[20:11:09 DBG] [v15.0.4] TfsNodeStructure:PopulateIterationDatesFronSource:\CompanyUno Asset Management\Iteration
[20:11:09 DBG] [v15.0.4] TfsNodeStructure:CheckForMissingPaths:CheckTarget::\CompanyUno Migration Test Asset Management\Iteration
[20:11:09 DBG] [v15.0.4] TfsNodeStructure:CheckForMissingPaths:CheckTarget::NOTFOUND:\CompanyUno Migration Test Asset Management\Iteration
[20:11:09 DBG] [v15.0.4] TfsNodeStructure:GetOrCreateNode(\CompanyUno Migration Test Asset Management\Iteration, null, null)
[20:11:10 INF] [v15.0.4] Processing Node: \CompanyUno Migration Test Asset Management\Iteration, start date: null, finish date: null
[20:11:10 DBG] [v15.0.4] Not Found:
[20:11:10 DBG] [v15.0.4] Not Found:
[20:11:10 INF] [v15.0.4] DONE in 00:04:05.5047247
[20:11:10 FTL] [v15.0.4] Error while running WorkItemMigration
System.InvalidOperationException: Path \CompanyUno Migration Test Asset Management\Iteration is not anchored in the target project, it cannot be created.

[blamb21]

I was able to get past the error by changing the mapping to this:

"CommonEnrichersConfig": [
{
"$type": "TfsNodeStructureOptions",
"Enabled": true,
"NodeBasePaths": [],
"AreaMaps": {
"^CompanyUno Asset Management" : "CompanyUno Migration Test"
},
"IterationMaps": {
"^CompanyUno Asset Management\\*" : "CompanyUno Migration Test\Iteration 1"
},
"ShouldCreateMissingRevisionPaths": true,
"ReplicateAllExistingNodes": true
}
],
--Iteration 1 already existed in target so it was meant as a 'placeholder' since i didnt know what actual work item was causing issues yet.

is there anyone who can explain why this worked compared to what I had in the original? It looks like Iteration and Area are just hidden values that ADO uses, but im not sure how do it without the * or if that is the correct way

[MrHinsh]

There are clear examples on https://nkdagility.com/learn/azure-devops-migration-tools/Reference/v2/ProcessorEnrichers/TfsNodeStructure/

Issues:

1. There is no "Iteration" or "Area" needed in the mapping... that's why we have two separate lists...
2. Your original (^CompanyUno Asset Management) would only match the exact name. It would not match any sub-items. This is a regular expression and you can use https://regex101.com/ to test your mappings.

A solution from the documentation linked:

"IterationMaps": {
  "^CompanyUno Asset Management\\\\(.*)" , "CompanyUno Migration Test\\$1",
},
"AreaMaps": {
   "^CompanyUno Asset Management\\\\(.*)" , "CompanyUno Migration Test\\$1",
}

This would do the following:

• CompanyUno Asset Management = CompanyUno Migration Test
• CompanyUno Asset Management\Area1= CompanyUno Migration Test\Area1
• CompanyUno Asset Management\Area1\Area2 = CompanyUno Migration Test\Area1\Area2

[blamb21]

thank you! I was testing it out but for some reason (not enough coffee probably), i kept leaving the $ in there. I appreciate all you do for this!