[Bug]: Unable to migrate the process template using the Process Definition Processor

[prathyusha-reddy-nalla]

Version

• I confirm that I am using the latest version

Source Version

Azure DevOps Service

Target Version

Azure DevOps Service

Relevant configuration

{
  "$schema": "https://devopsmigration.io/schema/configuration.schema.json",
  "Serilog": {
    "MinimumLevel": "Debug"
  },
  "MigrationTools": {
    "Version": "16.3",

    "Endpoints": {
      "Source": {
        "EndpointType": "AzureDevOpsEndpoint",
        "Organisation": "https://dev.azure.com/ABC/",
        "Project": "XYZ",
        "AuthenticationMode": "AccessToken",
        "AccessToken": "XXXXXXXXXXX",
        "ReflectedWorkItemIdField": "Custom.ReflectedWorkItemId",
        "AllowCrossProjectLinking": false,
        "LanguageMaps": {
          "AreaPath": "Area",
          "IterationPath": "Iteration"
        }
      },
      "Target": {
        "EndpointType": "AzureDevOpsEndpoint",
        "Organisation": "https://dev.azure.com/XYX/",
        "Project": "XYZ",
        "AuthenticationMode": "AccessToken",
        "AccessToken": "XXXXXXXXX",
        "ReflectedWorkItemIdField": "Custom.ReflectedWorkItemId",
        "AllowCrossProjectLinking": false,
        "LanguageMaps": {
          "AreaPath": "Area",
          "IterationPath": "Iteration"
        }
      }
    },

    "Processors": [
      {
        "ProcessorType": "ProcessDefinitionProcessor",
        "Enabled": true,
        "ProcessMaps": {
          "Scrum_OperationTeam": "Scrum_OperationTeam"
        },
        "UpdateProcessDetails": true,
        "MaxDegreeOfParallelism": 0,
        "SourceName": "Source",
        "TargetName": "Target"
      }
    ]
  }
}

Relevant log output

Logger`1
[20:57:56 DBG] [16.3.1] Attempting to pass parameters: OptionsWrapper`1
[20:57:56 DBG] [16.3.1] ===================================
[20:57:56 DBG] [16.3.1] Configuring 'MigrationTools:CommonTools:FieldMappingTool:FieldMaps'
[20:57:56 DBG] [16.3.1] ===================================
[20:57:56 INF] [16.3.1] Logging has been configured and is set to: unknown.
[20:57:56 INF] [16.3.1]                               Max Logfile: Verbose.
[20:57:56 INF] [16.3.1]                               Max Console: Debug.
[20:57:56 INF] [16.3.1]                  Max Application Insights: Error.
[20:57:56 INF] [16.3.1] The Max log levels above show where to go look for extra info. e.g. Even if you set the log level to Verbose you will only see that info in the Log File, however everything up to Debug will be in the Console.
[20:57:56 INF] [16.3.1] Beginning run of 1 processors
[20:57:56 INF] [16.3.1] Processor: ProcessDefinitionProcessor
[20:57:56 INF] [16.3.1] Migration Context Start: ProcessDefinitionProcessor
[20:57:56 INF] [16.3.1] Processor::InternalExecute::Start
[20:57:56 INF] [16.3.1] Processor::EnsureConfigured
[20:57:57 FTL] [16.3.1] Error while running ProcessDefinitionProcessor
System.NullReferenceException: Object reference not set to an instance of an object.
   at MigrationTools.Processors.ProcessDefinitionProcessor.EnsureConfigured() in D:\a\azure-devops-migration-tools\azure-devops-migration-tools\src\MigrationTools.Clients.AzureDevops.Rest\Processors\ProcessDefinitionProcessor.cs:line 112
   at MigrationTools.Processors.ProcessDefinitionProcessor.InternalExecute() in D:\a\azure-devops-migration-tools\azure-devops-migration-tools\src\MigrationTools.Clients.AzureDevops.Rest\Processors\ProcessDefinitionProcessor.cs:line 90
   at MigrationTools.Processors.Infrastructure.Processor.Execute() in D:\a\azure-devops-migration-tools\azure-devops-migration-tools\src\MigrationTools\Processors\Infrastructure\Processor.cs:line 99
Error logged to Elmah.io!
!! Check for latest version - We fix issues constantly - If not, please create a discussion on https://github.com/nkdAgility/azure-devops-migration-tools/discussions so we can get this fixed !!
[20:57:59 INF] [16.3.1] ProcessDefinitionProcessor completed in 00:00:00
[20:57:59 ERR] [16.3.1] ProcessDefinitionProcessor The Processor MigrationEngine entered the failed state...stopping run
[20:57:59 INF] [16.3.1] Command ExecuteMigrationCommand completed in 00:00:04.0155064
[20:57:59 INF] [16.3.1] Check the logs for errors: D:\MigrationTools-16.3.1\logs\20260311205753

What happened?

A bug happened!
Please let us the configurations to be used, I have tried multiple combinations but didn't work tried with 16.3.1 and 16.3.3 versions, it would be really helpful if have any samples for the each of the processors, The tool is really great but the documentations might be really helpful!!

Debug in Visual Studio

• Visual Studio Debug

[MrHinsh]

@prathyusha-reddy-nalla We will need to take a look at the code. I did not build this feature and have not used it.