Add fieldMapMode to FieldToFieldMap and update related documentation

Author: MrHinsh

docs/content/docs/how-to/migrating-plans-and-suites/index.md

@@ -68,6 +68,7 @@ The important bits:
         "FieldMaps": [
           {
             "FieldMapType": "FieldToFieldMap",
+            "fieldMapMode": "TargetToTarget",
             "sourceField": "Custom.ReflectedWorkItemId",
             "targetField": "Microsoft.VSTS.Build.IntegrationBuild",
             "defaultValue": "",

docs/data/classes/reference.fieldmaps.fieldtofieldmap.yaml

@@ -54,6 +54,7 @@ configurationSamples:
   code: >-
     {
       "$type": "FieldToFieldMapOptions",
+      "fieldMapMode": "SourceToTarget",
       "sourceField": "Microsoft.VSTS.Common.BacklogPriority",
       "targetField": "Microsoft.VSTS.Common.StackRank",
       "defaultValue": "42",
@@ -85,6 +86,12 @@ options:
   defaultValue: missing XML code comments
   isRequired: false
   dotNetType: System.Boolean, System.Private.CoreLib, Version=8.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e
+- parameterName: fieldMapMode
+  type: FieldMapMode
+  description: Gets or sets the mode of field mapping to be applied during migration. SourceToTarget will get data from the source system and apply it to the target. TargetToTarget will move data between the target fields.
+  defaultValue: SourceToTarget
+  isRequired: false
+  dotNetType: MigrationTools.Tools.FieldMapMode, MigrationTools, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null
 - parameterName: sourceField
   type: String
   description: Gets or sets the name of the source field to copy data from during migration.

docs/static/schema/configuration.schema.json

@@ -1922,6 +1922,11 @@
                               "description": "If set to `true` then the Fieldmap will run. Set to `false` and the processor will not run.",
                               "type": "boolean"
                             },
+                            "fieldMapMode": {
+                              "description": "Gets or sets the mode of field mapping to be applied during migration. SourceToTarget will get data from the source system and apply it to the target. TargetToTarget will move data between the target fields.",
+                              "type": "string",
+                              "default": "SourceToTarget"
+                            },
                             "sourceField": {
                               "description": "Gets or sets the name of the source field to copy data from during migration.",
                               "type": "string"

docs/static/schema/schema.fieldmaps.fieldtofieldmap.json

@@ -17,6 +17,11 @@
       "description": "If set to `true` then the Fieldmap will run. Set to `false` and the processor will not run.",
       "type": "boolean"
     },
+    "fieldMapMode": {
+      "description": "Gets or sets the mode of field mapping to be applied during migration. SourceToTarget will get data from the source system and apply it to the target. TargetToTarget will move data between the target fields.",
+      "type": "string",
+      "default": "SourceToTarget"
+    },
     "sourceField": {
       "description": "Gets or sets the name of the source field to copy data from during migration.",
       "type": "string"

docs/static/schema/schema.tools.fieldmappingtool.json

@@ -189,6 +189,11 @@
                   "description": "If set to `true` then the Fieldmap will run. Set to `false` and the processor will not run.",
                   "type": "boolean"
                 },
+                "fieldMapMode": {
+                  "description": "Gets or sets the mode of field mapping to be applied during migration. SourceToTarget will get data from the source system and apply it to the target. TargetToTarget will move data between the target fields.",
+                  "type": "string",
+                  "default": "SourceToTarget"
+                },
                 "sourceField": {
                   "description": "Gets or sets the name of the source field to copy data from during migration.",
                   "type": "string"

src/MigrationTools.Clients.TfsObjectModel/Tools/FieldMappingTool/FieldMaps/FieldToFieldMap.cs

@@ -1,4 +1,5 @@
 using System;
+using System.Windows.Forms;
 using Microsoft.Extensions.Logging;
 using Microsoft.TeamFoundation.WorkItemTracking.Client;
 using MigrationTools.Tools;
@@ -40,14 +41,23 @@ internal override void InternalExecute(WorkItem source, WorkItem target)
         {
             return;
         }
-
-        var value = Convert.ToString(source.Fields[Config.sourceField]?.Value);
+        string value;
+        switch (Config.fieldMapMode)
+        {
+            case FieldMapMode.SourceToTarget:
+                value = Convert.ToString(source.Fields[Config.sourceField]?.Value);
+                break;
+            case FieldMapMode.TargetToTarget:
+                value = Convert.ToString(target.Fields[Config.sourceField]?.Value);
+                break;
+            default:
+                throw new ArgumentOutOfRangeException();
+        }
         if (string.IsNullOrEmpty(value) && Config.defaultValue is not null)
         {
             value = Config.defaultValue;
         }
-
         target.Fields[Config.targetField].Value = value;
-        Log.LogDebug("FieldToFieldMap: [UPDATE] field mapped {0}:{1} to {2}:{3}", source.Id, Config.sourceField, target.Id, Config.targetField);
+        Log.LogDebug("FieldToFieldMap: [UPDATE] field mapped {0}:{1} to {2}:{3} as {4}", source.Id, Config.sourceField, target.Id, Config.targetField, Config.fieldMapMode.ToString());
     }
-}
+}

src/MigrationTools/Tools/FieldMappingTool/FieldMaps/FieldtoFieldMapOptions.cs

@@ -1,26 +1,44 @@
 
 using System.Collections.Generic;
+using Newtonsoft.Json;
+using Newtonsoft.Json.Converters;
 using MigrationTools.Tools.Infrastructure;
 
 namespace MigrationTools.Tools
 {
+
+    [JsonConverter(typeof(StringEnumConverter))]
+    public enum FieldMapMode
+    {
+        SourceToTarget = 0,
+        TargetToTarget = 1
+    }
+
+
     /// <summary>
     /// Just want to map one field to another? This is the one for you.
     /// </summary>
     /// <status>ready</status>
     /// <processingtarget>Work Item Field</processingtarget>
     public class FieldToFieldMapOptions : FieldMapOptions
     {
+
+        /// <summary>
+        /// Gets or sets the mode of field mapping to be applied during migration. SourceToTarget will get data from the source system and apply it to the target. TargetToTarget will move data between the target fields.
+        /// </summary>
+        /// <default>SourceToTarget</default>
+        public FieldMapMode fieldMapMode { get; set; } = FieldMapMode.SourceToTarget;
+
         /// <summary>
         /// Gets or sets the name of the source field to copy data from during migration.
         /// </summary>
         public string sourceField { get; set; }
-        
+
         /// <summary>
         /// Gets or sets the name of the target field to copy data to during migration.
         /// </summary>
         public string targetField { get; set; }
-        
+
         /// <summary>
         /// Gets or sets the default value to use when the source field is empty or null.
         /// </summary>
@@ -32,6 +50,7 @@ public void SetExampleConfigDefaults()
             sourceField = "System.StackRank";
             targetField = "System.Rank";
             defaultValue = "1000";
+            fieldMapMode = FieldMapMode.SourceToTarget;
         }
     }
-}
+}