Commit 5f7edda
authored
Add better logic for diferent tfs versions (#2960)
This pull request updates the schema and documentation for several
TFS/Azure DevOps endpoint configuration files to improve flexibility and
clarity. The most significant changes are the addition of a new
`ProductVersion` option, making several previously required fields
optional, and removing legacy processor options. These updates are
reflected across the YAML documentation and JSON schema files.
**Schema and Documentation Enhancements:**
* Added a new optional `ProductVersion` parameter to TFS endpoint
options, allowing users to specify the TFS product version for
compatibility and feature support. The default is "OnPremises" for TFS
2013+ and Azure DevOps Server.
(`[[1]](diffhunk://#diff-1b65e7ad11e417a8638f7ccda9f90feb4c400542ba71f54ae77030ce20b383d6L131-R145)`,
`[[2]](diffhunk://#diff-298ed9f2cb74a86ed0214311effa01a9f8cecd84e062261b832744f68599e282L127-R141)`,
`[[3]](diffhunk://#diff-5bf4ba0d1a55b31d78d862ef25bf3ad64f65e81c38f8280c8b2d13e373bf4d22L68-R82)`,
`[[4]](diffhunk://#diff-b1f465cdd3e8a1c7ce0907028b191384e1895af0e81590fc33077dbd8a59c799L69-R83)`,
`[[5]](diffhunk://#diff-52f03d9f526916598fa826728ae4633eae3ac279b3dd76548f1e6fdb93686ae4R178-R181)`,
`[[6]](diffhunk://#diff-52f03d9f526916598fa826728ae4633eae3ac279b3dd76548f1e6fdb93686ae4R268-R271)`,
`[[7]](diffhunk://#diff-52f03d9f526916598fa826728ae4633eae3ac279b3dd76548f1e6fdb93686ae4R358-R361)`,
`[[8]](diffhunk://#diff-52f03d9f526916598fa826728ae4633eae3ac279b3dd76548f1e6fdb93686ae4R448-R451)`,
`[[9]](diffhunk://#diff-3410394864cb550a523ff6ed7634bf6cd64568b4a85f68c9ac600b8ff4ea15a8R36-R39)`)
**Relaxing Required Options:**
* Made `LanguageMaps` and `ReflectedWorkItemIdField` optional
(previously required) in TFS endpoint and team project/team settings
endpoint configurations, both in YAML and JSON schema.
(`[[1]](diffhunk://#diff-1b65e7ad11e417a8638f7ccda9f90feb4c400542ba71f54ae77030ce20b383d6L131-R145)`,
`[[2]](diffhunk://#diff-298ed9f2cb74a86ed0214311effa01a9f8cecd84e062261b832744f68599e282L127-R141)`,
`[[3]](diffhunk://#diff-5bf4ba0d1a55b31d78d862ef25bf3ad64f65e81c38f8280c8b2d13e373bf4d22L68-R82)`,
`[[4]](diffhunk://#diff-b1f465cdd3e8a1c7ce0907028b191384e1895af0e81590fc33077dbd8a59c799L69-R83)`,
`[[5]](diffhunk://#diff-52f03d9f526916598fa826728ae4633eae3ac279b3dd76548f1e6fdb93686ae4L196-L198)`,
`[[6]](diffhunk://#diff-52f03d9f526916598fa826728ae4633eae3ac279b3dd76548f1e6fdb93686ae4L284-L286)`,
`[[7]](diffhunk://#diff-52f03d9f526916598fa826728ae4633eae3ac279b3dd76548f1e6fdb93686ae4L372-L374)`,
`[[8]](diffhunk://#diff-52f03d9f526916598fa826728ae4633eae3ac279b3dd76548f1e6fdb93686ae4L478-L480)`,
`[[9]](diffhunk://#diff-3410394864cb550a523ff6ed7634bf6cd64568b4a85f68c9ac600b8ff4ea15a8L48-R52)`)
* Updated configuration samples to reflect the new defaults for
`ReflectedWorkItemIdField` and the inclusion of `ProductVersion`.
(`[[1]](diffhunk://#diff-5bf4ba0d1a55b31d78d862ef25bf3ad64f65e81c38f8280c8b2d13e373bf4d22L23-R28)`,
`[[2]](diffhunk://#diff-b1f465cdd3e8a1c7ce0907028b191384e1895af0e81590fc33077dbd8a59c799L24-R29)`,
`[[3]](diffhunk://#diff-298ed9f2cb74a86ed0214311effa01a9f8cecd84e062261b832744f68599e282L86-R87)`,
`[[4]](diffhunk://#diff-1b65e7ad11e417a8638f7ccda9f90feb4c400542ba71f54ae77030ce20b383d6L90-R91)`)
**Processor Option Cleanup:**
* Removed the `UpdateCreatedBy` and `UpdateCreatedDate` options from the
TFS work item migration processor, both from documentation and schema,
as these are no longer supported or necessary.
(`[[1]](diffhunk://#diff-631e837a607e4e39820d4cec5df379f2c10276d3fea8b6fa10aac11227ba0eb7L62-L63)`,
`[[2]](diffhunk://#diff-631e837a607e4e39820d4cec5df379f2c10276d3fea8b6fa10aac11227ba0eb7L164-L181)`,
`[[3]](diffhunk://#diff-52f03d9f526916598fa826728ae4633eae3ac279b3dd76548f1e6fdb93686ae4L1461-L1470)`)
**General Documentation Improvements:**
* Updated descriptions and clarified the purpose of new and existing
options in the YAML documentation for endpoints and processors.
(`[[1]](diffhunk://#diff-1b65e7ad11e417a8638f7ccda9f90feb4c400542ba71f54ae77030ce20b383d6L131-R145)`,
`[[2]](diffhunk://#diff-298ed9f2cb74a86ed0214311effa01a9f8cecd84e062261b832744f68599e282L127-R141)`,
`[[3]](diffhunk://#diff-5bf4ba0d1a55b31d78d862ef25bf3ad64f65e81c38f8280c8b2d13e373bf4d22L68-R82)`,
`[[4]](diffhunk://#diff-b1f465cdd3e8a1c7ce0907028b191384e1895af0e81590fc33077dbd8a59c799L69-R83)`,
`[[5]](diffhunk://#diff-52f03d9f526916598fa826728ae4633eae3ac279b3dd76548f1e6fdb93686ae4R178-R181)`,
`[[6]](diffhunk://#diff-52f03d9f526916598fa826728ae4633eae3ac279b3dd76548f1e6fdb93686ae4R268-R271)`,
`[[7]](diffhunk://#diff-52f03d9f526916598fa826728ae4633eae3ac279b3dd76548f1e6fdb93686ae4R358-R361)`,
`[[8]](diffhunk://#diff-52f03d9f526916598fa826728ae4633eae3ac279b3dd76548f1e6fdb93686ae4R448-R451)`,
`[[9]](diffhunk://#diff-3410394864cb550a523ff6ed7634bf6cd64568b4a85f68c9ac600b8ff4ea15a8R36-R39)`)
These changes make endpoint configuration more flexible and up-to-date
with current usage patterns, while simplifying processor options and
improving documentation clarity.File tree
14 files changed
+109
-102
lines changed- docs
- data/classes
- static/schema
- src/MigrationTools.Clients.TfsObjectModel
- Endpoints
- Processors
14 files changed
+109
-102
lines changed| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
87 | 87 | | |
88 | 88 | | |
89 | 89 | | |
90 | | - | |
| 90 | + | |
| 91 | + | |
91 | 92 | | |
92 | 93 | | |
93 | 94 | | |
| |||
128 | 129 | | |
129 | 130 | | |
130 | 131 | | |
131 | | - | |
| 132 | + | |
132 | 133 | | |
133 | 134 | | |
134 | 135 | | |
135 | 136 | | |
136 | 137 | | |
137 | 138 | | |
138 | 139 | | |
| 140 | + | |
| 141 | + | |
| 142 | + | |
| 143 | + | |
| 144 | + | |
| 145 | + | |
139 | 146 | | |
140 | 147 | | |
141 | 148 | | |
| |||
146 | 153 | | |
147 | 154 | | |
148 | 155 | | |
149 | | - | |
| 156 | + | |
150 | 157 | | |
151 | 158 | | |
152 | 159 | | |
| |||
Lines changed: 10 additions & 3 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
83 | 83 | | |
84 | 84 | | |
85 | 85 | | |
86 | | - | |
| 86 | + | |
| 87 | + | |
87 | 88 | | |
88 | 89 | | |
89 | 90 | | |
| |||
124 | 125 | | |
125 | 126 | | |
126 | 127 | | |
127 | | - | |
| 128 | + | |
128 | 129 | | |
129 | 130 | | |
130 | 131 | | |
131 | 132 | | |
132 | 133 | | |
133 | 134 | | |
134 | 135 | | |
| 136 | + | |
| 137 | + | |
| 138 | + | |
| 139 | + | |
| 140 | + | |
| 141 | + | |
135 | 142 | | |
136 | 143 | | |
137 | 144 | | |
| |||
142 | 149 | | |
143 | 150 | | |
144 | 151 | | |
145 | | - | |
| 152 | + | |
146 | 153 | | |
147 | 154 | | |
148 | 155 | | |
| |||
Lines changed: 11 additions & 4 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
20 | 20 | | |
21 | 21 | | |
22 | 22 | | |
23 | | - | |
| 23 | + | |
24 | 24 | | |
25 | 25 | | |
26 | 26 | | |
27 | | - | |
| 27 | + | |
| 28 | + | |
28 | 29 | | |
29 | 30 | | |
30 | 31 | | |
| |||
65 | 66 | | |
66 | 67 | | |
67 | 68 | | |
68 | | - | |
| 69 | + | |
69 | 70 | | |
70 | 71 | | |
71 | 72 | | |
72 | 73 | | |
73 | 74 | | |
74 | 75 | | |
75 | 76 | | |
| 77 | + | |
| 78 | + | |
| 79 | + | |
| 80 | + | |
| 81 | + | |
| 82 | + | |
76 | 83 | | |
77 | 84 | | |
78 | 85 | | |
| |||
83 | 90 | | |
84 | 91 | | |
85 | 92 | | |
86 | | - | |
| 93 | + | |
87 | 94 | | |
88 | 95 | | |
89 | 96 | | |
| |||
Lines changed: 11 additions & 4 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
21 | 21 | | |
22 | 22 | | |
23 | 23 | | |
24 | | - | |
| 24 | + | |
25 | 25 | | |
26 | 26 | | |
27 | 27 | | |
28 | | - | |
| 28 | + | |
| 29 | + | |
29 | 30 | | |
30 | 31 | | |
31 | 32 | | |
| |||
66 | 67 | | |
67 | 68 | | |
68 | 69 | | |
69 | | - | |
| 70 | + | |
70 | 71 | | |
71 | 72 | | |
72 | 73 | | |
73 | 74 | | |
74 | 75 | | |
75 | 76 | | |
76 | 77 | | |
| 78 | + | |
| 79 | + | |
| 80 | + | |
| 81 | + | |
| 82 | + | |
| 83 | + | |
77 | 84 | | |
78 | 85 | | |
79 | 86 | | |
| |||
90 | 97 | | |
91 | 98 | | |
92 | 99 | | |
93 | | - | |
| 100 | + | |
94 | 101 | | |
95 | 102 | | |
96 | 103 | | |
| |||
Lines changed: 0 additions & 20 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
59 | 59 | | |
60 | 60 | | |
61 | 61 | | |
62 | | - | |
63 | | - | |
64 | 62 | | |
65 | 63 | | |
66 | 64 | | |
| |||
161 | 159 | | |
162 | 160 | | |
163 | 161 | | |
164 | | - | |
165 | | - | |
166 | | - | |
167 | | - | |
168 | | - | |
169 | | - | |
170 | | - | |
171 | | - | |
172 | | - | |
173 | | - | |
174 | | - | |
175 | | - | |
176 | | - | |
177 | | - | |
178 | | - | |
179 | | - | |
180 | | - | |
181 | | - | |
182 | 162 | | |
183 | 163 | | |
184 | 164 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
175 | 175 | | |
176 | 176 | | |
177 | 177 | | |
| 178 | + | |
| 179 | + | |
| 180 | + | |
| 181 | + | |
178 | 182 | | |
179 | 183 | | |
180 | 184 | | |
| |||
193 | 197 | | |
194 | 198 | | |
195 | 199 | | |
196 | | - | |
197 | 200 | | |
198 | | - | |
199 | 201 | | |
200 | 202 | | |
201 | 203 | | |
| |||
263 | 265 | | |
264 | 266 | | |
265 | 267 | | |
| 268 | + | |
| 269 | + | |
| 270 | + | |
| 271 | + | |
266 | 272 | | |
267 | 273 | | |
268 | 274 | | |
| |||
281 | 287 | | |
282 | 288 | | |
283 | 289 | | |
284 | | - | |
285 | 290 | | |
286 | | - | |
287 | 291 | | |
288 | 292 | | |
289 | 293 | | |
| |||
351 | 355 | | |
352 | 356 | | |
353 | 357 | | |
| 358 | + | |
| 359 | + | |
| 360 | + | |
| 361 | + | |
354 | 362 | | |
355 | 363 | | |
356 | 364 | | |
| |||
369 | 377 | | |
370 | 378 | | |
371 | 379 | | |
372 | | - | |
373 | 380 | | |
374 | | - | |
375 | 381 | | |
376 | 382 | | |
377 | 383 | | |
| |||
439 | 445 | | |
440 | 446 | | |
441 | 447 | | |
| 448 | + | |
| 449 | + | |
| 450 | + | |
| 451 | + | |
442 | 452 | | |
443 | 453 | | |
444 | 454 | | |
| |||
475 | 485 | | |
476 | 486 | | |
477 | 487 | | |
478 | | - | |
479 | 488 | | |
480 | | - | |
481 | 489 | | |
482 | 490 | | |
483 | 491 | | |
| |||
1458 | 1466 | | |
1459 | 1467 | | |
1460 | 1468 | | |
1461 | | - | |
1462 | | - | |
1463 | | - | |
1464 | | - | |
1465 | | - | |
1466 | | - | |
1467 | | - | |
1468 | | - | |
1469 | | - | |
1470 | | - | |
1471 | 1469 | | |
1472 | 1470 | | |
1473 | 1471 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
33 | 33 | | |
34 | 34 | | |
35 | 35 | | |
| 36 | + | |
| 37 | + | |
| 38 | + | |
| 39 | + | |
36 | 40 | | |
37 | 41 | | |
38 | 42 | | |
| |||
45 | 49 | | |
46 | 50 | | |
47 | 51 | | |
48 | | - | |
49 | | - | |
50 | | - | |
| 52 | + | |
51 | 53 | | |
52 | 54 | | |
Lines changed: 5 additions & 3 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
33 | 33 | | |
34 | 34 | | |
35 | 35 | | |
| 36 | + | |
| 37 | + | |
| 38 | + | |
| 39 | + | |
36 | 40 | | |
37 | 41 | | |
38 | 42 | | |
| |||
45 | 49 | | |
46 | 50 | | |
47 | 51 | | |
48 | | - | |
49 | | - | |
50 | | - | |
| 52 | + | |
51 | 53 | | |
52 | 54 | | |
Lines changed: 5 additions & 3 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
33 | 33 | | |
34 | 34 | | |
35 | 35 | | |
| 36 | + | |
| 37 | + | |
| 38 | + | |
| 39 | + | |
36 | 40 | | |
37 | 41 | | |
38 | 42 | | |
| |||
45 | 49 | | |
46 | 50 | | |
47 | 51 | | |
48 | | - | |
49 | | - | |
50 | | - | |
| 52 | + | |
51 | 53 | | |
52 | 54 | | |
Lines changed: 5 additions & 3 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
33 | 33 | | |
34 | 34 | | |
35 | 35 | | |
| 36 | + | |
| 37 | + | |
| 38 | + | |
| 39 | + | |
36 | 40 | | |
37 | 41 | | |
38 | 42 | | |
| |||
49 | 53 | | |
50 | 54 | | |
51 | 55 | | |
52 | | - | |
53 | | - | |
54 | | - | |
| 56 | + | |
55 | 57 | | |
56 | 58 | | |
0 commit comments