This update is a +semver: major change. There are many config changes!
**Change 1:** Updates all Processors to use only `CommonEnrichersConfig`
and removes inline options. _Only options set in `CommonEnrichersConfig`
will be honored._
This will minimise the number of configuration options for processors,
and reduce confusion and support tickets.
1. `TfsNodeStructureOptions` has been made the default so `AreaMaps`,
`IterationMaps`, `NodeBasePaths`, `PrefixProjectToNodes`,
`ShouldCreateMissingRevisionPaths`, and `ReplicateAllExistingNodes` are
all removed from `WorkItemMigrationContext` and must instead be added to
`CommonEnrichersConfig` in line with
[TfsNodeStructure](https://nkdagility.com/learn/azure-devops-migration-tools/Reference/v2/ProcessorEnrichers/TfsNodeStructure/).
The documentation for `AreaMaps`, `IterationMaps`, `NodeBasePaths` has
all been moved here.
2. `TfsRevisionManagerOptions` has been made default so
`ReplayRevisions` and `MaxRevisions` is now only configurable by adding
a `TfsRevisionManagerOptions` section to `CommonEnrichersConfig`. See
[TfsRevisionManagerOptions](https://nkdagility.com/learn/azure-devops-migration-tools/Reference/v2/ProcessorEnrichers/TfsRevisionManager/)
3. 'TfsWorkItemLinkEnricherOptions' has been made the default moving its
option `FilterIfLinkCountMatches`, and `SaveAfterEachLinkIsAdded` to
`CommonEnrichersConfig`. See
[TfsWorkItemLinkEnricherOptions](https://nkdagility.com/learn/azure-devops-migration-tools/Reference/v2/ProcessorEnrichers/TfsWorkItemLinkEnricher/)
```
"CommonEnrichersConfig": [
{
"$type": "TfsNodeStructureOptions",
"PrefixProjectToNodes": false,
"NodeBasePaths": [],
"AreaMaps": {
"^Skypoint Cloud$": "MigrationTest5"
},
"IterationMaps": {
"^Skypoint Cloud\\\\Sprint 1$": "MigrationTest5\\Sprint 1"
},
"ShouldCreateMissingRevisionPaths": true,
"ReplicateAllExistingNodes": true
},
{
"$type": "TfsWorkItemLinkEnricherOptions",
"Enabled": true,
"FilterIfLinkCountMatches": true,
"SaveAfterEachLinkIsAdded": false
},
{
"$type": "TfsRevisionManagerOptions",
"Enabled": true,
"ReplayRevisions": true,
"MaxRevisions": 0
}
],
```
**Change 2:** Update the Query system to no longer have two parts that
are added together. All queries are now the full query. There are no
docs on this but a typical query now looks like:
```
"WIQLQuery": "SELECT [System.Id] FROM WorkItems WHERE [System.TeamProject] = @teamproject AND [System.WorkItemType] NOT IN ('Test Suite', 'Test Plan','Shared Steps','Shared Parameter','Feedback Request') ORDER BY [System.ChangedDate] desc",
```