ignore-empty-revisions flag

docs/Samples/config-agile.json

@@ -16,6 +16,7 @@
   "ignore-failed-links": true,
   "include-link-comments": false,
   "include-jira-css-styles": false,
+  "ignore-empty-revisions": false,
   "sleep-time-between-revision-import-milliseconds": 0,
   "process-template": "Agile",
   "link-map": {

docs/Samples/config-basic.json

@@ -16,6 +16,7 @@
   "ignore-failed-links": true,
   "include-link-comments": false,
   "include-jira-css-styles": false,
+  "ignore-empty-revisions": false,
   "sleep-time-between-revision-import-milliseconds": 0,
   "process-template": "Basic",
   "link-map": {

docs/Samples/config-cmmi.json

@@ -16,6 +16,7 @@
     "ignore-failed-links": true,
     "include-link-comments": false,
     "include-jira-css-styles": false,
+    "ignore-empty-revisions": false,
     "sleep-time-between-revision-import-milliseconds": 0,
     "process-template": "CMMI",
     "link-map": {

docs/Samples/config-scrum.json

@@ -16,6 +16,7 @@
   "ignore-failed-links": true,
   "include-link-comments": false,
   "include-jira-css-styles": false,
+  "ignore-empty-revisions": false,
   "sleep-time-between-revision-import-milliseconds": 0,
   "process-template": "Scrum",
   "link-map": {

docs/config.md

@@ -34,6 +34,7 @@ The migration configuration file is defined in a json file with the properties d
 |**ignore-failed-links**|False|boolean|Set to True if failed links are to be ignored. Default = False.|
 |**include-link-comments**|False|boolean|Set to True to get a verbose comment on the work item for every work item link created. Default = True.|
 |**include-jira-css-styles**|True|boolean|Set to True to generate and include confluence CSS Stylesheets for description, repro steps and comments. Default = True.|
+|**ignore-empty-revisions**|False|boolean|Set to True to ignore importing empty revisions. Empty revisions will be created if you have historical revisions where none of the changed fields or links have been mapped. This may indicate that you have unmapped data, which will not be migrated. Default = False.|
 |**sleep-time-between-revision-import-milliseconds**|False|integer|How many milliseconds to sleep between each revision import. Use this if throttling is an issue for ADO Services. Default = 0 (no sleep).|
 |**process-template**|False|string|Process template in the target DevOps project. Supported values: Scrum, Agile or CMMI. Default = "Scrum".|
 |**link-map**|True|json|List of **links** to map between Jira and Azure DevOps/TFS work item link types.|

src/WorkItemMigrator/Migration.Common/Config/ConfigJson.cs

@@ -77,7 +77,11 @@ public class ConfigJson
 
         [JsonProperty(PropertyName = "include-commits")]
         public bool IncludeCommits { get; set; } = false;
+
         [JsonProperty(PropertyName = "include-jira-css-styles")]
         public bool IncludeJiraCssStyles { get; set; } = true;
+
+        [JsonProperty(PropertyName = "ignore-empty-revisions")]
+        public bool IgnoreEmptyRevisions { get; set; } = false;
     }
 }

src/WorkItemMigrator/WorkItemImport/ImportCommandLine.cs

@@ -117,7 +117,18 @@ private void ExecuteMigration(CommandOption token, CommandOption url, CommandOpt
                     try
                     {
                         if (!forceFresh && context.Journal.IsItemMigrated(executionItem.OriginId, executionItem.Revision.Index))
+                        {
+                            continue;
+                        }
+
+                        if (config.IgnoreEmptyRevisions &&
+                            executionItem.Revision.Fields.Count == 0 &&
+                            executionItem.Revision.Links.Count == 0 &&
+                            executionItem.Revision.Attachments.Count == 0)
+                        {
+                            Logger.Log(LogLevel.Info, $"Skipped processing empty revision: {executionItem.OriginId}, rev {executionItem.Revision.Index}");
                             continue;
+                        }
 
                         WorkItem wi = null;