Skip to content

Commit

Permalink
Updated docs
Browse files Browse the repository at this point in the history
  • Loading branch information
MrHinsh committed Feb 5, 2024
1 parent 0c1f609 commit da8f093
Show file tree
Hide file tree
Showing 2 changed files with 22 additions and 2 deletions.
Original file line number Diff line number Diff line change
@@ -1,4 +1,3 @@

## <a name="WIQLQueryBits"></a>WIQL Query Bits

The Work Item queries are all built using Work Item [Query Language (WIQL)](https://docs.microsoft.com/en-us/azure/devops/boards/queries/wiql-syntax).
Expand Down Expand Up @@ -48,6 +47,8 @@ Moved to the ProcessorEnricher [TfsNodeStructure](../Reference/v2/ProcessorEnric

Moved to the ProcessorEnricher [TfsNodeStructure](../Reference/v2/ProcessorEnrichers/TfsNodeStructure/)



## More Complex Team Migrations
The above options allow you to bring over a sub-set of the WIs (using the `WIQLQueryBit`) and move their area or iteration path to a default location. However you may wish to do something more complex e.g. re-map the team structure. This can be done with addition of a `FieldMaps` block to configuration in addition to the `NodeBasePaths`.

Expand All @@ -73,4 +74,8 @@ A complete list of [FieldMaps](../Reference/v1/FieldMaps/index.md) are available
```

> Note: This mappings could also be achieved with other forms of Field mapper e.g. `RegexFieldMapConfig`, but the value mapper as an example is easy to understand
> Note: This mappings could also be achieved with other forms of Field mapper e.g. `RegexFieldMapConfig`, but the value mapper as an example is easy to understand
# Removed Properties

- PrefixProjectToNodes - This option was removed in favour of the Area and Iteration Maps on [TfsNodeStructure](../Reference/v2/ProcessorEnrichers/TfsNodeStructure/)
15 changes: 15 additions & 0 deletions docs/Reference/v2/ProcessorEnrichers/TfsNodeStructure-notes.md
Original file line number Diff line number Diff line change
Expand Up @@ -185,6 +185,21 @@ _NOTE: You need `\\` to escape a `\` the pattern, and `\\` to escape a `\` in JS

![image](https://github.com/nkdAgility/azure-devops-migration-tools/assets/5205575/2cf50929-7ea9-4a71-beab-dd8ff3b5b2a8)

### Example with PrefixProjectToNodes

This will prepend a bucket to the area and iteration paths. This is useful when you want to keep the original paths but also want to be able to identify them as being from the original project.

```json

```json
"AreaMaps": {
"^OriginalProject(?:\\\\([^\\\\]+))?\\\\([^\\\\]+)$": "TargetProject\\BucketForIncommingAreas\$2",
},
"IterationMaps": {
"^OriginalProject(?:\\\\([^\\\\]+))?\\\\([^\\\\]+)$": "TargetProject\\BucketForIncommingInterations\$2",
}
```

### Example with AreaMaps and IterationMaps

```
Expand Down

0 comments on commit da8f093

Please sign in to comment.