Keep Outbound Link Target Processor

Performs mathematical calculations on numeric fields using NCalc expressions during migration.

Last updated: September 10, 2025 | Edit this page | Discuss this page

missing XML code comments

top

Options

Parameter
Type
Required
Description
Default Value
Parameter:
CleanupFileName
Type:
String
Required:
false
Description:
File path where the cleanup script or batch file will be generated for removing unwanted outbound links.
Default:
missing XML code comments
Parameter:
DryRun
Type:
Boolean
Required:
false
Description:
When true, performs a dry run without making actual changes, only generating the cleanup script for review.
Default:
missing XML code comments
Parameter:
Enabled
Type:
Boolean
Required:
true
Description:
If set to true then the processor will run. Set to false and the processor will not run.
Default:
missing XML code comments
Parameter:
Enrichers
Type:
List
Required:
false
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:
missing XML code comments
Parameter:
PrependCommand
Type:
String
Required:
false
Description:
Command to prepend to each line in the cleanup script, such as “start” for Windows batch files.
Default:
missing XML code comments
Parameter:
RefName
Type:
String
Required:
false
Description:
Refname will be used in the future to allow for using named Options without the need to copy all of the options.
Default:
missing XML code comments
Parameter:
SourceName
Type:
String
Required:
true
Description:
This is the IEndpoint that will be used as the source of the Migration. Can be null for a write only processor.
Default:
missing XML code comments
Parameter:
TargetLinksToKeepOrganization
Type:
String
Required:
false
Description:
URL of the Azure DevOps organization whose links should be preserved during cleanup operations.
Default:
missing XML code comments
Parameter:
TargetLinksToKeepProject
Type:
String
Required:
false
Description:
Project name or GUID within the target organization whose links should be preserved.
Default:
missing XML code comments
Parameter:
TargetName
Type:
String
Required:
true
Description:
This is the IEndpoint that will be used as the Target of the Migration. Can be null for a read only processor.
Default:
missing XML code comments
Parameter:
WIQLQuery
Type:
String
Required:
true
Description:
WIQL (Work Item Query Language) query used to select the work items whose outbound links should be processed for preservation.
Default:
missing XML code comments
top

Samples

top

Sample

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

Defaults

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

Classic

{
  "$type": "KeepOutboundLinkTargetProcessorOptions",
  "Enabled": false,
  "WIQLQuery": "Select [System.Id] From WorkItems Where [System.TeamProject] = @project and not [System.WorkItemType] contains 'Test Suite, Test Plan,Shared Steps,Shared Parameter,Feedback Request'",
  "TargetLinksToKeepOrganization": "https://dev.azure.com/nkdagility",
  "TargetLinksToKeepProject": "950311ea-ec93-4bf3-be62-de5e7eaff847",
  "CleanupFileName": "c:/temp/OutboundLinkTargets.bat",
  "PrependCommand": "start",
  "DryRun": true,
  "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.keepoutboundlinktargetprocessor.json",
  "title": "KeepOutboundLinkTargetProcessor",
  "description": "missing XML code comments",
  "type": "object",
  "properties": {
    "CleanupFileName": {
      "description": "File path where the cleanup script or batch file will be generated for removing unwanted outbound links.",
      "type": "string"
    },
    "DryRun": {
      "description": "When true, performs a dry run without making actual changes, only generating the cleanup script for review.",
      "type": "boolean"
    },
    "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"
    },
    "PrependCommand": {
      "description": "Command to prepend to each line in the cleanup script, such as \"start\" for Windows batch files.",
      "type": "string"
    },
    "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"
    },
    "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"
    },
    "TargetLinksToKeepOrganization": {
      "description": "URL of the Azure DevOps organization whose links should be preserved during cleanup operations.",
      "type": "string"
    },
    "TargetLinksToKeepProject": {
      "description": "Project name or GUID within the target organization whose links should be preserved.",
      "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"
    },
    "WIQLQuery": {
      "description": "WIQL (Work Item Query Language) query used to select the work items whose outbound links should be processed for preservation.",
      "type": "string"
    }
  },
  "required": [
    "enabled",
    "sourceName",
    "targetName",
    "wIQLQuery"
  ]
}
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