Skip to content

Commit 4305edf

Browse files
authored
Update README.md
1 parent abf456f commit 4305edf

File tree

1 file changed

+138
-0
lines changed

1 file changed

+138
-0
lines changed

README.md

Lines changed: 138 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -43,6 +43,144 @@ engine.AddFieldMap("*", new FieldToFieldMap("Microsoft.VSTS.CMMI.AcceptanceCrite
4343
engine.AddProcessor(new WorkItemUpdate(me, @" AND [System.Id]=3 "));
4444
```
4545

46+
You can also use the pre built package with a configuration file:
47+
48+
Download from [executable](https://github.com/nkdAgility/vsts-data-bulk-editor/releases) and extract. Use `vstsbulkeditor.exe init` to create a reference `vstsbulkeditor.json` configration file.
49+
50+
```json
51+
{
52+
"TelemetryEnableTrace": true,
53+
"Target": {
54+
"Collection": "https://sdd2016.visualstudio.com/",
55+
"Name": "DemoProjt"
56+
},
57+
"Source": {
58+
"Collection": "https://sdd2016.visualstudio.com/",
59+
"Name": "DemoProjs"
60+
},
61+
"ReflectedWorkItemIDFieldName": "TfsMigrationTool.ReflectedWorkItemId",
62+
"FieldMaps": [
63+
{
64+
"ObjectType": "VSTS.DataBulkEditor.Engine.Configuration.FieldMap.FieldValueMapConfig",
65+
"WorkItemTypeName": "*",
66+
"sourceField": "System.State",
67+
"targetField": "System.State",
68+
"valueMapping": {
69+
"Approved": "New",
70+
"New": "New",
71+
"Committed": "Active",
72+
"In Progress": "Active",
73+
"To Do": "New",
74+
"Done": "Closed"
75+
}
76+
},
77+
{
78+
"ObjectType": "VSTS.DataBulkEditor.Engine.Configuration.FieldMap.FieldtoFieldMapConfig",
79+
"WorkItemTypeName": "*",
80+
"sourceField": "Microsoft.VSTS.Common.BacklogPriority",
81+
"targetField": "Microsoft.VSTS.Common.StackRank"
82+
},
83+
{
84+
"ObjectType": "VSTS.DataBulkEditor.Engine.Configuration.FieldMap.FieldtoTagMapConfig",
85+
"WorkItemTypeName": "*",
86+
"sourceField": "System.State",
87+
"formatExpression": "ScrumState:{0}"
88+
},
89+
{
90+
"ObjectType": "VSTS.DataBulkEditor.Engine.Configuration.FieldMap.FieldMergeMapConfig",
91+
"WorkItemTypeName": "*",
92+
"sourceField1": "System.Description",
93+
"sourceField2": "Microsoft.VSTS.Common.AcceptanceCriteria",
94+
"targetField": "System.Description",
95+
"formatExpression": "{0} <br/><br/><h3>Acceptance Criteria</h3>{1}"
96+
},
97+
{
98+
"ObjectType": "VSTS.DataBulkEditor.Engine.Configuration.FieldMap.RegexFieldMapConfig",
99+
"WorkItemTypeName": "*",
100+
"sourceField": "COMPANY.PRODUCT.Release",
101+
"targetField": "COMPANY.DEVISION.MinorReleaseVersion",
102+
"pattern": "PRODUCT \\d{4}.(\\d{1})",
103+
"replacement": "$1"
104+
},
105+
{
106+
"ObjectType": "VSTS.DataBulkEditor.Engine.Configuration.FieldMap.TreeToTagMapConfig",
107+
"WorkItemTypeName": "*",
108+
"toSkip": 3,
109+
"timeTravel": 1
110+
}
111+
],
112+
"WorkItemTypeDefinition": {
113+
"Bug": "Bug",
114+
"Product Backlog Item": "Product Backlog Item"
115+
},
116+
"Processors": [
117+
{
118+
"ObjectType": "VSTS.DataBulkEditor.Engine.Configuration.Processing.WorkItemMigrationConfig",
119+
"Disabled": true,
120+
"QueryBit": "AND [TfsMigrationTool.ReflectedWorkItemId] = '' AND [Microsoft.VSTS.Common.ClosedDate] = '' AND [System.WorkItemType] IN ('Shared Steps', 'Shared Parameter', 'Test Case', 'Requirement', 'Task', 'User Story', 'Bug')"
121+
},
122+
{
123+
"ObjectType": "VSTS.DataBulkEditor.Engine.Configuration.Processing.WorkItemUpdateConfig",
124+
"WhatIf": false,
125+
"Disabled": true,
126+
"QueryBit": "AND [TfsMigrationTool.ReflectedWorkItemId] = '' AND [Microsoft.VSTS.Common.ClosedDate] = '' AND [System.WorkItemType] IN ('Shared Steps', 'Shared Parameter', 'Test Case', 'Requirement', 'Task', 'User Story', 'Bug')"
127+
},
128+
{
129+
"ObjectType": "VSTS.DataBulkEditor.Engine.Configuration.Processing.NodeStructuresMigrationConfig",
130+
"Disabled": true
131+
},
132+
{
133+
"ObjectType": "VSTS.DataBulkEditor.Engine.Configuration.Processing.LinkMigrationConfig",
134+
"Disabled": true
135+
},
136+
{
137+
"ObjectType": "VSTS.DataBulkEditor.Engine.Configuration.Processing.WorkItemPostProcessingConfig",
138+
"Disabled": true
139+
},
140+
{
141+
"ObjectType": "VSTS.DataBulkEditor.Engine.Configuration.Processing.WorkItemDeleteConfig",
142+
"Disabled": true
143+
},
144+
{
145+
"ObjectType": "VSTS.DataBulkEditor.Engine.Configuration.Processing.AttachementExportMigrationConfig",
146+
"Disabled": true
147+
},
148+
{
149+
"ObjectType": "VSTS.DataBulkEditor.Engine.Configuration.Processing.AttachementImportMigrationConfig",
150+
"Disabled": true
151+
},
152+
{
153+
"ObjectType": "VSTS.DataBulkEditor.Engine.Configuration.Processing.TestVeriablesMigrationConfig",
154+
"Disabled": true
155+
},
156+
{
157+
"ObjectType": "VSTS.DataBulkEditor.Engine.Configuration.Processing.TestConfigurationsMigrationConfig",
158+
"Disabled": true
159+
},
160+
{
161+
"ObjectType": "VSTS.DataBulkEditor.Engine.Configuration.Processing.TestPlansAndSuitsMigrationConfig",
162+
"Disabled": true
163+
},
164+
{
165+
"ObjectType": "VSTS.DataBulkEditor.Engine.Configuration.Processing.TestRunsMigrationConfig",
166+
"Disabled": true,
167+
"Status": "Experimental"
168+
},
169+
{
170+
"ObjectType": "VSTS.DataBulkEditor.Engine.Configuration.Processing.ImportProfilePictureConfig",
171+
"Disabled": true
172+
},
173+
{
174+
"ObjectType": "VSTS.DataBulkEditor.Engine.Configuration.Processing.ExportProfilePictureFromADConfig",
175+
"Disabled": true,
176+
"Domain": null,
177+
"Username": null,
178+
"Password": null
179+
}
180+
]
181+
}
182+
```
183+
46184
There are for field mapping systems available:
47185

48186
- FieldValueMap

0 commit comments

Comments
 (0)