Tfs Test Plans And Suites Migration Processor

Rebuilds Suits and plans for Test Cases migrated using the WorkItemMigration

Last updated: July 28, 2025 | Edit this page | Discuss this page

Rebuilds Suits and plans for Test Cases migrated using the WorkItemMigration

top

Options

Parameter
Type
Description
Default Value
Parameter:
Enabled
Type:
Boolean
Description:
If set to true then the processor will run. Set to false and the processor will not run.
Default Value:
missing XML code comments
Parameter:
Enrichers
Type:
List
Description:
List of Enrichers that can be used to add more features to this processor. Only works with Native Processors and not legacy Processors.
Default Value:
missing XML code comments
Parameter:
FilterCompleted
Type:
Boolean
Description:
missing XML code comments
Default Value:
missing XML code comments
Parameter:
MigrationDelay
Type:
Int32
Description:
??Not sure what this does. Check code.
Default Value:
Not specified
Parameter:
OnlyElementsWithTag
Type:
String
Description:
The tag name that is present on all elements that must be migrated. If this option isn’t present this processor will migrate all.
Default Value:
`String.Empty`
Parameter:
RefName
Type:
String
Description:
Refname will be used in the future to allow for using named Options without the need to copy all of the options.
Default Value:
missing XML code comments
Parameter:
RemoveAllLinks
Type:
Boolean
Description:
??Not sure what this does. Check code.
Default Value:
Not specified
Parameter:
RemoveInvalidTestSuiteLinks
Type:
Boolean
Description:
Indicates whether the configuration for node structure transformation should be taken from the common enricher configs. Otherwise the configuration elements below are used
Default Value:
Not specified
Parameter:
SourceName
Type:
String
Description:
This is the IEndpoint that will be used as the source of the Migration. Can be null for a write only processor.
Default Value:
missing XML code comments
Parameter:
TargetName
Type:
String
Description:
This is the IEndpoint that will be used as the Target of the Migration. Can be null for a read only processor.
Default Value:
missing XML code comments
Parameter:
TestPlanIds
Type:
Int32[]
Description:
This flag filters all test plans and retains only the specified ones for migration. Pass the test plan IDs as an array. Example: “TestPlanIds”: [123, 456, 789] Works optimally when “TestPlanQuery” is set to null.
Default Value:
missing XML code comments
Parameter:
TestPlanQuery
Type:
String
Description:
Filtering conditions to decide whether to migrate a test plan or not. When provided, this partial query is added after Select * From TestPlan Where when selecting test plans. Among filtering options, AreaPath, PlanName and PlanState are known to work. There is unfortunately no documentation regarding the available fields.
Default Value:
`String.Empty`
top

Samples

top

Sample

Sample

There is no sample, but you can check the classic below for a general feel.
top

Defaults

Defaults

There are no defaults! Check the sample for options!
top

Classic

Classic

{
  "$type": "TfsTestPlansAndSuitesMigrationProcessorOptions",
  "Enabled": false,
  "OnlyElementsWithTag": null,
  "TestPlanQuery": null,
  "RemoveAllLinks": false,
  "MigrationDelay": 0,
  "RemoveInvalidTestSuiteLinks": false,
  "FilterCompleted": false,
  "TestPlanIds": [],
  "SourceName": null,
  "TargetName": null
}
top

Metadata

top

Schema

This is the JSON schema that defines the structure and validation rules for this configuration.

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://devopsmigration.io/schema/schema.processors.tfstestplansandsuitesmigrationprocessor.json",
  "title": "TfsTestPlansAndSuitesMigrationProcessor",
  "description": "Rebuilds Suits and plans for Test Cases migrated using the WorkItemMigration",
  "type": "object",
  "properties": {
    "enabled": {
      "description": "If set to `true` then the processor will run. Set to `false` and the processor will not run.",
      "type": "boolean"
    },
    "enrichers": {
      "description": "List of Enrichers that can be used to add more features to this processor. Only works with Native Processors and not legacy Processors.",
      "type": "array"
    },
    "filterCompleted": {
      "description": "missing XML code comments",
      "type": "boolean"
    },
    "migrationDelay": {
      "description": "??Not sure what this does. Check code.",
      "type": "integer",
      "default": "0"
    },
    "onlyElementsWithTag": {
      "description": "The tag name that is present on all elements that must be migrated. If this option isn't present this processor will migrate all.",
      "type": "string",
      "default": "`String.Empty`"
    },
    "refName": {
      "description": "`Refname` will be used in the future to allow for using named Options without the need to copy all of the options.",
      "type": "string"
    },
    "removeAllLinks": {
      "description": "??Not sure what this does. Check code.",
      "type": "boolean",
      "default": "false"
    },
    "removeInvalidTestSuiteLinks": {
      "description": "Indicates whether the configuration for node structure transformation should be taken from the common enricher configs. Otherwise the configuration elements below are used",
      "type": "boolean",
      "default": "false"
    },
    "sourceName": {
      "description": "This is the `IEndpoint` that will be used as the source of the Migration. Can be null for a write only processor.",
      "type": "string"
    },
    "targetName": {
      "description": "This is the `IEndpoint` that will be used as the Target of the Migration. Can be null for a read only processor.",
      "type": "string"
    },
    "testPlanIds": {
      "description": "This flag filters all test plans and retains only the specified ones for migration. Pass the test plan IDs as an array. Example: \"TestPlanIds\": [123, 456, 789]   Works optimally when \"TestPlanQuery\" is set to null.",
      "type": "string"
    },
    "testPlanQuery": {
      "description": "Filtering conditions to decide whether to migrate a test plan or not. When provided, this partial query is added after `Select * From TestPlan Where` when selecting test plans. Among filtering options, `AreaPath`, `PlanName` and `PlanState` are known to work. There is unfortunately no documentation regarding the available fields.",
      "type": "string",
      "default": "`String.Empty`"
    }
  }
}
Project Information
Azure DevOps Marketplace
YouTube Channel
Maintainer

Created and maintained by Martin Hinshelwood of nkdagility.com

Getting Support
Community Support
Questions & Discussions

The first place to look for usage, configuration, and general help.

Commercial Support

We provide training, ad-hoc support, and full service migrations through our professional services.

Azure DevOps Migration Services
Documentation