diff --git a/docs/_includes/sampleConfig/configuration.json b/docs/_includes/sampleConfig/configuration.json
index 6a2f691dd..8dbb6ea78 100644
--- a/docs/_includes/sampleConfig/configuration.json
+++ b/docs/_includes/sampleConfig/configuration.json
@@ -1,118 +1,76 @@
{
- "ChangeSetMappingFile": null,
- "Source": {
- "$type": "TfsTeamProjectConfig",
- "Collection": "https://dev.azure.com/nkdagility-preview/",
- "Project": "migrationSource1",
- "ReflectedWorkItemIDFieldName": "nkdScrum.ReflectedWorkItemId",
- "AllowCrossProjectLinking": false,
- "AuthenticationMode": "Prompt",
- "PersonalAccessToken": "",
- "PersonalAccessTokenVariableName": "",
- "LanguageMaps": {
- "AreaPath": "Area",
- "IterationPath": "Iteration"
- }
+ "Serilog": {
+ "MinimumLevel": "Information"
},
- "Target": {
- "$type": "TfsTeamProjectConfig",
- "Collection": "https://dev.azure.com/nkdagility-preview/",
- "Project": "migrationTest5",
- "ReflectedWorkItemIDFieldName": "nkdScrum.ReflectedWorkItemId",
- "AllowCrossProjectLinking": false,
- "AuthenticationMode": "Prompt",
- "PersonalAccessToken": "njp3kcec4nbev63fmbepvdpn35drawmonk5qf5yqsw77dgfwnjda",
- "PersonalAccessTokenVariableName": "",
- "LanguageMaps": {
- "AreaPath": "Area",
- "IterationPath": "Iteration"
- }
- },
- "FieldMaps": [],
- "GitRepoMapping": null,
- "LogLevel": "Debug",
- "CommonEnrichersConfig": [
- {
- "$type": "TfsNodeStructureOptions",
- "NodeBasePaths": [],
- "AreaMaps": {
- "^Skypoint Cloud$": "MigrationTest5"
- },
- "IterationMaps": {
- "^Skypoint Cloud\\\\Sprint 1$": "MigrationTest5\\Sprint 1"
- },
- "ShouldCreateMissingRevisionPaths": true,
- "ReplicateAllExistingNodes": true
- },
- {
- "$type": "TfsWorkItemLinkEnricherOptions",
- "Enabled": true,
- "FilterIfLinkCountMatches": true,
- "SaveAfterEachLinkIsAdded": false
- },
- {
- "$type": "TfsRevisionManagerOptions",
- "Enabled": true,
- "ReplayRevisions": true,
- "MaxRevisions": 0
+ "MigrationTools": {
+ "Version": "16.0",
+ "Source": {
+ "EndpointType": "TfsTeamProject",
+ "Collection": "https://dev.azure.com/nkdagility-preview/",
+ "Project": "migrationSource1",
+ "AllowCrossProjectLinking": false,
+ "AuthenticationMode": "AccessToken",
+ "PersonalAccessToken": "",
+ "LanguageMaps": {
+ "AreaPath": "Area",
+ "IterationPath": "Iteration"
+
+ }
},
- {
- "$type": "TfsAttachmentEnricherOptions",
- "Enabled": true,
- "ExportBasePath": "c:\\temp\\WorkItemAttachmentExport",
- "MaxAttachmentSize": 480000000
+ "Target": {
+ "EndpointType": "TfsTeamProject",
+ "Collection": "https://dev.azure.com/nkdagility-preview/",
+ "Project": "migrationTest5",
+ "TfsVersion": "AzureDevOps",
+ "ReflectedWorkItemIDFieldName": "nkdScrum.ReflectedWorkItemId",
+ "AllowCrossProjectLinking": false,
+ "AuthenticationMode": "AccessToken",
+ "PersonalAccessToken": "",
+ "LanguageMaps": {
+ "AreaPath": "Area",
+ "IterationPath": "Iteration"
+ }
},
- {
- "$type": "StringManipulatorEnricherOptions",
- "Enabled": true,
- "MaxStringLength": 1000000,
- "Manipulators": [
- {
- "$type": "RegexStringManipulator",
- "Enabled": true,
- "Pattern": "[^( -~)\n\r\t]+",
- "Replacement": "",
- "Description": "Remove invalid characters from the end of the string"
- }
- ]
- }
- ],
- "Processors": [
- {
- "$type": "WorkItemMigrationConfig",
- "Enabled": true,
- "UpdateCreatedDate": true,
- "UpdateCreatedBy": true,
- "WIQLQuery": "SELECT [System.Id] FROM WorkItems WHERE [System.TeamProject] = @TeamProject AND [System.WorkItemType] NOT IN ('Test Suite', 'Test Plan','Shared Steps','Shared Parameter','Feedback Request') ORDER BY [System.ChangedDate] desc",
- "LinkMigration": true,
- "FixHtmlAttachmentLinks": false,
- "SkipToFinalRevisedWorkItemType": false,
- "WorkItemCreateRetryLimit": 5,
- "FilterWorkItemsThatAlreadyExistInTarget": false,
- "PauseAfterEachWorkItem": false,
- "AttachRevisionHistory": false,
- "LinkMigrationSaveEachAsAdded": false,
- "GenerateMigrationComment": true,
- "WorkItemIDs": null,
- "MaxGracefulFailures": 0,
- "SkipRevisionWithInvalidIterationPath": false,
- "SkipRevisionWithInvalidAreaPath": false
- }
- ],
- "Version": "15.0",
- "workaroundForQuerySOAPBugEnabled": false,
- "WorkItemTypeDefinition": {
- "sourceWorkItemTypeName": "targetWorkItemTypeName"
- },
- "Endpoints": {
- "InMemoryWorkItemEndpoints": [
- {
- "Name": "Source",
- "EndpointEnrichers": null
+ "CommonEnrichers": {
+ "TfsChangeSetMapping": {
+ "Enabled": true,
+ "File": "C:\\temp\\ChangeSetMappingFile.json"
},
+ "TfsFieldMappings": {
+ "Enabled": true,
+ "FieldMaps": [
+ {
+ "FieldMapType": "FieldToFieledMap",
+ "sourceField": "System.AcceptanceCriteria",
+ "targetField": "System.AcceptanceCriteria2"
+
+ },
+ {
+ "FieldMapType": "FieldToFieledMap",
+ "sourceField": "System.Description",
+ "targetField": "System.Description2"
+
+ }
+ ]
+ }
+ },
+ "Processors": [
{
- "Name": "Target",
- "EndpointEnrichers": null
+ "ProcessorType": "WorkItemMigration",
+ "Enabled": true,
+ "UpdateCreatedDate": true,
+ "UpdateCreatedBy": true,
+ "WIQLQuery": "SELECT [System.Id] FROM WorkItems WHERE [System.TeamProject] = @TeamProject AND [System.WorkItemType] NOT IN ('Test Suite', 'Test Plan','Shared Steps','Shared Parameter','Feedback Request') ORDER BY [System.ChangedDate] desc",
+ "FixHtmlAttachmentLinks": false,
+ "WorkItemCreateRetryLimit": 5,
+ "FilterWorkItemsThatAlreadyExistInTarget": false,
+ "PauseAfterEachWorkItem": false,
+ "AttachRevisionHistory": false,
+ "GenerateMigrationComment": true,
+ "WorkItemIDs": [],
+ "MaxGracefulFailures": 0,
+ "SkipRevisionWithInvalidIterationPath": false,
+ "SkipRevisionWithInvalidAreaPath": false
}
]
}
diff --git a/docs/_includes/sidebar-collection.html b/docs/_includes/sidebar-collection.html
index c527be963..67deda0ae 100644
--- a/docs/_includes/sidebar-collection.html
+++ b/docs/_includes/sidebar-collection.html
@@ -3,11 +3,11 @@
{{include.typeName}}
-
- Overview
{% if collection != null %}
- {% assign items = collection.docs | where: "typeName", include.typeName | where: "architecture", include.architecture | sort: "importance" | reverse %}
+ {% assign items = collection.docs | where: "typeName", include.typeName | sort: "importance" %}
{% if items != empty %}
{% for item in items %}
-
diff --git a/docs/_includes/sidebar.html b/docs/_includes/sidebar.html
index 917d0f889..4bc3917f1 100644
--- a/docs/_includes/sidebar.html
+++ b/docs/_includes/sidebar.html
@@ -2,36 +2,27 @@
-
Getting Started
-
-
Reference
- -
- v1
-
- - Overview
- {% include sidebar-collection.html collection = "reference" typeName = "Processors" architecture = "v1" %}
- {% include sidebar-collection.html collection = "reference" typeName = "FieldMaps" architecture = "v1" %}
-
-
- -
- v2
-
- - Overview
- {% include sidebar-collection.html collection = "reference" typeName = "Processors" architecture = "v2" %}
- {% include sidebar-collection.html collection = "reference" typeName = "Endpoints" architecture = "v2" %}
- {% include sidebar-collection.html collection = "reference" typeName = "EndpointEnrichers" architecture = "v2" %}
- {% include sidebar-collection.html collection = "reference" typeName = "FieldMaps" architecture = "v2" %}
- {% include sidebar-collection.html collection = "reference" typeName = "MappingTools" architecture = "v2" %}
- {% include sidebar-collection.html collection = "reference" typeName = "ProcessorEnrichers" architecture = "v2" %}
-
-
+
+ - Overview
+ {% include sidebar-collection.html collection = "reference" typeName = "Processors" %}
+ {% include sidebar-collection.html collection = "reference" typeName = "Endpoints" %}
+ {% include sidebar-collection.html collection = "reference" typeName = "EndpointEnrichers" %}
+ {% include sidebar-collection.html collection = "reference" typeName = "FieldMaps" %}
+ {% include sidebar-collection.html collection = "reference" typeName = "Tools" %}
+ {% include sidebar-collection.html collection = "reference" typeName = "ProcessorEnrichers" %}
+
+
diff --git a/docs/_layouts/reference.html b/docs/_layouts/reference.html
index 46f6248e7..433fd81d1 100644
--- a/docs/_layouts/reference.html
+++ b/docs/_layouts/reference.html
@@ -19,37 +19,40 @@ {{ page.className }}
{% assign mdInfo = page.topics | where: "topic", "introduction" | last %}
{{ mdInfo.markdown | markdownify }}
-
+
Options
-
-
- | Parameter name |
- Type |
- Description |
- Default Value |
-
- {% assign options = page.options %}
- {% for option in options %}
-
- | {{option.parameterName}} |
- {{option.type}} |
- {{option.description}} |
- {{option.defaultValue}} |
-
+
+
+ | Parameter name |
+ Type |
+ Description |
+ Default Value |
+
+ {% assign options = page.options %}
+ {% for option in options %}
+
+ | {{option.parameterName}} |
+ {{option.type}} |
+ {{option.description}} |
+ {{option.defaultValue}} |
+
+ {% endfor %}
+
+
+
+ Examples
+ {% assign configurationSamples = page.configurationSamples %}
+ {% for sample in configurationSamples %}
+ {{sample.name}}
+ {% if sample.name == "Classic" %}
+ We have moved to a new config format, but are still tying to get this here to generate :)! The sample below is generated and is still valid for the settings, but you will need to map it to the main format.
+ {% endif %}
+ {% highlight json linenos %}
+ {{sample.code}}
+ {% endhighlight %}
{% endfor %}
-
-
Example
-A basic sample for {{ page.className }} configuration.
- {% assign sample = page.configurationSamples | where: "name", "default" | last %}
-
-{% highlight json linenos %}
-{{sample.code}}
-{% endhighlight %}
-
-{% assign mdInfo = page.topics | where: "topic", "notes" | last %}
+ {% assign mdInfo = page.topics | where: "topic", "notes" | last %}
{{ mdInfo.markdown | markdownify }}
{{ content | inject_anchors }}
diff --git a/docs/assets/css/main.css b/docs/assets/css/main.css
index ae3879660..5503c887b 100644
--- a/docs/assets/css/main.css
+++ b/docs/assets/css/main.css
@@ -37,4 +37,14 @@ pre {
.nkda-main-menu-item:hover {
color: white;
background: #713183;
- }
\ No newline at end of file
+ }
+
+.btn-nkdprimary {
+ background-color: #713183;
+ color: white;
+}
+
+.btn-nkdprimary:hover {
+ background-color: #54595F;
+ color: white;
+}
\ No newline at end of file
diff --git a/docs/change-log.md b/docs/change-log.md
new file mode 100644
index 000000000..59c6cb504
--- /dev/null
+++ b/docs/change-log.md
@@ -0,0 +1,100 @@
+---
+title: Change Log
+layout: page
+template: default
+pageType: index
+toc: true
+pageStatus: published
+discussionId:
+redirect_from: /change-log.html
+---
+
+## Change Log
+
+- [v15.0](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v15.1.7) - The latest release brings a host of enhancements and fixes designed to improve user experience and configuration options. Noteworthy features include a new GitHub Actions workflow for automatic updates to pull request titles, enhanced management of area and iteration paths using regex mapping, and a more streamlined query format for migration configurations. Users can now enjoy greater flexibility in configuring attachment processing, including options for export paths and size limits. Additionally, updates to authentication methods and improved logging for user retrieval processes have been implemented. The release also addresses various bugs and makes adjustments to enhance overall functionality.
+ - [v15.1.7](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v15.1.7) - Version 15.1 introduces several user-impacting changes aimed at enhancing functionality and improving user experience. Notable features include the introduction of a new configuration for bulk editing work items, enhanced GitHub workflows for automated pull request labeling and code reviews, and improved logging and error handling across various components. Users will benefit from updated documentation reflecting these changes, as well as new options for work item processing and streamlined project structures. Additionally, the release includes updates to the Azure pipeline configurations and support for .NET 8.0, ensuring a more efficient and robust migration process.
+ - [v15.0.4](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v15.0.4) - Version 15.0 introduces significant enhancements and fixes to the Azure DevOps Migration Tools, focusing on user experience and configuration flexibility. Key updates include the introduction of a new GitHub Actions workflow for automatic pull request title updates, improved management of area and iteration paths through regex mapping, and a streamlined query format for migration configurations. Users can now configure attachment processing more flexibly with options for export paths and maximum sizes directly through the TfsAttachmentEnricherOptions. Additionally, authentication methods have been updated, and enhanced logging for user retrieval processes has been implemented. Various bug fixes and adjustments have also been made to improve overall functionality and user experience.
+- [v14.0](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v14.4.7) - The latest major release brings a host of user-focused enhancements and improvements. Key changes include the adoption of Winget as the primary installation method, making it easier for users to get started. The main executable has been renamed to `devopsmigration.exe`, and new configuration options enhance customization capabilities, including parallel builds and test case timeouts. The command for initializing configurations has been updated for greater flexibility, and logging improvements provide better insights during migration operations. Subsequent updates have refined version detection, improved command line arguments, and introduced new configuration files to prevent blank issues. Enhanced logging and error handling further improve user experience, while package upgrades and better handling of specific fields streamline migration processes. Overall, these updates aim to enhance functionality, usability, and reliability for users.
+ - [v14.4.7](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v14.4.7) - Version 14.4 introduces several user-impacting changes, including the addition of Azure DevOps Server 2022 to the bug issue template, enhancing clarity for users during issue reporting. Improvements to the handling of the "ClosedDate" field now allow for better migration processes, with detailed logging to alert users of potential issues. The update also includes significant package upgrades that enhance logging and dependency injection capabilities. Additionally, refinements in the detection services improve how package versions are retrieved and managed. Overall, these updates aim to streamline user experience and improve the reliability of the migration tools.
+ - [v14.3.11](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v14.3.11) - Version 14.3 introduces significant user-impacting changes, including enhancements to the TFS Node Structure processor with the new `ReplicateAllExistingNodes` parameter, and updates to work item migration configurations that affect how existing items are managed. The removal of certain options like `ShouldCreateNodesUpFront` and `skipToFinalRevisedWorkItemType` simplifies migration logic, while improved logging and error handling in the TestPlansAndSuitesMigrationContext enhance user feedback during operations. Additionally, the Git metadata has been updated across several releases to reflect the latest commit details, ensuring users have the most current information. Overall, these updates aim to streamline migration processes and improve user experience.
+ - [v14.2.3](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v14.2.3) - Version 14.2 introduces several user-impacting changes aimed at enhancing functionality and usability. Key updates include a new configuration file for issue templates that prevents blank issues and provides users with resources for questions and feature suggestions. The command line arguments have been updated, changing the configuration file path format and modifying the default options for the 'init' command from 'Full' to 'Basic', alongside the introduction of a new 'Basic' option in the options mode. Users can now also utilize a 'Reference' option in the configuration builder for generating various configurations. Additionally, the requirement for a Personal Access Token (PAT) during Azure DevOps migration has been enforced. The release also improves documentation with new Git-related properties, updates to dependencies for better performance, and enhanced logging for debugging during migrations.
+ - [v14.1.0](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v14.1.0) - Version 14.1.0, released on October 26, 2023, introduces several user-impacting changes aimed at improving functionality and debugging. Notably, the command line arguments in the launch settings for the initialization command have been updated, with the removal of the "skipVersionCheck" option to enhance version accuracy. The version detection logic has also been refined, improving how the running version is retrieved and displayed. Furthermore, the project now utilizes an updated version of the WGet.NET package, and logging verbosity has been enhanced, providing users with better insights for debugging purposes.
+ - [v14.0.3](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v14.0.3) - Version 14.0 introduces significant user-impacting changes, including a shift to Winget as the primary installation method, enhancing accessibility for users. The main executable has been renamed to `devopsmigration.exe`, streamlining command execution. New configuration options, such as `ShouldCreateMissingRevisionPaths` and the `MigrationTools.lutconfig` file, allow for improved customization, including parallel builds and test case timeouts. The command for creating default configurations has been updated to `devopsmigration init`, with added flexibility through the `--options` parameter. Additionally, logging improvements provide better context during migration operations, ensuring users have detailed insights into package management and version detection.
+- [v13.0](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v13.2.1) - The latest updates bring a range of enhancements and new features aimed at improving user experience and functionality. A key addition is the `WorkItemMigrationContext` processor, which facilitates the migration of work items, including their history and attachments, between Azure DevOps instances. Users will find clearer documentation and a new configuration file to simplify work item type and field mappings. The introduction of the `ExportUsersForMapping` feature allows for easy JSON file exports for field mapping, while security is bolstered with an updated authentication mode. Users can now disable telemetry collection during migration, and various improvements have been made to migration behavior and configuration settings, enhancing the overall robustness and integrity of the migration tools.
+ - [v13.2.1](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v13.2.1) - Version 13.2 introduces significant user-impacting changes, including enhancements to migration behavior and configuration settings. In version 13.2.0, the configuration file was updated to enable the creation of missing revision paths and activate the work item migration processor, while the user export processor was disabled. A new command line flag was also added to disable telemetry. The subsequent release, 13.2.1, further refines these features by updating the `StopMigrationOnMissingAreaIterationNodes` option to true and `ShouldCreateMissingRevisionPaths` to false, which may affect migration processes. Additionally, it improves the migration tool's robustness with a null check for `executeOptions` and enhances data integrity through validation checks in the `TestPlansAndSuitesMigrationContext`.
+ - [v13.1.1](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v13.1.1) - Version 13.1 introduces several user-impacting changes, including the new `ExportUsersForMapping` feature, which allows users to export a JSON file for field mapping. The authentication mode has been updated from "AccessToken" to "Prompt," enhancing security and user experience. Additionally, a new command-line option to disable telemetry collection has been added, which can be set during migration with `--telemetry off`, and this option is now included in the default launch settings. Documentation has been updated to reflect these changes and provide guidance on managing telemetry settings, alongside various enhancements and updates to NuGet package versions for improved functionality.
+ - [v13.0.9](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v13.0.9) - Version 13.0 introduces several user-impacting changes, including the new `WorkItemMigrationContext` processor that enhances the migration of work items, their history, attachments, and metadata between Azure DevOps instances. Users will benefit from improved documentation clarity, with updates to the TfsWorkItemEndpoint and migration tool instructions. A new configuration file, `configuration2-wit.json`, has been added to streamline work item type and field mappings. Additionally, enhancements to the handling of service connections during pipeline creation and the introduction of a bug report template in the GitHub repository aim to improve user experience and support. Overall, these updates enhance functionality, flexibility, and clarity for users engaging with the migration tools and documentation.
+- [v12.0](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v12.8.10) - The latest major release brings a host of enhancements designed to improve user experience and streamline migration processes. New configuration options for migration processors offer greater flexibility, allowing users to define custom remapping rules for area and iteration paths. Significant improvements in field mapping configurations and enhanced documentation provide clearer guidance for users. The introduction of features like case-insensitive matching for regular expressions and new parameters for work item migration enhances functionality. Additionally, updates to logging, error handling, and overall documentation structure ensure a more robust and user-friendly experience. Various bug fixes further contribute to the reliability and clarity of the migration tools, making the overall process smoother for users.
+ - [v12.8.10](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v12.8.10) - Version 12.8 introduces several user-impacting changes aimed at enhancing functionality and improving the overall experience. Key features include the addition of the `jekyll-redirect-from` gem for better redirect management, updates to the `_config.yml` file for new permalink settings, and the reinstatement of the `jekyll-optional-front-matter` gem. Documentation has been significantly improved, with clearer guidance on Azure DevOps endpoints and enhanced metadata for easier navigation. New GitHub Actions workflows for validating pull requests and updates to the Gemfile reflect dependency enhancements. Additionally, various bug fixes and performance improvements have been implemented, ensuring a smoother migration process for users.
+ - [v12.7.1](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v12.7.1) - Version 12.7 introduces significant user-impacting changes, including enhancements to configuration options and improved logging. In version 12.7.0, the `FieldBlankMapConfig` has been renamed to `FieldSkipMapConfig`, allowing users to skip populating existing fields, while a new `FieldClearMapConfig` enables setting populated fields to null. Documentation has been updated to reflect these changes. The subsequent release, version 12.7.1, adds a new `CommonEnrichersConfig` section for node structure processing and modifies the `UseCommonNodeStructureEnricherConfig` option to enable shared configuration for enrichment. Additionally, the migration configuration now includes the `LinkMigrationSaveEachAsAdded` option, and logging improvements have been made for validation processes related to target nodes.
+ - [v12.6.2](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v12.6.2) - Version 12.6 introduces several user-impacting changes aimed at enhancing functionality and improving user experience. Notably, version 12.6.1 adds new variables to the TfsWorkItemEmbededLinkEnricher, enabling more accurate replacement of project-specific links during migration. Version 12.6.0 enhances user support by updating the issue template to direct users to GitHub discussions for inquiries and feature suggestions, while also introducing a new configuration option, `ShouldCreateMissingRevisionPaths`, which allows users to manage the creation of missing revision paths. Additionally, version 12.6.2 modifies application shutdown behavior by removing certain method calls and logging statements, potentially affecting how users handle application exits.
+ - [v12.5.0](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v12.5.0) - Version 12.5.0, released on February 24, 2023, introduces significant user-impacting changes, including a new versioning scheme in the GitVersion configuration, which sets the next version to 12.5.0. The update also renames the 'master' branch to 'main' and refines branch regex patterns for both release and preview tags. Additionally, it removes the outdated GitVersion2.yml file and adds a new binary executable for GitVersion, enhancing overall usability and streamlining version management.
+ - [v12.3.11](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v12.3.11) - Version 12.3 introduces several user-impacting changes aimed at enhancing the migration experience in Azure DevOps. Key features include the new `TreeToTagMapConfig` for improved organization of work items, and the `ExportProfilePictureFromADConfig` for seamless profile updates. Enhancements to team migration and test plans allow for better management and flexibility, while the addition of the `SkipRevisionWithInvalidAreaPath` option improves the handling of work items during migration. Documentation updates clarify configuration parameters and execution sequences, ensuring users have the necessary guidance for effective use. Bug fixes and improvements, such as null value handling and consistent naming conventions, further enhance the robustness and clarity of the migration tools.
+ - [v12.2.1](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v12.2.1) - Version 12.2 introduces significant user-impacting changes, including enhancements to the WorkItemMigrationConfig processor in version 12.2.1, which now features new parameters like ReplayRevisions and UpdateCreatedBy, allowing for more control over work item migration. The documentation has also been updated to provide clearer guidance on WIQL queries and migration settings. In version 12.2.0, new documentation files for Endpoint Enrichers and Field Maps have been added, detailing configurations and including example JSON setups. Additionally, improvements to the `KeepOutboundLinkTargetProcessor` and overall documentation structure enhance clarity and accessibility for users.
+ - [v12.1.1](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v12.1.1) - Version 12.1 introduces several user-impacting changes aimed at enhancing functionality and usability. The release of version 12.1.0 includes updates to the MigrationTools solution, adding a new `_config.yml` documentation file and renaming the "Primary Contributors" section to "Primary Contributors & Consultants" for clarity. Additionally, the FieldMergeMap configuration method has been streamlined by removing unnecessary validation code, simplifying the configuration process. In version 12.1.1, a significant improvement is made with the introduction of case-insensitive matching for regular expressions in the TfsNodeStructure.cs file, which enhances flexibility in path recognition and error handling during the mapping and validation processes.
+ - [v12.0.38](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v12.0.38) - Version 12.0 introduces significant enhancements and features aimed at improving user experience and migration processes. Key updates include the introduction of new configuration options for migration processors, such as `TestPlanQueryBit` and `UseCommonNodeStructureEnricherConfig`, which enhance flexibility in migrating test plans and suites. Users can now define custom remapping rules for area and iteration paths using `AreaMaps` and `IterationMaps`. Additionally, the migration tools have seen improvements in field mapping configurations, including a new Azure DevOps consultant in the documentation, and enhancements to the mapping display name functionality. The release also addresses various bugs and usability issues, such as improved error handling during work item migrations and refined documentation for better clarity. Overall, these updates aim to streamline the migration process and provide users with more control and flexibility.
+- [v11.0](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v11.9.55) - The latest major release introduces a variety of impactful changes designed to enhance user experience and streamline migration processes. Key features include a rebranding of the project to "MigrationTools," improved configuration options, and enhanced error handling for migration operations. Users can now limit revisions during work item migrations, customize field retrieval, and benefit from new logging capabilities for better traceability. The introduction of new interfaces and methods, along with refined documentation, supports improved work item management and configuration flexibility. Overall, these updates aim to provide a more efficient, user-friendly migration experience while addressing previous bugs and enhancing system performance.
+ - [v11.9.55](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v11.9.55) - Version 11.9 of the Azure DevOps Migration Tools brings significant enhancements and new features aimed at improving user experience and migration capabilities. Key updates include the introduction of the `TfsRevisionManager`, allowing users to configure revision settings for migration, and support for migrating `Processes`, alongside existing features like `Work Items` and `Pipelines`. The release also enhances logging for better insights during migrations, updates configuration options for clarity, and integrates new methods for managing task groups and variable groups. Additionally, several bug fixes and improvements have been made to streamline the migration process, ensuring a more efficient and user-friendly experience.
+ - [v11.8.4](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v11.8.4) - Version 11.8 introduces several user-impacting changes aimed at enhancing configuration management and coding standards. Key features include the introduction of a default configuration file ("configuration.json") for the MigrationTools application, which is now essential for execution, and a new inferred `.editorconfig` file that provides comprehensive C# coding style rules for better customization. The release also standardizes contributions with a new pull request template and adds a `RefName` option across various configurations for improved referencing. Additionally, updates to logging configurations and enhanced error handling in the TfsReflectedWorkItemId class improve overall usability and functionality. Users are advised to update their configurations accordingly to align with the new standards.
+ - [v11.7.7](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v11.7.7) - Version 11.7 introduces several user-impacting changes aimed at enhancing the migration experience and improving system flexibility. Key features include the ability to customize fields retrieved for work items through optional parameters in the `RefreshWorkItem` and `AsWorkItemData` methods, as well as new properties in the `RevisionItem` class. The migration process is further streamlined with a stricter project retrieval method and improved error handling, ensuring users are informed during item queries. Additionally, the introduction of the `MigrationTools.ConsoleConfigGenerator` simplifies configuration file generation, while updates to authentication modes enhance user connectivity options. Overall, these enhancements aim to improve usability, data integrity, and performance across the migration tools.
+ - [v11.6.46](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v11.6.46) - Version 11.6 of the Azure DevOps Migration Tools brings significant user-impacting changes, including enhanced logging capabilities across various components, which will improve tracking and debugging during migration processes. Notably, the introduction of a new configuration option allows users to generate migration comments for work items, providing better traceability. The update also consolidates issue templates in the GitHub repository for streamlined reporting and enhances the migration of work items, test plans, and teams with improved bulk editing options. Additionally, users will benefit from clearer documentation and improved error handling, making the migration experience more robust and user-friendly.
+ - [v11.5.18](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v11.5.18) - Version 11.5 introduces significant user-impacting changes, including a new configuration structure that enhances flexibility in managing migration settings. The `TeamProjectConfig` has been replaced with the `IMigrationClientConfig` interface, allowing for more dynamic configuration management. Users will benefit from improved clarity in configuration options, particularly with the renaming of query and order bits for better consistency. Enhancements to work item processing, error handling, and logging mechanisms have been implemented, making it easier to identify issues during migration. Additionally, the introduction of new mapping mechanisms for work item types and improved telemetry tracking will enhance the overall migration experience. Overall, these updates aim to streamline the migration process and improve user interaction with the tools.
+ - [v11.4.3](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v11.4.3) - Version 11.4 introduces several user-impacting changes aimed at enhancing functionality and usability. Notably, the new "SampleConfigs" project provides users with sample configuration files, while the default setting for `LinkMigrationSaveEachAsAdded` in `configuration.json` simplifies initial setups. The update also streamlines the saving process of work items to Azure DevOps through the new `SaveToAzureDevOps` method, improving efficiency. Additionally, logging messages have been refined for better clarity, and the version retrieval method has been updated to ensure accurate version identification and upgrade prompts. Overall, these enhancements aim to improve user experience and operational clarity.
+ - [v11.3.3](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v11.3.3) - Version 11.3 introduces several user-impacting changes aimed at improving the Azure DevOps Migration Tools experience. Notably, the migration context has been updated to retrieve project information from target work items, which may alter project migration configurations. Documentation enhancements include improved clarity in warnings, support for migrating between different language versions (specifically German to English), and a simplified configuration design. Additionally, the expected processor count in configuration tests has been adjusted, and query parameters have been renamed to better align with Work Item Query Language (WIQL), accompanied by new examples to aid users in crafting queries.
+ - [v11.2.1](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v11.2.1) - Version 11.2 introduces significant user-impacting changes, including enhancements to migration tools and work item management. In version 11.2.0, a new configuration option, "WorkItemDeleteConfig," allows users to control the deletion of work items based on specific queries, while the migration client has been refactored for improved efficiency in handling work item data. Version 11.2.1 further streamlines the migration process by integrating node structure migration into the updated `WorkItemMigrationConfig`, replacing the deprecated `NodeStructuresMigrationConfig`. Users can now specify `NodeBasePaths` directly within the migration configuration, and comprehensive documentation updates ensure that users have access to the latest configuration options.
+ - [v11.12.23](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v11.12.23) - Version 11.12.23 introduces a significant enhancement with the addition of a new boolean parameter, `PrefixProjectToNodes`, in the `FixAreaPathAndIterationPathForTargetQuery` method, allowing users to control the inclusion of the project name in area path constructions during work item migration. This update is supported by multiple test cases to ensure accurate functionality. Additionally, previous versions have seen improvements in identity refresh processes, enhanced logging for better visibility, and new configuration options for migrating team member capacities and handling embedded images, all aimed at streamlining the migration experience and providing users with greater control and clarity throughout the process.
+ - [v11.11.27](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v11.11.27) - Version 11.11 introduces a range of user-impacting changes aimed at enhancing the Azure DevOps Migration Tools. Key features include the addition of a `YamlFilename` property in the `BuildDefinitions.cs` file, a new GitHub Actions workflow for project building and testing, and improved handling of work item queries through a factory for query builders. Users will benefit from enhanced flexibility with nullable boolean values in configuration options, the ability to filter test plans by area path, and new methods for retrieving pipeline definitions. Additionally, logging improvements provide clearer error messages, while various bug fixes and updates to package references enhance overall functionality and compatibility.
+ - [v11.10.1](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v11.10.1) - Version 11.10 introduces significant user-impacting changes, including a new feature that allows users to limit the number of revisions migrated in the WorkItemMigration processor through the `MaxRevisions` option, enhancing control over migration processes. Additionally, version 11.10.1 improves error logging and debugging for the TfsWorkItemLinkEnricher, particularly in handling related links, providing more detailed log messages for various scenarios. However, users should note that a section related to revision limits in the TfsRevisionManager has been commented out, which may affect how revisions are processed and reported.
+ - [v11.1.4](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v11.1.4) - Version 11.1 introduces several user-impacting changes aimed at enhancing flexibility and improving service management during migration processes. Key updates include the ability to conditionally register hosted services based on command-line arguments in version 11.1.4, allowing users to choose between initializing or executing services directly. Version 11.1.3 shifts the service registration for IMigrationClient from singleton to transient, affecting how services are instantiated. Additionally, version 11.1.2 features a renaming of the `MigrationOMClient` to `MigrationClient`, along with the introduction of the `IWorkItemMigrationClient` interface and a new `WorkItemMigrationClient` class, which enhance work item management capabilities. The overall structure has been refined to improve query handling and retrieval of work items. Other improvements include enhanced configuration handling in version 11.1.1 and updates to configuration files in version 11.1.0, ensuring a more consistent and user-friendly experience across the application.
+ - [v11.0.2](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v11.0.2) - Version 11.0 introduces significant user-impacting changes, including a shift in project naming from "VstsSyncMigrator" to "MigrationTools," enhancing clarity for Azure DevOps and File System clients. The update streamlines configuration options and removes obsolete projects, improving usability for developers. Additionally, error handling in migration operations has been enhanced, providing better logging and exception management. The introduction of C# 9.0 support and new project references further optimizes the application's performance and configuration management, ensuring a smoother user experience.
+- [v10.0](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v10.2.13) - The latest updates to the Migration Tools suite introduce a range of impactful enhancements for users. New projects, such as "MigrationTools.Sinks.AzureDevOps," have been added, along with a revamped console UI for improved Azure DevOps integration. Configuration management has been enhanced, allowing for easier JSON file loading and new telemetry settings. The migration engine has been optimized for better work item handling, and logging has been clarified. Users will need to update their configuration files due to a namespace change and new parameters for work item migration. Subsequent updates further simplify the configuration process, improve field mapping options, and enhance documentation for migrating test artifacts. Overall, these changes provide users with greater flexibility, control, and usability in their migration tasks.
+ - [v10.2.13](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v10.2.13) - Version 10.2 introduces significant user-impacting changes, including enhanced documentation for migrating test artifacts and work item types, and the addition of new consultants for support. Key improvements include the renaming of the `IWorkItemSink` interface to `IWorkItemMigrationSink`, new field mapping classes for better migration flexibility, and updates to logging capabilities with the introduction of an `ITelemetryLogger` interface. Users will benefit from improved error handling in logging, enhanced configuration options, and a more organized project structure. Additionally, minor documentation corrections and formatting updates enhance overall usability and clarity.
+ - [v10.1.1](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v10.1.1) - Version 10.1 introduces significant user-impacting changes aimed at enhancing the configuration experience. The design has been simplified to require only the class Name instead of the FullName, streamlining the setup process. Additionally, the ObjectType field has been updated to remove unnecessary prefixes, making it more user-friendly. Users will also benefit from updated configuration examples that incorporate new source and target project settings, including the addition of a Personal Access Token and various new field mapping options, which provide greater customization during migration tasks.
+ - [v10.0.10](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v10.0.10) - Version 10.0 of the Migration Tools suite brings significant user-impacting changes, including the introduction of new projects like "MigrationTools.Sinks.AzureDevOps" and enhancements to the console UI for better integration with Azure DevOps. Users will benefit from improved configuration management, allowing for JSON file loading and new settings for telemetry and application insights. The migration engine has been streamlined with new interfaces for better work item handling, while logging has been enhanced for clarity. Additionally, users must update their configuration files due to a namespace change and the introduction of new parameters for work item migration, ensuring greater flexibility and control in their migration processes.
+- [v9.0](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v9.3.1) - The latest major release brings a host of user-focused enhancements and improvements. Key features include multi-language support for Azure DevOps migrations, allowing for greater flexibility in handling different language versions. Users will benefit from improved configuration documentation, which now includes new fields for language mapping of Area and Iteration paths. Subsequent updates have introduced customizable field mappings, conditional logic for excluding specific work item types, and enhanced error handling for better troubleshooting. Additionally, logging capabilities have been significantly upgraded, providing more structured output and insights into application performance. Overall, these changes aim to streamline the migration process and improve user experience.
+ - [v9.3.1](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v9.3.1) - Version 9.3 introduces significant enhancements, including an upgrade of the Microsoft.ApplicationInsights library to version 2.12.0, which improves application performance monitoring. The addition of Serilog enhances logging capabilities, providing users with more structured and detailed logging output. Furthermore, the update includes improved error handling and logging practices, transitioning from traditional trace logging to Serilog's framework, which may require users to adjust their log configuration and viewing methods. Overall, these changes aim to enhance user experience through better performance insights and more effective logging.
+ - [v9.2.0](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v9.2.0) - Version 9.2.0, released on August 21, 2020, introduces significant user-impacting changes, including an update to the configuration documentation that renames the key "LanguageMap" to "LanguageMaps" and corrects the mapping for "AreaPath" to "IterationPath," enhancing clarity in the configuration structure. Furthermore, error handling in the WorkItemQueryMigrationContext has been improved, offering more detailed logging of source and target queries during save failures, which will assist users in troubleshooting issues more effectively.
+ - [v9.1.1](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v9.1.1) - Version 9.1 introduces significant enhancements to the migration process, focusing on user experience and flexibility. The new configuration option in version 9.1.0 allows users to define SourceToTargetFieldMappings, improving the customization of field mappings during migrations. Additionally, version 9.1.1 enhances the WorkItemMigrationContext class by implementing conditional logic to exclude "Test Plan" and "Test Suite" work item types from certain migrations, ensuring better handling of work item revisions and metrics. This update also improves the management of work item states and includes better logging for unsupported types, providing users with clearer insights during the migration process.
+ - [v9.0.1](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v9.0.1) - Version 9.0 introduces significant user-impacting changes, including the addition of multi-language support for migrating between different language versions of Azure DevOps, enhancing user flexibility. The configuration documentation has been improved to include new fields for language mapping of Area and Iteration paths, allowing users to specify these mappings for both source and target projects. Additionally, version 9.0.1 brings a new funding configuration file, deprecates the `doneMatch` property in the `FieldMergeMapConfig` class, improves error handling to prevent matching source and target fields, and enhances merging logic for better field updates. Users will also notice a change in the URI for the getting started guide in the extension's configuration.
+- [v8.0](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v8.9.10) - The latest major release introduces a range of impactful enhancements and features designed to improve user experience and streamline migration processes. Users can now take advantage of enhanced configuration options, including custom paths for configuration files and new modes for the `init` command. The migration process has been significantly refined with improved error handling, better logging, and new parameters for managing attachments and links. Notable features include the ability to sync changes post-migration, retry failed work item saves, and customize attachment handling. Additionally, the rebranding of the tool ensures users have access to accurate documentation and resources. Overall, these updates focus on providing greater control, efficiency, and clarity throughout the migration experience.
+ - [v8.9.10](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v8.9.10) - Version 8.9 introduces several user-impacting changes aimed at enhancing functionality and improving user experience. Notably, version 8.9.10 modifies the method for finding reflected work items, requiring integer conversion for query IDs, and adds null checks for target plans, which may affect test suite management. Version 8.9.9 brings new configuration options to address migration errors and updates documentation for better clarity. Additionally, version 8.9.6 introduces structured issue templates for GitHub, facilitating user interaction for reporting bugs and suggesting features. The release also includes updates to support resources, streamlining migration processes, and enhancing code clarity through refactoring and the introduction of a new `.editorconfig` file. Overall, these updates aim to improve usability and streamline operations for users of the Azure DevOps Migration Tools.
+ - [v8.8.0](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v8.8.0) - Version 8.8.0, released on February 21, 2020, introduces significant user-impacting changes aimed at enhancing migration processes. A new configuration option, `SkipToFinalRevisedWorkItemType`, allows users to seamlessly migrate work items by adopting the most recent revision's work item type when a type change is detected, particularly beneficial for migrations from Azure DevOps Service to Azure DevOps Server. Additionally, the `FilterWorkItemsThatAlreadyExistInTarget` option has been improved to boost migration efficiency by excluding work items that have already been migrated, streamlining the overall process for users.
+ - [v8.7.3](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v8.7.3) - Version 8.7 introduces several user-impacting changes aimed at enhancing the migration process and improving configuration management. Key features include a new GitHub Actions workflow for nightly merges, support for Personal Access Tokens in work item migration, and new settings for attachment migration, which allow users to customize attachment handling more effectively. Additionally, the configuration documentation has been updated to reflect these changes, including a new executable name and command options for initializing configuration files. The updates also refine the handling of work item and test point assignments during migration, ensuring a smoother user experience.
+ - [v8.6.9](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v8.6.9) - Version 8.6 of the Azure DevOps Migration Tools introduces several user-impacting enhancements and fixes. Key features include improved handling of work item attachments and links, enhanced link validation for Git commit and pull request IDs, and refined project prefixing logic during team migrations. Users will benefit from a new Visual Studio Code task configuration for building projects, as well as updated documentation for changeset migration and cross-project linking. Additionally, the release addresses various bugs, such as ensuring only valid external links are processed and enhancing version management reliability. Users should note the removal of certain project files, which may require configuration adjustments.
+ - [v8.5.5](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v8.5.5) - Version 8.5 of the Azure DevOps Migration Tools introduces significant user-impacting changes, including a rebranding from "vsts-sync-migrator" to "azure-devops-migration-tools," ensuring users have accurate documentation and resources. Enhancements to repository querying capabilities allow for improved traceability and error handling during migrations, while validation checks for work item fields bolster data integrity. The update also modifies cross-project linking behavior, potentially affecting work item queries. Additionally, new configuration options for work item migration, such as attachment management and migration control features, provide users with greater flexibility and efficiency in their migration processes.
+ - [v8.4.7](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v8.4.7) - Version 8.4 introduces significant user-impacting changes, including new configuration options such as `WorkItemCreateRetryLimit` for retrying failed work item saves and `FilterWorkItemsThatAlreadyExistInTarget` to streamline the migration process. The GitHub Actions workflow for managing stale issues and pull requests has been enhanced, now running daily and allowing exemptions for 'enhancement' labeled items. Additionally, the migration engine's console title now displays project names, and the project naming conventions have been updated for better clarity. Other improvements include refined tag handling and adjustments to SQL query formatting for enhanced readability. Overall, these updates aim to improve user experience and efficiency in project management and migration tasks.
+ - [v8.3.8](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v8.3.8) - Version 8.3 of the Azure DevOps Migration Tools introduces several user-impacting enhancements and fixes. Key features include the ability to sync changes post-migration and restart migrations at the revision level, significantly improving the migration process. The documentation has been enhanced for better user guidance, with clearer setup instructions and the addition of a new consultant for paid support options. Notable updates to package references enhance compatibility and performance, while minor corrections in the README and documentation ensure clarity in support information. Overall, this release focuses on improving user experience and streamlining migration processes.
+ - [v8.2.6](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v8.2.6) - Version 8.2 introduces several user-impacting changes aimed at enhancing the migration process. Key features include the new `GitRepoMapping` configuration option for defining source and target Git repository mappings, and improved error messaging for configuration mismatches. Users can now pause the migration after each work item for confirmation, and optional parameters have been added for saving work items and processing attachments. Enhancements in logging provide better insights into the migration process, while the restructuring of the `TestPlansAndSuitesMigrationContext` class improves metrics tracking and telemetry. Additionally, the assembly title has been updated to "Azure DevOps Migration Tools," which may affect localization interactions. Overall, these updates aim to streamline the migration experience and improve user control and visibility.
+ - [v8.1.9](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v8.1.9) - Version 8.1 of the Azure DevOps Migration Tools introduces several user-impacting changes aimed at enhancing functionality and user experience. Key updates include improved visibility with the console title now displaying the configuration file name and version, as well as new configuration options for querying work items, allowing for more flexible retrieval. Users will benefit from enhanced error handling during work item retrieval, better telemetry tracking for migration performance, and new parameters for team migration settings. Additionally, the versioning system has been refined to prevent compatibility issues, and users are now warned of configuration mismatches. Overall, these updates provide users with greater control, stability, and insights during the migration process.
+ - [v8.0.17](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/v8.0.17) - Version 8.0 introduces significant user-impacting changes, including enhanced configuration options for the `init` command, allowing users to specify custom configuration file paths and choose between `Full` and `WorkItemTracking` modes. The migration process has been improved with new parameters for handling attachments and links, as well as options for retrying failed work item creations. Users will benefit from updated documentation paths and improved error handling during attachment processing. Additionally, the removal of certain configuration options may affect users relying on those features, while new command-line options for TFS instance credentials enhance security and flexibility. Overall, these updates aim to improve the migration experience and streamline user interactions with the tool.
+- [v7.0](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/7.5.74) - The latest major release brings a host of user-focused enhancements and features designed to improve performance and usability. Key updates include a framework upgrade that boosts application performance and compatibility, alongside dependency updates for improved functionality and security. New configuration options allow for greater flexibility during data migration, including filtering elements by tags and replaying work item revisions. Enhancements to error handling and logging, as well as improvements in attachment management, contribute to a more reliable user experience. Additionally, the introduction of online status checks for version updates ensures users stay informed about the latest changes while connected to the internet.
+ - [7.5.74](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/7.5.74) - Version 7.5 of the Azure DevOps Migration Tools introduces several user-impacting enhancements and features aimed at improving the migration experience. Key updates include the addition of new configuration options such as `ReplayRevisions`, `FieldtoFieldMultiMap`, and `TestPlanQueryBit`, which enhance flexibility in data migration and allow for more customized setups. The documentation has been significantly improved to provide clearer guidance on these new features and configuration requirements. Additionally, various bug fixes and performance optimizations have been implemented, including better error handling, improved logging, and refined attachment management processes, ensuring a more reliable and user-friendly migration experience.
+ - [7.4.2](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/7.4.2) - Version 7.4 introduces several user-impacting changes across its updates. In version 7.4.0, enhancements to the `FieldValuetoTagMap` class improve tag processing and display through better regular expression matching and formatting options. Version 7.4.1 adds a Contributor Covenant Code of Conduct to foster a respectful community, updates contributing guidelines for easier issue submissions, and upgrades key dependencies like Newtonsoft.Json and Microsoft.ApplicationInsights. Finally, version 7.4.2 improves the attachment download process by replacing the `WebClient` with a more efficient method from `WorkItemServer`, along with enhanced error logging for clearer exception messages.
+ - [7.2.0](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/7.2.0) - Version 7.2.0, released on August 1, 2017, introduces several user-impacting enhancements, particularly for the VSTS Sync Migration Tools. Key updates include an updated `next-version` in the `GitVersion.yml` file, now reflecting version 7.2.0, and improvements to the `vss-extension.json` file, which now features a repository link and updated support links. Users can continue to enjoy the same robust functionality for bulk editing and migrating work items in TFS and VSTS, ensuring a seamless experience with the latest version.
+ - [7.1.8](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/7.1.8) - Version 7.1 introduces several user-impacting changes, including the addition of a new configuration option, `OnlyElementsWithTag`, which allows users to filter elements during migration based on specified tags. The `FixGitCommitLinks` processor has been enhanced to support specifying a `TargetRepository`, improving flexibility in link fixing. Additionally, the `WorkItemRevisionReplayMigrationConfig` now enables users to replay all revisions of work items during migration. The release also includes updates to configuration files for better XML formatting and consistent assembly binding redirects, along with improvements in handling work item fields, ensuring a more streamlined and efficient user experience.
+ - [7.0.2](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/7.0.2) - Version 7.0 introduces several user-impacting changes, including a significant upgrade to the target framework from v4.5 to v4.6.2, enhancing overall application performance and compatibility. The update also includes dependency upgrades, notably `Newtonsoft.Json` to version 9.0.1 and `Microsoft.ApplicationInsights` to version 2.2.0, which may improve functionality and security. Subsequent releases, 7.0.1 and 7.0.2, further refine the user experience by implementing an online status check for version updates in the `VstsSyncMigrator.Console` application, ensuring users receive timely notifications only when connected to the internet. Additionally, version 7.0.2 comments out the conditional trace listener initialization in the telemetry logging, which may alter how telemetry data is captured during application execution.
+- [v6.0](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/6.3.1) - The latest major release brings a host of impactful changes for users. A key highlight is the rebranding of the command-line tool to `vstssyncmigrator`, accompanied by updated documentation to assist with the new command structure. Enhancements to attachment export and import migration contexts improve ID formatting, while the restructuring of project organization may necessitate updates to project references. Users will also benefit from improved global configuration documentation, with various processors now enabled by default for immediate functionality. New features include the `WorkItemQueryMigrationContext`, allowing for selective migration of work item queries, and the option to prefix project names in folder paths for better organization. Enhanced logging and an updated FAQ section further support users in managing their migration processes effectively.
+ - [6.3.1](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/6.3.1) - Version 6.3 introduces several user-impacting changes, including enhanced logging in the console application that notifies users of the current and latest available versions, encouraging timely upgrades. The release also features an updated FAQ section that clarifies the consistency requirement for the `PrefixProjectToNodes` setting and addresses potential migration errors. Additionally, improvements in documentation emphasize the need for users to customize their configuration files and ensure that processors are enabled for optimal functionality.
+ - [6.2.0](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/6.2.0) - Version 6.2.0 introduces significant user-impacting changes, including an updated `next-version` in the GitVersion configuration, now set to 6.2.0. A notable new feature is the `WorkItemQueryMigrationContext`, accompanied by the `WorkItemQueryMigrationConfig` class, which empowers users to enable or disable the migration of work item queries. Additionally, users can now choose to prefix project names in folder paths, providing enhanced flexibility and control over migration options.
+ - [6.1.0](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/6.1.0) - Version 6.1.0, released on January 24, 2017, brings significant user-impacting changes, including an update to the global configuration documentation for improved clarity on structure and options. A key enhancement is the change in the default state of various processors to enabled, allowing users to utilize functionality immediately upon configuration. The command-line documentation has also been improved to stress the importance of enabling processors for execution. Furthermore, this release includes enhancements in link migration handling and test plans, which provide better traceability and error management during the migration process.
+ - [6.0.2](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/6.0.2) - Version 6.0 introduces significant user-impacting changes, including a complete rebranding of the command-line tool from `vsts-sm` to `vstssyncmigrator`, which is reflected in updated documentation to guide users on the correct commands for setup and execution. The versioning has been updated in the GitVersion configuration, and the Chocolatey installation script has been modified to accommodate the new package name. Additionally, the release includes adjustments to attachment export and import migration contexts, enhancing the formatting of reflected IDs. Users should also note the restructuring of project organization, with various classes and namespaces renamed, which may require updates in their project references.
+- [v5.0](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/5.3.2) - The latest major release brings a host of impactful changes designed to enhance user experience and functionality. Key updates include a rebranding to "VSTS Sync Migration Tools" and a simplified command name for installation and uninstallation. Users can now benefit from the new `MultiValueConditionalMapConfig` class, which allows for more complex field mapping configurations. Version 5.1 introduces customizable user preferences and improved command-line functionality, while 5.3 enhances the migration process for test plans with a new method for handling test cases, updates to installation scripts for better package verification, and optimizations in field merging. Comprehensive new documentation supports these changes, ensuring users can easily adapt to the updated features and configurations.
+ - [5.3.2](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/5.3.2) - Version 5.3 introduces several user-impacting changes, including the addition of a new method, `ProcessChildTestCases`, in the `TestPlansAndSuitsMigrationContext` class, which streamlines the migration process for test plans and suites by enabling the handling of test cases. The release also updates the GitVersion configuration to reflect the new version, enhances Chocolatey installation scripts with a checksum for improved package verification, and introduces a `doneMatch` property in the field mapping configuration to optimize field merging by preventing the reprocessing of already merged fields. Additionally, new documentation has been provided to facilitate user onboarding.
+ - [5.1.0](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/5.1.0) - Version 5.1.0, released on October 19, 2016, brings significant user-impacting changes, including new configuration options that allow for greater customization of user preferences. Enhancements to existing command-line flags improve functionality, making it easier for users to execute commands efficiently. Additionally, adjustments to default settings have been made to streamline the overall user experience, ensuring a more intuitive interaction with the software.
+ - [5.0.1](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/5.0.1) - Version 5.0 introduces significant user-impacting changes, including a rebranding from "VSTS Bulk Data Editor & Migrator" to "VSTS Sync Migration Tools" and a streamlined command name change from `vstssyncmigration` to `vsts-sm` for installation and uninstallation. The update also features the new `MultiValueConditionalMapConfig` class, which enhances field mapping flexibility by allowing complex configurations with multiple source and target field values. Additionally, comprehensive new documentation has been provided to assist users with configuration and usage, reflecting updated command structures and new options for processing work items and links.
+- [v4.0](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/4.4.0) - The latest major release introduces a range of impactful enhancements aimed at improving user experience and flexibility during work item migration. A key feature is the new configuration option, `PrefixProjectToNodes`, which allows users to customize the prefixing of project names to area and iteration paths, as well as nodes, enhancing project structure management. The migration logic has been updated to support these options, streamlining the migration process. Additionally, users will benefit from improved documentation, including clearer installation instructions and new JSON configuration files. The release also includes an uninstall script for easier tool management and enhancements to caching and field exclusion during migrations, further refining the overall functionality.
+ - [4.4.0](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/4.4.0) - Version 4.4.0, released on October 18, 2016, brings significant user-facing enhancements, including updated README and documentation that clarify installation options for the VSTS Bulk Data Editor Engine. Users can now choose from recommended methods such as installing via Chocolatey, downloading the latest release from GitHub, or creating custom tools using the NuGet package. Additionally, the `FindReflectedWorkItem` method has been improved with a new caching option, and an ignore list feature has been introduced to allow users to exclude specific fields during work item migration, enhancing overall functionality and user experience.
+ - [4.3.0](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/4.3.0) - Version 4.3.0 introduces several user-impacting changes, including an updated `next-version` in the GitVersion configuration, now set to 4.2.0. A new uninstall script for the VSTS Sync Migration tool has been added, enhancing user experience during tool management. The package metadata has been improved with a new ID format and the inclusion of an icon URL. Additionally, users will benefit from new JSON configuration files in the documentation, which now offers clearer instructions for obtaining the tools, with a strong recommendation for installation via Chocolatey.
+ - [4.2.0](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/4.2.0) - Version 4.2.0, released on October 12, 2016, introduces significant user-impacting changes, including the addition of a Chocolatey package for the VSTS Sync Migrator, complete with a PowerShell installation script and nuspec file for streamlined installation and management. Furthermore, the update enhances the Test Plans and Suits migration configuration by introducing a new option, `PrefixProjectToNodes`, enabling users to customize how project names are prefixed during the migration process.
+ - [4.1.0.2](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/4.1.0.2) - Version 4.1 introduces significant user-impacting changes aimed at enhancing migration workflows. The update includes a new configuration option, `PrefixProjectToNodes`, in the `NodeStructuresMigrationConfig` class, allowing users to choose whether project names should be prefixed to nodes during migration, thereby increasing flexibility in node structure processing. Additionally, the migration context has been improved to utilize this new option. Furthermore, the update enhances the WorkItemMigrationContext by replacing hardcoded project names for AreaPath and IterationPath with dynamic references to the new work item's project name, further streamlining project migration configurations. Lastly, the project and license URLs in the `.nuspec` file have been updated to reflect the new repository location.
+ - [4.0.0.2](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/4.0.0.2) - Version 4.0.0.2 introduces a significant enhancement with the new configuration option, `PrefixProjectToNodes`, in the `WorkItemMigrationConfig` class. This feature allows users to customize whether the project name is prefixed to area and iteration paths during work item migration, providing greater flexibility in managing project structures. Additionally, the migration logic has been updated to support this new option, ensuring that area and iteration paths are constructed according to the user's preferences.
+- [v3.0](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/3.6.0.1) - The latest updates bring a host of enhancements designed to improve user experience and functionality. Key features include new configuration files for the VSTS Data Bulk Editor, allowing for tailored migration processes, and the introduction of classes for managing team settings. Users can now specify additional query criteria for attachment exports and customize employee picture URL formats. The migration process has been streamlined with improved telemetry tracking and error handling, while new documentation provides valuable context and guidance. Significant improvements to the TfsWitMigrator tool enhance work item tagging flexibility, and updates to the migration context for test plans and variables offer greater control during migrations. Overall, these changes aim to make data migration more efficient and user-friendly.
+ - [3.6.0.1](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/3.6.0.1) - Version 3.6.0.1 introduces significant enhancements to the migration process, particularly for test plans and variables. Notably, the `TestPlansAndSuitsMigrationContext` now includes logic to conditionally set the `AreaPath` and `Iteration` properties based on configuration values, providing users with greater flexibility during migrations. Additionally, the `TestVeriablesMigrationContext` has been improved to automatically create new test variables and their allowed values if they do not already exist, streamlining the management of test variables. These updates aim to enhance user experience and efficiency in migration tasks.
+ - [3.5.0.2](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/3.5.0.2) - Version 3.5.0.2 introduces significant enhancements to the Visual Studio Team Services Bulk Data Editor Engine, focusing on improved user experience and functionality. The documentation has been updated to clarify the capabilities of various mapping tools and processors, now featuring new field mapping options like FieldMergeMap and FieldBlankMap. Additionally, enhancements to the WorkItemUpdate and WorkItemDelete processors offer users greater flexibility and control during data migration and updates, making the process more efficient and user-friendly.
+ - [3.4.1.1](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/3.4.1.1) - Version 3.4 introduces significant user-impacting changes, including the release of version 3.4.1.1, which adds a new configuration option for mapping field values to tags in the TfsWitMigrator tool. This enhancement allows users to define a source field, a matching pattern, and a format expression for tag creation, greatly improving the flexibility of work item tagging. Additionally, version 3.4.0.2 includes a minor update to the Telemetry.cs file, adding a comment for clarity without affecting the functionality of the telemetry initialization process.
+ - [3.3.0.4](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/3.3.0.4) - Version 3.3 introduces significant user-impacting changes, including the public accessibility of the `Program` class, which broadens user interaction capabilities. Enhancements to the TfsWitMigrator feature a new configuration option for fixing Git commit links, allowing users to specify query conditions for link migrations. The Application Insights configuration has been improved to include performance monitoring modules, and telemetry events now track unhandled exceptions, enhancing error reporting. Additionally, the introduction of unit tests for the `EngineConfiguration` and `MigrationEngine` classes strengthens the testing framework, while new configuration files ensure proper assembly binding and dependencies, particularly for Newtonsoft.Json.
+ - [3.2.3.1](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/3.2.3.1) - Version 3.2 introduces several user-impacting changes, including the addition of a new documentation page titled "Why," which provides users with enhanced context and links to further information. Additionally, the VSTS Bulk Data Editor & Migrator has undergone significant improvements, requiring users to create a new `vstsbulkeditor.yml` file for defining migration settings. This update includes comprehensive documentation on configuration options, command-line usage instructions, and a NuGet package for advanced users, alongside enhancements in error handling and the migration process for test plans and suites.
+ - [3.1.0.2](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/3.1.0.2) - Version 3.1.0.2 introduces a new configuration option, `AreaIterationPath`, to the `TestPlansAndSuitsMigrationConfig` class, significantly enhancing the flexibility of migration settings for users. Additionally, improvements have been made to trace logging, with the inclusion of a consistent identifier, "vstsbulkeditor," which enhances the clarity of log outputs during execution and migration processes. These updates aim to improve user experience and streamline migration workflows.
+ - [3.0.0.41](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/3.0.0.41) - Version 3.0 introduces several impactful changes aimed at enhancing user experience and functionality. Key features include new configuration files for the VSTS Data Bulk Editor, allowing for customized migration processes, and the introduction of classes for team migration, which facilitate team settings management. Users can now specify additional query criteria for attachment exports and customize employee picture URL formats. The update also streamlines work item saving processes, improves telemetry tracking for better monitoring, and enhances error tracking capabilities. Notably, the assembly versioning scheme has been updated, and various configuration options have been added or improved, providing users with greater control and flexibility in their migration tasks.
+- [v0.0](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/0.5.1) - The latest update brings a range of enhancements designed to improve user experience. Users will benefit from increased performance and stability, alongside new features that simplify interactions. Additionally, numerous bugs identified in earlier releases have been resolved, contributing to a more seamless and dependable operation. This update focuses on creating a more efficient and user-friendly environment for all.
+ - [0.5.1](https://github.com/nkdAgility/azure-devops-migration-tools/releases/tag/0.5.1) - Version 0.5.1 introduces several user-impacting changes, including new features, improvements, and bug fixes. Users can expect enhanced performance and stability, along with the addition of new functionalities that streamline their experience. This update also addresses various bugs reported in previous versions, ensuring a smoother and more reliable operation. Overall, version 0.5.1 aims to provide a more efficient and user-friendly environment.
diff --git a/docs/collections/_reference/reference.endpoints.azuredevopsendpoint.md b/docs/collections/_reference/reference.endpoints.azuredevopsendpoint.md
new file mode 100644
index 000000000..d443f9832
--- /dev/null
+++ b/docs/collections/_reference/reference.endpoints.azuredevopsendpoint.md
@@ -0,0 +1,79 @@
+---
+optionsClassName: AzureDevOpsEndpointOptions
+optionsClassFullName: MigrationTools.Endpoints.AzureDevOpsEndpointOptions
+configurationSamples:
+- name: defaults
+ description:
+ code: There are no defaults! Check the sample for options!
+ sampleFor: MigrationTools.Endpoints.AzureDevOpsEndpointOptions
+- name: sample
+ description:
+ code: There is no sample, but you can check the classic below for a general feel.
+ sampleFor: MigrationTools.Endpoints.AzureDevOpsEndpointOptions
+- name: classic
+ description:
+ code: >-
+ {
+ "$type": "AzureDevOpsEndpointOptions",
+ "AuthenticationMode": "AccessToken",
+ "AccessToken": null,
+ "Organisation": null,
+ "Project": null,
+ "ReflectedWorkItemIdField": null,
+ "EndpointEnrichers": null
+ }
+ sampleFor: MigrationTools.Endpoints.AzureDevOpsEndpointOptions
+description: missng XML code comments
+className: AzureDevOpsEndpoint
+typeName: Endpoints
+architecture:
+options:
+- parameterName: AccessToken
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: AuthenticationMode
+ type: AuthenticationMode
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: EndpointEnrichers
+ type: List
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: Organisation
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: Project
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: ReflectedWorkItemIdField
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+status: missng XML code comments
+processingTarget: missng XML code comments
+classFile: /src/MigrationTools.Clients.AzureDevops.Rest/Endpoints/AzureDevOpsEndpoint.cs
+optionsClassFile: /src/MigrationTools.Clients.AzureDevops.Rest/Endpoints/AzureDevOpsEndpointOptions.cs
+
+redirectFrom:
+- /Reference/Endpoints/AzureDevOpsEndpointOptions/
+layout: reference
+toc: true
+permalink: /Reference/Endpoints/AzureDevOpsEndpoint/
+title: AzureDevOpsEndpoint
+categories:
+- Endpoints
+-
+topics:
+- topic: notes
+ path: /docs/Reference/Endpoints/AzureDevOpsEndpoint-notes.md
+ exists: false
+ markdown: ''
+- topic: introduction
+ path: /docs/Reference/Endpoints/AzureDevOpsEndpoint-introduction.md
+ exists: false
+ markdown: ''
+
+---
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.endpoints.filesystemworkitemendpoint.md b/docs/collections/_reference/reference.endpoints.filesystemworkitemendpoint.md
new file mode 100644
index 000000000..8ed011ca2
--- /dev/null
+++ b/docs/collections/_reference/reference.endpoints.filesystemworkitemendpoint.md
@@ -0,0 +1,59 @@
+---
+optionsClassName: FileSystemWorkItemEndpointOptions
+optionsClassFullName: MigrationTools.Endpoints.FileSystemWorkItemEndpointOptions
+configurationSamples:
+- name: defaults
+ description:
+ code: There are no defaults! Check the sample for options!
+ sampleFor: MigrationTools.Endpoints.FileSystemWorkItemEndpointOptions
+- name: sample
+ description:
+ code: There is no sample, but you can check the classic below for a general feel.
+ sampleFor: MigrationTools.Endpoints.FileSystemWorkItemEndpointOptions
+- name: classic
+ description:
+ code: >-
+ {
+ "$type": "FileSystemWorkItemEndpointOptions",
+ "FileStore": null,
+ "EndpointEnrichers": null
+ }
+ sampleFor: MigrationTools.Endpoints.FileSystemWorkItemEndpointOptions
+description: missng XML code comments
+className: FileSystemWorkItemEndpoint
+typeName: Endpoints
+architecture:
+options:
+- parameterName: EndpointEnrichers
+ type: List
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: FileStore
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+status: missng XML code comments
+processingTarget: missng XML code comments
+classFile: /src/MigrationTools.Clients.FileSystem/Endpoints/FileSystemWorkItemEndpoint.cs
+optionsClassFile: /src/MigrationTools.Clients.FileSystem/Endpoints/FileSystemWorkItemEndpointOptions.cs
+
+redirectFrom:
+- /Reference/Endpoints/FileSystemWorkItemEndpointOptions/
+layout: reference
+toc: true
+permalink: /Reference/Endpoints/FileSystemWorkItemEndpoint/
+title: FileSystemWorkItemEndpoint
+categories:
+- Endpoints
+-
+topics:
+- topic: notes
+ path: /docs/Reference/Endpoints/FileSystemWorkItemEndpoint-notes.md
+ exists: false
+ markdown: ''
+- topic: introduction
+ path: /docs/Reference/Endpoints/FileSystemWorkItemEndpoint-introduction.md
+ exists: false
+ markdown: ''
+
+---
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.v2.endpoints.generictfsendpoint`1.md b/docs/collections/_reference/reference.endpoints.generictfsendpoint`1.md
similarity index 69%
rename from docs/collections/_reference/reference.v2.endpoints.generictfsendpoint`1.md
rename to docs/collections/_reference/reference.endpoints.generictfsendpoint`1.md
index da134a927..4130f26bb 100644
--- a/docs/collections/_reference/reference.v2.endpoints.generictfsendpoint`1.md
+++ b/docs/collections/_reference/reference.endpoints.generictfsendpoint`1.md
@@ -12,21 +12,22 @@ processingTarget: missng XML code comments
classFile: ''
optionsClassFile:
-redirectFrom: []
+redirectFrom:
+- /Reference/v2/Endpoints//
layout: reference
toc: true
-permalink: /Reference/v2/Endpoints/GenericTfsEndpoint`1/
+permalink: /Reference/Endpoints/GenericTfsEndpoint`1/
title: GenericTfsEndpoint`1
categories:
- Endpoints
- v2
topics:
- topic: notes
- path: /docs/Reference/v2/Endpoints/GenericTfsEndpoint`1-notes.md
+ path: /Endpoints/GenericTfsEndpoint`1-notes.md
exists: false
markdown: ''
- topic: introduction
- path: /docs/Reference/v2/Endpoints/GenericTfsEndpoint`1-introduction.md
+ path: /Endpoints/GenericTfsEndpoint`1-introduction.md
exists: false
markdown: ''
diff --git a/docs/collections/_reference/reference.endpoints.tfsendpoint.md b/docs/collections/_reference/reference.endpoints.tfsendpoint.md
new file mode 100644
index 000000000..418e0d0fd
--- /dev/null
+++ b/docs/collections/_reference/reference.endpoints.tfsendpoint.md
@@ -0,0 +1,84 @@
+---
+optionsClassName: TfsEndpointOptions
+optionsClassFullName: MigrationTools.Endpoints.TfsEndpointOptions
+configurationSamples:
+- name: defaults
+ description:
+ code: There are no defaults! Check the sample for options!
+ sampleFor: MigrationTools.Endpoints.TfsEndpointOptions
+- name: sample
+ description:
+ code: There is no sample, but you can check the classic below for a general feel.
+ sampleFor: MigrationTools.Endpoints.TfsEndpointOptions
+- name: classic
+ description:
+ code: >-
+ {
+ "$type": "TfsEndpointOptions",
+ "Organisation": null,
+ "Project": null,
+ "AuthenticationMode": "AccessToken",
+ "AccessToken": null,
+ "ReflectedWorkItemIdField": null,
+ "LanguageMaps": null,
+ "EndpointEnrichers": null
+ }
+ sampleFor: MigrationTools.Endpoints.TfsEndpointOptions
+description: missng XML code comments
+className: TfsEndpoint
+typeName: Endpoints
+architecture:
+options:
+- parameterName: AccessToken
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: AuthenticationMode
+ type: AuthenticationMode
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: EndpointEnrichers
+ type: List
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: LanguageMaps
+ type: TfsLanguageMapOptions
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: Organisation
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: Project
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: ReflectedWorkItemIdField
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+status: missng XML code comments
+processingTarget: missng XML code comments
+classFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Endpoints/TfsEndpoint.cs
+optionsClassFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Endpoints/TfsEndpointOptions.cs
+
+redirectFrom:
+- /Reference/Endpoints/TfsEndpointOptions/
+layout: reference
+toc: true
+permalink: /Reference/Endpoints/TfsEndpoint/
+title: TfsEndpoint
+categories:
+- Endpoints
+-
+topics:
+- topic: notes
+ path: /docs/Reference/Endpoints/TfsEndpoint-notes.md
+ exists: false
+ markdown: ''
+- topic: introduction
+ path: /docs/Reference/Endpoints/TfsEndpoint-introduction.md
+ exists: false
+ markdown: ''
+
+---
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.endpoints.tfsmigrationclient.md b/docs/collections/_reference/reference.endpoints.tfsmigrationclient.md
new file mode 100644
index 000000000..a0a19332b
--- /dev/null
+++ b/docs/collections/_reference/reference.endpoints.tfsmigrationclient.md
@@ -0,0 +1,123 @@
+---
+optionsClassName: TfsMigrationClient
+optionsClassFullName: MigrationTools._EngineV1.Clients.TfsMigrationClient
+configurationSamples:
+- name: defaults
+ description:
+ code: >-
+ {
+ "MigrationTools": {
+ "EndpointDefaults": {
+ "TfsMigrationClient": []
+ }
+ }
+ }
+ sampleFor: MigrationTools._EngineV1.Clients.TfsMigrationClient
+- name: sample
+ description:
+ code: >-
+ {
+ "MigrationTools": {
+ "EndpointDefaults": {
+ "TfsMigrationClient": []
+ }
+ }
+ }
+ sampleFor: MigrationTools._EngineV1.Clients.TfsMigrationClient
+- name: classic
+ description:
+ code: >-
+ {
+ "$type": "TfsMigrationClient",
+ "Enabled": false,
+ "TfsConfig": null,
+ "Config": null,
+ "WorkItems": null,
+ "TestPlans": null,
+ "Credentials": {
+ "PromptType": 0,
+ "Federated": null,
+ "Windows": {
+ "Credentials": {
+ "UserName": "",
+ "Password": "",
+ "SecurePassword": {
+ "Length": 0
+ },
+ "Domain": ""
+ },
+ "CredentialType": 0,
+ "UseDefaultCredentials": true
+ },
+ "Storage": null
+ },
+ "InternalCollection": null,
+ "Name": null,
+ "EndpointEnrichers": null
+ }
+ sampleFor: MigrationTools._EngineV1.Clients.TfsMigrationClient
+description: missng XML code comments
+className: TfsMigrationClient
+typeName: Endpoints
+architecture:
+options:
+- parameterName: Config
+ type: IEndpointOptions
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: Credentials
+ type: VssCredentials
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: Enabled
+ type: Boolean
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: EndpointEnrichers
+ type: List
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: InternalCollection
+ type: Object
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: Name
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: TestPlans
+ type: ITestPlanMigrationClient
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: TfsConfig
+ type: TfsTeamProjectEndpointOptions
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: WorkItems
+ type: IWorkItemMigrationClient
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+status: missng XML code comments
+processingTarget: missng XML code comments
+classFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Clients/TfsMigrationClient.cs
+optionsClassFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Clients/TfsMigrationClient.cs
+
+redirectFrom: []
+layout: reference
+toc: true
+permalink: /Reference/Endpoints/TfsMigrationClient/
+title: TfsMigrationClient
+categories:
+- Endpoints
+-
+topics:
+- topic: notes
+ path: /docs/Reference/Endpoints/TfsMigrationClient-notes.md
+ exists: false
+ markdown: ''
+- topic: introduction
+ path: /docs/Reference/Endpoints/TfsMigrationClient-introduction.md
+ exists: false
+ markdown: ''
+
+---
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.endpoints.tfsteamprojectendpoint.md b/docs/collections/_reference/reference.endpoints.tfsteamprojectendpoint.md
new file mode 100644
index 000000000..e46c7af73
--- /dev/null
+++ b/docs/collections/_reference/reference.endpoints.tfsteamprojectendpoint.md
@@ -0,0 +1,150 @@
+---
+optionsClassName: TfsTeamProjectEndpointOptions
+optionsClassFullName: MigrationTools.Endpoints.TfsTeamProjectEndpointOptions
+configurationSamples:
+- name: defaults
+ description:
+ code: >-
+ {
+ "MigrationTools": {
+ "Endpoints": {
+ "#KEY#": {
+ "TfsTeamProjectEndpoint": {
+ "AllowCrossProjectLinking": "False",
+ "Authentication": {
+ "AccessToken": "12345",
+ "AuthenticationMode": "AccessToken",
+ "NetworkCredentials": {
+ "Domain": "",
+ "Password": "",
+ "UserName": ""
+ }
+ },
+ "AuthenticationMode": "AccessToken",
+ "Collection": "",
+ "EndpointType": "TfsTeamProjectEndpoint",
+ "LanguageMaps": {
+ "AreaPath": "Area",
+ "IterationPath": "Iteration"
+ },
+ "Project": ""
+ }
+ }
+ }
+ }
+ }
+ sampleFor: MigrationTools.Endpoints.TfsTeamProjectEndpointOptions
+- name: sample
+ description:
+ code: >-
+ {
+ "MigrationTools": {
+ "Endpoints": {
+ "#KEY#": {
+ "TfsTeamProjectEndpoint": {
+ "AllowCrossProjectLinking": "False",
+ "Authentication": {
+ "AccessToken": "jklsadhjksahfkjsdhjksahsadjhksadhsad",
+ "AuthenticationMode": "AccessToken",
+ "NetworkCredentials": {
+ "Domain": "",
+ "Password": "",
+ "UserName": ""
+ }
+ },
+ "Collection": "https://dev.azure.com/nkdagility-preview/",
+ "EndpointType": "TfsTeamProjectEndpoint",
+ "LanguageMaps": {
+ "AreaPath": "Area",
+ "IterationPath": "Iteration"
+ },
+ "Project": "migrationSource1"
+ }
+ }
+ }
+ }
+ }
+ sampleFor: MigrationTools.Endpoints.TfsTeamProjectEndpointOptions
+- name: classic
+ description:
+ code: >-
+ {
+ "$type": "TfsTeamProjectEndpointOptions",
+ "Collection": "https://dev.azure.com/nkdagility-preview/",
+ "Project": "migrationSource1",
+ "Authentication": {
+ "AuthenticationMode": "AccessToken",
+ "NetworkCredentials": {
+ "Domain": "",
+ "UserName": "",
+ "Password": ""
+ },
+ "AccessToken": "jklsadhjksahfkjsdhjksahsadjhksadhsad"
+ },
+ "ReflectedWorkItemIDFieldName": null,
+ "AllowCrossProjectLinking": false,
+ "LanguageMaps": {
+ "AreaPath": "Area",
+ "IterationPath": "Iteration"
+ },
+ "EndpointEnrichers": null
+ }
+ sampleFor: MigrationTools.Endpoints.TfsTeamProjectEndpointOptions
+description: missng XML code comments
+className: TfsTeamProjectEndpoint
+typeName: Endpoints
+architecture:
+options:
+- parameterName: AllowCrossProjectLinking
+ type: Boolean
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: Authentication
+ type: TfsAuthenticationOptions
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: Collection
+ type: Uri
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: EndpointEnrichers
+ type: List
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: LanguageMaps
+ type: TfsLanguageMapOptions
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: Project
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: ReflectedWorkItemIDFieldName
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+status: missng XML code comments
+processingTarget: missng XML code comments
+classFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Endpoints/TfsTeamProjectEndpoint.cs
+optionsClassFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Endpoints/TfsTeamProjectEndPointOptions.cs
+
+redirectFrom:
+- /Reference/Endpoints/TfsTeamProjectEndpointOptions/
+layout: reference
+toc: true
+permalink: /Reference/Endpoints/TfsTeamProjectEndpoint/
+title: TfsTeamProjectEndpoint
+categories:
+- Endpoints
+-
+topics:
+- topic: notes
+ path: /docs/Reference/Endpoints/TfsTeamProjectEndpoint-notes.md
+ exists: false
+ markdown: ''
+- topic: introduction
+ path: /docs/Reference/Endpoints/TfsTeamProjectEndpoint-introduction.md
+ exists: false
+ markdown: ''
+
+---
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.endpoints.tfsteamsettingsendpoint.md b/docs/collections/_reference/reference.endpoints.tfsteamsettingsendpoint.md
new file mode 100644
index 000000000..2e5a4f31d
--- /dev/null
+++ b/docs/collections/_reference/reference.endpoints.tfsteamsettingsendpoint.md
@@ -0,0 +1,84 @@
+---
+optionsClassName: TfsTeamSettingsEndpointOptions
+optionsClassFullName: MigrationTools.Endpoints.TfsTeamSettingsEndpointOptions
+configurationSamples:
+- name: defaults
+ description:
+ code: There are no defaults! Check the sample for options!
+ sampleFor: MigrationTools.Endpoints.TfsTeamSettingsEndpointOptions
+- name: sample
+ description:
+ code: There is no sample, but you can check the classic below for a general feel.
+ sampleFor: MigrationTools.Endpoints.TfsTeamSettingsEndpointOptions
+- name: classic
+ description:
+ code: >-
+ {
+ "$type": "TfsTeamSettingsEndpointOptions",
+ "Organisation": null,
+ "Project": null,
+ "AuthenticationMode": "AccessToken",
+ "AccessToken": null,
+ "ReflectedWorkItemIdField": null,
+ "LanguageMaps": null,
+ "EndpointEnrichers": null
+ }
+ sampleFor: MigrationTools.Endpoints.TfsTeamSettingsEndpointOptions
+description: missng XML code comments
+className: TfsTeamSettingsEndpoint
+typeName: Endpoints
+architecture:
+options:
+- parameterName: AccessToken
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: AuthenticationMode
+ type: AuthenticationMode
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: EndpointEnrichers
+ type: List
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: LanguageMaps
+ type: TfsLanguageMapOptions
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: Organisation
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: Project
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: ReflectedWorkItemIdField
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+status: missng XML code comments
+processingTarget: missng XML code comments
+classFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Endpoints/TfsTeamSettingsEndpoint.cs
+optionsClassFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Endpoints/TfsTeamSettingsEndpointOptions.cs
+
+redirectFrom:
+- /Reference/Endpoints/TfsTeamSettingsEndpointOptions/
+layout: reference
+toc: true
+permalink: /Reference/Endpoints/TfsTeamSettingsEndpoint/
+title: TfsTeamSettingsEndpoint
+categories:
+- Endpoints
+-
+topics:
+- topic: notes
+ path: /docs/Reference/Endpoints/TfsTeamSettingsEndpoint-notes.md
+ exists: false
+ markdown: ''
+- topic: introduction
+ path: /docs/Reference/Endpoints/TfsTeamSettingsEndpoint-introduction.md
+ exists: false
+ markdown: ''
+
+---
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.endpoints.tfsworkitemendpoint.md b/docs/collections/_reference/reference.endpoints.tfsworkitemendpoint.md
new file mode 100644
index 000000000..0d5d38b53
--- /dev/null
+++ b/docs/collections/_reference/reference.endpoints.tfsworkitemendpoint.md
@@ -0,0 +1,102 @@
+---
+optionsClassName: TfsWorkItemEndpointOptions
+optionsClassFullName: MigrationTools.Endpoints.TfsWorkItemEndpointOptions
+configurationSamples:
+- name: defaults
+ description:
+ code: There are no defaults! Check the sample for options!
+ sampleFor: MigrationTools.Endpoints.TfsWorkItemEndpointOptions
+- name: sample
+ description:
+ code: There is no sample, but you can check the classic below for a general feel.
+ sampleFor: MigrationTools.Endpoints.TfsWorkItemEndpointOptions
+- name: classic
+ description:
+ code: >-
+ {
+ "$type": "TfsWorkItemEndpointOptions",
+ "Organisation": null,
+ "Project": null,
+ "Query": null,
+ "AuthenticationMode": "AccessToken",
+ "AccessToken": null,
+ "ReflectedWorkItemIdField": null,
+ "LanguageMaps": null,
+ "EndpointEnrichers": null
+ }
+ sampleFor: MigrationTools.Endpoints.TfsWorkItemEndpointOptions
+description: missng XML code comments
+className: TfsWorkItemEndpoint
+typeName: Endpoints
+architecture:
+options:
+- parameterName: AccessToken
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: AuthenticationMode
+ type: AuthenticationMode
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: EndpointEnrichers
+ type: List
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: LanguageMaps
+ type: TfsLanguageMapOptions
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: Organisation
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: Project
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: Query
+ type: QueryOptions
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: ReflectedWorkItemIdField
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+status: missng XML code comments
+processingTarget: missng XML code comments
+classFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Endpoints/TfsWorkItemEndpoint.cs
+optionsClassFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Endpoints/TfsWorkItemEndpointOptions.cs
+
+redirectFrom:
+- /Reference/Endpoints/TfsWorkItemEndpointOptions/
+layout: reference
+toc: true
+permalink: /Reference/Endpoints/TfsWorkItemEndpoint/
+title: TfsWorkItemEndpoint
+categories:
+- Endpoints
+-
+topics:
+- topic: notes
+ path: /docs/Reference/Endpoints/TfsWorkItemEndpoint-notes.md
+ exists: true
+ markdown: >+
+ The Work Item endpoint is super awesome.
+
+
+ |Client | WriteTo/ReadFrom | Endpoint | Data Target | Description |
+
+ |:-:|:-:|:-:|:-:|:-:|
+
+ AzureDevops.ObjectModel | Tfs Object Model | `TfsWorkItemEndPoint` | WorkItems | TBA
+
+ AzureDevops.Rest | Azure DevOps REST | ?
+
+ FileSystem | Local Files | `FileSystemWorkItemEndpoint` | WorkItems | TBA
+
+- topic: introduction
+ path: /docs/Reference/Endpoints/TfsWorkItemEndpoint-introduction.md
+ exists: false
+ markdown: ''
+
+---
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.fieldmaps.fieldclearmap.md b/docs/collections/_reference/reference.fieldmaps.fieldclearmap.md
new file mode 100644
index 000000000..6529eb110
--- /dev/null
+++ b/docs/collections/_reference/reference.fieldmaps.fieldclearmap.md
@@ -0,0 +1,95 @@
+---
+optionsClassName: FieldClearMapOptions
+optionsClassFullName: MigrationTools.Tools.FieldClearMapOptions
+configurationSamples:
+- name: defaults
+ description:
+ code: >-
+ {
+ "MigrationTools": {
+ "CommonTools": {
+ "FieldMappingTool": {
+ "FieldMaps": [
+ {
+ "FieldMapType": "FieldClearMap",
+ "ApplyTo": [
+ "*"
+ ]
+ }
+ ]
+ }
+ }
+ }
+ }
+ sampleFor: MigrationTools.Tools.FieldClearMapOptions
+- name: sample
+ description:
+ code: >-
+ {
+ "MigrationTools": {
+ "CommonTools": {
+ "FieldMappingTool": {
+ "FieldMaps": [
+ {
+ "FieldMapType": "FieldClearMap",
+ "ApplyTo": [
+ "SomeWorkItemType"
+ ],
+ "targetField": "Custom.FieldC"
+ }
+ ]
+ }
+ }
+ }
+ }
+ sampleFor: MigrationTools.Tools.FieldClearMapOptions
+- name: classic
+ description:
+ code: >-
+ {
+ "$type": "FieldClearMapOptions",
+ "targetField": "Custom.FieldC",
+ "ApplyTo": [
+ "*",
+ "SomeWorkItemType"
+ ]
+ }
+ sampleFor: MigrationTools.Tools.FieldClearMapOptions
+description: missng XML code comments
+className: FieldClearMap
+typeName: FieldMaps
+architecture:
+options:
+- parameterName: ApplyTo
+ type: List
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: targetField
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+status: missng XML code comments
+processingTarget: missng XML code comments
+classFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Tools/FieldMappingTool/FieldMaps/FieldClearMap.cs
+optionsClassFile: /src/MigrationTools/Tools/FieldMappingTool/FieldMaps/FieldClearMapOptions.cs
+
+redirectFrom:
+- /Reference/FieldMaps/FieldClearMapOptions/
+layout: reference
+toc: true
+permalink: /Reference/FieldMaps/FieldClearMap/
+title: FieldClearMap
+categories:
+- FieldMaps
+-
+topics:
+- topic: notes
+ path: /docs/Reference/FieldMaps/FieldClearMap-notes.md
+ exists: false
+ markdown: ''
+- topic: introduction
+ path: /docs/Reference/FieldMaps/FieldClearMap-introduction.md
+ exists: false
+ markdown: ''
+
+---
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.fieldmaps.fieldliteralmap.md b/docs/collections/_reference/reference.fieldmaps.fieldliteralmap.md
new file mode 100644
index 000000000..e73ed4596
--- /dev/null
+++ b/docs/collections/_reference/reference.fieldmaps.fieldliteralmap.md
@@ -0,0 +1,101 @@
+---
+optionsClassName: FieldLiteralMapOptions
+optionsClassFullName: MigrationTools.Tools.FieldLiteralMapOptions
+configurationSamples:
+- name: defaults
+ description:
+ code: >-
+ {
+ "MigrationTools": {
+ "CommonTools": {
+ "FieldMappingTool": {
+ "FieldMaps": [
+ {
+ "FieldMapType": "FieldLiteralMap",
+ "ApplyTo": [
+ "*"
+ ]
+ }
+ ]
+ }
+ }
+ }
+ }
+ sampleFor: MigrationTools.Tools.FieldLiteralMapOptions
+- name: sample
+ description:
+ code: >-
+ {
+ "MigrationTools": {
+ "CommonTools": {
+ "FieldMappingTool": {
+ "FieldMaps": [
+ {
+ "FieldMapType": "FieldLiteralMap",
+ "ApplyTo": [
+ "SomeWorkItemType"
+ ],
+ "targetField": "Custom.SomeField",
+ "value": "New field value"
+ }
+ ]
+ }
+ }
+ }
+ }
+ sampleFor: MigrationTools.Tools.FieldLiteralMapOptions
+- name: classic
+ description:
+ code: >-
+ {
+ "$type": "FieldLiteralMapOptions",
+ "targetField": "Custom.SomeField",
+ "value": "New field value",
+ "ApplyTo": [
+ "*",
+ "SomeWorkItemType"
+ ]
+ }
+ sampleFor: MigrationTools.Tools.FieldLiteralMapOptions
+description: missng XML code comments
+className: FieldLiteralMap
+typeName: FieldMaps
+architecture:
+options:
+- parameterName: ApplyTo
+ type: List
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: targetField
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: value
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+status: missng XML code comments
+processingTarget: missng XML code comments
+classFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Tools/FieldMappingTool/FieldMaps/FieldLiteralMap.cs
+optionsClassFile: /src/MigrationTools/Tools/FieldMappingTool/FieldMaps/FieldLiteralMapOptions.cs
+
+redirectFrom:
+- /Reference/FieldMaps/FieldLiteralMapOptions/
+layout: reference
+toc: true
+permalink: /Reference/FieldMaps/FieldLiteralMap/
+title: FieldLiteralMap
+categories:
+- FieldMaps
+-
+topics:
+- topic: notes
+ path: /docs/Reference/FieldMaps/FieldLiteralMap-notes.md
+ exists: false
+ markdown: ''
+- topic: introduction
+ path: /docs/Reference/FieldMaps/FieldLiteralMap-introduction.md
+ exists: false
+ markdown: ''
+
+---
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.fieldmaps.fieldmergemap.md b/docs/collections/_reference/reference.fieldmaps.fieldmergemap.md
new file mode 100644
index 000000000..6b50f33e5
--- /dev/null
+++ b/docs/collections/_reference/reference.fieldmaps.fieldmergemap.md
@@ -0,0 +1,113 @@
+---
+optionsClassName: FieldMergeMapOptions
+optionsClassFullName: MigrationTools.Tools.FieldMergeMapOptions
+configurationSamples:
+- name: defaults
+ description:
+ code: >-
+ {
+ "MigrationTools": {
+ "CommonTools": {
+ "FieldMappingTool": {
+ "FieldMaps": [
+ {
+ "FieldMapType": "FieldMergeMap",
+ "ApplyTo": [
+ "*"
+ ]
+ }
+ ]
+ }
+ }
+ }
+ }
+ sampleFor: MigrationTools.Tools.FieldMergeMapOptions
+- name: sample
+ description:
+ code: >-
+ {
+ "MigrationTools": {
+ "CommonTools": {
+ "FieldMappingTool": {
+ "FieldMaps": [
+ {
+ "FieldMapType": "FieldMergeMap",
+ "ApplyTo": [
+ "SomeWorkItemType"
+ ],
+ "formatExpression": "{0} \n {1}",
+ "sourceFields": [
+ "Custom.FieldA",
+ "Custom.FieldB"
+ ],
+ "targetField": "Custom.FieldC"
+ }
+ ]
+ }
+ }
+ }
+ }
+ sampleFor: MigrationTools.Tools.FieldMergeMapOptions
+- name: classic
+ description:
+ code: >-
+ {
+ "$type": "FieldMergeMapOptions",
+ "sourceFields": [
+ "Custom.FieldA",
+ "Custom.FieldB"
+ ],
+ "targetField": "Custom.FieldC",
+ "formatExpression": "{0} \n {1}",
+ "ApplyTo": [
+ "*",
+ "SomeWorkItemType"
+ ]
+ }
+ sampleFor: MigrationTools.Tools.FieldMergeMapOptions
+description: missng XML code comments
+className: FieldMergeMap
+typeName: FieldMaps
+architecture:
+options:
+- parameterName: ApplyTo
+ type: List
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: formatExpression
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: sourceFields
+ type: List
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: targetField
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+status: missng XML code comments
+processingTarget: missng XML code comments
+classFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Tools/FieldMappingTool/FieldMaps/FieldMergeMap.cs
+optionsClassFile: /src/MigrationTools/Tools/FieldMappingTool/FieldMaps/FieldMergeMapOptions.cs
+
+redirectFrom:
+- /Reference/FieldMaps/FieldMergeMapOptions/
+layout: reference
+toc: true
+permalink: /Reference/FieldMaps/FieldMergeMap/
+title: FieldMergeMap
+categories:
+- FieldMaps
+-
+topics:
+- topic: notes
+ path: /docs/Reference/FieldMaps/FieldMergeMap-notes.md
+ exists: false
+ markdown: ''
+- topic: introduction
+ path: /docs/Reference/FieldMaps/FieldMergeMap-introduction.md
+ exists: false
+ markdown: ''
+
+---
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.fieldmaps.fieldskipmap.md b/docs/collections/_reference/reference.fieldmaps.fieldskipmap.md
new file mode 100644
index 000000000..5818d5cea
--- /dev/null
+++ b/docs/collections/_reference/reference.fieldmaps.fieldskipmap.md
@@ -0,0 +1,77 @@
+---
+optionsClassName: FieldSkipMapOptions
+optionsClassFullName: MigrationTools.Tools.FieldSkipMapOptions
+configurationSamples:
+- name: defaults
+ description:
+ code: >-
+ {
+ "MigrationTools": {
+ "CommonTools": {
+ "FieldMappingTool": {
+ "FieldMaps": [
+ {
+ "FieldMapType": "FieldSkipMap",
+ "ApplyTo": [
+ "*"
+ ]
+ }
+ ]
+ }
+ }
+ }
+ }
+ sampleFor: MigrationTools.Tools.FieldSkipMapOptions
+- name: sample
+ description:
+ code: There is no sample, but you can check the classic below for a general feel.
+ sampleFor: MigrationTools.Tools.FieldSkipMapOptions
+- name: classic
+ description:
+ code: >-
+ {
+ "$type": "FieldSkipMapOptions",
+ "targetField": null,
+ "ApplyTo": [
+ "*"
+ ]
+ }
+ sampleFor: MigrationTools.Tools.FieldSkipMapOptions
+description: missng XML code comments
+className: FieldSkipMap
+typeName: FieldMaps
+architecture:
+options:
+- parameterName: ApplyTo
+ type: List
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: targetField
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+status: missng XML code comments
+processingTarget: missng XML code comments
+classFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Tools/FieldMappingTool/FieldMaps/FieldSkipMap.cs
+optionsClassFile: /src/MigrationTools/Tools/FieldMappingTool/FieldMaps/FieldSkipMapOptions.cs
+
+redirectFrom:
+- /Reference/FieldMaps/FieldSkipMapOptions/
+layout: reference
+toc: true
+permalink: /Reference/FieldMaps/FieldSkipMap/
+title: FieldSkipMap
+categories:
+- FieldMaps
+-
+topics:
+- topic: notes
+ path: /docs/Reference/FieldMaps/FieldSkipMap-notes.md
+ exists: false
+ markdown: ''
+- topic: introduction
+ path: /docs/Reference/FieldMaps/FieldSkipMap-introduction.md
+ exists: false
+ markdown: ''
+
+---
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.fieldmaps.fieldtofieldmap.md b/docs/collections/_reference/reference.fieldmaps.fieldtofieldmap.md
new file mode 100644
index 000000000..fe3030e0d
--- /dev/null
+++ b/docs/collections/_reference/reference.fieldmaps.fieldtofieldmap.md
@@ -0,0 +1,107 @@
+---
+optionsClassName: FieldToFieldMapOptions
+optionsClassFullName: MigrationTools.Tools.FieldToFieldMapOptions
+configurationSamples:
+- name: defaults
+ description:
+ code: >-
+ {
+ "MigrationTools": {
+ "CommonTools": {
+ "FieldMappingTool": {
+ "FieldMaps": [
+ {
+ "FieldMapType": "FieldToFieldMap",
+ "ApplyTo": [
+ "*"
+ ]
+ }
+ ]
+ }
+ }
+ }
+ }
+ sampleFor: MigrationTools.Tools.FieldToFieldMapOptions
+- name: sample
+ description:
+ code: >-
+ {
+ "MigrationTools": {
+ "CommonTools": {
+ "FieldMappingTool": {
+ "FieldMaps": [
+ {
+ "FieldMapType": "FieldToFieldMap",
+ "ApplyTo": [
+ "SomeWorkItemType"
+ ],
+ "defaultValue": "42",
+ "sourceField": "Microsoft.VSTS.Common.BacklogPriority",
+ "targetField": "Microsoft.VSTS.Common.StackRank"
+ }
+ ]
+ }
+ }
+ }
+ }
+ sampleFor: MigrationTools.Tools.FieldToFieldMapOptions
+- name: classic
+ description:
+ code: >-
+ {
+ "$type": "FieldToFieldMapOptions",
+ "sourceField": "Microsoft.VSTS.Common.BacklogPriority",
+ "targetField": "Microsoft.VSTS.Common.StackRank",
+ "defaultValue": "42",
+ "ApplyTo": [
+ "*",
+ "SomeWorkItemType"
+ ]
+ }
+ sampleFor: MigrationTools.Tools.FieldToFieldMapOptions
+description: missng XML code comments
+className: FieldToFieldMap
+typeName: FieldMaps
+architecture:
+options:
+- parameterName: ApplyTo
+ type: List
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: defaultValue
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: sourceField
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: targetField
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+status: missng XML code comments
+processingTarget: missng XML code comments
+classFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Tools/FieldMappingTool/FieldMaps/FieldToFieldMap.cs
+optionsClassFile: /src/MigrationTools/Tools/FieldMappingTool/FieldMaps/FieldtoFieldMapOptions.cs
+
+redirectFrom:
+- /Reference/FieldMaps/FieldToFieldMapOptions/
+layout: reference
+toc: true
+permalink: /Reference/FieldMaps/FieldToFieldMap/
+title: FieldToFieldMap
+categories:
+- FieldMaps
+-
+topics:
+- topic: notes
+ path: /docs/Reference/FieldMaps/FieldToFieldMap-notes.md
+ exists: false
+ markdown: ''
+- topic: introduction
+ path: /docs/Reference/FieldMaps/FieldToFieldMap-introduction.md
+ exists: false
+ markdown: ''
+
+---
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.fieldmaps.fieldtofieldmultimap.md b/docs/collections/_reference/reference.fieldmaps.fieldtofieldmultimap.md
new file mode 100644
index 000000000..7ccb5ffe8
--- /dev/null
+++ b/docs/collections/_reference/reference.fieldmaps.fieldtofieldmultimap.md
@@ -0,0 +1,103 @@
+---
+optionsClassName: FieldToFieldMultiMapOptions
+optionsClassFullName: MigrationTools.Tools.FieldToFieldMultiMapOptions
+configurationSamples:
+- name: defaults
+ description:
+ code: >-
+ {
+ "MigrationTools": {
+ "CommonTools": {
+ "FieldMappingTool": {
+ "FieldMaps": [
+ {
+ "FieldMapType": "FieldToFieldMultiMap",
+ "ApplyTo": [
+ "*"
+ ]
+ }
+ ]
+ }
+ }
+ }
+ }
+ sampleFor: MigrationTools.Tools.FieldToFieldMultiMapOptions
+- name: sample
+ description:
+ code: >-
+ {
+ "MigrationTools": {
+ "CommonTools": {
+ "FieldMappingTool": {
+ "FieldMaps": [
+ {
+ "FieldMapType": "FieldToFieldMultiMap",
+ "ApplyTo": [
+ "SomeWorkItemType",
+ "SomeOtherWorkItemType"
+ ],
+ "SourceToTargetMappings": {
+ "SourceField1": "TargetField1",
+ "SourceField2": "TargetField2"
+ }
+ }
+ ]
+ }
+ }
+ }
+ }
+ sampleFor: MigrationTools.Tools.FieldToFieldMultiMapOptions
+- name: classic
+ description:
+ code: >-
+ {
+ "$type": "FieldToFieldMultiMapOptions",
+ "SourceToTargetMappings": {
+ "SourceField1": "TargetField1",
+ "SourceField2": "TargetField2"
+ },
+ "ApplyTo": [
+ "*",
+ "SomeWorkItemType",
+ "SomeOtherWorkItemType"
+ ]
+ }
+ sampleFor: MigrationTools.Tools.FieldToFieldMultiMapOptions
+description: missng XML code comments
+className: FieldToFieldMultiMap
+typeName: FieldMaps
+architecture:
+options:
+- parameterName: ApplyTo
+ type: List
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: SourceToTargetMappings
+ type: Dictionary
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+status: missng XML code comments
+processingTarget: missng XML code comments
+classFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Tools/FieldMappingTool/FieldMaps/FieldtoFieldMultiMap.cs
+optionsClassFile: /src/MigrationTools/Tools/FieldMappingTool/FieldMaps/FieldtoFieldMultiMapOptions.cs
+
+redirectFrom:
+- /Reference/FieldMaps/FieldToFieldMultiMapOptions/
+layout: reference
+toc: true
+permalink: /Reference/FieldMaps/FieldToFieldMultiMap/
+title: FieldToFieldMultiMap
+categories:
+- FieldMaps
+-
+topics:
+- topic: notes
+ path: /docs/Reference/FieldMaps/FieldToFieldMultiMap-notes.md
+ exists: false
+ markdown: ''
+- topic: introduction
+ path: /docs/Reference/FieldMaps/FieldToFieldMultiMap-introduction.md
+ exists: false
+ markdown: ''
+
+---
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.fieldmaps.fieldtotagfieldmap.md b/docs/collections/_reference/reference.fieldmaps.fieldtotagfieldmap.md
new file mode 100644
index 000000000..51e7e80e2
--- /dev/null
+++ b/docs/collections/_reference/reference.fieldmaps.fieldtotagfieldmap.md
@@ -0,0 +1,105 @@
+---
+optionsClassName: FieldToTagFieldMapOptions
+optionsClassFullName: MigrationTools.Tools.FieldToTagFieldMapOptions
+configurationSamples:
+- name: defaults
+ description:
+ code: >-
+ {
+ "MigrationTools": {
+ "CommonTools": {
+ "FieldMappingTool": {
+ "FieldMaps": [
+ {
+ "FieldMapType": "FieldToTagFieldMap",
+ "ApplyTo": [
+ "*"
+ ]
+ }
+ ]
+ }
+ }
+ }
+ }
+ sampleFor: MigrationTools.Tools.FieldToTagFieldMapOptions
+- name: sample
+ description:
+ code: >-
+ {
+ "MigrationTools": {
+ "CommonTools": {
+ "FieldMappingTool": {
+ "FieldMaps": [
+ {
+ "FieldMapType": "FieldToTagFieldMap",
+ "ApplyTo": [
+ "SomeWorkItemType"
+ ],
+ "formatExpression": "{0}
Acceptance Criteria
{1}",
+ "sourceFields": [
+ "System.Description",
+ "Microsoft.VSTS.Common.AcceptanceCriteria"
+ ],
+ "targetField": "System.Description"
+ }
+ ]
+ }
+ }
+ }
+ }
+ sampleFor: MigrationTools.Tools.FieldToTagFieldMapOptions
+- name: classic
+ description:
+ code: >-
+ {
+ "$type": "FieldToTagFieldMapOptions",
+ "sourceField": null,
+ "formatExpression": "{0}
Acceptance Criteria
{1}",
+ "ApplyTo": [
+ "*",
+ "SomeWorkItemType"
+ ]
+ }
+ sampleFor: MigrationTools.Tools.FieldToTagFieldMapOptions
+description: missng XML code comments
+className: FieldToTagFieldMap
+typeName: FieldMaps
+architecture:
+options:
+- parameterName: ApplyTo
+ type: List
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: formatExpression
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: sourceField
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+status: missng XML code comments
+processingTarget: missng XML code comments
+classFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Tools/FieldMappingTool/FieldMaps/FieldToTagFieldMap.cs
+optionsClassFile: ''
+
+redirectFrom:
+- /Reference/FieldMaps/FieldToTagFieldMapOptions/
+layout: reference
+toc: true
+permalink: /Reference/FieldMaps/FieldToTagFieldMap/
+title: FieldToTagFieldMap
+categories:
+- FieldMaps
+-
+topics:
+- topic: notes
+ path: /docs/Reference/FieldMaps/FieldToTagFieldMap-notes.md
+ exists: false
+ markdown: ''
+- topic: introduction
+ path: /docs/Reference/FieldMaps/FieldToTagFieldMap-introduction.md
+ exists: false
+ markdown: ''
+
+---
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.fieldmaps.fieldvaluemap.md b/docs/collections/_reference/reference.fieldmaps.fieldvaluemap.md
new file mode 100644
index 000000000..03ff39130
--- /dev/null
+++ b/docs/collections/_reference/reference.fieldmaps.fieldvaluemap.md
@@ -0,0 +1,117 @@
+---
+optionsClassName: FieldValueMapOptions
+optionsClassFullName: MigrationTools.Tools.FieldValueMapOptions
+configurationSamples:
+- name: defaults
+ description:
+ code: >-
+ {
+ "MigrationTools": {
+ "CommonTools": {
+ "FieldMappingTool": {
+ "FieldMaps": [
+ {
+ "FieldMapType": "FieldValueMap",
+ "ApplyTo": [
+ "*"
+ ]
+ }
+ ]
+ }
+ }
+ }
+ }
+ sampleFor: MigrationTools.Tools.FieldValueMapOptions
+- name: sample
+ description:
+ code: >-
+ {
+ "MigrationTools": {
+ "CommonTools": {
+ "FieldMappingTool": {
+ "FieldMaps": [
+ {
+ "FieldMapType": "FieldValueMap",
+ "ApplyTo": [
+ "SomeWorkItemType"
+ ],
+ "defaultValue": "StateB",
+ "sourceField": "System.State",
+ "targetField": "System.State",
+ "valueMapping": {
+ "StateA": "StateB"
+ }
+ }
+ ]
+ }
+ }
+ }
+ }
+ sampleFor: MigrationTools.Tools.FieldValueMapOptions
+- name: classic
+ description:
+ code: >-
+ {
+ "$type": "FieldValueMapOptions",
+ "sourceField": "System.State",
+ "targetField": "System.State",
+ "defaultValue": "StateB",
+ "valueMapping": {
+ "StateA": "StateB"
+ },
+ "ApplyTo": [
+ "*",
+ "SomeWorkItemType"
+ ]
+ }
+ sampleFor: MigrationTools.Tools.FieldValueMapOptions
+description: missng XML code comments
+className: FieldValueMap
+typeName: FieldMaps
+architecture:
+options:
+- parameterName: ApplyTo
+ type: List
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: defaultValue
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: sourceField
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: targetField
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: valueMapping
+ type: Dictionary
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+status: missng XML code comments
+processingTarget: missng XML code comments
+classFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Tools/FieldMappingTool/FieldMaps/FieldValueMap.cs
+optionsClassFile: /src/MigrationTools/Tools/FieldMappingTool/FieldMaps/FieldValueMapOptions.cs
+
+redirectFrom:
+- /Reference/FieldMaps/FieldValueMapOptions/
+layout: reference
+toc: true
+permalink: /Reference/FieldMaps/FieldValueMap/
+title: FieldValueMap
+categories:
+- FieldMaps
+-
+topics:
+- topic: notes
+ path: /docs/Reference/FieldMaps/FieldValueMap-notes.md
+ exists: false
+ markdown: ''
+- topic: introduction
+ path: /docs/Reference/FieldMaps/FieldValueMap-introduction.md
+ exists: false
+ markdown: ''
+
+---
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.fieldmaps.fieldvaluetotagmap.md b/docs/collections/_reference/reference.fieldmaps.fieldvaluetotagmap.md
new file mode 100644
index 000000000..64f31277b
--- /dev/null
+++ b/docs/collections/_reference/reference.fieldmaps.fieldvaluetotagmap.md
@@ -0,0 +1,91 @@
+---
+optionsClassName: FieldValuetoTagMapOptions
+optionsClassFullName: MigrationTools.Tools.FieldValuetoTagMapOptions
+configurationSamples:
+- name: defaults
+ description:
+ code: >-
+ {
+ "MigrationTools": {
+ "CommonTools": {
+ "FieldMappingTool": {
+ "FieldMapDefaults": {
+ "FieldValuetoTagMap": []
+ }
+ }
+ }
+ }
+ }
+ sampleFor: MigrationTools.Tools.FieldValuetoTagMapOptions
+- name: sample
+ description:
+ code: >-
+ {
+ "MigrationTools": {
+ "CommonTools": {
+ "FieldMappingTool": {
+ "FieldMapDefaults": {
+ "FieldValuetoTagMap": []
+ }
+ }
+ }
+ }
+ }
+ sampleFor: MigrationTools.Tools.FieldValuetoTagMapOptions
+- name: classic
+ description:
+ code: >-
+ {
+ "$type": "FieldValuetoTagMapOptions",
+ "sourceField": null,
+ "pattern": null,
+ "formatExpression": null,
+ "ApplyTo": []
+ }
+ sampleFor: MigrationTools.Tools.FieldValuetoTagMapOptions
+description: missng XML code comments
+className: FieldValuetoTagMap
+typeName: FieldMaps
+architecture:
+options:
+- parameterName: ApplyTo
+ type: List
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: formatExpression
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: pattern
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: sourceField
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+status: missng XML code comments
+processingTarget: missng XML code comments
+classFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Tools/FieldMappingTool/FieldMaps/FieldValuetoTagMap.cs
+optionsClassFile: /src/MigrationTools/Tools/FieldMappingTool/FieldMaps/FieldValuetoTagMapOptions.cs
+
+redirectFrom:
+- /Reference/FieldMaps/FieldValuetoTagMapOptions/
+layout: reference
+toc: true
+permalink: /Reference/FieldMaps/FieldValuetoTagMap/
+title: FieldValuetoTagMap
+categories:
+- FieldMaps
+-
+topics:
+- topic: notes
+ path: /docs/Reference/FieldMaps/FieldValuetoTagMap-notes.md
+ exists: false
+ markdown: ''
+- topic: introduction
+ path: /docs/Reference/FieldMaps/FieldValuetoTagMap-introduction.md
+ exists: false
+ markdown: ''
+
+---
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.fieldmaps.multivalueconditionalmap.md b/docs/collections/_reference/reference.fieldmaps.multivalueconditionalmap.md
new file mode 100644
index 000000000..3feaa964e
--- /dev/null
+++ b/docs/collections/_reference/reference.fieldmaps.multivalueconditionalmap.md
@@ -0,0 +1,113 @@
+---
+optionsClassName: MultiValueConditionalMapOptions
+optionsClassFullName: MigrationTools.Tools.MultiValueConditionalMapOptions
+configurationSamples:
+- name: defaults
+ description:
+ code: >-
+ {
+ "MigrationTools": {
+ "CommonTools": {
+ "FieldMappingTool": {
+ "FieldMaps": [
+ {
+ "FieldMapType": "MultiValueConditionalMap",
+ "ApplyTo": [
+ "*"
+ ]
+ }
+ ]
+ }
+ }
+ }
+ }
+ sampleFor: MigrationTools.Tools.MultiValueConditionalMapOptions
+- name: sample
+ description:
+ code: >-
+ {
+ "MigrationTools": {
+ "CommonTools": {
+ "FieldMappingTool": {
+ "FieldMaps": [
+ {
+ "FieldMapType": "MultiValueConditionalMap",
+ "ApplyTo": [
+ "SomeWorkItemType"
+ ],
+ "sourceFieldsAndValues": {
+ "Field1": "Value1",
+ "Field2": "Value2"
+ },
+ "targetFieldsAndValues": {
+ "Field1": "Value1",
+ "Field2": "Value2"
+ }
+ }
+ ]
+ }
+ }
+ }
+ }
+ sampleFor: MigrationTools.Tools.MultiValueConditionalMapOptions
+- name: classic
+ description:
+ code: >-
+ {
+ "$type": "MultiValueConditionalMapOptions",
+ "sourceFieldsAndValues": {
+ "Field1": "Value1",
+ "Field2": "Value2"
+ },
+ "targetFieldsAndValues": {
+ "Field1": "Value1",
+ "Field2": "Value2"
+ },
+ "ApplyTo": [
+ "*",
+ "SomeWorkItemType"
+ ]
+ }
+ sampleFor: MigrationTools.Tools.MultiValueConditionalMapOptions
+description: missng XML code comments
+className: MultiValueConditionalMap
+typeName: FieldMaps
+architecture:
+options:
+- parameterName: ApplyTo
+ type: List
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: sourceFieldsAndValues
+ type: Dictionary
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: targetFieldsAndValues
+ type: Dictionary
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+status: missng XML code comments
+processingTarget: missng XML code comments
+classFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Tools/FieldMappingTool/FieldMaps/MultiValueConditionalMap.cs
+optionsClassFile: /src/MigrationTools/Tools/FieldMappingTool/FieldMaps/MultiValueConditionalMapOptions.cs
+
+redirectFrom:
+- /Reference/FieldMaps/MultiValueConditionalMapOptions/
+layout: reference
+toc: true
+permalink: /Reference/FieldMaps/MultiValueConditionalMap/
+title: MultiValueConditionalMap
+categories:
+- FieldMaps
+-
+topics:
+- topic: notes
+ path: /docs/Reference/FieldMaps/MultiValueConditionalMap-notes.md
+ exists: false
+ markdown: ''
+- topic: introduction
+ path: /docs/Reference/FieldMaps/MultiValueConditionalMap-introduction.md
+ exists: false
+ markdown: ''
+
+---
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.fieldmaps.regexfieldmap.md b/docs/collections/_reference/reference.fieldmaps.regexfieldmap.md
new file mode 100644
index 000000000..bfcc60ec7
--- /dev/null
+++ b/docs/collections/_reference/reference.fieldmaps.regexfieldmap.md
@@ -0,0 +1,113 @@
+---
+optionsClassName: RegexFieldMapOptions
+optionsClassFullName: MigrationTools.Tools.RegexFieldMapOptions
+configurationSamples:
+- name: defaults
+ description:
+ code: >-
+ {
+ "MigrationTools": {
+ "CommonTools": {
+ "FieldMappingTool": {
+ "FieldMaps": [
+ {
+ "FieldMapType": "RegexFieldMap",
+ "ApplyTo": [
+ "*"
+ ]
+ }
+ ]
+ }
+ }
+ }
+ }
+ sampleFor: MigrationTools.Tools.RegexFieldMapOptions
+- name: sample
+ description:
+ code: >-
+ {
+ "MigrationTools": {
+ "CommonTools": {
+ "FieldMappingTool": {
+ "FieldMaps": [
+ {
+ "FieldMapType": "RegexFieldMap",
+ "ApplyTo": [
+ "SomeWorkItemType"
+ ],
+ "pattern": "PRODUCT \\d{4}.(\\d{1})",
+ "replacement": "$1",
+ "sourceField": "COMPANY.PRODUCT.Release",
+ "targetField": "COMPANY.DEVISION.MinorReleaseVersion"
+ }
+ ]
+ }
+ }
+ }
+ }
+ sampleFor: MigrationTools.Tools.RegexFieldMapOptions
+- name: classic
+ description:
+ code: >-
+ {
+ "$type": "RegexFieldMapOptions",
+ "sourceField": "COMPANY.PRODUCT.Release",
+ "targetField": "COMPANY.DEVISION.MinorReleaseVersion",
+ "pattern": "PRODUCT \\d{4}.(\\d{1})",
+ "replacement": "$1",
+ "ApplyTo": [
+ "*",
+ "SomeWorkItemType"
+ ]
+ }
+ sampleFor: MigrationTools.Tools.RegexFieldMapOptions
+description: missng XML code comments
+className: RegexFieldMap
+typeName: FieldMaps
+architecture:
+options:
+- parameterName: ApplyTo
+ type: List
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: pattern
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: replacement
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: sourceField
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: targetField
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+status: missng XML code comments
+processingTarget: missng XML code comments
+classFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Tools/FieldMappingTool/FieldMaps/RegexFieldMap.cs
+optionsClassFile: /src/MigrationTools/Tools/FieldMappingTool/FieldMaps/RegexFieldMapOptions.cs
+
+redirectFrom:
+- /Reference/FieldMaps/RegexFieldMapOptions/
+layout: reference
+toc: true
+permalink: /Reference/FieldMaps/RegexFieldMap/
+title: RegexFieldMap
+categories:
+- FieldMaps
+-
+topics:
+- topic: notes
+ path: /docs/Reference/FieldMaps/RegexFieldMap-notes.md
+ exists: false
+ markdown: ''
+- topic: introduction
+ path: /docs/Reference/FieldMaps/RegexFieldMap-introduction.md
+ exists: false
+ markdown: ''
+
+---
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.fieldmaps.treetotagfieldmap.md b/docs/collections/_reference/reference.fieldmaps.treetotagfieldmap.md
new file mode 100644
index 000000000..cd1f87df1
--- /dev/null
+++ b/docs/collections/_reference/reference.fieldmaps.treetotagfieldmap.md
@@ -0,0 +1,82 @@
+---
+optionsClassName: TreeToTagFieldMapOptions
+optionsClassFullName: MigrationTools.Tools.TreeToTagFieldMapOptions
+configurationSamples:
+- name: defaults
+ description:
+ code: >-
+ {
+ "MigrationTools": {
+ "CommonTools": {
+ "FieldMappingTool": {
+ "FieldMaps": [
+ {
+ "FieldMapType": "TreeToTagFieldMap",
+ "ApplyTo": [
+ "*"
+ ]
+ }
+ ]
+ }
+ }
+ }
+ }
+ sampleFor: MigrationTools.Tools.TreeToTagFieldMapOptions
+- name: sample
+ description:
+ code: There is no sample, but you can check the classic below for a general feel.
+ sampleFor: MigrationTools.Tools.TreeToTagFieldMapOptions
+- name: classic
+ description:
+ code: >-
+ {
+ "$type": "TreeToTagFieldMapOptions",
+ "toSkip": 0,
+ "timeTravel": 0,
+ "ApplyTo": [
+ "*"
+ ]
+ }
+ sampleFor: MigrationTools.Tools.TreeToTagFieldMapOptions
+description: missng XML code comments
+className: TreeToTagFieldMap
+typeName: FieldMaps
+architecture:
+options:
+- parameterName: ApplyTo
+ type: List
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: timeTravel
+ type: Int32
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: toSkip
+ type: Int32
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+status: missng XML code comments
+processingTarget: missng XML code comments
+classFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Tools/FieldMappingTool/FieldMaps/TreeToTagFieldMap.cs
+optionsClassFile: ''
+
+redirectFrom:
+- /Reference/FieldMaps/TreeToTagFieldMapOptions/
+layout: reference
+toc: true
+permalink: /Reference/FieldMaps/TreeToTagFieldMap/
+title: TreeToTagFieldMap
+categories:
+- FieldMaps
+-
+topics:
+- topic: notes
+ path: /docs/Reference/FieldMaps/TreeToTagFieldMap-notes.md
+ exists: false
+ markdown: ''
+- topic: introduction
+ path: /docs/Reference/FieldMaps/TreeToTagFieldMap-introduction.md
+ exists: false
+ markdown: ''
+
+---
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.processorenrichers.pauseaftereachitem.md b/docs/collections/_reference/reference.processorenrichers.pauseaftereachitem.md
new file mode 100644
index 000000000..63403a9bf
--- /dev/null
+++ b/docs/collections/_reference/reference.processorenrichers.pauseaftereachitem.md
@@ -0,0 +1,64 @@
+---
+optionsClassName: PauseAfterEachItemOptions
+optionsClassFullName: MigrationTools.Enrichers.PauseAfterEachItemOptions
+configurationSamples:
+- name: defaults
+ description:
+ code: There are no defaults! Check the sample for options!
+ sampleFor: MigrationTools.Enrichers.PauseAfterEachItemOptions
+- name: sample
+ description:
+ code: There is no sample, but you can check the classic below for a general feel.
+ sampleFor: MigrationTools.Enrichers.PauseAfterEachItemOptions
+- name: classic
+ description:
+ code: >-
+ {
+ "$type": "PauseAfterEachItemOptions",
+ "Enabled": false,
+ "OptionFor": "PauseAfterEachItem",
+ "RefName": null
+ }
+ sampleFor: MigrationTools.Enrichers.PauseAfterEachItemOptions
+description: missng XML code comments
+className: PauseAfterEachItem
+typeName: ProcessorEnrichers
+architecture:
+options:
+- parameterName: Enabled
+ type: Boolean
+ description: If enabled this will run this migrator
+ defaultValue: true
+- parameterName: OptionFor
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: RefName
+ type: String
+ description: For internal use
+ defaultValue: missng XML code comments
+status: missng XML code comments
+processingTarget: missng XML code comments
+classFile: /src/MigrationTools/Processors/Enrichers/PauseAfterEachItem.cs
+optionsClassFile: /src/MigrationTools/Processors/Enrichers/PauseAfterEachItemOptions.cs
+
+redirectFrom:
+- /Reference/ProcessorEnrichers/PauseAfterEachItemOptions/
+layout: reference
+toc: true
+permalink: /Reference/ProcessorEnrichers/PauseAfterEachItem/
+title: PauseAfterEachItem
+categories:
+- ProcessorEnrichers
+-
+topics:
+- topic: notes
+ path: /docs/Reference/ProcessorEnrichers/PauseAfterEachItem-notes.md
+ exists: false
+ markdown: ''
+- topic: introduction
+ path: /docs/Reference/ProcessorEnrichers/PauseAfterEachItem-introduction.md
+ exists: false
+ markdown: ''
+
+---
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.v2.processors.azuredevopspipelineprocessor.md b/docs/collections/_reference/reference.processors.azuredevopspipelineprocessor.md
similarity index 75%
rename from docs/collections/_reference/reference.v2.processors.azuredevopspipelineprocessor.md
rename to docs/collections/_reference/reference.processors.azuredevopspipelineprocessor.md
index bceef6ca6..f993ef2b8 100644
--- a/docs/collections/_reference/reference.v2.processors.azuredevopspipelineprocessor.md
+++ b/docs/collections/_reference/reference.processors.azuredevopspipelineprocessor.md
@@ -2,7 +2,53 @@
optionsClassName: AzureDevOpsPipelineProcessorOptions
optionsClassFullName: MigrationTools.Processors.AzureDevOpsPipelineProcessorOptions
configurationSamples:
-- name: default
+- name: defaults
+ description:
+ code: >-
+ {
+ "MigrationTools": {
+ "Processors": [
+ {
+ "ProcessorType": "AzureDevOpsPipelineProcessor",
+ "BuildPipelines": "",
+ "Enabled": "False",
+ "MigrateBuildPipelines": "True",
+ "MigrateReleasePipelines": "True",
+ "MigrateServiceConnections": "True",
+ "MigrateTaskGroups": "True",
+ "MigrateVariableGroups": "True",
+ "ReleasePipelines": "",
+ "SourceName": "sourceName",
+ "TargetName": "targetName"
+ }
+ ]
+ }
+ }
+ sampleFor: MigrationTools.Processors.AzureDevOpsPipelineProcessorOptions
+- name: sample
+ description:
+ code: >-
+ {
+ "MigrationTools": {
+ "Processors": [
+ {
+ "ProcessorType": "AzureDevOpsPipelineProcessor",
+ "BuildPipelines": "",
+ "Enabled": "False",
+ "MigrateBuildPipelines": "True",
+ "MigrateReleasePipelines": "True",
+ "MigrateServiceConnections": "True",
+ "MigrateTaskGroups": "True",
+ "MigrateVariableGroups": "True",
+ "ReleasePipelines": "",
+ "SourceName": "sourceName",
+ "TargetName": "targetName"
+ }
+ ]
+ }
+ }
+ sampleFor: MigrationTools.Processors.AzureDevOpsPipelineProcessorOptions
+- name: classic
description:
code: >-
{
@@ -16,15 +62,16 @@ configurationSamples:
"BuildPipelines": null,
"ReleasePipelines": null,
"RepositoryNameMaps": null,
- "ProcessorEnrichers": null,
+ "Enrichers": null,
"SourceName": "sourceName",
- "TargetName": "targetName"
+ "TargetName": "targetName",
+ "RefName": null
}
sampleFor: MigrationTools.Processors.AzureDevOpsPipelineProcessorOptions
description: Azure DevOps Processor that migrates Taskgroups, Build- and Release Pipelines.
className: AzureDevOpsPipelineProcessor
typeName: Processors
-architecture: v2
+architecture:
options:
- parameterName: BuildPipelines
type: List
@@ -34,6 +81,10 @@ options:
type: Boolean
description: If set to `true` then the processor will run. Set to `false` and the processor will not run.
defaultValue: missng XML code comments
+- parameterName: 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.
+ defaultValue: missng XML code comments
- parameterName: MigrateBuildPipelines
type: Boolean
description: Migrate Build Pipelines
@@ -54,10 +105,6 @@ options:
type: Boolean
description: Migrate Valiable Groups
defaultValue: true
-- parameterName: ProcessorEnrichers
- 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.
- defaultValue: missng XML code comments
- parameterName: 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.'
@@ -83,17 +130,18 @@ processingTarget: Pipelines
classFile: /src/MigrationTools.Clients.AzureDevops.Rest/Processors/AzureDevOpsPipelineProcessor.cs
optionsClassFile: /src/MigrationTools.Clients.AzureDevops.Rest/Processors/AzureDevOpsPipelineProcessorOptions.cs
-redirectFrom: []
+redirectFrom:
+- /Reference/Processors/AzureDevOpsPipelineProcessorOptions/
layout: reference
toc: true
-permalink: /Reference/v2/Processors/AzureDevOpsPipelineProcessor/
+permalink: /Reference/Processors/AzureDevOpsPipelineProcessor/
title: AzureDevOpsPipelineProcessor
categories:
- Processors
-- v2
+-
topics:
- topic: notes
- path: /docs/Reference/v2/Processors/AzureDevOpsPipelineProcessor-notes.md
+ path: /docs/Reference/Processors/AzureDevOpsPipelineProcessor-notes.md
exists: true
markdown: >2-
@@ -168,7 +216,7 @@ topics:
When the application is creating service connections make sure you have proper permissions on Azure Active Directory and you can grant Contributor role to the subscription that was chosen.
- topic: introduction
- path: /docs/Reference/v2/Processors/AzureDevOpsPipelineProcessor-introduction.md
+ path: /docs/Reference/Processors/AzureDevOpsPipelineProcessor-introduction.md
exists: true
markdown: >2-
diff --git a/docs/collections/_reference/reference.v1.processors.createteamfolders.md b/docs/collections/_reference/reference.processors.createteamfolders.md
similarity index 61%
rename from docs/collections/_reference/reference.v1.processors.createteamfolders.md
rename to docs/collections/_reference/reference.processors.createteamfolders.md
index 8ad83db87..a36094049 100644
--- a/docs/collections/_reference/reference.v1.processors.createteamfolders.md
+++ b/docs/collections/_reference/reference.processors.createteamfolders.md
@@ -9,24 +9,25 @@ architecture: v1
options: []
status: alpha
processingTarget: Shared Queries
-classFile: /src/VstsSyncMigrator.Core/Execution/ProcessingContext/CreateTeamFolders.cs
+classFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/CreateTeamFoldersProcessor.cs
optionsClassFile:
-redirectFrom: []
+redirectFrom:
+- /Reference/v1/Processors//
layout: reference
toc: true
-permalink: /Reference/v1/Processors/CreateTeamFolders/
+permalink: /Reference/Processors/CreateTeamFolders/
title: CreateTeamFolders
categories:
- Processors
- v1
topics:
- topic: notes
- path: /docs/Reference/v1/Processors/CreateTeamFolders-notes.md
+ path: /Processors/CreateTeamFolders-notes.md
exists: false
markdown: ''
- topic: introduction
- path: /docs/Reference/v1/Processors/CreateTeamFolders-introduction.md
+ path: /Processors/CreateTeamFolders-introduction.md
exists: false
markdown: ''
diff --git a/docs/collections/_reference/reference.processors.exportprofilepicturefromadprocessor.md b/docs/collections/_reference/reference.processors.exportprofilepicturefromadprocessor.md
new file mode 100644
index 000000000..40bb7b593
--- /dev/null
+++ b/docs/collections/_reference/reference.processors.exportprofilepicturefromadprocessor.md
@@ -0,0 +1,94 @@
+---
+optionsClassName: ExportProfilePictureFromADProcessorOptions
+optionsClassFullName: MigrationTools.Processors.ExportProfilePictureFromADProcessorOptions
+configurationSamples:
+- name: defaults
+ description:
+ code: There are no defaults! Check the sample for options!
+ sampleFor: MigrationTools.Processors.ExportProfilePictureFromADProcessorOptions
+- name: sample
+ description:
+ code: There is no sample, but you can check the classic below for a general feel.
+ sampleFor: MigrationTools.Processors.ExportProfilePictureFromADProcessorOptions
+- name: classic
+ description:
+ code: >-
+ {
+ "$type": "ExportProfilePictureFromADProcessorOptions",
+ "Enabled": false,
+ "Domain": null,
+ "Username": null,
+ "Password": null,
+ "PictureEmpIDFormat": null,
+ "Enrichers": null,
+ "SourceName": null,
+ "TargetName": null,
+ "RefName": null
+ }
+ sampleFor: MigrationTools.Processors.ExportProfilePictureFromADProcessorOptions
+description: Downloads corporate images and updates TFS/Azure DevOps profiles
+className: ExportProfilePictureFromADProcessor
+typeName: Processors
+architecture:
+options:
+- parameterName: Domain
+ type: String
+ description: The source domain where the pictures should be exported.
+ defaultValue: String.Empty
+- parameterName: Enabled
+ type: Boolean
+ description: If set to `true` then the processor will run. Set to `false` and the processor will not run.
+ defaultValue: missng XML code comments
+- parameterName: 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.
+ defaultValue: missng XML code comments
+- parameterName: Password
+ type: String
+ description: The password of the user that is used to export the pictures.
+ defaultValue: String.Empty
+- parameterName: PictureEmpIDFormat
+ type: String
+ description: 'TODO: You wpuld need to customise this for your system. Clone repo and run in Debug'
+ defaultValue: String.Empty
+- parameterName: 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.'
+ defaultValue: missng XML code comments
+- parameterName: SourceName
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: TargetName
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: Username
+ type: String
+ description: The user name of the user that is used to export the pictures.
+ defaultValue: String.Empty
+status: alpha
+processingTarget: Profiles
+classFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/ExportProfilePictureFromADProcessor.cs
+optionsClassFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/ExportProfilePictureFromADProcessorOptions.cs
+
+redirectFrom:
+- /Reference/Processors/ExportProfilePictureFromADProcessorOptions/
+layout: reference
+toc: true
+permalink: /Reference/Processors/ExportProfilePictureFromADProcessor/
+title: ExportProfilePictureFromADProcessor
+categories:
+- Processors
+-
+topics:
+- topic: notes
+ path: /docs/Reference/Processors/ExportProfilePictureFromADProcessor-notes.md
+ exists: false
+ markdown: ''
+- topic: introduction
+ path: /docs/Reference/Processors/ExportProfilePictureFromADProcessor-introduction.md
+ exists: false
+ markdown: ''
+
+---
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.v1.processors.exportteamlist.md b/docs/collections/_reference/reference.processors.exportteamlistprocessor.md
similarity index 52%
rename from docs/collections/_reference/reference.v1.processors.exportteamlist.md
rename to docs/collections/_reference/reference.processors.exportteamlistprocessor.md
index c6faa825b..b7bbf00f1 100644
--- a/docs/collections/_reference/reference.v1.processors.exportteamlist.md
+++ b/docs/collections/_reference/reference.processors.exportteamlistprocessor.md
@@ -3,30 +3,31 @@ optionsClassName:
optionsClassFullName:
configurationSamples: []
description: missng XML code comments
-className: ExportTeamList
+className: ExportTeamListProcessor
typeName: Processors
architecture: v1
options: []
status: missng XML code comments
processingTarget: missng XML code comments
-classFile: /src/VstsSyncMigrator.Core/Execution/ProcessingContext/ExportTeamList.cs
+classFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/ExportTeamListProcessor.cs
optionsClassFile:
-redirectFrom: []
+redirectFrom:
+- /Reference/v1/Processors//
layout: reference
toc: true
-permalink: /Reference/v1/Processors/ExportTeamList/
-title: ExportTeamList
+permalink: /Reference/Processors/ExportTeamListProcessor/
+title: ExportTeamListProcessor
categories:
- Processors
- v1
topics:
- topic: notes
- path: /docs/Reference/v1/Processors/ExportTeamList-notes.md
+ path: /Processors/ExportTeamListProcessor-notes.md
exists: false
markdown: ''
- topic: introduction
- path: /docs/Reference/v1/Processors/ExportTeamList-introduction.md
+ path: /Processors/ExportTeamListProcessor-introduction.md
exists: false
markdown: ''
diff --git a/docs/collections/_reference/reference.processors.exportusersformappingprocessor.md b/docs/collections/_reference/reference.processors.exportusersformappingprocessor.md
new file mode 100644
index 000000000..a30329549
--- /dev/null
+++ b/docs/collections/_reference/reference.processors.exportusersformappingprocessor.md
@@ -0,0 +1,188 @@
+---
+optionsClassName: ExportUsersForMappingProcessorOptions
+optionsClassFullName: MigrationTools.Processors.ExportUsersForMappingProcessorOptions
+configurationSamples:
+- name: defaults
+ description:
+ code: There are no defaults! Check the sample for options!
+ sampleFor: MigrationTools.Processors.ExportUsersForMappingProcessorOptions
+- name: sample
+ description:
+ code: There is no sample, but you can check the classic below for a general feel.
+ sampleFor: MigrationTools.Processors.ExportUsersForMappingProcessorOptions
+- name: classic
+ description:
+ code: >-
+ {
+ "$type": "ExportUsersForMappingProcessorOptions",
+ "Enabled": false,
+ "WIQLQuery": null,
+ "OnlyListUsersInWorkItems": true,
+ "Enrichers": null,
+ "SourceName": null,
+ "TargetName": null,
+ "RefName": null
+ }
+ sampleFor: MigrationTools.Processors.ExportUsersForMappingProcessorOptions
+description: ExportUsersForMappingContext is a tool used to create a starter mapping file for users between the source and target systems. Use `ExportUsersForMappingConfig` to configure.
+className: ExportUsersForMappingProcessor
+typeName: Processors
+architecture:
+options:
+- parameterName: Enabled
+ type: Boolean
+ description: If set to `true` then the processor will run. Set to `false` and the processor will not run.
+ defaultValue: missng XML code comments
+- parameterName: 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.
+ defaultValue: missng XML code comments
+- parameterName: OnlyListUsersInWorkItems
+ type: Boolean
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: 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.'
+ defaultValue: missng XML code comments
+- parameterName: SourceName
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: TargetName
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: WIQLQuery
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+status: ready
+processingTarget: Work Items
+classFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/ExportUsersForMappingProcessor.cs
+optionsClassFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/ExportUsersForMappingProcessorOptions.cs
+
+redirectFrom:
+- /Reference/Processors/ExportUsersForMappingProcessorOptions/
+layout: reference
+toc: true
+permalink: /Reference/Processors/ExportUsersForMappingProcessor/
+title: ExportUsersForMappingProcessor
+categories:
+- Processors
+-
+topics:
+- topic: notes
+ path: /docs/Reference/Processors/ExportUsersForMappingProcessor-notes.md
+ exists: true
+ markdown: >-
+ There was a request to have the ability to map users to try and maintain integrity across different systems. We added a `TfsUserMappingEnricher` that allows you to map users from Source to Target.
+
+
+ ##How it works
+
+
+ 1. Run `ExportUsersForMappingConfig` which will export all of the Users in Source Mapped or not to target.
+
+ 2. Run `WorkItemMigrationConfig` which will run a validator by detail to warn you of missing users. If it finds a mapping it will convert the field...
+
+
+ ## ExportUsersForMappingConfig
+
+
+ Running the `ExportUsersForMappingConfig` to get the list of users will produce something like:
+
+
+ ```
+
+ [
+ {
+ "Source": {
+ "FriendlyName": "Martin Hinshelwood nkdAgility.com",
+ "AccountName": "martin@nkdagility.com"
+ },
+ "target": {
+ "FriendlyName": "Hinshelwood, Martin",
+ "AccountName": "martin@othercompany.com"
+ }
+ },
+ {
+ "Source": {
+ "FriendlyName": "Rollup Bot",
+ "AccountName": "Bot@nkdagility.com"
+ },
+ "target": {
+ "FriendlyName": "Service Account 4",
+ "AccountName": "randoaccount@somecompany.com"
+ }
+ },
+ {
+ "Source": {
+ "FriendlyName": "Another non mapped Account",
+ "AccountName": "not-mapped@nkdagility.com"
+ },
+ "target": null
+ }
+ ]
+
+ ```
+
+
+ Any `null` in the target field means that the user is not mapped. You can then use this to create a mapping file will all of your users.
+
+
+ IMPORTANT: The Friendly name in Azure DevOps / TFS is not nessesarily the AAD Friendly name as users can change this in the tool. We load all of the users from both systems, and match on "email" to ensure we only assume mapping for the same user. Non mapped users, or users listed as null, will not be mapped.
+
+
+ ### Notes
+
+
+ - On `ExportUsersForMappingConfig` you can set `OnlyListUsersInWorkItems` to filter the mapping based on the scope of the query. This is greater if you have many users.
+
+ - Configured using the `TfsUserMappingEnricherOptions` setting in `CommonEnrichersConfig`
+
+
+ ## WorkItemMigrationConfig
+
+
+ When you run the `WorkItemMigrationContext`
+
+
+
+ ```
+
+ ...
+ "LogLevel": "Debug",
+ "CommonEnrichersConfig": [
+ {
+ "$type": "TfsUserMappingEnricherOptions",
+ "Enabled": true,
+ "UserMappingFile": "C:\\temp\\userExport.json",
+ "IdentityFieldsToCheck": [
+ "System.AssignedTo",
+ "System.ChangedBy",
+ "System.CreatedBy",
+ "Microsoft.VSTS.Common.ActivatedBy",
+ "Microsoft.VSTS.Common.ResolvedBy",
+ "Microsoft.VSTS.Common.ClosedBy"
+ ]
+ }
+ ],
+ ...
+
+ ```
+
+
+
+ ### Notes
+
+
+ - Configured using the `TfsUserMappingEnricherOptions` setting in `CommonEnrichersConfig`
+
+ - Applies to all identity fields specified in the list
+- topic: introduction
+ path: /docs/Reference/Processors/ExportUsersForMappingProcessor-introduction.md
+ exists: false
+ markdown: ''
+
+---
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.processors.fakeprocessor.md b/docs/collections/_reference/reference.processors.fakeprocessor.md
new file mode 100644
index 000000000..72497238a
--- /dev/null
+++ b/docs/collections/_reference/reference.processors.fakeprocessor.md
@@ -0,0 +1,34 @@
+---
+optionsClassName:
+optionsClassFullName:
+configurationSamples: []
+description: "Note: this is only for internal usage. Don't use this in your configurations."
+className: FakeProcessor
+typeName: Processors
+architecture: v1
+options: []
+status: missng XML code comments
+processingTarget: missng XML code comments
+classFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/FakeProcessor.cs
+optionsClassFile:
+
+redirectFrom:
+- /Reference/v1/Processors//
+layout: reference
+toc: true
+permalink: /Reference/Processors/FakeProcessor/
+title: FakeProcessor
+categories:
+- Processors
+- v1
+topics:
+- topic: notes
+ path: /Processors/FakeProcessor-notes.md
+ exists: false
+ markdown: ''
+- topic: introduction
+ path: /Processors/FakeProcessor-introduction.md
+ exists: false
+ markdown: ''
+
+---
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.processors.fixgitcommitlinksprocessor.md b/docs/collections/_reference/reference.processors.fixgitcommitlinksprocessor.md
new file mode 100644
index 000000000..2b3202a63
--- /dev/null
+++ b/docs/collections/_reference/reference.processors.fixgitcommitlinksprocessor.md
@@ -0,0 +1,103 @@
+---
+optionsClassName: FixGitCommitLinksProcessorOptions
+optionsClassFullName: MigrationTools.Processors.FixGitCommitLinksProcessorOptions
+configurationSamples:
+- name: defaults
+ description:
+ code: >-
+ {
+ "MigrationTools": {
+ "ProcessorDefaults": {
+ "FixGitCommitLinksProcessor": []
+ }
+ }
+ }
+ sampleFor: MigrationTools.Processors.FixGitCommitLinksProcessorOptions
+- name: sample
+ description:
+ code: >-
+ {
+ "MigrationTools": {
+ "ProcessorDefaults": {
+ "FixGitCommitLinksProcessor": []
+ }
+ }
+ }
+ sampleFor: MigrationTools.Processors.FixGitCommitLinksProcessorOptions
+- name: classic
+ description:
+ code: >-
+ {
+ "$type": "FixGitCommitLinksProcessorOptions",
+ "Enabled": false,
+ "TargetRepository": null,
+ "Query": null,
+ "Enrichers": null,
+ "ProcessorEnrichers": null,
+ "SourceName": null,
+ "TargetName": null,
+ "RefName": null
+ }
+ sampleFor: MigrationTools.Processors.FixGitCommitLinksProcessorOptions
+description: missng XML code comments
+className: FixGitCommitLinksProcessor
+typeName: Processors
+architecture:
+options:
+- parameterName: Enabled
+ type: Boolean
+ description: If set to `true` then the processor will run. Set to `false` and the processor will not run.
+ defaultValue: missng XML code comments
+- parameterName: Enrichers
+ type: List
+ description: A list of enrichers that can augment the proccessing of the data
+ defaultValue: missng XML code comments
+- parameterName: ProcessorEnrichers
+ 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.
+ defaultValue: missng XML code comments
+- parameterName: Query
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: 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.'
+ defaultValue: missng XML code comments
+- parameterName: SourceName
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: TargetName
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: TargetRepository
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+status: missng XML code comments
+processingTarget: missng XML code comments
+classFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/FixGitCommitLinksProcessor.cs
+optionsClassFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/FixGitCommitLinksProcessorOptions.cs
+
+redirectFrom:
+- /Reference/Processors/FixGitCommitLinksProcessorOptions/
+layout: reference
+toc: true
+permalink: /Reference/Processors/FixGitCommitLinksProcessor/
+title: FixGitCommitLinksProcessor
+categories:
+- Processors
+-
+topics:
+- topic: notes
+ path: /docs/Reference/Processors/FixGitCommitLinksProcessor-notes.md
+ exists: false
+ markdown: ''
+- topic: introduction
+ path: /docs/Reference/Processors/FixGitCommitLinksProcessor-introduction.md
+ exists: false
+ markdown: ''
+
+---
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.processors.importprofilepictureprocessor.md b/docs/collections/_reference/reference.processors.importprofilepictureprocessor.md
new file mode 100644
index 000000000..5cd662e66
--- /dev/null
+++ b/docs/collections/_reference/reference.processors.importprofilepictureprocessor.md
@@ -0,0 +1,74 @@
+---
+optionsClassName: ImportProfilePictureProcessorOptions
+optionsClassFullName: MigrationTools.Processors.ImportProfilePictureProcessorOptions
+configurationSamples:
+- name: defaults
+ description:
+ code: There are no defaults! Check the sample for options!
+ sampleFor: MigrationTools.Processors.ImportProfilePictureProcessorOptions
+- name: sample
+ description:
+ code: There is no sample, but you can check the classic below for a general feel.
+ sampleFor: MigrationTools.Processors.ImportProfilePictureProcessorOptions
+- name: classic
+ description:
+ code: >-
+ {
+ "$type": "ImportProfilePictureProcessorOptions",
+ "Enabled": false,
+ "Enrichers": null,
+ "SourceName": null,
+ "TargetName": null,
+ "RefName": null
+ }
+ sampleFor: MigrationTools.Processors.ImportProfilePictureProcessorOptions
+description: Downloads corporate images and updates TFS/Azure DevOps profiles
+className: ImportProfilePictureProcessor
+typeName: Processors
+architecture:
+options:
+- parameterName: Enabled
+ type: Boolean
+ description: If set to `true` then the processor will run. Set to `false` and the processor will not run.
+ defaultValue: missng XML code comments
+- parameterName: 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.
+ defaultValue: missng XML code comments
+- parameterName: 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.'
+ defaultValue: missng XML code comments
+- parameterName: SourceName
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: TargetName
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+status: alpha
+processingTarget: Profiles
+classFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/ImportProfilePictureProcessor.cs
+optionsClassFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/ImportProfilePictureProcessorOptions.cs
+
+redirectFrom:
+- /Reference/Processors/ImportProfilePictureProcessorOptions/
+layout: reference
+toc: true
+permalink: /Reference/Processors/ImportProfilePictureProcessor/
+title: ImportProfilePictureProcessor
+categories:
+- Processors
+-
+topics:
+- topic: notes
+ path: /docs/Reference/Processors/ImportProfilePictureProcessor-notes.md
+ exists: false
+ markdown: ''
+- topic: introduction
+ path: /docs/Reference/Processors/ImportProfilePictureProcessor-introduction.md
+ exists: false
+ markdown: ''
+
+---
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.processors.keepoutboundlinktargetprocessor.md b/docs/collections/_reference/reference.processors.keepoutboundlinktargetprocessor.md
new file mode 100644
index 000000000..f0f42407c
--- /dev/null
+++ b/docs/collections/_reference/reference.processors.keepoutboundlinktargetprocessor.md
@@ -0,0 +1,104 @@
+---
+optionsClassName: KeepOutboundLinkTargetProcessorOptions
+optionsClassFullName: MigrationTools.Clients.AzureDevops.Rest.Processors.KeepOutboundLinkTargetProcessorOptions
+configurationSamples:
+- name: defaults
+ description:
+ code: There are no defaults! Check the sample for options!
+ sampleFor: MigrationTools.Clients.AzureDevops.Rest.Processors.KeepOutboundLinkTargetProcessorOptions
+- name: sample
+ description:
+ code: There is no sample, but you can check the classic below for a general feel.
+ sampleFor: MigrationTools.Clients.AzureDevops.Rest.Processors.KeepOutboundLinkTargetProcessorOptions
+- name: classic
+ description:
+ code: >-
+ {
+ "$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": "40f944b1-2508-4e6a-b544-c9601390f082",
+ "CleanupFileName": "c:/temp/OutboundLinkTargets.bat",
+ "PrependCommand": "start",
+ "DryRun": true,
+ "Enrichers": null,
+ "SourceName": null,
+ "TargetName": null,
+ "RefName": null
+ }
+ sampleFor: MigrationTools.Clients.AzureDevops.Rest.Processors.KeepOutboundLinkTargetProcessorOptions
+description: missng XML code comments
+className: KeepOutboundLinkTargetProcessor
+typeName: Processors
+architecture:
+options:
+- parameterName: CleanupFileName
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: DryRun
+ type: Boolean
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: Enabled
+ type: Boolean
+ description: If set to `true` then the processor will run. Set to `false` and the processor will not run.
+ defaultValue: missng XML code comments
+- parameterName: 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.
+ defaultValue: missng XML code comments
+- parameterName: PrependCommand
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: 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.'
+ defaultValue: missng XML code comments
+- parameterName: SourceName
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: TargetLinksToKeepOrganization
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: TargetLinksToKeepProject
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: TargetName
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: WIQLQuery
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+status: missng XML code comments
+processingTarget: missng XML code comments
+classFile: /src/MigrationTools.Clients.AzureDevops.Rest/Processors/KeepOutboundLinkTargetProcessor.cs
+optionsClassFile: /src/MigrationTools.Clients.AzureDevops.Rest/Processors/KeepOutboundLinkTargetProcessorOptions.cs
+
+redirectFrom:
+- /Reference/Processors/KeepOutboundLinkTargetProcessorOptions/
+layout: reference
+toc: true
+permalink: /Reference/Processors/KeepOutboundLinkTargetProcessor/
+title: KeepOutboundLinkTargetProcessor
+categories:
+- Processors
+-
+topics:
+- topic: notes
+ path: /docs/Reference/Processors/KeepOutboundLinkTargetProcessor-notes.md
+ exists: false
+ markdown: ''
+- topic: introduction
+ path: /docs/Reference/Processors/KeepOutboundLinkTargetProcessor-introduction.md
+ exists: false
+ markdown: ''
+
+---
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.processors.outboundlinkcheckingprocessor.md b/docs/collections/_reference/reference.processors.outboundlinkcheckingprocessor.md
new file mode 100644
index 000000000..18b1b7e34
--- /dev/null
+++ b/docs/collections/_reference/reference.processors.outboundlinkcheckingprocessor.md
@@ -0,0 +1,84 @@
+---
+optionsClassName: OutboundLinkCheckingProcessorOptions
+optionsClassFullName: MigrationTools.Clients.AzureDevops.Rest.Processors.OutboundLinkCheckingProcessorOptions
+configurationSamples:
+- name: defaults
+ description:
+ code: There are no defaults! Check the sample for options!
+ sampleFor: MigrationTools.Clients.AzureDevops.Rest.Processors.OutboundLinkCheckingProcessorOptions
+- name: sample
+ description:
+ code: There is no sample, but you can check the classic below for a general feel.
+ sampleFor: MigrationTools.Clients.AzureDevops.Rest.Processors.OutboundLinkCheckingProcessorOptions
+- name: classic
+ description:
+ code: >-
+ {
+ "$type": "OutboundLinkCheckingProcessorOptions",
+ "Enabled": false,
+ "WIQLQuery": null,
+ "ResultFileName": null,
+ "Enrichers": null,
+ "SourceName": null,
+ "TargetName": null,
+ "RefName": null
+ }
+ sampleFor: MigrationTools.Clients.AzureDevops.Rest.Processors.OutboundLinkCheckingProcessorOptions
+description: missng XML code comments
+className: OutboundLinkCheckingProcessor
+typeName: Processors
+architecture:
+options:
+- parameterName: Enabled
+ type: Boolean
+ description: If set to `true` then the processor will run. Set to `false` and the processor will not run.
+ defaultValue: missng XML code comments
+- parameterName: 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.
+ defaultValue: missng XML code comments
+- parameterName: 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.'
+ defaultValue: missng XML code comments
+- parameterName: ResultFileName
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: SourceName
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: TargetName
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: WIQLQuery
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+status: missng XML code comments
+processingTarget: missng XML code comments
+classFile: /src/MigrationTools.Clients.AzureDevops.Rest/Processors/OutboundLinkCheckingProcessor.cs
+optionsClassFile: /src/MigrationTools.Clients.AzureDevops.Rest/Processors/OutboundLinkCheckingProcessorOptions.cs
+
+redirectFrom:
+- /Reference/Processors/OutboundLinkCheckingProcessorOptions/
+layout: reference
+toc: true
+permalink: /Reference/Processors/OutboundLinkCheckingProcessor/
+title: OutboundLinkCheckingProcessor
+categories:
+- Processors
+-
+topics:
+- topic: notes
+ path: /docs/Reference/Processors/OutboundLinkCheckingProcessor-notes.md
+ exists: false
+ markdown: ''
+- topic: introduction
+ path: /docs/Reference/Processors/OutboundLinkCheckingProcessor-introduction.md
+ exists: false
+ markdown: ''
+
+---
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.v2.processors.processdefinitionprocessor.md b/docs/collections/_reference/reference.processors.processdefinitionprocessor.md
similarity index 82%
rename from docs/collections/_reference/reference.v2.processors.processdefinitionprocessor.md
rename to docs/collections/_reference/reference.processors.processdefinitionprocessor.md
index 1ab4dffee..3b5969943 100644
--- a/docs/collections/_reference/reference.v2.processors.processdefinitionprocessor.md
+++ b/docs/collections/_reference/reference.processors.processdefinitionprocessor.md
@@ -2,37 +2,43 @@
optionsClassName: ProcessDefinitionProcessorOptions
optionsClassFullName: MigrationTools.Processors.ProcessDefinitionProcessorOptions
configurationSamples:
-- name: default
+- name: defaults
+ description:
+ code: There are no defaults! Check the sample for options!
+ sampleFor: MigrationTools.Processors.ProcessDefinitionProcessorOptions
+- name: sample
+ description:
+ code: There is no sample, but you can check the classic below for a general feel.
+ sampleFor: MigrationTools.Processors.ProcessDefinitionProcessorOptions
+- name: classic
description:
code: >-
{
"$type": "ProcessDefinitionProcessorOptions",
"Enabled": false,
- "Processes": {
- "$type": "Dictionary`2",
- "*": [
- "*"
- ]
- },
- "ProcessMaps": {
- "$type": "Dictionary`2"
- },
- "UpdateProcessDetails": true,
- "MaxDegreeOfParallelism": 1,
- "ProcessorEnrichers": null,
+ "Processes": null,
+ "ProcessMaps": null,
+ "UpdateProcessDetails": false,
+ "MaxDegreeOfParallelism": 0,
+ "Enrichers": null,
"SourceName": null,
- "TargetName": null
+ "TargetName": null,
+ "RefName": null
}
sampleFor: MigrationTools.Processors.ProcessDefinitionProcessorOptions
description: Process definition processor used to keep processes between two orgs in sync
className: ProcessDefinitionProcessor
typeName: Processors
-architecture: v2
+architecture:
options:
- parameterName: Enabled
type: Boolean
description: If set to `true` then the processor will run. Set to `false` and the processor will not run.
defaultValue: missng XML code comments
+- parameterName: 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.
+ defaultValue: missng XML code comments
- parameterName: MaxDegreeOfParallelism
type: Int32
description: missng XML code comments
@@ -45,10 +51,6 @@ options:
type: Dictionary
description: missng XML code comments
defaultValue: missng XML code comments
-- parameterName: ProcessorEnrichers
- 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.
- defaultValue: missng XML code comments
- parameterName: 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.'
@@ -70,17 +72,18 @@ processingTarget: Pipelines
classFile: /src/MigrationTools.Clients.AzureDevops.Rest/Processors/ProcessDefinitionProcessor.cs
optionsClassFile: /src/MigrationTools.Clients.AzureDevops.Rest/Processors/ProcessDefinitionProcessorOptions.cs
-redirectFrom: []
+redirectFrom:
+- /Reference/Processors/ProcessDefinitionProcessorOptions/
layout: reference
toc: true
-permalink: /Reference/v2/Processors/ProcessDefinitionProcessor/
+permalink: /Reference/Processors/ProcessDefinitionProcessor/
title: ProcessDefinitionProcessor
categories:
- Processors
-- v2
+-
topics:
- topic: notes
- path: /docs/Reference/v2/Processors/ProcessDefinitionProcessor-notes.md
+ path: /docs/Reference/Processors/ProcessDefinitionProcessor-notes.md
exists: true
markdown: >2+
@@ -124,7 +127,7 @@ topics:
```
- topic: introduction
- path: /docs/Reference/v2/Processors/ProcessDefinitionProcessor-introduction.md
+ path: /docs/Reference/Processors/ProcessDefinitionProcessor-introduction.md
exists: true
markdown: >2-
diff --git a/docs/collections/_reference/reference.processors.testconfigurationsmigrationprocessor.md b/docs/collections/_reference/reference.processors.testconfigurationsmigrationprocessor.md
new file mode 100644
index 000000000..8e440b8ca
--- /dev/null
+++ b/docs/collections/_reference/reference.processors.testconfigurationsmigrationprocessor.md
@@ -0,0 +1,74 @@
+---
+optionsClassName: TestConfigurationsMigrationProcessorOptions
+optionsClassFullName: MigrationTools.Processors.TestConfigurationsMigrationProcessorOptions
+configurationSamples:
+- name: defaults
+ description:
+ code: There are no defaults! Check the sample for options!
+ sampleFor: MigrationTools.Processors.TestConfigurationsMigrationProcessorOptions
+- name: sample
+ description:
+ code: There is no sample, but you can check the classic below for a general feel.
+ sampleFor: MigrationTools.Processors.TestConfigurationsMigrationProcessorOptions
+- name: classic
+ description:
+ code: >-
+ {
+ "$type": "TestConfigurationsMigrationProcessorOptions",
+ "Enabled": false,
+ "Enrichers": null,
+ "SourceName": null,
+ "TargetName": null,
+ "RefName": null
+ }
+ sampleFor: MigrationTools.Processors.TestConfigurationsMigrationProcessorOptions
+description: This processor can migrate `test configuration`. This should be run before `LinkMigrationConfig`.
+className: TestConfigurationsMigrationProcessor
+typeName: Processors
+architecture:
+options:
+- parameterName: Enabled
+ type: Boolean
+ description: If set to `true` then the processor will run. Set to `false` and the processor will not run.
+ defaultValue: missng XML code comments
+- parameterName: 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.
+ defaultValue: missng XML code comments
+- parameterName: 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.'
+ defaultValue: missng XML code comments
+- parameterName: SourceName
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: TargetName
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+status: Beta
+processingTarget: Suites & Plans
+classFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/TestConfigurationsMigrationProcessor.cs
+optionsClassFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/TestConfigurationsMigrationProcessorOptions.cs
+
+redirectFrom:
+- /Reference/Processors/TestConfigurationsMigrationProcessorOptions/
+layout: reference
+toc: true
+permalink: /Reference/Processors/TestConfigurationsMigrationProcessor/
+title: TestConfigurationsMigrationProcessor
+categories:
+- Processors
+-
+topics:
+- topic: notes
+ path: /docs/Reference/Processors/TestConfigurationsMigrationProcessor-notes.md
+ exists: false
+ markdown: ''
+- topic: introduction
+ path: /docs/Reference/Processors/TestConfigurationsMigrationProcessor-introduction.md
+ exists: false
+ markdown: ''
+
+---
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.v1.processors.testplansandsuitesmigrationcontext.md b/docs/collections/_reference/reference.processors.testplansandsuitesmigrationprocessor.md
similarity index 56%
rename from docs/collections/_reference/reference.v1.processors.testplansandsuitesmigrationcontext.md
rename to docs/collections/_reference/reference.processors.testplansandsuitesmigrationprocessor.md
index abbe01f15..12aa1ade6 100644
--- a/docs/collections/_reference/reference.v1.processors.testplansandsuitesmigrationcontext.md
+++ b/docs/collections/_reference/reference.processors.testplansandsuitesmigrationprocessor.md
@@ -1,29 +1,45 @@
---
-optionsClassName: TestPlansAndSuitesMigrationConfig
-optionsClassFullName: MigrationTools._EngineV1.Configuration.Processing.TestPlansAndSuitesMigrationConfig
+optionsClassName: TestPlansAndSuitesMigrationProcessorOptions
+optionsClassFullName: MigrationTools._EngineV1.Configuration.Processing.TestPlansAndSuitesMigrationProcessorOptions
configurationSamples:
-- name: default
+- name: defaults
+ description:
+ code: There are no defaults! Check the sample for options!
+ sampleFor: MigrationTools._EngineV1.Configuration.Processing.TestPlansAndSuitesMigrationProcessorOptions
+- name: sample
+ description:
+ code: There is no sample, but you can check the classic below for a general feel.
+ sampleFor: MigrationTools._EngineV1.Configuration.Processing.TestPlansAndSuitesMigrationProcessorOptions
+- name: classic
description:
code: >-
{
- "$type": "TestPlansAndSuitesMigrationConfig",
+ "$type": "TestPlansAndSuitesMigrationProcessorOptions",
"Enabled": false,
"OnlyElementsWithTag": null,
"TestPlanQuery": null,
"RemoveAllLinks": false,
"MigrationDelay": 0,
"RemoveInvalidTestSuiteLinks": false,
- "FilterCompleted": false
+ "FilterCompleted": false,
+ "Enrichers": null,
+ "SourceName": null,
+ "TargetName": null,
+ "RefName": null
}
- sampleFor: MigrationTools._EngineV1.Configuration.Processing.TestPlansAndSuitesMigrationConfig
+ sampleFor: MigrationTools._EngineV1.Configuration.Processing.TestPlansAndSuitesMigrationProcessorOptions
description: Rebuilds Suits and plans for Test Cases migrated using the WorkItemMigration
-className: TestPlansAndSuitesMigrationContext
+className: TestPlansAndSuitesMigrationProcessor
typeName: Processors
-architecture: v1
+architecture:
options:
- parameterName: Enabled
type: Boolean
- description: missng XML code comments
+ description: If set to `true` then the processor will run. Set to `false` and the processor will not run.
+ defaultValue: missng XML code comments
+- parameterName: 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.
defaultValue: missng XML code comments
- parameterName: FilterCompleted
type: Boolean
@@ -37,13 +53,25 @@ options:
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.
defaultValue: '`String.Empty`'
+- parameterName: 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.'
+ defaultValue: missng XML code comments
- parameterName: RemoveAllLinks
type: Boolean
description: ??Not sure what this does. Check code.
defaultValue: false
- parameterName: RemoveInvalidTestSuiteLinks
type: Boolean
- description: Remove Invalid Links, see https://github.com/nkdAgility/azure-devops-migration-tools/issues/178
+ description: Indicates whether the configuration for node structure transformation should be taken from the common enricher configs. Otherwise the configuration elements below are used
+ defaultValue: false
+- parameterName: SourceName
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: TargetName
+ type: String
+ description: missng XML code comments
defaultValue: missng XML code comments
- parameterName: TestPlanQuery
type: String
@@ -51,20 +79,21 @@ options:
defaultValue: '`String.Empty`'
status: Beta
processingTarget: Suites & Plans
-classFile: /src/VstsSyncMigrator.Core/Execution/MigrationContext/TestPlansAndSuitesMigrationContext.cs
-optionsClassFile: /src/MigrationTools/_EngineV1/Configuration/Processing/TestPlansAndSuitesMigrationConfig.cs
+classFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/TestPlansAndSuitesMigrationProcessor.cs
+optionsClassFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/TestPlansAndSuitesMigrationProcessorOptions.cs
-redirectFrom: []
+redirectFrom:
+- /Reference/Processors/TestPlansAndSuitesMigrationProcessorOptions/
layout: reference
toc: true
-permalink: /Reference/v1/Processors/TestPlansAndSuitesMigrationContext/
-title: TestPlansAndSuitesMigrationContext
+permalink: /Reference/Processors/TestPlansAndSuitesMigrationProcessor/
+title: TestPlansAndSuitesMigrationProcessor
categories:
- Processors
-- v1
+-
topics:
- topic: notes
- path: /docs/Reference/v1/Processors/TestPlansAndSuitesMigrationContext-notes.md
+ path: /docs/Reference/Processors/TestPlansAndSuitesMigrationProcessor-notes.md
exists: true
markdown: >2-
@@ -116,7 +145,7 @@ topics:
```
- topic: introduction
- path: /docs/Reference/v1/Processors/TestPlansAndSuitesMigrationContext-introduction.md
+ path: /docs/Reference/Processors/TestPlansAndSuitesMigrationProcessor-introduction.md
exists: false
markdown: ''
diff --git a/docs/collections/_reference/reference.processors.testvariablesmigrationprocessor.md b/docs/collections/_reference/reference.processors.testvariablesmigrationprocessor.md
new file mode 100644
index 000000000..c409679ac
--- /dev/null
+++ b/docs/collections/_reference/reference.processors.testvariablesmigrationprocessor.md
@@ -0,0 +1,79 @@
+---
+optionsClassName: TestVariablesMigrationProcessorOptions
+optionsClassFullName: MigrationTools.Processors.TestVariablesMigrationProcessorOptions
+configurationSamples:
+- name: defaults
+ description:
+ code: There are no defaults! Check the sample for options!
+ sampleFor: MigrationTools.Processors.TestVariablesMigrationProcessorOptions
+- name: sample
+ description:
+ code: There is no sample, but you can check the classic below for a general feel.
+ sampleFor: MigrationTools.Processors.TestVariablesMigrationProcessorOptions
+- name: classic
+ description:
+ code: >-
+ {
+ "$type": "TestVariablesMigrationProcessorOptions",
+ "Enabled": false,
+ "Processor": "TestVariablesMigrationContext",
+ "Enrichers": null,
+ "SourceName": null,
+ "TargetName": null,
+ "RefName": null
+ }
+ sampleFor: MigrationTools.Processors.TestVariablesMigrationProcessorOptions
+description: This processor can migrate test variables that are defined in the test plans / suites. This must run before `TestPlansAndSuitesMigrationConfig`.
+className: TestVariablesMigrationProcessor
+typeName: Processors
+architecture:
+options:
+- parameterName: Enabled
+ type: Boolean
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: 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.
+ defaultValue: missng XML code comments
+- parameterName: Processor
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: 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.'
+ defaultValue: missng XML code comments
+- parameterName: SourceName
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: TargetName
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+status: Beta
+processingTarget: Suites & Plans
+classFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/TestVariablesMigrationProcessor.cs
+optionsClassFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/TestVariablesMigrationProcessorOptions.cs
+
+redirectFrom:
+- /Reference/Processors/TestVariablesMigrationProcessorOptions/
+layout: reference
+toc: true
+permalink: /Reference/Processors/TestVariablesMigrationProcessor/
+title: TestVariablesMigrationProcessor
+categories:
+- Processors
+-
+topics:
+- topic: notes
+ path: /docs/Reference/Processors/TestVariablesMigrationProcessor-notes.md
+ exists: false
+ markdown: ''
+- topic: introduction
+ path: /docs/Reference/Processors/TestVariablesMigrationProcessor-introduction.md
+ exists: false
+ markdown: ''
+
+---
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.v2.processors.tfssharedqueryprocessor.md b/docs/collections/_reference/reference.processors.tfssharedqueryprocessor.md
similarity index 75%
rename from docs/collections/_reference/reference.v2.processors.tfssharedqueryprocessor.md
rename to docs/collections/_reference/reference.processors.tfssharedqueryprocessor.md
index e7e671a53..7a6ab0ddc 100644
--- a/docs/collections/_reference/reference.v2.processors.tfssharedqueryprocessor.md
+++ b/docs/collections/_reference/reference.processors.tfssharedqueryprocessor.md
@@ -2,7 +2,15 @@
optionsClassName: TfsSharedQueryProcessorOptions
optionsClassFullName: MigrationTools.Processors.TfsSharedQueryProcessorOptions
configurationSamples:
-- name: default
+- name: defaults
+ description:
+ code: There are no defaults! Check the sample for options!
+ sampleFor: MigrationTools.Processors.TfsSharedQueryProcessorOptions
+- name: sample
+ description:
+ code: There is no sample, but you can check the classic below for a general feel.
+ sampleFor: MigrationTools.Processors.TfsSharedQueryProcessorOptions
+- name: classic
description:
code: >-
{
@@ -11,28 +19,29 @@ configurationSamples:
"PrefixProjectToNodes": false,
"SharedFolderName": "Shared Queries",
"SourceToTargetFieldMappings": null,
- "ProcessorEnrichers": null,
- "SourceName": "sourceName",
- "TargetName": "targetName"
+ "Enrichers": null,
+ "SourceName": null,
+ "TargetName": null,
+ "RefName": null
}
sampleFor: MigrationTools.Processors.TfsSharedQueryProcessorOptions
description: The TfsSharedQueryProcessor enabled you to migrate queries from one locatio nto another.
className: TfsSharedQueryProcessor
typeName: Processors
-architecture: v2
+architecture:
options:
- parameterName: Enabled
type: Boolean
description: If set to `true` then the processor will run. Set to `false` and the processor will not run.
defaultValue: missng XML code comments
+- parameterName: 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.
+ defaultValue: missng XML code comments
- parameterName: PrefixProjectToNodes
type: Boolean
description: Do we add the source project name into the folder path
defaultValue: false
-- parameterName: ProcessorEnrichers
- 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.
- defaultValue: missng XML code comments
- parameterName: 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.'
@@ -58,21 +67,22 @@ processingTarget: Queries
classFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/TfsSharedQueryProcessor.cs
optionsClassFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/TfsSharedQueryProcessorOptions.cs
-redirectFrom: []
+redirectFrom:
+- /Reference/Processors/TfsSharedQueryProcessorOptions/
layout: reference
toc: true
-permalink: /Reference/v2/Processors/TfsSharedQueryProcessor/
+permalink: /Reference/Processors/TfsSharedQueryProcessor/
title: TfsSharedQueryProcessor
categories:
- Processors
-- v2
+-
topics:
- topic: notes
- path: /docs/Reference/v2/Processors/TfsSharedQueryProcessor-notes.md
+ path: /docs/Reference/Processors/TfsSharedQueryProcessor-notes.md
exists: false
markdown: ''
- topic: introduction
- path: /docs/Reference/v2/Processors/TfsSharedQueryProcessor-introduction.md
+ path: /docs/Reference/Processors/TfsSharedQueryProcessor-introduction.md
exists: false
markdown: ''
diff --git a/docs/collections/_reference/reference.v2.processors.tfsteamsettingsprocessor.md b/docs/collections/_reference/reference.processors.tfsteamsettingsprocessor.md
similarity index 77%
rename from docs/collections/_reference/reference.v2.processors.tfsteamsettingsprocessor.md
rename to docs/collections/_reference/reference.processors.tfsteamsettingsprocessor.md
index 89c05a545..c3e08d2b3 100644
--- a/docs/collections/_reference/reference.v2.processors.tfsteamsettingsprocessor.md
+++ b/docs/collections/_reference/reference.processors.tfsteamsettingsprocessor.md
@@ -2,31 +2,44 @@
optionsClassName: TfsTeamSettingsProcessorOptions
optionsClassFullName: MigrationTools.Processors.TfsTeamSettingsProcessorOptions
configurationSamples:
-- name: default
+- name: defaults
+ description:
+ code: There are no defaults! Check the sample for options!
+ sampleFor: MigrationTools.Processors.TfsTeamSettingsProcessorOptions
+- name: sample
+ description:
+ code: There is no sample, but you can check the classic below for a general feel.
+ sampleFor: MigrationTools.Processors.TfsTeamSettingsProcessorOptions
+- name: classic
description:
code: >-
{
"$type": "TfsTeamSettingsProcessorOptions",
"Enabled": false,
- "MigrateTeamSettings": true,
- "UpdateTeamSettings": true,
+ "MigrateTeamSettings": false,
+ "UpdateTeamSettings": false,
"PrefixProjectToNodes": false,
"MigrateTeamCapacities": false,
"Teams": null,
- "ProcessorEnrichers": null,
- "SourceName": "sourceName",
- "TargetName": "targetName"
+ "Enrichers": null,
+ "SourceName": null,
+ "TargetName": null,
+ "RefName": null
}
sampleFor: MigrationTools.Processors.TfsTeamSettingsProcessorOptions
description: Native TFS Processor, does not work with any other Endpoints.
className: TfsTeamSettingsProcessor
typeName: Processors
-architecture: v2
+architecture:
options:
- parameterName: Enabled
type: Boolean
description: If set to `true` then the processor will run. Set to `false` and the processor will not run.
defaultValue: missng XML code comments
+- parameterName: 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.
+ defaultValue: missng XML code comments
- parameterName: MigrateTeamCapacities
type: Boolean
description: 'Migrate original team member capacities after their creation on the target team project. Note: It will only migrate team member capacity if the team member with same display name exists on the target collection otherwise it will be ignored.'
@@ -39,10 +52,6 @@ options:
type: Boolean
description: Prefix your iterations and areas with the project name. If you have enabled this in `NodeStructuresMigrationConfig` you must do it here too.
defaultValue: false
-- parameterName: ProcessorEnrichers
- 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.
- defaultValue: missng XML code comments
- parameterName: 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.'
@@ -68,21 +77,22 @@ processingTarget: Teams
classFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/TfsTeamSettingsProcessor.cs
optionsClassFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/TfsTeamSettingsProcessorOptions.cs
-redirectFrom: []
+redirectFrom:
+- /Reference/Processors/TfsTeamSettingsProcessorOptions/
layout: reference
toc: true
-permalink: /Reference/v2/Processors/TfsTeamSettingsProcessor/
+permalink: /Reference/Processors/TfsTeamSettingsProcessor/
title: TfsTeamSettingsProcessor
categories:
- Processors
-- v2
+-
topics:
- topic: notes
- path: /docs/Reference/v2/Processors/TfsTeamSettingsProcessor-notes.md
+ path: /docs/Reference/Processors/TfsTeamSettingsProcessor-notes.md
exists: false
markdown: ''
- topic: introduction
- path: /docs/Reference/v2/Processors/TfsTeamSettingsProcessor-introduction.md
+ path: /docs/Reference/Processors/TfsTeamSettingsProcessor-introduction.md
exists: false
markdown: ''
diff --git a/docs/collections/_reference/reference.processors.tfsworkitemmigrationprocessor.md b/docs/collections/_reference/reference.processors.tfsworkitemmigrationprocessor.md
new file mode 100644
index 000000000..c9f906285
--- /dev/null
+++ b/docs/collections/_reference/reference.processors.tfsworkitemmigrationprocessor.md
@@ -0,0 +1,189 @@
+---
+optionsClassName: TfsWorkItemMigrationProcessorOptions
+optionsClassFullName: MigrationTools.Processors.TfsWorkItemMigrationProcessorOptions
+configurationSamples:
+- name: defaults
+ description:
+ code: >-
+ {
+ "MigrationTools": {
+ "Processors": [
+ {
+ "ProcessorType": "TfsWorkItemMigrationProcessor",
+ "AttachRevisionHistory": "False",
+ "Enabled": "False",
+ "FilterWorkItemsThatAlreadyExistInTarget": "False",
+ "FixHtmlAttachmentLinks": "True",
+ "GenerateMigrationComment": "True",
+ "MaxGracefulFailures": "0",
+ "PauseAfterEachWorkItem": "False",
+ "SkipRevisionWithInvalidAreaPath": "False",
+ "SkipRevisionWithInvalidIterationPath": "False",
+ "SourceName": "Source",
+ "TargetName": "Target",
+ "UpdateCreatedBy": "True",
+ "UpdateCreatedDate": "True",
+ "WIQLQuery": "SELECT [System.Id] FROM WorkItems WHERE [System.TeamProject] = @TeamProject AND [System.WorkItemType] NOT IN ('Test Suite', 'Test Plan','Shared Steps','Shared Parameter','Feedback Request') ORDER BY [System.ChangedDate] desc",
+ "WorkItemCreateRetryLimit": "5",
+ "WorkItemIDs": null
+ }
+ ]
+ }
+ }
+ sampleFor: MigrationTools.Processors.TfsWorkItemMigrationProcessorOptions
+- name: sample
+ description:
+ code: >-
+ {
+ "MigrationTools": {
+ "Processors": [
+ {
+ "ProcessorType": "TfsWorkItemMigrationProcessor",
+ "AttachRevisionHistory": "False",
+ "Enabled": "False",
+ "FilterWorkItemsThatAlreadyExistInTarget": "False",
+ "FixHtmlAttachmentLinks": "True",
+ "GenerateMigrationComment": "True",
+ "MaxGracefulFailures": "0",
+ "PauseAfterEachWorkItem": "False",
+ "SkipRevisionWithInvalidAreaPath": "False",
+ "SkipRevisionWithInvalidIterationPath": "False",
+ "SourceName": "Source",
+ "TargetName": "Target",
+ "UpdateCreatedBy": "True",
+ "UpdateCreatedDate": "True",
+ "WIQLQuery": "SELECT [System.Id] FROM WorkItems WHERE [System.TeamProject] = @TeamProject AND [System.WorkItemType] NOT IN ('Test Suite', 'Test Plan','Shared Steps','Shared Parameter','Feedback Request') ORDER BY [System.ChangedDate] desc",
+ "WorkItemCreateRetryLimit": "5",
+ "WorkItemIDs": null
+ }
+ ]
+ }
+ }
+ sampleFor: MigrationTools.Processors.TfsWorkItemMigrationProcessorOptions
+- name: classic
+ description:
+ code: >-
+ {
+ "$type": "TfsWorkItemMigrationProcessorOptions",
+ "Enabled": false,
+ "UpdateCreatedDate": true,
+ "UpdateCreatedBy": true,
+ "WIQLQuery": "SELECT [System.Id] FROM WorkItems WHERE [System.TeamProject] = @TeamProject AND [System.WorkItemType] NOT IN ('Test Suite', 'Test Plan','Shared Steps','Shared Parameter','Feedback Request') ORDER BY [System.ChangedDate] desc",
+ "FixHtmlAttachmentLinks": true,
+ "WorkItemCreateRetryLimit": 5,
+ "FilterWorkItemsThatAlreadyExistInTarget": false,
+ "PauseAfterEachWorkItem": false,
+ "AttachRevisionHistory": false,
+ "GenerateMigrationComment": true,
+ "WorkItemIDs": null,
+ "MaxGracefulFailures": 0,
+ "SkipRevisionWithInvalidIterationPath": false,
+ "SkipRevisionWithInvalidAreaPath": false,
+ "Enrichers": null,
+ "SourceName": "Source",
+ "TargetName": "Target",
+ "RefName": null
+ }
+ sampleFor: MigrationTools.Processors.TfsWorkItemMigrationProcessorOptions
+description: WorkItemMigrationConfig is the main processor used to Migrate Work Items, Links, and Attachments. Use `WorkItemMigrationConfig` to configure.
+className: TfsWorkItemMigrationProcessor
+typeName: Processors
+architecture:
+options:
+- parameterName: AttachRevisionHistory
+ type: Boolean
+ description: This will create a json file with the revision history and attach it to the work item. Best used with `MaxRevisions` or `ReplayRevisions`.
+ defaultValue: '?'
+- parameterName: Enabled
+ type: Boolean
+ description: If set to `true` then the processor will run. Set to `false` and the processor will not run.
+ defaultValue: missng XML code comments
+- parameterName: 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.
+ defaultValue: missng XML code comments
+- parameterName: FilterWorkItemsThatAlreadyExistInTarget
+ type: Boolean
+ description: This loads all of the work items already saved to the Target and removes them from the Source work item list prior to commencing the run. While this may take some time in large data sets it reduces the time of the overall migration significantly if you need to restart.
+ defaultValue: true
+- parameterName: FixHtmlAttachmentLinks
+ type: Boolean
+ description: "**beta** If enabled this will fix any image attachments URL's, work item mention URL's or user mentions in the HTML fields as well as discussion comments. You must specify a PersonalAccessToken in the Source project for Azure DevOps; TFS should use integrated authentication."
+ defaultValue: '?'
+- parameterName: GenerateMigrationComment
+ type: Boolean
+ description: If enabled, adds a comment recording the migration
+ defaultValue: false
+- parameterName: MaxGracefulFailures
+ type: Int32
+ description: The maximum number of failures to tolerate before the migration fails. When set above zero, a work item migration error is logged but the migration will continue until the number of failed items reaches the configured value, after which the migration fails.
+ defaultValue: 0
+- parameterName: PauseAfterEachWorkItem
+ type: Boolean
+ description: Pause after each work item is migrated
+ defaultValue: false
+- parameterName: 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.'
+ defaultValue: missng XML code comments
+- parameterName: SkipRevisionWithInvalidAreaPath
+ type: Boolean
+ description: When set to true, this setting will skip a revision if the source area has not been migrated, has been deleted or is somehow invalid, etc.
+ defaultValue: missng XML code comments
+- parameterName: SkipRevisionWithInvalidIterationPath
+ type: Boolean
+ description: This will skip a revision if the source iteration has not been migrated i.e. it was deleted
+ defaultValue: missng XML code comments
+- parameterName: SourceName
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: TargetName
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: UpdateCreatedBy
+ type: Boolean
+ description: "If this is enabled the creation process on the target project will create the items with the original creation date. (Important: The item history is always pointed to the date of the migration, it's change only the data column CreateDate, not the internal create date)"
+ defaultValue: true
+- parameterName: UpdateCreatedDate
+ type: Boolean
+ description: "If this is enabled the creation process on the target project will create the items with the original creation date. (Important: The item history is always pointed to the date of the migration, it's change only the data column CreateDate, not the internal create date)"
+ defaultValue: true
+- parameterName: WIQLQuery
+ type: String
+ description: A work item query based on WIQL to select only important work items. To migrate all leave this empty. See [WIQL Query Bits](#wiql-query-bits)
+ defaultValue: SELECT [System.Id] FROM WorkItems WHERE [System.TeamProject] = @TeamProject AND [[System.WorkItemType] NOT IN ('Test Suite', 'Test Plan','Shared Steps','Shared Parameter','Feedback Request') ORDER BY [System.ChangedDate] desc
+- parameterName: WorkItemCreateRetryLimit
+ type: Int32
+ description: '**beta** If set to a number greater than 0 work items that fail to save will retry after a number of seconds equal to the retry count. This allows for periodic network glitches not to end the process.'
+ defaultValue: 5
+- parameterName: WorkItemIDs
+ type: IList
+ description: A list of work items to import
+ defaultValue: '[]'
+status: ready
+processingTarget: Work Items
+classFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/TfsWorkItemMigrationProcessor.cs
+optionsClassFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/TfsWorkItemMigrationProcessorOptions.cs
+
+redirectFrom:
+- /Reference/Processors/TfsWorkItemMigrationProcessorOptions/
+layout: reference
+toc: true
+permalink: /Reference/Processors/TfsWorkItemMigrationProcessor/
+title: TfsWorkItemMigrationProcessor
+categories:
+- Processors
+-
+topics:
+- topic: notes
+ path: /docs/Reference/Processors/TfsWorkItemMigrationProcessor-notes.md
+ exists: false
+ markdown: ''
+- topic: introduction
+ path: /docs/Reference/Processors/TfsWorkItemMigrationProcessor-introduction.md
+ exists: false
+ markdown: ''
+
+---
\ No newline at end of file
diff --git a/docs/_data/reference.v1.processors.workitembulkeditprocessor.yaml b/docs/collections/_reference/reference.processors.workitembulkeditprocessor.md
similarity index 53%
rename from docs/_data/reference.v1.processors.workitembulkeditprocessor.yaml
rename to docs/collections/_reference/reference.processors.workitembulkeditprocessor.md
index 6d4f96c92..b2a65c466 100644
--- a/docs/_data/reference.v1.processors.workitembulkeditprocessor.yaml
+++ b/docs/collections/_reference/reference.processors.workitembulkeditprocessor.md
@@ -1,28 +1,45 @@
-optionsClassName: WorkItemBulkEditProcessorConfig
-optionsClassFullName: MigrationTools._EngineV1.Configuration.Processing.WorkItemBulkEditProcessorConfig
+---
+optionsClassName: WorkItemBulkEditProcessorOptions
+optionsClassFullName: MigrationTools._EngineV1.Configuration.Processing.WorkItemBulkEditProcessorOptions
configurationSamples:
-- name: default
+- name: defaults
+ description:
+ code: There are no defaults! Check the sample for options!
+ sampleFor: MigrationTools._EngineV1.Configuration.Processing.WorkItemBulkEditProcessorOptions
+- name: sample
+ description:
+ code: There is no sample, but you can check the classic below for a general feel.
+ sampleFor: MigrationTools._EngineV1.Configuration.Processing.WorkItemBulkEditProcessorOptions
+- name: classic
description:
code: >-
{
- "$type": "WorkItemBulkEditProcessorConfig",
+ "$type": "WorkItemBulkEditProcessorOptions",
"Enabled": false,
"WhatIf": false,
"WIQLQuery": "SELECT [System.Id] FROM WorkItems WHERE [System.TeamProject] = @TeamProject AND [@ReflectedWorkItemIdFieldName] = '' AND [System.WorkItemType] NOT IN ('Test Suite', 'Test Plan','Shared Steps','Shared Parameter','Feedback Request') ORDER BY [System.ChangedDate] desc",
"WorkItemIDs": null,
"FilterWorkItemsThatAlreadyExistInTarget": false,
"PauseAfterEachWorkItem": false,
- "WorkItemCreateRetryLimit": 0
+ "WorkItemCreateRetryLimit": 0,
+ "Enrichers": null,
+ "SourceName": null,
+ "TargetName": null,
+ "RefName": null
}
- sampleFor: MigrationTools._EngineV1.Configuration.Processing.WorkItemBulkEditProcessorConfig
+ sampleFor: MigrationTools._EngineV1.Configuration.Processing.WorkItemBulkEditProcessorOptions
description: This processor allows you to make changes in place where we load from teh Target and update the Target. This is used for bulk updates with the most common reason being a process template change.
className: WorkItemBulkEditProcessor
typeName: Processors
-architecture: v1
+architecture:
options:
- parameterName: Enabled
type: Boolean
- description: missng XML code comments
+ description: If set to `true` then the processor will run. Set to `false` and the processor will not run.
+ defaultValue: missng XML code comments
+- parameterName: 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.
defaultValue: missng XML code comments
- parameterName: FilterWorkItemsThatAlreadyExistInTarget
type: Boolean
@@ -32,6 +49,18 @@ options:
type: Boolean
description: Pause after each work item is migrated
defaultValue: false
+- parameterName: 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.'
+ defaultValue: missng XML code comments
+- parameterName: SourceName
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: TargetName
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
- parameterName: WhatIf
type: Boolean
description: missng XML code comments
@@ -50,5 +79,26 @@ options:
defaultValue: '[]'
status: missng XML code comments
processingTarget: WorkItem
-classFile: /src/VstsSyncMigrator.Core/Execution/ProcessingContext/WorkItemBulkEditProcessor.cs
-optionsClassFile: /src/MigrationTools/_EngineV1/Configuration/Processing/WorkItemBulkEditProcessorConfig.cs
+classFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/WorkItemBulkEditProcessor.cs
+optionsClassFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/WorkItemBulkEditProcessorOptions.cs
+
+redirectFrom:
+- /Reference/Processors/WorkItemBulkEditProcessorOptions/
+layout: reference
+toc: true
+permalink: /Reference/Processors/WorkItemBulkEditProcessor/
+title: WorkItemBulkEditProcessor
+categories:
+- Processors
+-
+topics:
+- topic: notes
+ path: /docs/Reference/Processors/WorkItemBulkEditProcessor-notes.md
+ exists: false
+ markdown: ''
+- topic: introduction
+ path: /docs/Reference/Processors/WorkItemBulkEditProcessor-introduction.md
+ exists: false
+ markdown: ''
+
+---
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.processors.workitemdeleteprocessor.md b/docs/collections/_reference/reference.processors.workitemdeleteprocessor.md
new file mode 100644
index 000000000..224619e50
--- /dev/null
+++ b/docs/collections/_reference/reference.processors.workitemdeleteprocessor.md
@@ -0,0 +1,99 @@
+---
+optionsClassName: WorkItemDeleteProcessorOptions
+optionsClassFullName: MigrationTools.Processors.WorkItemDeleteProcessorOptions
+configurationSamples:
+- name: defaults
+ description:
+ code: There are no defaults! Check the sample for options!
+ sampleFor: MigrationTools.Processors.WorkItemDeleteProcessorOptions
+- name: sample
+ description:
+ code: There is no sample, but you can check the classic below for a general feel.
+ sampleFor: MigrationTools.Processors.WorkItemDeleteProcessorOptions
+- name: classic
+ description:
+ code: >-
+ {
+ "$type": "WorkItemDeleteProcessorOptions",
+ "Enabled": false,
+ "WIQLQuery": "SELECT [System.Id] FROM WorkItems WHERE [System.TeamProject] = @TeamProject AND [System.WorkItemType] NOT IN ('Test Suite', 'Test Plan','Shared Steps','Shared Parameter','Feedback Request') ORDER BY [System.ChangedDate] desc",
+ "WorkItemIDs": null,
+ "FilterWorkItemsThatAlreadyExistInTarget": false,
+ "PauseAfterEachWorkItem": false,
+ "WorkItemCreateRetryLimit": 0,
+ "Enrichers": null,
+ "SourceName": null,
+ "TargetName": null,
+ "RefName": null
+ }
+ sampleFor: MigrationTools.Processors.WorkItemDeleteProcessorOptions
+description: The `WorkItemDelete` processor allows you to delete any amount of work items that meet the query. **DANGER:** This is not a recoverable action and should be use with extream caution.
+className: WorkItemDeleteProcessor
+typeName: Processors
+architecture:
+options:
+- parameterName: Enabled
+ type: Boolean
+ description: If set to `true` then the processor will run. Set to `false` and the processor will not run.
+ defaultValue: missng XML code comments
+- parameterName: 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.
+ defaultValue: missng XML code comments
+- parameterName: FilterWorkItemsThatAlreadyExistInTarget
+ type: Boolean
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: PauseAfterEachWorkItem
+ type: Boolean
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: 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.'
+ defaultValue: missng XML code comments
+- parameterName: SourceName
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: TargetName
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: WIQLQuery
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: WorkItemCreateRetryLimit
+ type: Int32
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: WorkItemIDs
+ type: IList
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+status: ready
+processingTarget: WorkItem
+classFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/WorkItemDeleteProcessor.cs
+optionsClassFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/WorkItemDeleteProcessorOptions.cs
+
+redirectFrom:
+- /Reference/Processors/WorkItemDeleteProcessorOptions/
+layout: reference
+toc: true
+permalink: /Reference/Processors/WorkItemDeleteProcessor/
+title: WorkItemDeleteProcessor
+categories:
+- Processors
+-
+topics:
+- topic: notes
+ path: /docs/Reference/Processors/WorkItemDeleteProcessor-notes.md
+ exists: false
+ markdown: ''
+- topic: introduction
+ path: /docs/Reference/Processors/WorkItemDeleteProcessor-introduction.md
+ exists: false
+ markdown: ''
+
+---
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.v1.processors.workitemmigrationcontext.md b/docs/collections/_reference/reference.processors.workitemmigrationprocessor.md
similarity index 67%
rename from docs/collections/_reference/reference.v1.processors.workitemmigrationcontext.md
rename to docs/collections/_reference/reference.processors.workitemmigrationprocessor.md
index 968575e0f..0acb1b849 100644
--- a/docs/collections/_reference/reference.v1.processors.workitemmigrationcontext.md
+++ b/docs/collections/_reference/reference.processors.workitemmigrationprocessor.md
@@ -1,12 +1,70 @@
---
-optionsClassName: WorkItemMigrationConfig
-optionsClassFullName: MigrationTools._EngineV1.Configuration.Processing.WorkItemMigrationConfig
+optionsClassName: WorkItemMigrationProcessorOptions
+optionsClassFullName: MigrationTools.Processors.WorkItemMigrationProcessorOptions
configurationSamples:
-- name: default
+- name: confinguration.json
description:
code: >-
{
- "$type": "WorkItemMigrationConfig",
+ "MigrationTools": {
+ "Processors": [
+ {
+ "ProcessorType": "WorkItemMigrationProcessor",
+ "Enabled": false,
+ "UpdateCreatedDate": true,
+ "UpdateCreatedBy": true,
+ "WIQLQuery": "SELECT [System.Id] FROM WorkItems WHERE [System.TeamProject] = @TeamProject AND [System.WorkItemType] NOT IN ('Test Suite', 'Test Plan','Shared Steps','Shared Parameter','Feedback Request') ORDER BY [System.ChangedDate] desc",
+ "FixHtmlAttachmentLinks": true,
+ "WorkItemCreateRetryLimit": 5,
+ "FilterWorkItemsThatAlreadyExistInTarget": false,
+ "PauseAfterEachWorkItem": false,
+ "AttachRevisionHistory": false,
+ "GenerateMigrationComment": true,
+ "WorkItemIDs": null,
+ "MaxGracefulFailures": 0,
+ "SkipRevisionWithInvalidIterationPath": false,
+ "SkipRevisionWithInvalidAreaPath": false,
+ "Enrichers": null,
+ "ProcessorEnrichers": null,
+ "SourceName": null,
+ "TargetName": null,
+ "RefName": null
+ }
+ ]
+ }
+ }
+ sampleFor: MigrationTools.Processors.WorkItemMigrationProcessorOptions
+- name: defaults
+ description:
+ code: >-
+ {
+ "MigrationTools": {
+ "ProcessorDefaults": {
+ "WorkItemMigrationProcessor": {
+ "AttachRevisionHistory": "False",
+ "Enabled": "False",
+ "FilterWorkItemsThatAlreadyExistInTarget": "False",
+ "FixHtmlAttachmentLinks": "True",
+ "GenerateMigrationComment": "True",
+ "MaxGracefulFailures": "0",
+ "PauseAfterEachWorkItem": "False",
+ "SkipRevisionWithInvalidAreaPath": "False",
+ "SkipRevisionWithInvalidIterationPath": "False",
+ "UpdateCreatedBy": "True",
+ "UpdateCreatedDate": "True",
+ "WIQLQuery": "SELECT [System.Id] FROM WorkItems WHERE [System.TeamProject] = @TeamProject AND [System.WorkItemType] NOT IN ('Test Suite', 'Test Plan','Shared Steps','Shared Parameter','Feedback Request') ORDER BY [System.ChangedDate] desc",
+ "WorkItemCreateRetryLimit": "5",
+ "WorkItemIDs": null
+ }
+ }
+ }
+ }
+ sampleFor: MigrationTools.Processors.WorkItemMigrationProcessorOptions
+- name: Classic
+ description:
+ code: >-
+ {
+ "$type": "WorkItemMigrationProcessorOptions",
"Enabled": false,
"UpdateCreatedDate": true,
"UpdateCreatedBy": true,
@@ -20,13 +78,17 @@ configurationSamples:
"WorkItemIDs": null,
"MaxGracefulFailures": 0,
"SkipRevisionWithInvalidIterationPath": false,
- "SkipRevisionWithInvalidAreaPath": false
+ "SkipRevisionWithInvalidAreaPath": false,
+ "Enrichers": null,
+ "ProcessorEnrichers": null,
+ "SourceName": null,
+ "TargetName": null
}
- sampleFor: MigrationTools._EngineV1.Configuration.Processing.WorkItemMigrationConfig
+ sampleFor: MigrationTools.Processors.WorkItemMigrationProcessorOptions
description: WorkItemMigrationConfig is the main processor used to Migrate Work Items, Links, and Attachments. Use `WorkItemMigrationConfig` to configure.
-className: WorkItemMigrationContext
+className: WorkItemMigrationProcessor
typeName: Processors
-architecture: v1
+architecture:
options:
- parameterName: AttachRevisionHistory
type: Boolean
@@ -34,8 +96,12 @@ options:
defaultValue: '?'
- parameterName: Enabled
type: Boolean
- description: If enabled then the processor will run
- defaultValue: false
+ description: If set to `true` then the processor will run. Set to `false` and the processor will not run.
+ defaultValue: missng XML code comments
+- parameterName: Enrichers
+ type: List
+ description: A list of enrichers that can augment the proccessing of the data
+ defaultValue: missng XML code comments
- parameterName: FilterWorkItemsThatAlreadyExistInTarget
type: Boolean
description: This loads all of the work items already saved to the Target and removes them from the Source work item list prior to commencing the run. While this may take some time in large data sets it reduces the time of the overall migration significantly if you need to restart.
@@ -56,6 +122,14 @@ options:
type: Boolean
description: Pause after each work item is migrated
defaultValue: false
+- parameterName: ProcessorEnrichers
+ 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.
+ defaultValue: missng XML code comments
+- parameterName: 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.'
+ defaultValue: missng XML code comments
- parameterName: SkipRevisionWithInvalidAreaPath
type: Boolean
description: When set to true, this setting will skip a revision if the source area has not been migrated, has been deleted or is somehow invalid, etc.
@@ -64,6 +138,14 @@ options:
type: Boolean
description: This will skip a revision if the source iteration has not been migrated i.e. it was deleted
defaultValue: missng XML code comments
+- parameterName: SourceName
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: TargetName
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
- parameterName: UpdateCreatedBy
type: Boolean
description: "If this is enabled the creation process on the target project will create the items with the original creation date. (Important: The item history is always pointed to the date of the migration, it's change only the data column CreateDate, not the internal create date)"
@@ -86,20 +168,21 @@ options:
defaultValue: '[]'
status: ready
processingTarget: Work Items
-classFile: /src/VstsSyncMigrator.Core/Execution/MigrationContext/WorkItemMigrationContext.cs
-optionsClassFile: /src/MigrationTools/_EngineV1/Configuration/Processing/WorkItemMigrationConfig.cs
+classFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/WorkItemMigrationProcessor.cs
+optionsClassFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/WorkItemMigrationProcessorOptions.cs
-redirectFrom: []
+redirectFrom:
+- /Reference/Processors/WorkItemMigrationProcessorOptions/
layout: reference
toc: true
-permalink: /Reference/v1/Processors/WorkItemMigrationContext/
-title: WorkItemMigrationContext
+permalink: /Reference/Processors/WorkItemMigrationProcessor/
+title: WorkItemMigrationProcessor
categories:
- Processors
-- v1
+-
topics:
- topic: notes
- path: /docs/Reference/v1/Processors/WorkItemMigrationContext-notes.md
+ path: /docs/Reference/Processors/WorkItemMigrationProcessor-notes.md
exists: true
markdown: >+
## WIQL Query Bits
@@ -188,7 +271,7 @@ topics:
- PrefixProjectToNodes - This option was removed in favour of the Area and Iteration Maps on [TfsNodeStructure](/Reference/v2/ProcessorEnrichers/TfsNodeStructure/)
- topic: introduction
- path: /docs/Reference/v1/Processors/WorkItemMigrationContext-introduction.md
+ path: /docs/Reference/Processors/WorkItemMigrationProcessor-introduction.md
exists: true
markdown: >+
The `WorkItemMigrationContext` processor is used for migrating work items from one Azure DevOps instance to another. This encompasses a variety of activities:
diff --git a/docs/collections/_reference/reference.processors.workitempostprocessingprocessor.md b/docs/collections/_reference/reference.processors.workitempostprocessingprocessor.md
new file mode 100644
index 000000000..760ca8811
--- /dev/null
+++ b/docs/collections/_reference/reference.processors.workitempostprocessingprocessor.md
@@ -0,0 +1,99 @@
+---
+optionsClassName: WorkItemPostProcessingProcessorOptions
+optionsClassFullName: MigrationTools.Processors.WorkItemPostProcessingProcessorOptions
+configurationSamples:
+- name: defaults
+ description:
+ code: There are no defaults! Check the sample for options!
+ sampleFor: MigrationTools.Processors.WorkItemPostProcessingProcessorOptions
+- name: sample
+ description:
+ code: There is no sample, but you can check the classic below for a general feel.
+ sampleFor: MigrationTools.Processors.WorkItemPostProcessingProcessorOptions
+- name: classic
+ description:
+ code: >-
+ {
+ "$type": "WorkItemPostProcessingProcessorOptions",
+ "Enabled": false,
+ "WorkItemIDs": null,
+ "WIQLQuery": "SELECT [System.Id] FROM WorkItems WHERE [System.TeamProject] = @TeamProject AND [@ReflectedWorkItemIdFieldName] = '' AND [System.WorkItemType] NOT IN ('Test Suite', 'Test Plan','Shared Steps','Shared Parameter','Feedback Request') ORDER BY [System.ChangedDate] desc",
+ "FilterWorkItemsThatAlreadyExistInTarget": false,
+ "PauseAfterEachWorkItem": false,
+ "WorkItemCreateRetryLimit": 0,
+ "Enrichers": null,
+ "SourceName": null,
+ "TargetName": null,
+ "RefName": null
+ }
+ sampleFor: MigrationTools.Processors.WorkItemPostProcessingProcessorOptions
+description: Reapply field mappings after a migration. Does not migtate Work Items, only reapplied changes to filed mappings.
+className: WorkItemPostProcessingProcessor
+typeName: Processors
+architecture:
+options:
+- parameterName: Enabled
+ type: Boolean
+ description: If set to `true` then the processor will run. Set to `false` and the processor will not run.
+ defaultValue: missng XML code comments
+- parameterName: 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.
+ defaultValue: missng XML code comments
+- parameterName: FilterWorkItemsThatAlreadyExistInTarget
+ type: Boolean
+ description: This loads all of the work items already saved to the Target and removes them from the Source work item list prior to commencing the run. While this may take some time in large data sets it reduces the time of the overall migration significantly if you need to restart.
+ defaultValue: true
+- parameterName: PauseAfterEachWorkItem
+ type: Boolean
+ description: Pause after each work item is migrated
+ defaultValue: false
+- parameterName: 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.'
+ defaultValue: missng XML code comments
+- parameterName: SourceName
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: TargetName
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: WIQLQuery
+ type: String
+ description: A work item query based on WIQL to select only important work items. To migrate all leave this empty. See [WIQL Query Bits](#wiql-query-bits)
+ defaultValue: AND [Microsoft.VSTS.Common.ClosedDate] = '' AND [System.WorkItemType] NOT IN ('Test Suite', 'Test Plan','Shared Steps','Shared Parameter','Feedback Request')
+- parameterName: WorkItemCreateRetryLimit
+ type: Int32
+ description: '**beta** If set to a number greater than 0 work items that fail to save will retry after a number of seconds equal to the retry count. This allows for periodic network glitches not to end the process.'
+ defaultValue: 5
+- parameterName: WorkItemIDs
+ type: IList
+ description: A list of work items to import
+ defaultValue: '[]'
+status: preview
+processingTarget: Work Items
+classFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/WorkItemPostProcessingProcessor.cs
+optionsClassFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/WorkItemPostProcessingProcessorOptions.cs
+
+redirectFrom:
+- /Reference/Processors/WorkItemPostProcessingProcessorOptions/
+layout: reference
+toc: true
+permalink: /Reference/Processors/WorkItemPostProcessingProcessor/
+title: WorkItemPostProcessingProcessor
+categories:
+- Processors
+-
+topics:
+- topic: notes
+ path: /docs/Reference/Processors/WorkItemPostProcessingProcessor-notes.md
+ exists: false
+ markdown: ''
+- topic: introduction
+ path: /docs/Reference/Processors/WorkItemPostProcessingProcessor-introduction.md
+ exists: false
+ markdown: ''
+
+---
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.v2.processors.workitemtrackingprocessor.md b/docs/collections/_reference/reference.processors.workitemtrackingprocessor.md
similarity index 85%
rename from docs/collections/_reference/reference.v2.processors.workitemtrackingprocessor.md
rename to docs/collections/_reference/reference.processors.workitemtrackingprocessor.md
index 50a22de61..30536ae37 100644
--- a/docs/collections/_reference/reference.v2.processors.workitemtrackingprocessor.md
+++ b/docs/collections/_reference/reference.processors.workitemtrackingprocessor.md
@@ -2,33 +2,33 @@
optionsClassName: WorkItemTrackingProcessorOptions
optionsClassFullName: MigrationTools.Processors.WorkItemTrackingProcessorOptions
configurationSamples:
-- name: default
+- name: defaults
+ description:
+ code: There are no defaults! Check the sample for options!
+ sampleFor: MigrationTools.Processors.WorkItemTrackingProcessorOptions
+- name: sample
+ description:
+ code: There is no sample, but you can check the classic below for a general feel.
+ sampleFor: MigrationTools.Processors.WorkItemTrackingProcessorOptions
+- name: classic
description:
code: >-
{
"$type": "WorkItemTrackingProcessorOptions",
- "Enabled": true,
- "ReplayRevisions": true,
+ "Enabled": false,
+ "ReplayRevisions": false,
"CollapseRevisions": false,
- "WorkItemCreateRetryLimit": 5,
- "ProcessorEnrichers": [
- {
- "$type": "PauseAfterEachItemOptions",
- "Enabled": true
- },
- {
- "$type": "AppendMigrationToolSignatureFooterOptions",
- "Enabled": true
- }
- ],
+ "WorkItemCreateRetryLimit": 0,
+ "Enrichers": null,
"SourceName": null,
- "TargetName": null
+ "TargetName": null,
+ "RefName": null
}
sampleFor: MigrationTools.Processors.WorkItemTrackingProcessorOptions
description: This processor is intended, with the aid of [ProcessorEnrichers](../ProcessorEnrichers/index.md), to allow the migration of Work Items between two [Endpoints](../Endpoints/index.md).
className: WorkItemTrackingProcessor
typeName: Processors
-architecture: v2
+architecture:
options:
- parameterName: CollapseRevisions
type: Boolean
@@ -38,7 +38,7 @@ options:
type: Boolean
description: If set to `true` then the processor will run. Set to `false` and the processor will not run.
defaultValue: missng XML code comments
-- parameterName: ProcessorEnrichers
+- parameterName: 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.
defaultValue: missng XML code comments
@@ -64,20 +64,21 @@ options:
defaultValue: missng XML code comments
status: missng XML code comments
processingTarget: missng XML code comments
-classFile: /src/MigrationTools/Processors/WorkItemProcessor/WorkItemTrackingProcessor.cs
-optionsClassFile: /src/MigrationTools/Processors/WorkItemProcessor/WorkItemTrackingProcessorOptions.cs
+classFile: /src/MigrationTools/Processors/WorkItemTrackingProcessor.cs
+optionsClassFile: /src/MigrationTools/Processors/WorkItemTrackingProcessorOptions.cs
-redirectFrom: []
+redirectFrom:
+- /Reference/Processors/WorkItemTrackingProcessorOptions/
layout: reference
toc: true
-permalink: /Reference/v2/Processors/WorkItemTrackingProcessor/
+permalink: /Reference/Processors/WorkItemTrackingProcessor/
title: WorkItemTrackingProcessor
categories:
- Processors
-- v2
+-
topics:
- topic: notes
- path: /docs/Reference/v2/Processors/WorkItemTrackingProcessor-notes.md
+ path: /docs/Reference/Processors/WorkItemTrackingProcessor-notes.md
exists: true
markdown: >2+
@@ -200,7 +201,7 @@ topics:
}
```
- topic: introduction
- path: /docs/Reference/v2/Processors/WorkItemTrackingProcessor-introduction.md
+ path: /docs/Reference/Processors/WorkItemTrackingProcessor-introduction.md
exists: false
markdown: ''
diff --git a/docs/collections/_reference/reference.processors.workitemupdateareasastagsprocessor.md b/docs/collections/_reference/reference.processors.workitemupdateareasastagsprocessor.md
new file mode 100644
index 000000000..2516f5066
--- /dev/null
+++ b/docs/collections/_reference/reference.processors.workitemupdateareasastagsprocessor.md
@@ -0,0 +1,79 @@
+---
+optionsClassName: WorkItemUpdateAreasAsTagsProcessorOptions
+optionsClassFullName: MigrationTools.Processors.WorkItemUpdateAreasAsTagsProcessorOptions
+configurationSamples:
+- name: defaults
+ description:
+ code: There are no defaults! Check the sample for options!
+ sampleFor: MigrationTools.Processors.WorkItemUpdateAreasAsTagsProcessorOptions
+- name: sample
+ description:
+ code: There is no sample, but you can check the classic below for a general feel.
+ sampleFor: MigrationTools.Processors.WorkItemUpdateAreasAsTagsProcessorOptions
+- name: classic
+ description:
+ code: >-
+ {
+ "$type": "WorkItemUpdateAreasAsTagsProcessorOptions",
+ "Enabled": false,
+ "AreaIterationPath": null,
+ "Enrichers": null,
+ "SourceName": null,
+ "TargetName": null,
+ "RefName": null
+ }
+ sampleFor: MigrationTools.Processors.WorkItemUpdateAreasAsTagsProcessorOptions
+description: A common issue with older *TFS/Azure DevOps* instances is the proliferation of `Area Paths`. With the use of `Area Path` for `Teams` and the addition of the `Node Name` column option these extensive tag hierarchies should instad be moved to tags.
+className: WorkItemUpdateAreasAsTagsProcessor
+typeName: Processors
+architecture:
+options:
+- parameterName: AreaIterationPath
+ type: String
+ description: This is a required parameter. That define the root path of the iteration. To get the full path use `\`
+ defaultValue: '\'
+- parameterName: Enabled
+ type: Boolean
+ description: If set to `true` then the processor will run. Set to `false` and the processor will not run.
+ defaultValue: missng XML code comments
+- parameterName: 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.
+ defaultValue: missng XML code comments
+- parameterName: 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.'
+ defaultValue: missng XML code comments
+- parameterName: SourceName
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: TargetName
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+status: Beta
+processingTarget: Work Item
+classFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/WorkItemUpdateAreasAsTagsProcessor.cs
+optionsClassFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/WorkItemUpdateAreasAsTagsProcessorOptions.cs
+
+redirectFrom:
+- /Reference/Processors/WorkItemUpdateAreasAsTagsProcessorOptions/
+layout: reference
+toc: true
+permalink: /Reference/Processors/WorkItemUpdateAreasAsTagsProcessor/
+title: WorkItemUpdateAreasAsTagsProcessor
+categories:
+- Processors
+-
+topics:
+- topic: notes
+ path: /docs/Reference/Processors/WorkItemUpdateAreasAsTagsProcessor-notes.md
+ exists: false
+ markdown: ''
+- topic: introduction
+ path: /docs/Reference/Processors/WorkItemUpdateAreasAsTagsProcessor-introduction.md
+ exists: false
+ markdown: ''
+
+---
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.tools.fieldmappingtool.md b/docs/collections/_reference/reference.tools.fieldmappingtool.md
new file mode 100644
index 000000000..76a3991cd
--- /dev/null
+++ b/docs/collections/_reference/reference.tools.fieldmappingtool.md
@@ -0,0 +1,236 @@
+---
+optionsClassName: FieldMappingToolOptions
+optionsClassFullName: MigrationTools.Tools.FieldMappingToolOptions
+configurationSamples:
+- name: defaults
+ description:
+ code: >-
+ {
+ "MigrationTools": {
+ "CommonTools": {
+ "FieldMappingTool": {
+ "Enabled": "False",
+ "FieldMapDefaults": {
+ "ApplyTo": [
+ "*"
+ ]
+ },
+ "FieldMaps": null
+ }
+ }
+ }
+ }
+ sampleFor: MigrationTools.Tools.FieldMappingToolOptions
+- name: sample
+ description:
+ code: >-
+ {
+ "MigrationTools": {
+ "CommonTools": {
+ "FieldMappingTool": {
+ "Enabled": "True",
+ "FieldMaps": [
+ {
+ "ApplyTo": [
+ "SomeWorkItemType"
+ ],
+ "FieldMapType": "FieldMergeMap",
+ "formatExpression": "{0} \n {1}",
+ "sourceFields": [
+ "Custom.FieldA",
+ "Custom.FieldB"
+ ],
+ "targetField": "Custom.FieldC"
+ },
+ {
+ "ApplyTo": [
+ "SomeWorkItemType"
+ ],
+ "defaultValue": "New",
+ "FieldMapType": "FieldValueMap",
+ "sourceField": "System.State",
+ "targetField": "System.State",
+ "valueMapping": {
+ "Active": "InProgress",
+ "Closed": "Done",
+ "Resolved": "InProgress"
+ }
+ },
+ {
+ "ApplyTo": [
+ "SomeWorkItemType"
+ ],
+ "defaultValue": "42",
+ "FieldMapType": "FieldToFieldMap",
+ "sourceField": "Microsoft.VSTS.Common.BacklogPriority",
+ "targetField": "Microsoft.VSTS.Common.StackRank"
+ }
+ ],
+ "FieldMapSamples": {
+ "FieldClearMap": {
+ "ApplyTo": [
+ "SomeWorkItemType"
+ ],
+ "targetField": "Custom.FieldC"
+ },
+ "FieldLiteralMap": {
+ "ApplyTo": [
+ "SomeWorkItemType"
+ ],
+ "targetField": "Custom.SomeField",
+ "value": "New field value"
+ },
+ "FieldMergeMap": {
+ "ApplyTo": [
+ "SomeWorkItemType"
+ ],
+ "formatExpression": "{0} \n {1}",
+ "sourceFields": [
+ "Custom.FieldA",
+ "Custom.FieldB"
+ ],
+ "targetField": "Custom.FieldC"
+ },
+ "FieldToFieldMap": {
+ "ApplyTo": [
+ "SomeWorkItemType"
+ ],
+ "defaultValue": "42",
+ "sourceField": "Microsoft.VSTS.Common.BacklogPriority",
+ "targetField": "Microsoft.VSTS.Common.StackRank"
+ },
+ "FieldToFieldMultiMap": {
+ "ApplyTo": [
+ "SomeWorkItemType",
+ "SomeOtherWorkItemType"
+ ],
+ "SourceToTargetMappings": {
+ "SourceField1": "TargetField1",
+ "SourceField2": "TargetField2"
+ }
+ },
+ "FieldToTagFieldMap": {
+ "ApplyTo": [
+ "SomeWorkItemType"
+ ],
+ "formatExpression": "{0}
Acceptance Criteria
{1}",
+ "sourceFields": [
+ "System.Description",
+ "Microsoft.VSTS.Common.AcceptanceCriteria"
+ ],
+ "targetField": "System.Description"
+ },
+ "FieldToTagMap": {
+ "ApplyTo": [
+ "SomeWorkItemType"
+ ],
+ "formatExpression": "ScrumState:{0}",
+ "sourceField": "System.State"
+ },
+ "FieldValueMap": {
+ "ApplyTo": [
+ "SomeWorkItemType"
+ ],
+ "defaultValue": "StateB",
+ "sourceField": "System.State",
+ "targetField": "System.State",
+ "valueMapping": {
+ "StateA": "StateB"
+ }
+ },
+ "FieldValueToTagMap": {
+ "ApplyTo": [
+ "SomeWorkItemType"
+ ],
+ "formatExpression": "{0}",
+ "pattern": "Yes",
+ "sourceField": "Microsoft.VSTS.CMMI.Blocked"
+ },
+ "MultiValueConditionalMap": {
+ "ApplyTo": [
+ "SomeWorkItemType"
+ ],
+ "sourceFieldsAndValues": {
+ "Field1": "Value1",
+ "Field2": "Value2"
+ },
+ "targetFieldsAndValues": {
+ "Field1": "Value1",
+ "Field2": "Value2"
+ }
+ },
+ "RegexFieldMap": {
+ "ApplyTo": [
+ "SomeWorkItemType"
+ ],
+ "pattern": "PRODUCT \\d{4}.(\\d{1})",
+ "replacement": "$1",
+ "sourceField": "COMPANY.PRODUCT.Release",
+ "targetField": "COMPANY.DEVISION.MinorReleaseVersion"
+ },
+ "targetFieldsAndValues": {
+ "ApplyTo": [
+ "SomeWorkItemType"
+ ],
+ "targetField": "Custom.ReflectedWorkItemId"
+ },
+ "TreeToTagMap": {
+ "ApplyTo": [
+ "SomeWorkItemType"
+ ],
+ "timeTravel": "1",
+ "toSkip": "3"
+ }
+ }
+ }
+ }
+ }
+ }
+ sampleFor: MigrationTools.Tools.FieldMappingToolOptions
+- name: classic
+ description:
+ code: >-
+ {
+ "$type": "FieldMappingToolOptions",
+ "Enabled": true,
+ "FieldMaps": []
+ }
+ sampleFor: MigrationTools.Tools.FieldMappingToolOptions
+description: missng XML code comments
+className: FieldMappingTool
+typeName: Tools
+architecture:
+options:
+- parameterName: Enabled
+ type: Boolean
+ description: If set to `true` then the tool will run. Set to `false` and the processor will not run.
+ defaultValue: missng XML code comments
+- parameterName: FieldMaps
+ type: List
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+status: missng XML code comments
+processingTarget: missng XML code comments
+classFile: /src/MigrationTools/Tools/FieldMappingTool.cs
+optionsClassFile: /src/MigrationTools/Tools/FieldMappingToolOptions.cs
+
+redirectFrom:
+- /Reference/Tools/FieldMappingToolOptions/
+layout: reference
+toc: true
+permalink: /Reference/Tools/FieldMappingTool/
+title: FieldMappingTool
+categories:
+- Tools
+-
+topics:
+- topic: notes
+ path: /docs/Reference/Tools/FieldMappingTool-notes.md
+ exists: false
+ markdown: ''
+- topic: introduction
+ path: /docs/Reference/Tools/FieldMappingTool-introduction.md
+ exists: false
+ markdown: ''
+
+---
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.tools.gitrepomappingtool.md b/docs/collections/_reference/reference.tools.gitrepomappingtool.md
new file mode 100644
index 000000000..10f7f621d
--- /dev/null
+++ b/docs/collections/_reference/reference.tools.gitrepomappingtool.md
@@ -0,0 +1,59 @@
+---
+optionsClassName: GitRepoMappingToolOptions
+optionsClassFullName: MigrationTools.Tools.GitRepoMappingToolOptions
+configurationSamples:
+- name: defaults
+ description:
+ code: There are no defaults! Check the sample for options!
+ sampleFor: MigrationTools.Tools.GitRepoMappingToolOptions
+- name: sample
+ description:
+ code: There is no sample, but you can check the classic below for a general feel.
+ sampleFor: MigrationTools.Tools.GitRepoMappingToolOptions
+- name: classic
+ description:
+ code: >-
+ {
+ "$type": "GitRepoMappingToolOptions",
+ "Enabled": false,
+ "Mappings": null
+ }
+ sampleFor: MigrationTools.Tools.GitRepoMappingToolOptions
+description: Used to process the String fields of a work item. This is useful for cleaning up data. It will limit fields to a max length and apply regex replacements based on what is configured. Each regex replacement is applied in order and can be enabled or disabled.
+className: GitRepoMappingTool
+typeName: Tools
+architecture:
+options:
+- parameterName: Enabled
+ type: Boolean
+ description: If set to `true` then the tool will run. Set to `false` and the processor will not run.
+ defaultValue: missng XML code comments
+- parameterName: Mappings
+ type: Dictionary
+ description: List of work item mappings.
+ defaultValue: '{}'
+status: missng XML code comments
+processingTarget: missng XML code comments
+classFile: /src/MigrationTools/Tools/GitRepoMappingTool.cs
+optionsClassFile: /src/MigrationTools/Tools/GitRepoMappingToolOptions.cs
+
+redirectFrom:
+- /Reference/Tools/GitRepoMappingToolOptions/
+layout: reference
+toc: true
+permalink: /Reference/Tools/GitRepoMappingTool/
+title: GitRepoMappingTool
+categories:
+- Tools
+-
+topics:
+- topic: notes
+ path: /docs/Reference/Tools/GitRepoMappingTool-notes.md
+ exists: false
+ markdown: ''
+- topic: introduction
+ path: /docs/Reference/Tools/GitRepoMappingTool-introduction.md
+ exists: false
+ markdown: ''
+
+---
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.tools.itool.md b/docs/collections/_reference/reference.tools.itool.md
new file mode 100644
index 000000000..6032cefef
--- /dev/null
+++ b/docs/collections/_reference/reference.tools.itool.md
@@ -0,0 +1,34 @@
+---
+optionsClassName:
+optionsClassFullName:
+configurationSamples: []
+description: missng XML code comments
+className: ITool
+typeName: Tools
+architecture: v1
+options: []
+status: missng XML code comments
+processingTarget: missng XML code comments
+classFile: /src/MigrationTools/Tools/Infra/ITool.cs
+optionsClassFile:
+
+redirectFrom:
+- /Reference/v1/Tools//
+layout: reference
+toc: true
+permalink: /Reference/Tools/ITool/
+title: ITool
+categories:
+- Tools
+- v1
+topics:
+- topic: notes
+ path: /Tools/ITool-notes.md
+ exists: false
+ markdown: ''
+- topic: introduction
+ path: /Tools/ITool-introduction.md
+ exists: false
+ markdown: ''
+
+---
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.tools.stringmanipulatortool.md b/docs/collections/_reference/reference.tools.stringmanipulatortool.md
new file mode 100644
index 000000000..797f8ee88
--- /dev/null
+++ b/docs/collections/_reference/reference.tools.stringmanipulatortool.md
@@ -0,0 +1,115 @@
+---
+optionsClassName: StringManipulatorToolOptions
+optionsClassFullName: MigrationTools.Tools.StringManipulatorToolOptions
+configurationSamples:
+- name: defaults
+ description:
+ code: >-
+ {
+ "MigrationTools": {
+ "CommonTools": {
+ "StringManipulatorTool": {
+ "Enabled": "True",
+ "Manipulators": [
+ {
+ "$type": "RegexStringManipulator",
+ "Description": "Remove invalid characters from the end of the string",
+ "Enabled": "True",
+ "Pattern": "[^( -~)\n\r\t]+",
+ "Replacement": ""
+ }
+ ],
+ "MaxStringLength": "1000000"
+ }
+ }
+ }
+ }
+ sampleFor: MigrationTools.Tools.StringManipulatorToolOptions
+- name: sample
+ description:
+ code: >-
+ {
+ "MigrationTools": {
+ "CommonTools": {
+ "StringManipulatorTool": {
+ "Enabled": "True",
+ "Manipulators": [
+ {
+ "$type": "RegexStringManipulator",
+ "Description": "Remove invalid characters from the end of the string",
+ "Enabled": "True",
+ "Pattern": "[^( -~)\n\r\t]+",
+ "Replacement": ""
+ }
+ ],
+ "MaxStringLength": "1000000"
+ }
+ }
+ }
+ }
+ sampleFor: MigrationTools.Tools.StringManipulatorToolOptions
+- name: classic
+ description:
+ code: >-
+ {
+ "$type": "StringManipulatorToolOptions",
+ "Enabled": true,
+ "MaxStringLength": 1000000,
+ "Manipulators": [
+ {
+ "Enabled": true,
+ "Pattern": "[^( -~)\n\r\t]+",
+ "Replacement": "",
+ "Description": "Remove invalid characters from the end of the string"
+ },
+ {
+ "Enabled": true,
+ "Pattern": "[^( -~)\n\r\t]+",
+ "Replacement": "",
+ "Description": "Remove invalid characters from the end of the string"
+ }
+ ]
+ }
+ sampleFor: MigrationTools.Tools.StringManipulatorToolOptions
+description: Used to process the String fields of a work item. This is useful for cleaning up data. It will limit fields to a max length and apply regex replacements based on what is configured. Each regex replacement is applied in order and can be enabled or disabled.
+className: StringManipulatorTool
+typeName: Tools
+architecture:
+options:
+- parameterName: Enabled
+ type: Boolean
+ description: If set to `true` then the tool will run. Set to `false` and the processor will not run.
+ defaultValue: missng XML code comments
+- parameterName: Manipulators
+ type: List
+ description: List of regex based string manipulations to apply to all string fields. Each regex replacement is applied in order and can be enabled or disabled.
+ defaultValue: '{}'
+- parameterName: MaxStringLength
+ type: Int32
+ description: Max number of chars in a string. Applied last, and set to 1000000 by default.
+ defaultValue: 1000000
+status: missng XML code comments
+processingTarget: missng XML code comments
+classFile: /src/MigrationTools/Tools/StringManipulatorTool.cs
+optionsClassFile: /src/MigrationTools/Tools/StringManipulatorToolOptions.cs
+
+redirectFrom:
+- /Reference/Tools/StringManipulatorToolOptions/
+layout: reference
+toc: true
+permalink: /Reference/Tools/StringManipulatorTool/
+title: StringManipulatorTool
+categories:
+- Tools
+-
+topics:
+- topic: notes
+ path: /docs/Reference/Tools/StringManipulatorTool-notes.md
+ exists: false
+ markdown: ''
+- topic: introduction
+ path: /docs/Reference/Tools/StringManipulatorTool-introduction.md
+ exists: false
+ markdown: ''
+
+---
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.tools.tfsattachmenttool.md b/docs/collections/_reference/reference.tools.tfsattachmenttool.md
new file mode 100644
index 000000000..68e610bb9
--- /dev/null
+++ b/docs/collections/_reference/reference.tools.tfsattachmenttool.md
@@ -0,0 +1,88 @@
+---
+optionsClassName: TfsAttachmentToolOptions
+optionsClassFullName: MigrationTools.Tools.TfsAttachmentToolOptions
+configurationSamples:
+- name: defaults
+ description:
+ code: >-
+ {
+ "MigrationTools": {
+ "CommonTools": {
+ "TfsAttachmentTool": {
+ "Enabled": "True",
+ "ExportBasePath": "c:\\temp\\WorkItemAttachmentExport",
+ "MaxAttachmentSize": "480000000",
+ "RefName": "TfsAttachmentTool"
+ }
+ }
+ }
+ }
+ sampleFor: MigrationTools.Tools.TfsAttachmentToolOptions
+- name: sample
+ description:
+ code: >-
+ {
+ "MigrationTools": {
+ "CommonTools": {
+ "TfsAttachmentTool": {
+ "Enabled": "True",
+ "ExportBasePath": "c:\\temp\\WorkItemAttachmentExport",
+ "MaxAttachmentSize": "480000000",
+ "RefName": "TfsAttachmentTool"
+ }
+ }
+ }
+ }
+ sampleFor: MigrationTools.Tools.TfsAttachmentToolOptions
+- name: classic
+ description:
+ code: >-
+ {
+ "$type": "TfsAttachmentToolOptions",
+ "Enabled": true,
+ "ExportBasePath": "c:\\temp\\WorkItemAttachmentExport",
+ "MaxAttachmentSize": 480000000
+ }
+ sampleFor: MigrationTools.Tools.TfsAttachmentToolOptions
+description: missng XML code comments
+className: TfsAttachmentTool
+typeName: Tools
+architecture:
+options:
+- parameterName: Enabled
+ type: Boolean
+ description: If set to `true` then the tool will run. Set to `false` and the processor will not run.
+ defaultValue: missng XML code comments
+- parameterName: ExportBasePath
+ type: String
+ description: '`AttachmentMigration` is set to true then you need to specify a working path for attachments to be saved locally.'
+ defaultValue: C:\temp\Migration\
+- parameterName: MaxAttachmentSize
+ type: Int32
+ description: '`AttachmentMigration` is set to true then you need to specify a max file size for upload in bites. For Azure DevOps Services the default is 480,000,000 bites (60mb), for TFS its 32,000,000 bites (4mb).'
+ defaultValue: 480000000
+status: missng XML code comments
+processingTarget: missng XML code comments
+classFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Tools/TfsAttachmentTool.cs
+optionsClassFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Tools/TfsAttachmentToolOptions.cs
+
+redirectFrom:
+- /Reference/Tools/TfsAttachmentToolOptions/
+layout: reference
+toc: true
+permalink: /Reference/Tools/TfsAttachmentTool/
+title: TfsAttachmentTool
+categories:
+- Tools
+-
+topics:
+- topic: notes
+ path: /docs/Reference/Tools/TfsAttachmentTool-notes.md
+ exists: false
+ markdown: ''
+- topic: introduction
+ path: /docs/Reference/Tools/TfsAttachmentTool-introduction.md
+ exists: false
+ markdown: ''
+
+---
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.tools.tfschangesetmappingtool.md b/docs/collections/_reference/reference.tools.tfschangesetmappingtool.md
new file mode 100644
index 000000000..6d7fd19ee
--- /dev/null
+++ b/docs/collections/_reference/reference.tools.tfschangesetmappingtool.md
@@ -0,0 +1,79 @@
+---
+optionsClassName: TfsChangeSetMappingToolOptions
+optionsClassFullName: MigrationTools.Tools.TfsChangeSetMappingToolOptions
+configurationSamples:
+- name: defaults
+ description:
+ code: >-
+ {
+ "MigrationTools": {
+ "CommonTools": {
+ "TfsChangeSetMappingTool": {
+ "Enabled": "False",
+ "File": ""
+ }
+ }
+ }
+ }
+ sampleFor: MigrationTools.Tools.TfsChangeSetMappingToolOptions
+- name: sample
+ description:
+ code: >-
+ {
+ "MigrationTools": {
+ "CommonTools": {
+ "TfsChangeSetMappingTool": {
+ "Enabled": "True",
+ "File": "c:\\changesetmappings.json"
+ }
+ }
+ }
+ }
+ sampleFor: MigrationTools.Tools.TfsChangeSetMappingToolOptions
+- name: classic
+ description:
+ code: >-
+ {
+ "$type": "TfsChangeSetMappingToolOptions",
+ "Enabled": true,
+ "ChangeSetMappingFile": null
+ }
+ sampleFor: MigrationTools.Tools.TfsChangeSetMappingToolOptions
+description: missng XML code comments
+className: TfsChangeSetMappingTool
+typeName: Tools
+architecture:
+options:
+- parameterName: ChangeSetMappingFile
+ type: String
+ description: missng XML code comments
+ defaultValue: missng XML code comments
+- parameterName: Enabled
+ type: Boolean
+ description: If set to `true` then the tool will run. Set to `false` and the processor will not run.
+ defaultValue: missng XML code comments
+status: missng XML code comments
+processingTarget: missng XML code comments
+classFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Tools/TfsChangeSetMappingTool.cs
+optionsClassFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Tools/TfsChangeSetMappingToolOptions.cs
+
+redirectFrom:
+- /Reference/Tools/TfsChangeSetMappingToolOptions/
+layout: reference
+toc: true
+permalink: /Reference/Tools/TfsChangeSetMappingTool/
+title: TfsChangeSetMappingTool
+categories:
+- Tools
+-
+topics:
+- topic: notes
+ path: /docs/Reference/Tools/TfsChangeSetMappingTool-notes.md
+ exists: false
+ markdown: ''
+- topic: introduction
+ path: /docs/Reference/Tools/TfsChangeSetMappingTool-introduction.md
+ exists: false
+ markdown: ''
+
+---
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.tools.tfsembededimagestool.md b/docs/collections/_reference/reference.tools.tfsembededimagestool.md
new file mode 100644
index 000000000..cc48d6d0e
--- /dev/null
+++ b/docs/collections/_reference/reference.tools.tfsembededimagestool.md
@@ -0,0 +1,72 @@
+---
+optionsClassName: TfsEmbededImagesToolOptions
+optionsClassFullName: MigrationTools.Tools.TfsEmbededImagesToolOptions
+configurationSamples:
+- name: defaults
+ description:
+ code: >-
+ {
+ "MigrationTools": {
+ "CommonTools": {
+ "TfsEmbededImagesTool": {
+ "Enabled": "True"
+ }
+ }
+ }
+ }
+ sampleFor: MigrationTools.Tools.TfsEmbededImagesToolOptions
+- name: sample
+ description:
+ code: >-
+ {
+ "MigrationTools": {
+ "CommonTools": {
+ "TfsEmbededImagesTool": {
+ "Enabled": "True"
+ }
+ }
+ }
+ }
+ sampleFor: MigrationTools.Tools.TfsEmbededImagesToolOptions
+- name: classic
+ description:
+ code: >-
+ {
+ "$type": "TfsEmbededImagesToolOptions",
+ "Enabled": true
+ }
+ sampleFor: MigrationTools.Tools.TfsEmbededImagesToolOptions
+description: missng XML code comments
+className: TfsEmbededImagesTool
+typeName: Tools
+architecture:
+options:
+- parameterName: Enabled
+ type: Boolean
+ description: If set to `true` then the tool will run. Set to `false` and the processor will not run.
+ defaultValue: missng XML code comments
+status: missng XML code comments
+processingTarget: missng XML code comments
+classFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Tools/TfsEmbededImagesTool.cs
+optionsClassFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Tools/TfsEmbededImagesToolOptions.cs
+
+redirectFrom:
+- /Reference/Tools/TfsEmbededImagesToolOptions/
+layout: reference
+toc: true
+permalink: /Reference/Tools/TfsEmbededImagesTool/
+title: TfsEmbededImagesTool
+categories:
+- Tools
+-
+topics:
+- topic: notes
+ path: /docs/Reference/Tools/TfsEmbededImagesTool-notes.md
+ exists: false
+ markdown: ''
+- topic: introduction
+ path: /docs/Reference/Tools/TfsEmbededImagesTool-introduction.md
+ exists: false
+ markdown: ''
+
+---
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.tools.tfsgitrepositorytool.md b/docs/collections/_reference/reference.tools.tfsgitrepositorytool.md
new file mode 100644
index 000000000..18cf68876
--- /dev/null
+++ b/docs/collections/_reference/reference.tools.tfsgitrepositorytool.md
@@ -0,0 +1,83 @@
+---
+optionsClassName: TfsGitRepositoryToolOptions
+optionsClassFullName: MigrationTools.Tools.TfsGitRepositoryToolOptions
+configurationSamples:
+- name: defaults
+ description:
+ code: >-
+ {
+ "MigrationTools": {
+ "CommonTools": {
+ "TfsGitRepositoryTool": {
+ "Enabled": "True",
+ "Mappings": null
+ }
+ }
+ }
+ }
+ sampleFor: MigrationTools.Tools.TfsGitRepositoryToolOptions
+- name: sample
+ description:
+ code: >-
+ {
+ "MigrationTools": {
+ "CommonTools": {
+ "TfsGitRepositoryTool": {
+ "Enabled": "True",
+ "Mappings": {
+ "RepoInSource": "RepoInTarget"
+ }
+ }
+ }
+ }
+ }
+ sampleFor: MigrationTools.Tools.TfsGitRepositoryToolOptions
+- name: classic
+ description:
+ code: >-
+ {
+ "$type": "TfsGitRepositoryToolOptions",
+ "Enabled": true,
+ "Mappings": {
+ "RepoInSource": "RepoInTarget"
+ }
+ }
+ sampleFor: MigrationTools.Tools.TfsGitRepositoryToolOptions
+description: missng XML code comments
+className: TfsGitRepositoryTool
+typeName: Tools
+architecture:
+options:
+- parameterName: Enabled
+ type: Boolean
+ description: If set to `true` then the tool will run. Set to `false` and the processor will not run.
+ defaultValue: missng XML code comments
+- parameterName: Mappings
+ type: Dictionary
+ description: List of work item mappings.
+ defaultValue: '{}'
+status: missng XML code comments
+processingTarget: missng XML code comments
+classFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Tools/TfsGitRepositoryTool.cs
+optionsClassFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Tools/TfsGitRepositoryToolOptions.cs
+
+redirectFrom:
+- /Reference/Tools/TfsGitRepositoryToolOptions/
+layout: reference
+toc: true
+permalink: /Reference/Tools/TfsGitRepositoryTool/
+title: TfsGitRepositoryTool
+categories:
+- Tools
+-
+topics:
+- topic: notes
+ path: /docs/Reference/Tools/TfsGitRepositoryTool-notes.md
+ exists: false
+ markdown: ''
+- topic: introduction
+ path: /docs/Reference/Tools/TfsGitRepositoryTool-introduction.md
+ exists: false
+ markdown: ''
+
+---
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.v2.processorenrichers.tfsnodestructure.md b/docs/collections/_reference/reference.tools.tfsnodestructuretool.md
similarity index 65%
rename from docs/collections/_reference/reference.v2.processorenrichers.tfsnodestructure.md
rename to docs/collections/_reference/reference.tools.tfsnodestructuretool.md
index 0e8d56a60..cec8628e0 100644
--- a/docs/collections/_reference/reference.v2.processorenrichers.tfsnodestructure.md
+++ b/docs/collections/_reference/reference.tools.tfsnodestructuretool.md
@@ -1,49 +1,114 @@
---
-optionsClassName: TfsNodeStructureOptions
-optionsClassFullName: MigrationTools.Enrichers.TfsNodeStructureOptions
+optionsClassName: TfsNodeStructureToolOptions
+optionsClassFullName: MigrationTools.Tools.TfsNodeStructureToolOptions
configurationSamples:
-- name: default
+- name: defaults
description:
code: >-
{
- "$type": "TfsNodeStructureOptions",
+ "MigrationTools": {
+ "CommonTools": {
+ "TfsNodeStructureTool": {
+ "Areas": {
+ "Filters": null,
+ "Mappings": null
+ },
+ "Enabled": "True",
+ "Iterations": {
+ "Filters": null,
+ "Mappings": null
+ },
+ "ReplicateAllExistingNodes": "True",
+ "ShouldCreateMissingRevisionPaths": "True"
+ }
+ }
+ }
+ }
+ sampleFor: MigrationTools.Tools.TfsNodeStructureToolOptions
+- name: sample
+ description:
+ code: >-
+ {
+ "MigrationTools": {
+ "CommonTools": {
+ "TfsNodeStructureTool": {
+ "Areas": {
+ "Filters": [
+ "*\\Team 1,*\\Team 1\\**"
+ ],
+ "Mappings": {
+ "^7473924d-c47f-4089-8f5c-077c728b576e([\\\\]?.*)$": "MigrationTest5$1",
+ "^migrationSource1([\\\\]?.*)$": "MigrationTest5$1",
+ "^Skypoint Cloud([\\\\]?.*)$": "MigrationTest5$1"
+ }
+ },
+ "Enabled": "True",
+ "Iterations": {
+ "Filters": [
+ "*\\Sprint*",
+ "*\\Sprint*\\**"
+ ],
+ "Mappings": {
+ "^7473924d-c47f-4089-8f5c-077c728b576e([\\\\]?.*)$": "MigrationTest5$1",
+ "^migrationSource1([\\\\]?.*)$": "MigrationTest5$1",
+ "^Skypoint Cloud([\\\\]?.*)$": "MigrationTest5$1"
+ }
+ },
+ "ReplicateAllExistingNodes": "True",
+ "ShouldCreateMissingRevisionPaths": "True"
+ }
+ }
+ }
+ }
+ sampleFor: MigrationTools.Tools.TfsNodeStructureToolOptions
+- name: classic
+ description:
+ code: >-
+ {
+ "$type": "TfsNodeStructureToolOptions",
"Enabled": true,
- "NodeBasePaths": null,
- "AreaMaps": {
- "$type": "Dictionary`2"
+ "Areas": {
+ "Filters": [
+ "*\\Team 1,*\\Team 1\\**"
+ ],
+ "Mappings": {
+ "^7473924d-c47f-4089-8f5c-077c728b576e([\\\\]?.*)$": "MigrationTest5$1",
+ "^migrationSource1([\\\\]?.*)$": "MigrationTest5$1",
+ "^Skypoint Cloud([\\\\]?.*)$": "MigrationTest5$1"
+ }
},
- "IterationMaps": {
- "$type": "Dictionary`2"
+ "Iterations": {
+ "Filters": [
+ "*\\Sprint*",
+ "*\\Sprint*\\**"
+ ],
+ "Mappings": {
+ "^7473924d-c47f-4089-8f5c-077c728b576e([\\\\]?.*)$": "MigrationTest5$1",
+ "^migrationSource1([\\\\]?.*)$": "MigrationTest5$1",
+ "^Skypoint Cloud([\\\\]?.*)$": "MigrationTest5$1"
+ }
},
"ShouldCreateMissingRevisionPaths": true,
- "ReplicateAllExistingNodes": false
+ "ReplicateAllExistingNodes": true
}
- sampleFor: MigrationTools.Enrichers.TfsNodeStructureOptions
-description: The TfsNodeStructureEnricher is used to create missing nodes in the target project. To configure it add a `TfsNodeStructureOptions` section to `CommonEnrichersConfig` in the config file. Otherwise defaults will be applied.
-className: TfsNodeStructure
-typeName: ProcessorEnrichers
-architecture: v2
+ sampleFor: MigrationTools.Tools.TfsNodeStructureToolOptions
+description: The TfsNodeStructureToolEnricher is used to create missing nodes in the target project. To configure it add a `TfsNodeStructureToolOptions` section to `CommonEnrichersConfig` in the config file. Otherwise defaults will be applied.
+className: TfsNodeStructureTool
+typeName: Tools
+architecture:
options:
-- parameterName: AreaMaps
- type: Dictionary
- description: Remapping rules for area paths, implemented with regular expressions. The rules apply with a higher priority than the `PrefixProjectToNodes`, that is, if no rule matches the path and the `PrefixProjectToNodes` option is enabled, then the old `PrefixProjectToNodes` behavior is applied.
- defaultValue: '{}'
+- parameterName: Areas
+ type: NodeOptions
+ description: 'Rules to apply to the Area Path. Is an object of NodeOptions e.g. { "Filters": ["*/**"], "Mappings": { "^oldProjectName([\\\\]?.*)$": "targetProjectA$1", } }'
+ defaultValue: '{"Filters": [], "Mappings": { "^migrationSource1([\\\\]?.*)$": "MigrationTest5$1" })'
- parameterName: Enabled
type: Boolean
- description: If enabled this will run this migrator
- defaultValue: true
-- parameterName: IterationMaps
- type: Dictionary
- description: Remapping rules for iteration paths, implemented with regular expressions. The rules apply with a higher priority than the `PrefixProjectToNodes`, that is, if no rule matches the path and the `PrefixProjectToNodes` option is enabled, then the old `PrefixProjectToNodes` behavior is applied.
- defaultValue: '{}'
-- parameterName: NodeBasePaths
- type: String[]
- description: The root paths of the Ares / Iterations you want migrate. See [NodeBasePath Configuration](#nodebasepath-configuration)
- defaultValue: '["/"]'
-- parameterName: RefName
- type: String
- description: For internal use
+ description: If set to `true` then the tool will run. Set to `false` and the processor will not run.
defaultValue: missng XML code comments
+- parameterName: Iterations
+ type: NodeOptions
+ description: 'Rules to apply to the Area Path. Is an object of NodeOptions e.g. { "Filters": ["*/**"], "Mappings": { "^oldProjectName([\\\\]?.*)$": "targetProjectA$1", } }'
+ defaultValue: '{"Filters": [], "Mappings": { "^migrationSource1([\\\\]?.*)$": "MigrationTest5$1" })'
- parameterName: ReplicateAllExistingNodes
type: Boolean
description: missng XML code comments
@@ -54,22 +119,23 @@ options:
defaultValue: missng XML code comments
status: missng XML code comments
processingTarget: missng XML code comments
-classFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/ProcessorEnrichers/TfsNodeStructure.cs
-optionsClassFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/ProcessorEnrichers/TfsNodeStructureOptions.cs
+classFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Tools/TfsNodeStructureTool.cs
+optionsClassFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Tools/TfsNodeStructureToolOptions.cs
-redirectFrom: []
+redirectFrom:
+- /Reference/Tools/TfsNodeStructureToolOptions/
layout: reference
toc: true
-permalink: /Reference/v2/ProcessorEnrichers/TfsNodeStructure/
-title: TfsNodeStructure
+permalink: /Reference/Tools/TfsNodeStructureTool/
+title: TfsNodeStructureTool
categories:
-- ProcessorEnrichers
-- v2
+- Tools
+-
topics:
- topic: notes
- path: /docs/Reference/v2/ProcessorEnrichers/TfsNodeStructure-notes.md
+ path: /docs/Reference/Tools/TfsNodeStructureTool-notes.md
exists: true
- markdown: >2-
+ markdown: >2+
@@ -359,7 +425,7 @@ topics:
```
- ## NodeBasePath Configuration
+ ## Filters
The `NodeBasePaths` entry allows the filtering of the nodes to be replicated on the target projects. To try to explain the correct usage let us assume that we have a source team project `SourceProj` with the following node structures
@@ -368,7 +434,8 @@ topics:
- SourceProj
- SourceProj\Team 1
- SourceProj\Team 2
- - SourceProj\Team 2\Sub-Area
+ - SourceProj\Team 2\Sub-Area 1
+ - SourceProj\Team 2\Sub-Area 2
- SourceProj\Team 3
- IterationPath
- SourceProj
@@ -386,43 +453,78 @@ topics:
| Intention | Migrate all areas and iterations and all Work Items
- | NodeBasePath | `[]`
+ | Filters | `[]`
- | Comment | The same AreaPath and Iteration Paths are created on the target as on the source. Hence, all migrated WI remain in their existing area and iteration paths
+ | Comment | The same AreaPath and Iteration Paths are created on the target as on the source. Hence, all migrated WI remain in their existing area and iteration paths.
This will be affected by the `AreaMaps` and `IterationMaps` settings.
||
| Intention | Only migrate area path `Team 2` and it associated Work Items, but all iteration paths
- | NodeBasePath | `["Team 2", "Sprint"]`
+ | NodeBasePath | `["*\\Team 2", "*\\Sprint*"]`
- | Comment | Only the area path ending `Team 2` will be migrated.
The `WIQLQueryBit` should be edited to limit the WI migrated to this area path e.g. add `AND [System.AreaPath] UNDER 'SampleProject\\Team 2'` .
The migrated WI will have an area path of `TargetProj\Team 2` but retain their iteration paths matching the sprint name on the source
+ | Comment | Only the area path ending `Team 2` will be migrated.
The `WIQLQuery` should be edited to limit the WI migrated to this area path e.g. add `AND [System.AreaPath] UNDER 'SampleProject\\Team 2'` .
The migrated WI will have an area path of `TargetProj\Team 2` but retain their iteration paths matching the sprint name on the source
||
- | Intention | Only migrate iterations structure
+ | Intention | Move the `Team 2` area, including its `Sub-Area`, and any others at the same level
- | NodeBasePath | `["Sprint"]`
+ | NodeBasePath | `["*\\Team 2", "Team 2\\*"]`
- | Comment | Only the area path ending `Team 2` will be migrated
All the iteration paths will be migrated.
The migrated WI will have the default area path of `TargetProj` as their source area path was not migrated i.e. `TargetProj`
The migrated WI will have an iteration path match the sprint name on the source
+ | Comment | The Work Items will have to be restricted to the right areas, e.g. with `AND [System.AreaPath] UNDER 'SampleProject\\Team 2' AND [System.AreaPath] NOT UNDER 'SampleProject\\Team 2\\Sub-Area'`, otherwise their migratin will fail
||
- | Intention | Move all WI to the existing area and iteration paths on the targetProj
+ | Intention | Move the `Team 2` area, but not its `Sub-Area`
- | NodeBasePath | `["DUMMY VALUE"]`
+ | NodeBasePath | `["*\\Team 2", "!Team 2\\SubArea"]`
- | Comment | As the `NodeBasePath` does not match any source area or iteration path no nodes are migrated.
Migrated WI will be assigned to any matching area or iteration paths. If no matching ones can be found they will default to the respective root values
+ | Comment | The Work Items will have to be restricted to the right areas, e.g. with `AND [System.AreaPath] UNDER 'SampleProject\\Team 2' AND [System.AreaPath] NOT UNDER 'SampleProject\\Team 2\\Sub-Area'`, otherwise their migratin will fail
- ||
- | Intention | Move the `Team 2` area, but not its `Sub-Area`
+ # Patterns
- | NodeBasePath | `["Team 2", "!Team 2\\SubArea"]`
- | Comment | The Work Items will have to be restricted to the right areas, e.g. with `AND [System.AreaPath] UNDER 'SampleProject\\Team 2' AND [System.AreaPath] NOT UNDER 'SampleProject\\Team 2\\Sub-Area'`, otherwise their migratin will fail
+ The following patterns are supported:
+
+ >
+
+ | Wildcard | Description | Example | Matches | Does not match |
+
+ | -------- | ----------- | ------- | ------- | -------------- |
+
+ | \* | matches any number of any characters including none | Law\*| Law, Laws, or Lawyer |
+
+ | ? | matches any single character | ?at | Cat, cat, Bat or bat | at |
+
+ | [abc] | matches one character given in the bracket | [CB]at | Cat or Bat | cat or bat |
+
+ | [a-z] | matches one character from the range given in the bracket | Letter[0-9] | Letter0, Letter1, Letter2 up to Letter9 | Letters, Letter or Letter10 |
+
+ | [!abc] | matches one character that is not given in the bracket | [!C]at | Bat, bat, or cat | Cat |
+
+ | [!a-z] | matches one character that is not from the range given in the bracket | Letter[!3-5] | Letter1, Letter2, Letter6 up to Letter9 and Letterx etc. | Letter3, Letter4, Letter5 or Letterxx |
+
+
+ In addition, Glob also supports:
+
+
+ | Wildcard | Description | Example | Matches | Does not match |
+
+ | -------- | ----------- | ------- | ------- | -------------- |
+
+ | `**` | matches any number of path / directory segments. When used must be the only contents of a segment. | /\*\*/some.\* | /foo/bar/bah/some.txt, /some.txt, or /foo/some.txt |
+
+
+
+ # Escaping special characters
+
+
+ Wrap special characters `?, *, [` in square brackets in order to escape them.
+
+ You can also use negation when doing this.
- topic: introduction
- path: /docs/Reference/v2/ProcessorEnrichers/TfsNodeStructure-introduction.md
+ path: /docs/Reference/Tools/TfsNodeStructureTool-introduction.md
exists: true
markdown: ''
diff --git a/docs/collections/_reference/reference.tools.tfsrevisionmanagertool.md b/docs/collections/_reference/reference.tools.tfsrevisionmanagertool.md
new file mode 100644
index 000000000..59325f82e
--- /dev/null
+++ b/docs/collections/_reference/reference.tools.tfsrevisionmanagertool.md
@@ -0,0 +1,86 @@
+---
+optionsClassName: TfsRevisionManagerToolOptions
+optionsClassFullName: MigrationTools.Tools.TfsRevisionManagerToolOptions
+configurationSamples:
+- name: defaults
+ description:
+ code: >-
+ {
+ "MigrationTools": {
+ "CommonTools": {
+ "TfsRevisionManagerTool": {
+ "Enabled": "True",
+ "MaxRevisions": "0",
+ "ReplayRevisions": "True"
+ }
+ }
+ }
+ }
+ sampleFor: MigrationTools.Tools.TfsRevisionManagerToolOptions
+- name: sample
+ description:
+ code: >-
+ {
+ "MigrationTools": {
+ "CommonTools": {
+ "TfsRevisionManagerTool": {
+ "Enabled": "True",
+ "MaxRevisions": "0",
+ "ReplayRevisions": "True"
+ }
+ }
+ }
+ }
+ sampleFor: MigrationTools.Tools.TfsRevisionManagerToolOptions
+- name: classic
+ description:
+ code: >-
+ {
+ "$type": "TfsRevisionManagerToolOptions",
+ "Enabled": true,
+ "ReplayRevisions": true,
+ "MaxRevisions": 0
+ }
+ sampleFor: MigrationTools.Tools.TfsRevisionManagerToolOptions
+description: The TfsRevisionManagerTool manipulates the revisions of a work item to reduce the number of revisions that are migrated.
+className: TfsRevisionManagerTool
+typeName: Tools
+architecture:
+options:
+- parameterName: Enabled
+ type: Boolean
+ description: If set to `true` then the tool will run. Set to `false` and the processor will not run.
+ defaultValue: missng XML code comments
+- parameterName: MaxRevisions
+ type: Int32
+ description: Sets the maximum number of revisions that will be migrated. "First + Last N = Max". If this was set to 5 and there were 10 revisions you would get the first 1 (creation) and the latest 4 migrated.
+ defaultValue: 0
+- parameterName: ReplayRevisions
+ type: Boolean
+ description: You can choose to migrate the tip only (a single write) or all of the revisions (many writes). If you are setting this to `false` to migrate only the tip then you should set `BuildFieldTable` to `true`.
+ defaultValue: true
+status: missng XML code comments
+processingTarget: missng XML code comments
+classFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Tools/TfsRevisionManagerTool.cs
+optionsClassFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Tools/TfsRevisionManagerToolOptions.cs
+
+redirectFrom:
+- /Reference/Tools/TfsRevisionManagerToolOptions/
+layout: reference
+toc: true
+permalink: /Reference/Tools/TfsRevisionManagerTool/
+title: TfsRevisionManagerTool
+categories:
+- Tools
+-
+topics:
+- topic: notes
+ path: /docs/Reference/Tools/TfsRevisionManagerTool-notes.md
+ exists: false
+ markdown: ''
+- topic: introduction
+ path: /docs/Reference/Tools/TfsRevisionManagerTool-introduction.md
+ exists: false
+ markdown: ''
+
+---
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.tools.tfsteamsettingstool.md b/docs/collections/_reference/reference.tools.tfsteamsettingstool.md
new file mode 100644
index 000000000..cd05b25bb
--- /dev/null
+++ b/docs/collections/_reference/reference.tools.tfsteamsettingstool.md
@@ -0,0 +1,106 @@
+---
+optionsClassName: TfsTeamSettingsToolOptions
+optionsClassFullName: MigrationTools.Tools.TfsTeamSettingsToolOptions
+configurationSamples:
+- name: defaults
+ description:
+ code: >-
+ {
+ "MigrationTools": {
+ "CommonTools": {
+ "TfsTeamSettingsTool": {
+ "Enabled": "True",
+ "MigrateTeamCapacities": "True",
+ "MigrateTeamSettings": "True",
+ "Teams": null,
+ "UpdateTeamSettings": "True"
+ }
+ }
+ }
+ }
+ sampleFor: MigrationTools.Tools.TfsTeamSettingsToolOptions
+- name: sample
+ description:
+ code: >-
+ {
+ "MigrationTools": {
+ "CommonTools": {
+ "TfsTeamSettingsTool": {
+ "Enabled": "True",
+ "MigrateTeamCapacities": "True",
+ "MigrateTeamSettings": "True",
+ "Teams": [
+ "Team 1",
+ "Team 2"
+ ],
+ "UpdateTeamSettings": "True"
+ }
+ }
+ }
+ }
+ sampleFor: MigrationTools.Tools.TfsTeamSettingsToolOptions
+- name: classic
+ description:
+ code: >-
+ {
+ "$type": "TfsTeamSettingsToolOptions",
+ "Enabled": true,
+ "MigrateTeamSettings": true,
+ "UpdateTeamSettings": true,
+ "MigrateTeamCapacities": true,
+ "Teams": [
+ "Team 1",
+ "Team 2"
+ ]
+ }
+ sampleFor: MigrationTools.Tools.TfsTeamSettingsToolOptions
+description: The TfsUserMappingTool is used to map users from the source to the target system. Run it with the ExportUsersForMappingContext to create a mapping file then with WorkItemMigrationContext to use the mapping file to update the users in the target system as you migrate the work items.
+className: TfsTeamSettingsTool
+typeName: Tools
+architecture:
+options:
+- parameterName: Enabled
+ type: Boolean
+ description: If set to `true` then the tool will run. Set to `false` and the processor will not run.
+ defaultValue: missng XML code comments
+- parameterName: MigrateTeamCapacities
+ type: Boolean
+ description: 'Migrate original team member capacities after their creation on the target team project. Note: It will only migrate team member capacity if the team member with same display name exists on the target collection otherwise it will be ignored.'
+ defaultValue: false
+- parameterName: MigrateTeamSettings
+ type: Boolean
+ description: Migrate original team settings after their creation on target team project
+ defaultValue: false
+- parameterName: Teams
+ type: List
+ description: List of Teams to process. If this is `null` then all teams will be processed.
+ defaultValue: missng XML code comments
+- parameterName: UpdateTeamSettings
+ type: Boolean
+ description: Reset the target team settings to match the source if the team exists
+ defaultValue: false
+status: missng XML code comments
+processingTarget: missng XML code comments
+classFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Tools/TfsTeamSettingsTool.cs
+optionsClassFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Tools/TfsTeamSettingsToolOptions.cs
+
+redirectFrom:
+- /Reference/Tools/TfsTeamSettingsToolOptions/
+layout: reference
+toc: true
+permalink: /Reference/Tools/TfsTeamSettingsTool/
+title: TfsTeamSettingsTool
+categories:
+- Tools
+-
+topics:
+- topic: notes
+ path: /docs/Reference/Tools/TfsTeamSettingsTool-notes.md
+ exists: false
+ markdown: ''
+- topic: introduction
+ path: /docs/Reference/Tools/TfsTeamSettingsTool-introduction.md
+ exists: false
+ markdown: ''
+
+---
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.tools.tfsusermappingtool.md b/docs/collections/_reference/reference.tools.tfsusermappingtool.md
new file mode 100644
index 000000000..44c0a8769
--- /dev/null
+++ b/docs/collections/_reference/reference.tools.tfsusermappingtool.md
@@ -0,0 +1,113 @@
+---
+optionsClassName: TfsUserMappingToolOptions
+optionsClassFullName: MigrationTools.Tools.TfsUserMappingToolOptions
+configurationSamples:
+- name: defaults
+ description:
+ code: >-
+ {
+ "MigrationTools": {
+ "CommonTools": {
+ "TfsUserMappingTool": {
+ "Enabled": "False",
+ "IdentityFieldsToCheck": [
+ "System.AssignedTo",
+ "System.ChangedBy",
+ "System.CreatedBy",
+ "Microsoft.VSTS.Common.ActivatedBy",
+ "Microsoft.VSTS.Common.ResolvedBy",
+ "Microsoft.VSTS.Common.ClosedBy"
+ ],
+ "UserMappingFile": "C:\\temp\\userExport.json"
+ }
+ }
+ }
+ }
+ sampleFor: MigrationTools.Tools.TfsUserMappingToolOptions
+- name: sample
+ description:
+ code: >-
+ {
+ "MigrationTools": {
+ "CommonTools": {
+ "TfsUserMappingTool": {
+ "Enabled": "True",
+ "IdentityFieldsToCheck": [
+ "System.AssignedTo",
+ "System.ChangedBy",
+ "System.CreatedBy",
+ "Microsoft.VSTS.Common.ActivatedBy",
+ "Microsoft.VSTS.Common.ResolvedBy",
+ "Microsoft.VSTS.Common.ClosedBy"
+ ],
+ "UserMappingFile": "C:\\temp\\userExport.json"
+ }
+ }
+ }
+ }
+ sampleFor: MigrationTools.Tools.TfsUserMappingToolOptions
+- name: classic
+ description:
+ code: >-
+ {
+ "$type": "TfsUserMappingToolOptions",
+ "Enabled": true,
+ "IdentityFieldsToCheck": [
+ "System.AssignedTo",
+ "System.ChangedBy",
+ "System.CreatedBy",
+ "Microsoft.VSTS.Common.ActivatedBy",
+ "Microsoft.VSTS.Common.ResolvedBy",
+ "Microsoft.VSTS.Common.ClosedBy",
+ "System.AssignedTo",
+ "System.ChangedBy",
+ "System.CreatedBy",
+ "Microsoft.VSTS.Common.ActivatedBy",
+ "Microsoft.VSTS.Common.ResolvedBy",
+ "Microsoft.VSTS.Common.ClosedBy"
+ ],
+ "UserMappingFile": "C:\\temp\\userExport.json"
+ }
+ sampleFor: MigrationTools.Tools.TfsUserMappingToolOptions
+description: The TfsUserMappingTool is used to map users from the source to the target system. Run it with the ExportUsersForMappingContext to create a mapping file then with WorkItemMigrationContext to use the mapping file to update the users in the target system as you migrate the work items.
+className: TfsUserMappingTool
+typeName: Tools
+architecture:
+options:
+- parameterName: Enabled
+ type: Boolean
+ description: If set to `true` then the tool will run. Set to `false` and the processor will not run.
+ defaultValue: missng XML code comments
+- parameterName: IdentityFieldsToCheck
+ type: List
+ description: This is a list of the Identiy fields in the Source to check for user mapping purposes. You should list all identiy fields that you wan to map.
+ defaultValue: missng XML code comments
+- parameterName: UserMappingFile
+ type: String
+ description: This is the file that will be used to export or import the user mappings. Use the ExportUsersForMapping processor to create the file.
+ defaultValue: missng XML code comments
+status: missng XML code comments
+processingTarget: missng XML code comments
+classFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Tools/TfsUserMappingTool.cs
+optionsClassFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Tools/TfsUserMappingToolOptions.cs
+
+redirectFrom:
+- /Reference/Tools/TfsUserMappingToolOptions/
+layout: reference
+toc: true
+permalink: /Reference/Tools/TfsUserMappingTool/
+title: TfsUserMappingTool
+categories:
+- Tools
+-
+topics:
+- topic: notes
+ path: /docs/Reference/Tools/TfsUserMappingTool-notes.md
+ exists: false
+ markdown: ''
+- topic: introduction
+ path: /docs/Reference/Tools/TfsUserMappingTool-introduction.md
+ exists: false
+ markdown: ''
+
+---
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.tools.tfsvalidaterequiredfieldtool.md b/docs/collections/_reference/reference.tools.tfsvalidaterequiredfieldtool.md
new file mode 100644
index 000000000..af74f1210
--- /dev/null
+++ b/docs/collections/_reference/reference.tools.tfsvalidaterequiredfieldtool.md
@@ -0,0 +1,54 @@
+---
+optionsClassName: TfsValidateRequiredFieldToolOptions
+optionsClassFullName: MigrationTools.Tools.TfsValidateRequiredFieldToolOptions
+configurationSamples:
+- name: defaults
+ description:
+ code: There are no defaults! Check the sample for options!
+ sampleFor: MigrationTools.Tools.TfsValidateRequiredFieldToolOptions
+- name: sample
+ description:
+ code: There is no sample, but you can check the classic below for a general feel.
+ sampleFor: MigrationTools.Tools.TfsValidateRequiredFieldToolOptions
+- name: classic
+ description:
+ code: >-
+ {
+ "$type": "TfsValidateRequiredFieldToolOptions",
+ "Enabled": false
+ }
+ sampleFor: MigrationTools.Tools.TfsValidateRequiredFieldToolOptions
+description: missng XML code comments
+className: TfsValidateRequiredFieldTool
+typeName: Tools
+architecture:
+options:
+- parameterName: Enabled
+ type: Boolean
+ description: If set to `true` then the tool will run. Set to `false` and the processor will not run.
+ defaultValue: missng XML code comments
+status: missng XML code comments
+processingTarget: missng XML code comments
+classFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Tools/TfsValidateRequiredFieldTool.cs
+optionsClassFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Tools/TfsValidateRequiredFieldToolOptions.cs
+
+redirectFrom:
+- /Reference/Tools/TfsValidateRequiredFieldToolOptions/
+layout: reference
+toc: true
+permalink: /Reference/Tools/TfsValidateRequiredFieldTool/
+title: TfsValidateRequiredFieldTool
+categories:
+- Tools
+-
+topics:
+- topic: notes
+ path: /docs/Reference/Tools/TfsValidateRequiredFieldTool-notes.md
+ exists: false
+ markdown: ''
+- topic: introduction
+ path: /docs/Reference/Tools/TfsValidateRequiredFieldTool-introduction.md
+ exists: false
+ markdown: ''
+
+---
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.tools.tfsworkitemembededlinktool.md b/docs/collections/_reference/reference.tools.tfsworkitemembededlinktool.md
new file mode 100644
index 000000000..e8c081b68
--- /dev/null
+++ b/docs/collections/_reference/reference.tools.tfsworkitemembededlinktool.md
@@ -0,0 +1,72 @@
+---
+optionsClassName: TfsWorkItemEmbededLinkToolOptions
+optionsClassFullName: MigrationTools.Tools.TfsWorkItemEmbededLinkToolOptions
+configurationSamples:
+- name: defaults
+ description:
+ code: >-
+ {
+ "MigrationTools": {
+ "CommonTools": {
+ "TfsWorkItemEmbededLinkTool": {
+ "Enabled": "True"
+ }
+ }
+ }
+ }
+ sampleFor: MigrationTools.Tools.TfsWorkItemEmbededLinkToolOptions
+- name: sample
+ description:
+ code: >-
+ {
+ "MigrationTools": {
+ "CommonTools": {
+ "TfsWorkItemEmbededLinkTool": {
+ "Enabled": "True"
+ }
+ }
+ }
+ }
+ sampleFor: MigrationTools.Tools.TfsWorkItemEmbededLinkToolOptions
+- name: classic
+ description:
+ code: >-
+ {
+ "$type": "TfsWorkItemEmbededLinkToolOptions",
+ "Enabled": true
+ }
+ sampleFor: MigrationTools.Tools.TfsWorkItemEmbededLinkToolOptions
+description: missng XML code comments
+className: TfsWorkItemEmbededLinkTool
+typeName: Tools
+architecture:
+options:
+- parameterName: Enabled
+ type: Boolean
+ description: If set to `true` then the tool will run. Set to `false` and the processor will not run.
+ defaultValue: missng XML code comments
+status: missng XML code comments
+processingTarget: missng XML code comments
+classFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Tools/TfsWorkItemEmbededLinkTool.cs
+optionsClassFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Tools/TfsWorkItemEmbededLinkToolOptions.cs
+
+redirectFrom:
+- /Reference/Tools/TfsWorkItemEmbededLinkToolOptions/
+layout: reference
+toc: true
+permalink: /Reference/Tools/TfsWorkItemEmbededLinkTool/
+title: TfsWorkItemEmbededLinkTool
+categories:
+- Tools
+-
+topics:
+- topic: notes
+ path: /docs/Reference/Tools/TfsWorkItemEmbededLinkTool-notes.md
+ exists: false
+ markdown: ''
+- topic: introduction
+ path: /docs/Reference/Tools/TfsWorkItemEmbededLinkTool-introduction.md
+ exists: false
+ markdown: ''
+
+---
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.tools.tfsworkitemlinktool.md b/docs/collections/_reference/reference.tools.tfsworkitemlinktool.md
new file mode 100644
index 000000000..de4c5058d
--- /dev/null
+++ b/docs/collections/_reference/reference.tools.tfsworkitemlinktool.md
@@ -0,0 +1,86 @@
+---
+optionsClassName: TfsWorkItemLinkToolOptions
+optionsClassFullName: MigrationTools.Tools.TfsWorkItemLinkToolOptions
+configurationSamples:
+- name: defaults
+ description:
+ code: >-
+ {
+ "MigrationTools": {
+ "CommonTools": {
+ "TfsWorkItemLinkTool": {
+ "Enabled": "True",
+ "FilterIfLinkCountMatches": "True",
+ "SaveAfterEachLinkIsAdded": "False"
+ }
+ }
+ }
+ }
+ sampleFor: MigrationTools.Tools.TfsWorkItemLinkToolOptions
+- name: sample
+ description:
+ code: >-
+ {
+ "MigrationTools": {
+ "CommonTools": {
+ "TfsWorkItemLinkTool": {
+ "Enabled": "True",
+ "FilterIfLinkCountMatches": "True",
+ "SaveAfterEachLinkIsAdded": "False"
+ }
+ }
+ }
+ }
+ sampleFor: MigrationTools.Tools.TfsWorkItemLinkToolOptions
+- name: classic
+ description:
+ code: >-
+ {
+ "$type": "TfsWorkItemLinkToolOptions",
+ "Enabled": true,
+ "FilterIfLinkCountMatches": true,
+ "SaveAfterEachLinkIsAdded": false
+ }
+ sampleFor: MigrationTools.Tools.TfsWorkItemLinkToolOptions
+description: missng XML code comments
+className: TfsWorkItemLinkTool
+typeName: Tools
+architecture:
+options:
+- parameterName: Enabled
+ type: Boolean
+ description: If set to `true` then the tool will run. Set to `false` and the processor will not run.
+ defaultValue: missng XML code comments
+- parameterName: FilterIfLinkCountMatches
+ type: Boolean
+ description: Skip validating links if the number of links in the source and the target matches!
+ defaultValue: missng XML code comments
+- parameterName: SaveAfterEachLinkIsAdded
+ type: Boolean
+ description: Save the work item after each link is added. This will slow the migration as it will cause many saves to the TFS database.
+ defaultValue: false
+status: missng XML code comments
+processingTarget: missng XML code comments
+classFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Tools/TfsWorkItemLinkTool.cs
+optionsClassFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Tools/TfsWorkItemLinkToolOptions.cs
+
+redirectFrom:
+- /Reference/Tools/TfsWorkItemLinkToolOptions/
+layout: reference
+toc: true
+permalink: /Reference/Tools/TfsWorkItemLinkTool/
+title: TfsWorkItemLinkTool
+categories:
+- Tools
+-
+topics:
+- topic: notes
+ path: /docs/Reference/Tools/TfsWorkItemLinkTool-notes.md
+ exists: false
+ markdown: ''
+- topic: introduction
+ path: /docs/Reference/Tools/TfsWorkItemLinkTool-introduction.md
+ exists: false
+ markdown: ''
+
+---
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.tools.workitemtypemappingtool.md b/docs/collections/_reference/reference.tools.workitemtypemappingtool.md
new file mode 100644
index 000000000..a4cce1271
--- /dev/null
+++ b/docs/collections/_reference/reference.tools.workitemtypemappingtool.md
@@ -0,0 +1,86 @@
+---
+optionsClassName: WorkItemTypeMappingToolOptions
+optionsClassFullName: MigrationTools.Tools.WorkItemTypeMappingToolOptions
+configurationSamples:
+- name: defaults
+ description:
+ code: >-
+ {
+ "MigrationTools": {
+ "CommonTools": {
+ "WorkItemTypeMappingTool": {
+ "Enabled": "False",
+ "Mappings": {
+ "Source Work Item Type Name": "Target Work Item Type Name"
+ }
+ }
+ }
+ }
+ }
+ sampleFor: MigrationTools.Tools.WorkItemTypeMappingToolOptions
+- name: sample
+ description:
+ code: >-
+ {
+ "MigrationTools": {
+ "CommonTools": {
+ "WorkItemTypeMappingTool": {
+ "Enabled": "True",
+ "Mappings": {
+ "User Story": "Product Backlog Item"
+ }
+ }
+ }
+ }
+ }
+ sampleFor: MigrationTools.Tools.WorkItemTypeMappingToolOptions
+- name: classic
+ description:
+ code: >-
+ {
+ "$type": "WorkItemTypeMappingToolOptions",
+ "Enabled": true,
+ "Mappings": {
+ "Source Work Item Type Name": "Target Work Item Type Name",
+ "User Story": "Product Backlog Item"
+ }
+ }
+ sampleFor: MigrationTools.Tools.WorkItemTypeMappingToolOptions
+description: Used to process the String fields of a work item. This is useful for cleaning up data. It will limit fields to a max length and apply regex replacements based on what is configured. Each regex replacement is applied in order and can be enabled or disabled.
+className: WorkItemTypeMappingTool
+typeName: Tools
+architecture:
+options:
+- parameterName: Enabled
+ type: Boolean
+ description: If set to `true` then the tool will run. Set to `false` and the processor will not run.
+ defaultValue: missng XML code comments
+- parameterName: Mappings
+ type: Dictionary
+ description: List of work item mappings.
+ defaultValue: '{}'
+status: missng XML code comments
+processingTarget: missng XML code comments
+classFile: /src/MigrationTools/Tools/WorkItemTypeMappingTool.cs
+optionsClassFile: /src/MigrationTools/Tools/WorkItemTypeMappingToolOptions.cs
+
+redirectFrom:
+- /Reference/Tools/WorkItemTypeMappingToolOptions/
+layout: reference
+toc: true
+permalink: /Reference/Tools/WorkItemTypeMappingTool/
+title: WorkItemTypeMappingTool
+categories:
+- Tools
+-
+topics:
+- topic: notes
+ path: /docs/Reference/Tools/WorkItemTypeMappingTool-notes.md
+ exists: false
+ markdown: ''
+- topic: introduction
+ path: /docs/Reference/Tools/WorkItemTypeMappingTool-introduction.md
+ exists: false
+ markdown: ''
+
+---
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.v1.fieldmaps.fieldclearmapconfig.md b/docs/collections/_reference/reference.v1.fieldmaps.fieldclearmapconfig.md
deleted file mode 100644
index a48bea5ec..000000000
--- a/docs/collections/_reference/reference.v1.fieldmaps.fieldclearmapconfig.md
+++ /dev/null
@@ -1,50 +0,0 @@
----
-optionsClassName: FieldClearMapConfig
-optionsClassFullName: MigrationTools._EngineV1.Configuration.FieldMap.FieldClearMapConfig
-configurationSamples:
-- name: default
- description:
- code: >-
- {
- "$type": "FieldClearMapConfig",
- "WorkItemTypeName": "*",
- "targetField": "System.Description"
- }
- sampleFor: MigrationTools._EngineV1.Configuration.FieldMap.FieldClearMapConfig
-description: Allows you to set an already populated field to Null. This will only work with fields that support null.
-className: FieldClearMapConfig
-typeName: FieldMaps
-architecture: v1
-options:
-- parameterName: targetField
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: WorkItemTypeName
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-status: ready
-processingTarget: Work Item
-classFile: /src/MigrationTools/_EngineV1/Configuration/FieldMap/FieldClearMapConfig.cs
-optionsClassFile: /src/MigrationTools/_EngineV1/Configuration/FieldMap/FieldClearMapConfig.cs
-
-redirectFrom: []
-layout: reference
-toc: true
-permalink: /Reference/v1/FieldMaps/FieldClearMapConfig/
-title: FieldClearMapConfig
-categories:
-- FieldMaps
-- v1
-topics:
-- topic: notes
- path: /docs/Reference/v1/FieldMaps/FieldClearMapConfig-notes.md
- exists: false
- markdown: ''
-- topic: introduction
- path: /docs/Reference/v1/FieldMaps/FieldClearMapConfig-introduction.md
- exists: false
- markdown: ''
-
----
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.v1.fieldmaps.fieldliteralmapconfig.md b/docs/collections/_reference/reference.v1.fieldmaps.fieldliteralmapconfig.md
deleted file mode 100644
index c55e2ec48..000000000
--- a/docs/collections/_reference/reference.v1.fieldmaps.fieldliteralmapconfig.md
+++ /dev/null
@@ -1,55 +0,0 @@
----
-optionsClassName: FieldLiteralMapConfig
-optionsClassFullName: MigrationTools._EngineV1.Configuration.FieldMap.FieldLiteralMapConfig
-configurationSamples:
-- name: default
- description:
- code: >-
- {
- "$type": "FieldLiteralMapConfig",
- "WorkItemTypeName": "*",
- "targetField": "System.Status",
- "value": "New"
- }
- sampleFor: MigrationTools._EngineV1.Configuration.FieldMap.FieldLiteralMapConfig
-description: Sets a field on the `target` to b a specific value.
-className: FieldLiteralMapConfig
-typeName: FieldMaps
-architecture: v1
-options:
-- parameterName: targetField
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: value
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: WorkItemTypeName
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-status: ready
-processingTarget: Work Item Field
-classFile: /src/MigrationTools/_EngineV1/Configuration/FieldMap/FieldLiteralMapConfig.cs
-optionsClassFile: /src/MigrationTools/_EngineV1/Configuration/FieldMap/FieldLiteralMapConfig.cs
-
-redirectFrom: []
-layout: reference
-toc: true
-permalink: /Reference/v1/FieldMaps/FieldLiteralMapConfig/
-title: FieldLiteralMapConfig
-categories:
-- FieldMaps
-- v1
-topics:
-- topic: notes
- path: /docs/Reference/v1/FieldMaps/FieldLiteralMapConfig-notes.md
- exists: false
- markdown: ''
-- topic: introduction
- path: /docs/Reference/v1/FieldMaps/FieldLiteralMapConfig-introduction.md
- exists: false
- markdown: ''
-
----
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.v1.fieldmaps.fieldmergemapconfig.md b/docs/collections/_reference/reference.v1.fieldmaps.fieldmergemapconfig.md
deleted file mode 100644
index 00420ddd8..000000000
--- a/docs/collections/_reference/reference.v1.fieldmaps.fieldmergemapconfig.md
+++ /dev/null
@@ -1,63 +0,0 @@
----
-optionsClassName: FieldMergeMapConfig
-optionsClassFullName: MigrationTools._EngineV1.Configuration.FieldMap.FieldMergeMapConfig
-configurationSamples:
-- name: default
- description:
- code: >-
- {
- "$type": "FieldMergeMapConfig",
- "WorkItemTypeName": "*",
- "sourceFields": [
- "System.Description",
- "System.Status"
- ],
- "targetField": "System.Description",
- "formatExpression": "{0} \n {1}"
- }
- sampleFor: MigrationTools._EngineV1.Configuration.FieldMap.FieldMergeMapConfig
-description: Ever wanted to merge two or three fields? This mapping will let you do just that.
-className: FieldMergeMapConfig
-typeName: FieldMaps
-architecture: v1
-options:
-- parameterName: formatExpression
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: sourceFields
- type: List
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: targetField
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: WorkItemTypeName
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-status: ready
-processingTarget: Work Item Field
-classFile: /src/MigrationTools/_EngineV1/Configuration/FieldMap/FieldMergeMapConfig.cs
-optionsClassFile: /src/MigrationTools/_EngineV1/Configuration/FieldMap/FieldMergeMapConfig.cs
-
-redirectFrom: []
-layout: reference
-toc: true
-permalink: /Reference/v1/FieldMaps/FieldMergeMapConfig/
-title: FieldMergeMapConfig
-categories:
-- FieldMaps
-- v1
-topics:
-- topic: notes
- path: /docs/Reference/v1/FieldMaps/FieldMergeMapConfig-notes.md
- exists: false
- markdown: ''
-- topic: introduction
- path: /docs/Reference/v1/FieldMaps/FieldMergeMapConfig-introduction.md
- exists: false
- markdown: ''
-
----
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.v1.fieldmaps.fieldskipmapconfig.md b/docs/collections/_reference/reference.v1.fieldmaps.fieldskipmapconfig.md
deleted file mode 100644
index d13204589..000000000
--- a/docs/collections/_reference/reference.v1.fieldmaps.fieldskipmapconfig.md
+++ /dev/null
@@ -1,50 +0,0 @@
----
-optionsClassName: FieldSkipMapConfig
-optionsClassFullName: MigrationTools._EngineV1.Configuration.FieldMap.FieldSkipMapConfig
-configurationSamples:
-- name: default
- description:
- code: >-
- {
- "$type": "FieldSkipMapConfig",
- "WorkItemTypeName": "*",
- "targetField": "System.Description"
- }
- sampleFor: MigrationTools._EngineV1.Configuration.FieldMap.FieldSkipMapConfig
-description: Allows you to skip populating an existing field. Value in target with be reset to its OriginalValue.
-className: FieldSkipMapConfig
-typeName: FieldMaps
-architecture: v1
-options:
-- parameterName: targetField
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: WorkItemTypeName
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-status: ready
-processingTarget: Work Item
-classFile: /src/MigrationTools/_EngineV1/Configuration/FieldMap/FieldSkipMapConfig.cs
-optionsClassFile: /src/MigrationTools/_EngineV1/Configuration/FieldMap/FieldSkipMapConfig.cs
-
-redirectFrom: []
-layout: reference
-toc: true
-permalink: /Reference/v1/FieldMaps/FieldSkipMapConfig/
-title: FieldSkipMapConfig
-categories:
-- FieldMaps
-- v1
-topics:
-- topic: notes
- path: /docs/Reference/v1/FieldMaps/FieldSkipMapConfig-notes.md
- exists: false
- markdown: ''
-- topic: introduction
- path: /docs/Reference/v1/FieldMaps/FieldSkipMapConfig-introduction.md
- exists: false
- markdown: ''
-
----
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.v1.fieldmaps.fieldtofieldmapconfig.md b/docs/collections/_reference/reference.v1.fieldmaps.fieldtofieldmapconfig.md
deleted file mode 100644
index 411d1a07f..000000000
--- a/docs/collections/_reference/reference.v1.fieldmaps.fieldtofieldmapconfig.md
+++ /dev/null
@@ -1,60 +0,0 @@
----
-optionsClassName: FieldtoFieldMapConfig
-optionsClassFullName: MigrationTools._EngineV1.Configuration.FieldMap.FieldtoFieldMapConfig
-configurationSamples:
-- name: default
- description:
- code: >-
- {
- "$type": "FieldtoFieldMapConfig",
- "WorkItemTypeName": "*",
- "sourceField": "System.StackRank",
- "targetField": "System.Rank",
- "defaultValue": "1000"
- }
- sampleFor: MigrationTools._EngineV1.Configuration.FieldMap.FieldtoFieldMapConfig
-description: Just want to map one field to another? This is the one for you.
-className: FieldtoFieldMapConfig
-typeName: FieldMaps
-architecture: v1
-options:
-- parameterName: defaultValue
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: sourceField
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: targetField
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: WorkItemTypeName
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-status: ready
-processingTarget: Work Item Field
-classFile: /src/MigrationTools/_EngineV1/Configuration/FieldMap/FieldtoFieldMapConfig.cs
-optionsClassFile: /src/MigrationTools/_EngineV1/Configuration/FieldMap/FieldtoFieldMapConfig.cs
-
-redirectFrom: []
-layout: reference
-toc: true
-permalink: /Reference/v1/FieldMaps/FieldtoFieldMapConfig/
-title: FieldtoFieldMapConfig
-categories:
-- FieldMaps
-- v1
-topics:
-- topic: notes
- path: /docs/Reference/v1/FieldMaps/FieldtoFieldMapConfig-notes.md
- exists: false
- markdown: ''
-- topic: introduction
- path: /docs/Reference/v1/FieldMaps/FieldtoFieldMapConfig-introduction.md
- exists: false
- markdown: ''
-
----
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.v1.fieldmaps.fieldtofieldmultimapconfig.md b/docs/collections/_reference/reference.v1.fieldmaps.fieldtofieldmultimapconfig.md
deleted file mode 100644
index de871ed6f..000000000
--- a/docs/collections/_reference/reference.v1.fieldmaps.fieldtofieldmultimapconfig.md
+++ /dev/null
@@ -1,55 +0,0 @@
----
-optionsClassName: FieldtoFieldMultiMapConfig
-optionsClassFullName: MigrationTools._EngineV1.Configuration.FieldMap.FieldtoFieldMultiMapConfig
-configurationSamples:
-- name: default
- description:
- code: >-
- {
- "$type": "FieldtoFieldMultiMapConfig",
- "WorkItemTypeName": "*",
- "SourceToTargetMappings": {
- "$type": "Dictionary`2",
- "Custom.Field1": "Custom.Field4",
- "Custom.Field2": "Custom.Field5",
- "Custom.Field3": "Custom.Field6"
- }
- }
- sampleFor: MigrationTools._EngineV1.Configuration.FieldMap.FieldtoFieldMultiMapConfig
-description: Want to setup a bunch of field maps in a single go. Use this shortcut!
-className: FieldtoFieldMultiMapConfig
-typeName: FieldMaps
-architecture: v1
-options:
-- parameterName: SourceToTargetMappings
- type: Dictionary
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: WorkItemTypeName
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-status: ready
-processingTarget: Work Item Field
-classFile: /src/MigrationTools/_EngineV1/Configuration/FieldMap/FieldtoFieldMultiMapConfig.cs
-optionsClassFile: /src/MigrationTools/_EngineV1/Configuration/FieldMap/FieldtoFieldMultiMapConfig.cs
-
-redirectFrom: []
-layout: reference
-toc: true
-permalink: /Reference/v1/FieldMaps/FieldtoFieldMultiMapConfig/
-title: FieldtoFieldMultiMapConfig
-categories:
-- FieldMaps
-- v1
-topics:
-- topic: notes
- path: /docs/Reference/v1/FieldMaps/FieldtoFieldMultiMapConfig-notes.md
- exists: false
- markdown: ''
-- topic: introduction
- path: /docs/Reference/v1/FieldMaps/FieldtoFieldMultiMapConfig-introduction.md
- exists: false
- markdown: ''
-
----
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.v1.fieldmaps.fieldtotagmapconfig.md b/docs/collections/_reference/reference.v1.fieldmaps.fieldtotagmapconfig.md
deleted file mode 100644
index 2e2393f4d..000000000
--- a/docs/collections/_reference/reference.v1.fieldmaps.fieldtotagmapconfig.md
+++ /dev/null
@@ -1,55 +0,0 @@
----
-optionsClassName: FieldtoTagMapConfig
-optionsClassFullName: MigrationTools._EngineV1.Configuration.FieldMap.FieldtoTagMapConfig
-configurationSamples:
-- name: default
- description:
- code: >-
- {
- "$type": "FieldtoTagMapConfig",
- "WorkItemTypeName": "*",
- "sourceField": "Custom.ProjectName",
- "formatExpression": "Project: {0}"
- }
- sampleFor: MigrationTools._EngineV1.Configuration.FieldMap.FieldtoTagMapConfig
-description: Want to take a field and convert its value to a tag? Done...
-className: FieldtoTagMapConfig
-typeName: FieldMaps
-architecture: v1
-options:
-- parameterName: formatExpression
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: sourceField
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: WorkItemTypeName
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-status: ready
-processingTarget: Work Item Field
-classFile: /src/MigrationTools/_EngineV1/Configuration/FieldMap/FieldtoTagMapConfig.cs
-optionsClassFile: /src/MigrationTools/_EngineV1/Configuration/FieldMap/FieldtoTagMapConfig.cs
-
-redirectFrom: []
-layout: reference
-toc: true
-permalink: /Reference/v1/FieldMaps/FieldtoTagMapConfig/
-title: FieldtoTagMapConfig
-categories:
-- FieldMaps
-- v1
-topics:
-- topic: notes
- path: /docs/Reference/v1/FieldMaps/FieldtoTagMapConfig-notes.md
- exists: false
- markdown: ''
-- topic: introduction
- path: /docs/Reference/v1/FieldMaps/FieldtoTagMapConfig-introduction.md
- exists: false
- markdown: ''
-
----
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.v1.fieldmaps.fieldvaluemapconfig.md b/docs/collections/_reference/reference.v1.fieldmaps.fieldvaluemapconfig.md
deleted file mode 100644
index 7b29f317e..000000000
--- a/docs/collections/_reference/reference.v1.fieldmaps.fieldvaluemapconfig.md
+++ /dev/null
@@ -1,71 +0,0 @@
----
-optionsClassName: FieldValueMapConfig
-optionsClassFullName: MigrationTools._EngineV1.Configuration.FieldMap.FieldValueMapConfig
-configurationSamples:
-- name: default
- description:
- code: >-
- {
- "$type": "FieldValueMapConfig",
- "WorkItemTypeName": "*",
- "sourceField": "System.Status",
- "targetField": "System.Status",
- "defaultValue": "New",
- "valueMapping": {
- "$type": "Dictionary`2",
- "New": "New",
- "Active": "Committed",
- "Resolved": "Committed",
- "Closed": "Done"
- }
- }
- sampleFor: MigrationTools._EngineV1.Configuration.FieldMap.FieldValueMapConfig
-description: Need to map not just the field but also values? This is the default value mapper.
-className: FieldValueMapConfig
-typeName: FieldMaps
-architecture: v1
-options:
-- parameterName: defaultValue
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: sourceField
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: targetField
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: valueMapping
- type: Dictionary
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: WorkItemTypeName
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-status: ready
-processingTarget: Work Item Field
-classFile: /src/MigrationTools/_EngineV1/Configuration/FieldMap/FieldValueMapConfig.cs
-optionsClassFile: /src/MigrationTools/_EngineV1/Configuration/FieldMap/FieldValueMapConfig.cs
-
-redirectFrom: []
-layout: reference
-toc: true
-permalink: /Reference/v1/FieldMaps/FieldValueMapConfig/
-title: FieldValueMapConfig
-categories:
-- FieldMaps
-- v1
-topics:
-- topic: notes
- path: /docs/Reference/v1/FieldMaps/FieldValueMapConfig-notes.md
- exists: false
- markdown: ''
-- topic: introduction
- path: /docs/Reference/v1/FieldMaps/FieldValueMapConfig-introduction.md
- exists: false
- markdown: ''
-
----
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.v1.fieldmaps.fieldvaluetotagmapconfig.md b/docs/collections/_reference/reference.v1.fieldmaps.fieldvaluetotagmapconfig.md
deleted file mode 100644
index 7cbfd4208..000000000
--- a/docs/collections/_reference/reference.v1.fieldmaps.fieldvaluetotagmapconfig.md
+++ /dev/null
@@ -1,60 +0,0 @@
----
-optionsClassName: FieldValuetoTagMapConfig
-optionsClassFullName: MigrationTools._EngineV1.Configuration.FieldMap.FieldValuetoTagMapConfig
-configurationSamples:
-- name: default
- description:
- code: >-
- {
- "$type": "FieldValuetoTagMapConfig",
- "WorkItemTypeName": "*",
- "sourceField": "System.Status",
- "pattern": "(Active|Resolved)",
- "formatExpression": "Status: {0}"
- }
- sampleFor: MigrationTools._EngineV1.Configuration.FieldMap.FieldValuetoTagMapConfig
-description: Need to create a Tag based on a field value? Just create a regex match and choose how to populate the target.
-className: FieldValuetoTagMapConfig
-typeName: FieldMaps
-architecture: v1
-options:
-- parameterName: formatExpression
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: pattern
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: sourceField
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: WorkItemTypeName
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-status: ready
-processingTarget: Work Item Field
-classFile: /src/MigrationTools/_EngineV1/Configuration/FieldMap/FieldValuetoTagMapConfig.cs
-optionsClassFile: /src/MigrationTools/_EngineV1/Configuration/FieldMap/FieldValuetoTagMapConfig.cs
-
-redirectFrom: []
-layout: reference
-toc: true
-permalink: /Reference/v1/FieldMaps/FieldValuetoTagMapConfig/
-title: FieldValuetoTagMapConfig
-categories:
-- FieldMaps
-- v1
-topics:
-- topic: notes
- path: /docs/Reference/v1/FieldMaps/FieldValuetoTagMapConfig-notes.md
- exists: false
- markdown: ''
-- topic: introduction
- path: /docs/Reference/v1/FieldMaps/FieldValuetoTagMapConfig-introduction.md
- exists: false
- markdown: ''
-
----
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.v1.fieldmaps.multivalueconditionalmapconfig.md b/docs/collections/_reference/reference.v1.fieldmaps.multivalueconditionalmapconfig.md
deleted file mode 100644
index b148caf54..000000000
--- a/docs/collections/_reference/reference.v1.fieldmaps.multivalueconditionalmapconfig.md
+++ /dev/null
@@ -1,61 +0,0 @@
----
-optionsClassName: MultiValueConditionalMapConfig
-optionsClassFullName: MigrationTools._EngineV1.Configuration.FieldMap.MultiValueConditionalMapConfig
-configurationSamples:
-- name: default
- description:
- code: >-
- {
- "$type": "MultiValueConditionalMapConfig",
- "WorkItemTypeName": "*",
- "sourceFieldsAndValues": {
- "$type": "Dictionary`2",
- "Something": "SomethingElse"
- },
- "targetFieldsAndValues": {
- "$type": "Dictionary`2",
- "Something": "SomethingElse"
- }
- }
- sampleFor: MigrationTools._EngineV1.Configuration.FieldMap.MultiValueConditionalMapConfig
-description: ??? If you know how to use this please send a PR :)
-className: MultiValueConditionalMapConfig
-typeName: FieldMaps
-architecture: v1
-options:
-- parameterName: sourceFieldsAndValues
- type: Dictionary
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: targetFieldsAndValues
- type: Dictionary
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: WorkItemTypeName
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-status: ready
-processingTarget: Work Item Field
-classFile: /src/MigrationTools/_EngineV1/Configuration/FieldMap/MultiValueConditionalMapConfig.cs
-optionsClassFile: /src/MigrationTools/_EngineV1/Configuration/FieldMap/MultiValueConditionalMapConfig.cs
-
-redirectFrom: []
-layout: reference
-toc: true
-permalink: /Reference/v1/FieldMaps/MultiValueConditionalMapConfig/
-title: MultiValueConditionalMapConfig
-categories:
-- FieldMaps
-- v1
-topics:
-- topic: notes
- path: /docs/Reference/v1/FieldMaps/MultiValueConditionalMapConfig-notes.md
- exists: false
- markdown: ''
-- topic: introduction
- path: /docs/Reference/v1/FieldMaps/MultiValueConditionalMapConfig-introduction.md
- exists: false
- markdown: ''
-
----
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.v1.fieldmaps.regexfieldmapconfig.md b/docs/collections/_reference/reference.v1.fieldmaps.regexfieldmapconfig.md
deleted file mode 100644
index 573c1603c..000000000
--- a/docs/collections/_reference/reference.v1.fieldmaps.regexfieldmapconfig.md
+++ /dev/null
@@ -1,65 +0,0 @@
----
-optionsClassName: RegexFieldMapConfig
-optionsClassFullName: MigrationTools._EngineV1.Configuration.FieldMap.RegexFieldMapConfig
-configurationSamples:
-- name: default
- description:
- code: >-
- {
- "$type": "RegexFieldMapConfig",
- "WorkItemTypeName": "*",
- "sourceField": "Custom.MyVersion",
- "targetField": "Custom.MyVersionYearOnly",
- "pattern": "([0-9]{4})",
- "replacement": "$1"
- }
- sampleFor: MigrationTools._EngineV1.Configuration.FieldMap.RegexFieldMapConfig
-description: I just need that bit of a field... need to send "2016.2" to two fields, one for year and one for release? Done.
-className: RegexFieldMapConfig
-typeName: FieldMaps
-architecture: v1
-options:
-- parameterName: pattern
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: replacement
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: sourceField
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: targetField
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: WorkItemTypeName
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-status: ready
-processingTarget: Work Item Field
-classFile: /src/MigrationTools/_EngineV1/Configuration/FieldMap/RegexFieldMapConfig.cs
-optionsClassFile: /src/MigrationTools/_EngineV1/Configuration/FieldMap/RegexFieldMapConfig.cs
-
-redirectFrom: []
-layout: reference
-toc: true
-permalink: /Reference/v1/FieldMaps/RegexFieldMapConfig/
-title: RegexFieldMapConfig
-categories:
-- FieldMaps
-- v1
-topics:
-- topic: notes
- path: /docs/Reference/v1/FieldMaps/RegexFieldMapConfig-notes.md
- exists: false
- markdown: ''
-- topic: introduction
- path: /docs/Reference/v1/FieldMaps/RegexFieldMapConfig-introduction.md
- exists: false
- markdown: ''
-
----
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.v1.fieldmaps.treetotagmapconfig.md b/docs/collections/_reference/reference.v1.fieldmaps.treetotagmapconfig.md
deleted file mode 100644
index a26abd2a6..000000000
--- a/docs/collections/_reference/reference.v1.fieldmaps.treetotagmapconfig.md
+++ /dev/null
@@ -1,55 +0,0 @@
----
-optionsClassName: TreeToTagMapConfig
-optionsClassFullName: MigrationTools._EngineV1.Configuration.FieldMap.TreeToTagMapConfig
-configurationSamples:
-- name: default
- description:
- code: >-
- {
- "$type": "TreeToTagMapConfig",
- "WorkItemTypeName": "*",
- "toSkip": 2,
- "timeTravel": 0
- }
- sampleFor: MigrationTools._EngineV1.Configuration.FieldMap.TreeToTagMapConfig
-description: Need to clear out those nasty Area tree hierarchies? This creates Tags for each node in the Area Path...
-className: TreeToTagMapConfig
-typeName: FieldMaps
-architecture: v1
-options:
-- parameterName: timeTravel
- type: Int32
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: toSkip
- type: Int32
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: WorkItemTypeName
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-status: ready
-processingTarget: Work Item Field
-classFile: /src/MigrationTools/_EngineV1/Configuration/FieldMap/TreeToTagMapConfig.cs
-optionsClassFile: /src/MigrationTools/_EngineV1/Configuration/FieldMap/TreeToTagMapConfig.cs
-
-redirectFrom: []
-layout: reference
-toc: true
-permalink: /Reference/v1/FieldMaps/TreeToTagMapConfig/
-title: TreeToTagMapConfig
-categories:
-- FieldMaps
-- v1
-topics:
-- topic: notes
- path: /docs/Reference/v1/FieldMaps/TreeToTagMapConfig-notes.md
- exists: false
- markdown: ''
-- topic: introduction
- path: /docs/Reference/v1/FieldMaps/TreeToTagMapConfig-introduction.md
- exists: false
- markdown: ''
-
----
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.v1.processors.exportprofilepicturefromadcontext.md b/docs/collections/_reference/reference.v1.processors.exportprofilepicturefromadcontext.md
deleted file mode 100644
index f3b90141b..000000000
--- a/docs/collections/_reference/reference.v1.processors.exportprofilepicturefromadcontext.md
+++ /dev/null
@@ -1,65 +0,0 @@
----
-optionsClassName: ExportProfilePictureFromADConfig
-optionsClassFullName: MigrationTools._EngineV1.Configuration.Processing.ExportProfilePictureFromADConfig
-configurationSamples:
-- name: default
- description:
- code: >-
- {
- "$type": "ExportProfilePictureFromADConfig",
- "Enabled": false,
- "Domain": null,
- "Username": null,
- "Password": null,
- "PictureEmpIDFormat": null
- }
- sampleFor: MigrationTools._EngineV1.Configuration.Processing.ExportProfilePictureFromADConfig
-description: Downloads corporate images and updates TFS/Azure DevOps profiles
-className: ExportProfilePictureFromADContext
-typeName: Processors
-architecture: v1
-options:
-- parameterName: Domain
- type: String
- description: The source domain where the pictures should be exported.
- defaultValue: String.Empty
-- parameterName: Enabled
- type: Boolean
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: Password
- type: String
- description: The password of the user that is used to export the pictures.
- defaultValue: String.Empty
-- parameterName: PictureEmpIDFormat
- type: String
- description: 'TODO: You wpuld need to customise this for your system. Clone repo and run in Debug'
- defaultValue: String.Empty
-- parameterName: Username
- type: String
- description: The user name of the user that is used to export the pictures.
- defaultValue: String.Empty
-status: alpha
-processingTarget: Profiles
-classFile: /src/VstsSyncMigrator.Core/Execution/ProcessingContext/ExportProfilePictureFromADContext.cs
-optionsClassFile: /src/MigrationTools/_EngineV1/Configuration/Processing/ExportProfilePictureFromADConfig.cs
-
-redirectFrom: []
-layout: reference
-toc: true
-permalink: /Reference/v1/Processors/ExportProfilePictureFromADContext/
-title: ExportProfilePictureFromADContext
-categories:
-- Processors
-- v1
-topics:
-- topic: notes
- path: /docs/Reference/v1/Processors/ExportProfilePictureFromADContext-notes.md
- exists: false
- markdown: ''
-- topic: introduction
- path: /docs/Reference/v1/Processors/ExportProfilePictureFromADContext-introduction.md
- exists: false
- markdown: ''
-
----
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.v1.processors.exportusersformapping.md b/docs/collections/_reference/reference.v1.processors.exportusersformapping.md
deleted file mode 100644
index 5b0145295..000000000
--- a/docs/collections/_reference/reference.v1.processors.exportusersformapping.md
+++ /dev/null
@@ -1,81 +0,0 @@
----
-optionsClassName: ExportUsersForMappingConfig
-optionsClassFullName: MigrationTools._EngineV1.Configuration.Processing.ExportUsersForMappingConfig
-configurationSamples:
-- name: default
- description:
- code: >-
- {
- "$type": "ExportUsersForMappingConfig",
- "Enabled": false,
- "LocalExportJsonFile": null,
- "WIQLQuery": null,
- "IdentityFieldsToCheck": null
- }
- sampleFor: MigrationTools._EngineV1.Configuration.Processing.ExportUsersForMappingConfig
-description: missng XML code comments
-className: ExportUsersForMapping
-typeName: Processors
-architecture: v1
-options:
-- parameterName: Enabled
- type: Boolean
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: IdentityFieldsToCheck
- type: List
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: LocalExportJsonFile
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: WIQLQuery
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-status: missng XML code comments
-processingTarget: missng XML code comments
-classFile: /src/VstsSyncMigrator.Core/Execution/MigrationContext/ExportUsersForMapping.cs
-optionsClassFile: /src/MigrationTools/_EngineV1/Configuration/Processing/ExportUsersForMappingConfig.cs
-
-redirectFrom: []
-layout: reference
-toc: true
-permalink: /Reference/v1/Processors/ExportUsersForMapping/
-title: ExportUsersForMapping
-categories:
-- Processors
-- v1
-topics:
-- topic: notes
- path: /docs/Reference/v1/Processors/ExportUsersForMapping-notes.md
- exists: true
- markdown: >-
- ## Additional Samples & Info
-
-
- ```
-
- {
- "$type": "ExportUsersForMappingConfig",
- "Enabled": false,
- "LocalExportJsonFile": "c:\\temp\\ExportUsersForMappingConfig.json",
- "WIQLQuery": "SELECT [System.Id], [System.Tags] FROM WorkItems WHERE [System.TeamProject] = @TeamProject AND [System.WorkItemType] NOT IN ('Test Suite', 'Test Plan') ORDER BY [System.ChangedDate] desc",
- "IdentityFieldsToCheck": [
- "System.AssignedTo",
- "System.ChangedBy",
- "System.CreatedBy",
- "Microsoft.VSTS.Common.ActivatedBy",
- "Microsoft.VSTS.Common.ResolvedBy",
- "Microsoft.VSTS.Common.ClosedBy"
- ]
- }
-
- ```
-- topic: introduction
- path: /docs/Reference/v1/Processors/ExportUsersForMapping-introduction.md
- exists: false
- markdown: ''
-
----
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.v1.processors.exportusersformappingcontext.md b/docs/collections/_reference/reference.v1.processors.exportusersformappingcontext.md
deleted file mode 100644
index 90c3699b9..000000000
--- a/docs/collections/_reference/reference.v1.processors.exportusersformappingcontext.md
+++ /dev/null
@@ -1,55 +0,0 @@
----
-optionsClassName: ExportUsersForMappingConfig
-optionsClassFullName: MigrationTools._EngineV1.Configuration.Processing.ExportUsersForMappingConfig
-configurationSamples:
-- name: default
- description:
- code: >-
- {
- "$type": "ExportUsersForMappingConfig",
- "Enabled": false,
- "WIQLQuery": null,
- "OnlyListUsersInWorkItems": true
- }
- sampleFor: MigrationTools._EngineV1.Configuration.Processing.ExportUsersForMappingConfig
-description: ExportUsersForMappingContext is a tool used to create a starter mapping file for users between the source and target systems. Use `ExportUsersForMappingConfig` to configure.
-className: ExportUsersForMappingContext
-typeName: Processors
-architecture: v1
-options:
-- parameterName: Enabled
- type: Boolean
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: OnlyListUsersInWorkItems
- type: Boolean
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: WIQLQuery
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-status: ready
-processingTarget: Work Items
-classFile: ''
-optionsClassFile: /src/MigrationTools/_EngineV1/Configuration/Processing/ExportUsersForMappingConfig.cs
-
-redirectFrom: []
-layout: reference
-toc: true
-permalink: /Reference/v1/Processors/ExportUsersForMappingContext/
-title: ExportUsersForMappingContext
-categories:
-- Processors
-- v1
-topics:
-- topic: notes
- path: /docs/Reference/v1/Processors/ExportUsersForMappingContext-notes.md
- exists: false
- markdown: ''
-- topic: introduction
- path: /docs/Reference/v1/Processors/ExportUsersForMappingContext-introduction.md
- exists: false
- markdown: ''
-
----
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.v1.processors.fakeprocessor.md b/docs/collections/_reference/reference.v1.processors.fakeprocessor.md
deleted file mode 100644
index 71babef2e..000000000
--- a/docs/collections/_reference/reference.v1.processors.fakeprocessor.md
+++ /dev/null
@@ -1,45 +0,0 @@
----
-optionsClassName: FakeProcessorConfig
-optionsClassFullName: MigrationTools._EngineV1.Configuration.Processing.FakeProcessorConfig
-configurationSamples:
-- name: default
- description:
- code: >-
- {
- "$type": "FakeProcessorConfig",
- "Enabled": false
- }
- sampleFor: MigrationTools._EngineV1.Configuration.Processing.FakeProcessorConfig
-description: "Note: this is only for internal usage. Don't use this in your configurations."
-className: FakeProcessor
-typeName: Processors
-architecture: v1
-options:
-- parameterName: Enabled
- type: Boolean
- description: missng XML code comments
- defaultValue: missng XML code comments
-status: missng XML code comments
-processingTarget: missng XML code comments
-classFile: /src/VstsSyncMigrator.Core/Execution/MigrationContext/FakeProcessor.cs
-optionsClassFile: /src/MigrationTools/_EngineV1/Configuration/Processing/FakeProcessorConfig.cs
-
-redirectFrom: []
-layout: reference
-toc: true
-permalink: /Reference/v1/Processors/FakeProcessor/
-title: FakeProcessor
-categories:
-- Processors
-- v1
-topics:
-- topic: notes
- path: /docs/Reference/v1/Processors/FakeProcessor-notes.md
- exists: false
- markdown: ''
-- topic: introduction
- path: /docs/Reference/v1/Processors/FakeProcessor-introduction.md
- exists: false
- markdown: ''
-
----
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.v1.processors.fixgitcommitlinks.md b/docs/collections/_reference/reference.v1.processors.fixgitcommitlinks.md
deleted file mode 100644
index 3d41327ad..000000000
--- a/docs/collections/_reference/reference.v1.processors.fixgitcommitlinks.md
+++ /dev/null
@@ -1,55 +0,0 @@
----
-optionsClassName: FixGitCommitLinksConfig
-optionsClassFullName: MigrationTools._EngineV1.Configuration.Processing.FixGitCommitLinksConfig
-configurationSamples:
-- name: default
- description:
- code: >-
- {
- "$type": "FixGitCommitLinksConfig",
- "Enabled": false,
- "TargetRepository": null,
- "Query": null
- }
- sampleFor: MigrationTools._EngineV1.Configuration.Processing.FixGitCommitLinksConfig
-description: missng XML code comments
-className: FixGitCommitLinks
-typeName: Processors
-architecture: v1
-options:
-- parameterName: Enabled
- type: Boolean
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: Query
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: TargetRepository
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-status: missng XML code comments
-processingTarget: missng XML code comments
-classFile: /src/VstsSyncMigrator.Core/Execution/ProcessingContext/FixGitCommitLinks.cs
-optionsClassFile: /src/MigrationTools/_EngineV1/Configuration/Processing/FixGitCommitLinksConfig.cs
-
-redirectFrom: []
-layout: reference
-toc: true
-permalink: /Reference/v1/Processors/FixGitCommitLinks/
-title: FixGitCommitLinks
-categories:
-- Processors
-- v1
-topics:
-- topic: notes
- path: /docs/Reference/v1/Processors/FixGitCommitLinks-notes.md
- exists: false
- markdown: ''
-- topic: introduction
- path: /docs/Reference/v1/Processors/FixGitCommitLinks-introduction.md
- exists: false
- markdown: ''
-
----
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.v1.processors.importprofilepicturecontext.md b/docs/collections/_reference/reference.v1.processors.importprofilepicturecontext.md
deleted file mode 100644
index a1b2057bb..000000000
--- a/docs/collections/_reference/reference.v1.processors.importprofilepicturecontext.md
+++ /dev/null
@@ -1,45 +0,0 @@
----
-optionsClassName: ImportProfilePictureConfig
-optionsClassFullName: MigrationTools._EngineV1.Configuration.Processing.ImportProfilePictureConfig
-configurationSamples:
-- name: default
- description:
- code: >-
- {
- "$type": "ImportProfilePictureConfig",
- "Enabled": false
- }
- sampleFor: MigrationTools._EngineV1.Configuration.Processing.ImportProfilePictureConfig
-description: Downloads corporate images and updates TFS/Azure DevOps profiles
-className: ImportProfilePictureContext
-typeName: Processors
-architecture: v1
-options:
-- parameterName: Enabled
- type: Boolean
- description: missng XML code comments
- defaultValue: missng XML code comments
-status: alpha
-processingTarget: Profiles
-classFile: /src/VstsSyncMigrator.Core/Execution/ProcessingContext/ImportProfilePictureContext.cs
-optionsClassFile: /src/MigrationTools/_EngineV1/Configuration/Processing/ImportProfilePictureConfig.cs
-
-redirectFrom: []
-layout: reference
-toc: true
-permalink: /Reference/v1/Processors/ImportProfilePictureContext/
-title: ImportProfilePictureContext
-categories:
-- Processors
-- v1
-topics:
-- topic: notes
- path: /docs/Reference/v1/Processors/ImportProfilePictureContext-notes.md
- exists: false
- markdown: ''
-- topic: introduction
- path: /docs/Reference/v1/Processors/ImportProfilePictureContext-introduction.md
- exists: false
- markdown: ''
-
----
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.v1.processors.teammigrationcontext.md b/docs/collections/_reference/reference.v1.processors.teammigrationcontext.md
deleted file mode 100644
index 4953a5ff0..000000000
--- a/docs/collections/_reference/reference.v1.processors.teammigrationcontext.md
+++ /dev/null
@@ -1,55 +0,0 @@
----
-optionsClassName: TeamMigrationConfig
-optionsClassFullName: MigrationTools._EngineV1.Configuration.Processing.TeamMigrationConfig
-configurationSamples:
-- name: default
- description:
- code: >-
- {
- "$type": "TeamMigrationConfig",
- "Enabled": false,
- "EnableTeamSettingsMigration": true,
- "FixTeamSettingsForExistingTeams": false
- }
- sampleFor: MigrationTools._EngineV1.Configuration.Processing.TeamMigrationConfig
-description: 'Migrates Teams and Team Settings: This should be run after `NodeStructuresMigrationConfig` and before all other processors.'
-className: TeamMigrationContext
-typeName: Processors
-architecture: v1
-options:
-- parameterName: Enabled
- type: Boolean
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: EnableTeamSettingsMigration
- type: Boolean
- description: Migrate original team settings after their creation on target team project
- defaultValue: true
-- parameterName: FixTeamSettingsForExistingTeams
- type: Boolean
- description: Reset the target team settings to match the source if the team exists
- defaultValue: true
-status: preview
-processingTarget: Teams
-classFile: /src/VstsSyncMigrator.Core/Execution/MigrationContext/TeamMigrationContext.cs
-optionsClassFile: /src/MigrationTools/_EngineV1/Configuration/Processing/TeamMigrationConfig.cs
-
-redirectFrom: []
-layout: reference
-toc: true
-permalink: /Reference/v1/Processors/TeamMigrationContext/
-title: TeamMigrationContext
-categories:
-- Processors
-- v1
-topics:
-- topic: notes
- path: /docs/Reference/v1/Processors/TeamMigrationContext-notes.md
- exists: false
- markdown: ''
-- topic: introduction
- path: /docs/Reference/v1/Processors/TeamMigrationContext-introduction.md
- exists: false
- markdown: ''
-
----
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.v1.processors.testconfigurationsmigrationcontext.md b/docs/collections/_reference/reference.v1.processors.testconfigurationsmigrationcontext.md
deleted file mode 100644
index 333a4cca6..000000000
--- a/docs/collections/_reference/reference.v1.processors.testconfigurationsmigrationcontext.md
+++ /dev/null
@@ -1,45 +0,0 @@
----
-optionsClassName: TestConfigurationsMigrationConfig
-optionsClassFullName: MigrationTools._EngineV1.Configuration.Processing.TestConfigurationsMigrationConfig
-configurationSamples:
-- name: default
- description:
- code: >-
- {
- "$type": "TestConfigurationsMigrationConfig",
- "Enabled": false
- }
- sampleFor: MigrationTools._EngineV1.Configuration.Processing.TestConfigurationsMigrationConfig
-description: This processor can migrate `test configuration`. This should be run before `LinkMigrationConfig`.
-className: TestConfigurationsMigrationContext
-typeName: Processors
-architecture: v1
-options:
-- parameterName: Enabled
- type: Boolean
- description: missng XML code comments
- defaultValue: missng XML code comments
-status: Beta
-processingTarget: Suites & Plans
-classFile: /src/VstsSyncMigrator.Core/Execution/MigrationContext/TestConfigurationsMigrationContext.cs
-optionsClassFile: /src/MigrationTools/_EngineV1/Configuration/Processing/TestConfigurationsMigrationConfig.cs
-
-redirectFrom: []
-layout: reference
-toc: true
-permalink: /Reference/v1/Processors/TestConfigurationsMigrationContext/
-title: TestConfigurationsMigrationContext
-categories:
-- Processors
-- v1
-topics:
-- topic: notes
- path: /docs/Reference/v1/Processors/TestConfigurationsMigrationContext-notes.md
- exists: false
- markdown: ''
-- topic: introduction
- path: /docs/Reference/v1/Processors/TestConfigurationsMigrationContext-introduction.md
- exists: false
- markdown: ''
-
----
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.v1.processors.testvariablesmigrationcontext.md b/docs/collections/_reference/reference.v1.processors.testvariablesmigrationcontext.md
deleted file mode 100644
index 908bfe99a..000000000
--- a/docs/collections/_reference/reference.v1.processors.testvariablesmigrationcontext.md
+++ /dev/null
@@ -1,45 +0,0 @@
----
-optionsClassName: TestVariablesMigrationConfig
-optionsClassFullName: MigrationTools._EngineV1.Configuration.Processing.TestVariablesMigrationConfig
-configurationSamples:
-- name: default
- description:
- code: >-
- {
- "$type": "TestVariablesMigrationConfig",
- "Enabled": false
- }
- sampleFor: MigrationTools._EngineV1.Configuration.Processing.TestVariablesMigrationConfig
-description: This processor can migrate test variables that are defined in the test plans / suites. This must run before `TestPlansAndSuitesMigrationConfig`.
-className: TestVariablesMigrationContext
-typeName: Processors
-architecture: v1
-options:
-- parameterName: Enabled
- type: Boolean
- description: missng XML code comments
- defaultValue: missng XML code comments
-status: Beta
-processingTarget: Suites & Plans
-classFile: /src/VstsSyncMigrator.Core/Execution/MigrationContext/TestVariablesMigrationContext.cs
-optionsClassFile: /src/MigrationTools/_EngineV1/Configuration/Processing/TestVariablesMigrationConfig.cs
-
-redirectFrom: []
-layout: reference
-toc: true
-permalink: /Reference/v1/Processors/TestVariablesMigrationContext/
-title: TestVariablesMigrationContext
-categories:
-- Processors
-- v1
-topics:
-- topic: notes
- path: /docs/Reference/v1/Processors/TestVariablesMigrationContext-notes.md
- exists: false
- markdown: ''
-- topic: introduction
- path: /docs/Reference/v1/Processors/TestVariablesMigrationContext-introduction.md
- exists: false
- markdown: ''
-
----
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.v1.processors.workitemdelete.md b/docs/collections/_reference/reference.v1.processors.workitemdelete.md
deleted file mode 100644
index 94ac01af9..000000000
--- a/docs/collections/_reference/reference.v1.processors.workitemdelete.md
+++ /dev/null
@@ -1,70 +0,0 @@
----
-optionsClassName: WorkItemDeleteConfig
-optionsClassFullName: MigrationTools._EngineV1.Configuration.Processing.WorkItemDeleteConfig
-configurationSamples:
-- name: default
- description:
- code: >-
- {
- "$type": "WorkItemDeleteConfig",
- "Enabled": false,
- "WIQLQuery": "SELECT [System.Id] FROM WorkItems WHERE [System.TeamProject] = @TeamProject AND [System.WorkItemType] NOT IN ('Test Suite', 'Test Plan','Shared Steps','Shared Parameter','Feedback Request') ORDER BY [System.ChangedDate] desc",
- "WorkItemIDs": null,
- "FilterWorkItemsThatAlreadyExistInTarget": false,
- "PauseAfterEachWorkItem": false,
- "WorkItemCreateRetryLimit": 0
- }
- sampleFor: MigrationTools._EngineV1.Configuration.Processing.WorkItemDeleteConfig
-description: The `WorkItemDelete` processor allows you to delete any amount of work items that meet the query. **DANGER:** This is not a recoverable action and should be use with extream caution.
-className: WorkItemDelete
-typeName: Processors
-architecture: v1
-options:
-- parameterName: Enabled
- type: Boolean
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: FilterWorkItemsThatAlreadyExistInTarget
- type: Boolean
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: PauseAfterEachWorkItem
- type: Boolean
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: WIQLQuery
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: WorkItemCreateRetryLimit
- type: Int32
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: WorkItemIDs
- type: IList
- description: missng XML code comments
- defaultValue: missng XML code comments
-status: ready
-processingTarget: WorkItem
-classFile: /src/VstsSyncMigrator.Core/Execution/ProcessingContext/WorkItemDelete.cs
-optionsClassFile: /src/MigrationTools/_EngineV1/Configuration/Processing/WorkItemDeleteConfig.cs
-
-redirectFrom: []
-layout: reference
-toc: true
-permalink: /Reference/v1/Processors/WorkItemDelete/
-title: WorkItemDelete
-categories:
-- Processors
-- v1
-topics:
-- topic: notes
- path: /docs/Reference/v1/Processors/WorkItemDelete-notes.md
- exists: false
- markdown: ''
-- topic: introduction
- path: /docs/Reference/v1/Processors/WorkItemDelete-introduction.md
- exists: false
- markdown: ''
-
----
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.v1.processors.workitemquerymigrationcontext.md b/docs/collections/_reference/reference.v1.processors.workitemquerymigrationcontext.md
deleted file mode 100644
index ef62a248f..000000000
--- a/docs/collections/_reference/reference.v1.processors.workitemquerymigrationcontext.md
+++ /dev/null
@@ -1,60 +0,0 @@
----
-optionsClassName: WorkItemQueryMigrationConfig
-optionsClassFullName: MigrationTools._EngineV1.Configuration.Processing.WorkItemQueryMigrationConfig
-configurationSamples:
-- name: default
- description:
- code: >-
- {
- "$type": "WorkItemQueryMigrationConfig",
- "Enabled": false,
- "PrefixProjectToNodes": false,
- "SharedFolderName": "Shared Queries",
- "SourceToTargetFieldMappings": null
- }
- sampleFor: MigrationTools._EngineV1.Configuration.Processing.WorkItemQueryMigrationConfig
-description: This processor can migrate queries for work items. Only shared queries are included. Personal queries can't migrate with this tool.
-className: WorkItemQueryMigrationContext
-typeName: Processors
-architecture: v1
-options:
-- parameterName: Enabled
- type: Boolean
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: PrefixProjectToNodes
- type: Boolean
- description: Prefix your iterations and areas with the project name. If you have enabled this in `NodeStructuresMigrationConfig` you must do it here too.
- defaultValue: false
-- parameterName: SharedFolderName
- type: String
- description: The name of the shared folder, made a parameter incase it every needs to be edited
- defaultValue: none
-- parameterName: SourceToTargetFieldMappings
- type: Dictionary
- description: Any field mappings
- defaultValue: none
-status: preview
-processingTarget: Shared Queries
-classFile: /src/VstsSyncMigrator.Core/Execution/MigrationContext/WorkItemQueryMigrationContext.cs
-optionsClassFile: /src/MigrationTools/_EngineV1/Configuration/Processing/WorkItemQueryMigrationConfig.cs
-
-redirectFrom: []
-layout: reference
-toc: true
-permalink: /Reference/v1/Processors/WorkItemQueryMigrationContext/
-title: WorkItemQueryMigrationContext
-categories:
-- Processors
-- v1
-topics:
-- topic: notes
- path: /docs/Reference/v1/Processors/WorkItemQueryMigrationContext-notes.md
- exists: false
- markdown: ''
-- topic: introduction
- path: /docs/Reference/v1/Processors/WorkItemQueryMigrationContext-introduction.md
- exists: false
- markdown: ''
-
----
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.v1.processors.workitemupdateareasastagscontext.md b/docs/collections/_reference/reference.v1.processors.workitemupdateareasastagscontext.md
deleted file mode 100644
index ebdfc039a..000000000
--- a/docs/collections/_reference/reference.v1.processors.workitemupdateareasastagscontext.md
+++ /dev/null
@@ -1,50 +0,0 @@
----
-optionsClassName: WorkItemUpdateAreasAsTagsConfig
-optionsClassFullName: MigrationTools._EngineV1.Configuration.Processing.WorkItemUpdateAreasAsTagsConfig
-configurationSamples:
-- name: default
- description:
- code: >-
- {
- "$type": "WorkItemUpdateAreasAsTagsConfig",
- "Enabled": false,
- "AreaIterationPath": null
- }
- sampleFor: MigrationTools._EngineV1.Configuration.Processing.WorkItemUpdateAreasAsTagsConfig
-description: A common issue with older *TFS/Azure DevOps* instances is the proliferation of `Area Paths`. With the use of `Area Path` for `Teams` and the addition of the `Node Name` column option these extensive tag hierarchies should instad be moved to tags.
-className: WorkItemUpdateAreasAsTagsContext
-typeName: Processors
-architecture: v1
-options:
-- parameterName: AreaIterationPath
- type: String
- description: This is a required parameter. That define the root path of the iteration. To get the full path use `\`
- defaultValue: '\'
-- parameterName: Enabled
- type: Boolean
- description: missng XML code comments
- defaultValue: missng XML code comments
-status: Beta
-processingTarget: Work Item
-classFile: /src/VstsSyncMigrator.Core/Execution/ProcessingContext/WorkItemUpdateAreasAsTagsContext.cs
-optionsClassFile: /src/MigrationTools/_EngineV1/Configuration/Processing/WorkItemUpdateAreasAsTagsConfig.cs
-
-redirectFrom: []
-layout: reference
-toc: true
-permalink: /Reference/v1/Processors/WorkItemUpdateAreasAsTagsContext/
-title: WorkItemUpdateAreasAsTagsContext
-categories:
-- Processors
-- v1
-topics:
-- topic: notes
- path: /docs/Reference/v1/Processors/WorkItemUpdateAreasAsTagsContext-notes.md
- exists: false
- markdown: ''
-- topic: introduction
- path: /docs/Reference/v1/Processors/WorkItemUpdateAreasAsTagsContext-introduction.md
- exists: false
- markdown: ''
-
----
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.v2.endpointenrichers.tfsworkitemattachmentenricher.md b/docs/collections/_reference/reference.v2.endpointenrichers.tfsworkitemattachmentenricher.md
deleted file mode 100644
index de5bf9441..000000000
--- a/docs/collections/_reference/reference.v2.endpointenrichers.tfsworkitemattachmentenricher.md
+++ /dev/null
@@ -1,59 +0,0 @@
----
-optionsClassName: TfsWorkItemAttachmentEnricherOptions
-optionsClassFullName: MigrationTools.EndpointEnrichers.TfsWorkItemAttachmentEnricherOptions
-configurationSamples:
-- name: default
- description:
- code: >-
- {
- "$type": "TfsWorkItemAttachmentEnricherOptions",
- "Enabled": true,
- "WorkingPath": "c:\\temp\\WorkItemAttachmentWorkingFolder\\",
- "MaxSize": 480000000
- }
- sampleFor: MigrationTools.EndpointEnrichers.TfsWorkItemAttachmentEnricherOptions
-description: The `TfsWorkItemAttachmentEnricher` processes the attachements for a specific work item.
-className: TfsWorkItemAttachmentEnricher
-typeName: EndpointEnrichers
-architecture: v2
-options:
-- parameterName: Enabled
- type: Boolean
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: MaxSize
- type: Int32
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: RefName
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: WorkingPath
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-status: missng XML code comments
-processingTarget: WorkItem
-classFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/EndpointEnrichers/TfsWorkItemAttachmentEnricher.cs
-optionsClassFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/EndpointEnrichers/TfsWorkItemAttachmentEnricherOptions.cs
-
-redirectFrom: []
-layout: reference
-toc: true
-permalink: /Reference/v2/EndpointEnrichers/TfsWorkItemAttachmentEnricher/
-title: TfsWorkItemAttachmentEnricher
-categories:
-- EndpointEnrichers
-- v2
-topics:
-- topic: notes
- path: /docs/Reference/v2/EndpointEnrichers/TfsWorkItemAttachmentEnricher-notes.md
- exists: false
- markdown: ''
-- topic: introduction
- path: /docs/Reference/v2/EndpointEnrichers/TfsWorkItemAttachmentEnricher-introduction.md
- exists: false
- markdown: ''
-
----
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.v2.endpoints.azuredevopsendpoint.md b/docs/collections/_reference/reference.v2.endpoints.azuredevopsendpoint.md
deleted file mode 100644
index a49ee376b..000000000
--- a/docs/collections/_reference/reference.v2.endpoints.azuredevopsendpoint.md
+++ /dev/null
@@ -1,33 +0,0 @@
----
-optionsClassName: AzureDevOpsEndpointOptions
-optionsClassFullName: MigrationTools.Endpoints.AzureDevOpsEndpointOptions
-configurationSamples: []
-description: missng XML code comments
-className: AzureDevOpsEndpoint
-typeName: Endpoints
-architecture: v2
-options: []
-status: missng XML code comments
-processingTarget: missng XML code comments
-classFile: /src/MigrationTools.Clients.AzureDevops.Rest/Endpoints/AzureDevOpsEndpoint.cs
-optionsClassFile: /src/MigrationTools.Clients.AzureDevops.Rest/Endpoints/AzureDevOpsEndpointOptions.cs
-
-redirectFrom: []
-layout: reference
-toc: true
-permalink: /Reference/v2/Endpoints/AzureDevOpsEndpoint/
-title: AzureDevOpsEndpoint
-categories:
-- Endpoints
-- v2
-topics:
-- topic: notes
- path: /docs/Reference/v2/Endpoints/AzureDevOpsEndpoint-notes.md
- exists: false
- markdown: ''
-- topic: introduction
- path: /docs/Reference/v2/Endpoints/AzureDevOpsEndpoint-introduction.md
- exists: false
- markdown: ''
-
----
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.v2.endpoints.filesystemworkitemendpoint.md b/docs/collections/_reference/reference.v2.endpoints.filesystemworkitemendpoint.md
deleted file mode 100644
index 5a3b78e5f..000000000
--- a/docs/collections/_reference/reference.v2.endpoints.filesystemworkitemendpoint.md
+++ /dev/null
@@ -1,33 +0,0 @@
----
-optionsClassName: FileSystemWorkItemEndpointOptions
-optionsClassFullName: MigrationTools.Endpoints.FileSystemWorkItemEndpointOptions
-configurationSamples: []
-description: missng XML code comments
-className: FileSystemWorkItemEndpoint
-typeName: Endpoints
-architecture: v2
-options: []
-status: missng XML code comments
-processingTarget: missng XML code comments
-classFile: /src/MigrationTools.Clients.FileSystem/Endpoints/FileSystemWorkItemEndpoint.cs
-optionsClassFile: /src/MigrationTools.Clients.FileSystem/Endpoints/FileSystemWorkItemEndpointOptions.cs
-
-redirectFrom: []
-layout: reference
-toc: true
-permalink: /Reference/v2/Endpoints/FileSystemWorkItemEndpoint/
-title: FileSystemWorkItemEndpoint
-categories:
-- Endpoints
-- v2
-topics:
-- topic: notes
- path: /docs/Reference/v2/Endpoints/FileSystemWorkItemEndpoint-notes.md
- exists: false
- markdown: ''
-- topic: introduction
- path: /docs/Reference/v2/Endpoints/FileSystemWorkItemEndpoint-introduction.md
- exists: false
- markdown: ''
-
----
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.v2.endpoints.tfsendpoint.md b/docs/collections/_reference/reference.v2.endpoints.tfsendpoint.md
deleted file mode 100644
index 646338657..000000000
--- a/docs/collections/_reference/reference.v2.endpoints.tfsendpoint.md
+++ /dev/null
@@ -1,33 +0,0 @@
----
-optionsClassName: TfsEndpointOptions
-optionsClassFullName: MigrationTools.Endpoints.TfsEndpointOptions
-configurationSamples: []
-description: missng XML code comments
-className: TfsEndpoint
-typeName: Endpoints
-architecture: v2
-options: []
-status: missng XML code comments
-processingTarget: missng XML code comments
-classFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Endpoints/TfsEndpoint.cs
-optionsClassFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Endpoints/TfsEndpointOptions.cs
-
-redirectFrom: []
-layout: reference
-toc: true
-permalink: /Reference/v2/Endpoints/TfsEndpoint/
-title: TfsEndpoint
-categories:
-- Endpoints
-- v2
-topics:
-- topic: notes
- path: /docs/Reference/v2/Endpoints/TfsEndpoint-notes.md
- exists: false
- markdown: ''
-- topic: introduction
- path: /docs/Reference/v2/Endpoints/TfsEndpoint-introduction.md
- exists: false
- markdown: ''
-
----
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.v2.endpoints.tfsteamsettingsendpoint.md b/docs/collections/_reference/reference.v2.endpoints.tfsteamsettingsendpoint.md
deleted file mode 100644
index 513248bd6..000000000
--- a/docs/collections/_reference/reference.v2.endpoints.tfsteamsettingsendpoint.md
+++ /dev/null
@@ -1,33 +0,0 @@
----
-optionsClassName: TfsTeamSettingsEndpointOptions
-optionsClassFullName: MigrationTools.Endpoints.TfsTeamSettingsEndpointOptions
-configurationSamples: []
-description: missng XML code comments
-className: TfsTeamSettingsEndpoint
-typeName: Endpoints
-architecture: v2
-options: []
-status: missng XML code comments
-processingTarget: missng XML code comments
-classFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Endpoints/TfsTeamSettingsEndpoint.cs
-optionsClassFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Endpoints/TfsTeamSettingsEndpointOptions.cs
-
-redirectFrom: []
-layout: reference
-toc: true
-permalink: /Reference/v2/Endpoints/TfsTeamSettingsEndpoint/
-title: TfsTeamSettingsEndpoint
-categories:
-- Endpoints
-- v2
-topics:
-- topic: notes
- path: /docs/Reference/v2/Endpoints/TfsTeamSettingsEndpoint-notes.md
- exists: false
- markdown: ''
-- topic: introduction
- path: /docs/Reference/v2/Endpoints/TfsTeamSettingsEndpoint-introduction.md
- exists: false
- markdown: ''
-
----
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.v2.endpoints.tfsworkitemendpoint.md b/docs/collections/_reference/reference.v2.endpoints.tfsworkitemendpoint.md
deleted file mode 100644
index f42bcd4f5..000000000
--- a/docs/collections/_reference/reference.v2.endpoints.tfsworkitemendpoint.md
+++ /dev/null
@@ -1,46 +0,0 @@
----
-optionsClassName: TfsWorkItemEndpointOptions
-optionsClassFullName: MigrationTools.Endpoints.TfsWorkItemEndpointOptions
-configurationSamples: []
-description: missng XML code comments
-className: TfsWorkItemEndpoint
-typeName: Endpoints
-architecture: v2
-options: []
-status: missng XML code comments
-processingTarget: missng XML code comments
-classFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Endpoints/TfsWorkItemEndpoint.cs
-optionsClassFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Endpoints/TfsWorkItemEndpointOptions.cs
-
-redirectFrom: []
-layout: reference
-toc: true
-permalink: /Reference/v2/Endpoints/TfsWorkItemEndpoint/
-title: TfsWorkItemEndpoint
-categories:
-- Endpoints
-- v2
-topics:
-- topic: notes
- path: /docs/Reference/v2/Endpoints/TfsWorkItemEndpoint-notes.md
- exists: true
- markdown: >+
- The Work Item endpoint is super awesome.
-
-
- |Client | WriteTo/ReadFrom | Endpoint | Data Target | Description |
-
- |:-:|:-:|:-:|:-:|:-:|
-
- AzureDevops.ObjectModel | Tfs Object Model | `TfsWorkItemEndPoint` | WorkItems | TBA
-
- AzureDevops.Rest | Azure DevOps REST | ?
-
- FileSystem | Local Files | `FileSystemWorkItemEndpoint` | WorkItems | TBA
-
-- topic: introduction
- path: /docs/Reference/v2/Endpoints/TfsWorkItemEndpoint-introduction.md
- exists: false
- markdown: ''
-
----
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.v2.fieldmaps.fieldclearmapconfig.md b/docs/collections/_reference/reference.v2.fieldmaps.fieldclearmapconfig.md
deleted file mode 100644
index 5270ef2db..000000000
--- a/docs/collections/_reference/reference.v2.fieldmaps.fieldclearmapconfig.md
+++ /dev/null
@@ -1,50 +0,0 @@
----
-optionsClassName: FieldClearMapConfig
-optionsClassFullName: MigrationTools._EngineV1.Configuration.FieldMap.FieldClearMapConfig
-configurationSamples:
-- name: default
- description:
- code: >-
- {
- "$type": "FieldClearMapConfig",
- "WorkItemTypeName": "*",
- "targetField": "System.Description"
- }
- sampleFor: MigrationTools._EngineV1.Configuration.FieldMap.FieldClearMapConfig
-description: Allows you to set an already populated field to Null. This will only work with fields that support null.
-className: FieldClearMapConfig
-typeName: FieldMaps
-architecture: v2
-options:
-- parameterName: targetField
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: WorkItemTypeName
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-status: ready
-processingTarget: Work Item
-classFile: /src/MigrationTools/_EngineV1/Configuration/FieldMap/FieldClearMapConfig.cs
-optionsClassFile: /src/MigrationTools/_EngineV1/Configuration/FieldMap/FieldClearMapConfig.cs
-
-redirectFrom: []
-layout: reference
-toc: true
-permalink: /Reference/v2/FieldMaps/FieldClearMapConfig/
-title: FieldClearMapConfig
-categories:
-- FieldMaps
-- v2
-topics:
-- topic: notes
- path: /docs/Reference/v2/FieldMaps/FieldClearMapConfig-notes.md
- exists: false
- markdown: ''
-- topic: introduction
- path: /docs/Reference/v2/FieldMaps/FieldClearMapConfig-introduction.md
- exists: false
- markdown: ''
-
----
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.v2.fieldmaps.fieldliteralmapconfig.md b/docs/collections/_reference/reference.v2.fieldmaps.fieldliteralmapconfig.md
deleted file mode 100644
index f51c415dd..000000000
--- a/docs/collections/_reference/reference.v2.fieldmaps.fieldliteralmapconfig.md
+++ /dev/null
@@ -1,55 +0,0 @@
----
-optionsClassName: FieldLiteralMapConfig
-optionsClassFullName: MigrationTools._EngineV1.Configuration.FieldMap.FieldLiteralMapConfig
-configurationSamples:
-- name: default
- description:
- code: >-
- {
- "$type": "FieldLiteralMapConfig",
- "WorkItemTypeName": "*",
- "targetField": "System.Status",
- "value": "New"
- }
- sampleFor: MigrationTools._EngineV1.Configuration.FieldMap.FieldLiteralMapConfig
-description: Sets a field on the `target` to b a specific value.
-className: FieldLiteralMapConfig
-typeName: FieldMaps
-architecture: v2
-options:
-- parameterName: targetField
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: value
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: WorkItemTypeName
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-status: ready
-processingTarget: Work Item Field
-classFile: /src/MigrationTools/_EngineV1/Configuration/FieldMap/FieldLiteralMapConfig.cs
-optionsClassFile: /src/MigrationTools/_EngineV1/Configuration/FieldMap/FieldLiteralMapConfig.cs
-
-redirectFrom: []
-layout: reference
-toc: true
-permalink: /Reference/v2/FieldMaps/FieldLiteralMapConfig/
-title: FieldLiteralMapConfig
-categories:
-- FieldMaps
-- v2
-topics:
-- topic: notes
- path: /docs/Reference/v2/FieldMaps/FieldLiteralMapConfig-notes.md
- exists: false
- markdown: ''
-- topic: introduction
- path: /docs/Reference/v2/FieldMaps/FieldLiteralMapConfig-introduction.md
- exists: false
- markdown: ''
-
----
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.v2.fieldmaps.fieldmergemapconfig.md b/docs/collections/_reference/reference.v2.fieldmaps.fieldmergemapconfig.md
deleted file mode 100644
index 1179ff2b7..000000000
--- a/docs/collections/_reference/reference.v2.fieldmaps.fieldmergemapconfig.md
+++ /dev/null
@@ -1,63 +0,0 @@
----
-optionsClassName: FieldMergeMapConfig
-optionsClassFullName: MigrationTools._EngineV1.Configuration.FieldMap.FieldMergeMapConfig
-configurationSamples:
-- name: default
- description:
- code: >-
- {
- "$type": "FieldMergeMapConfig",
- "WorkItemTypeName": "*",
- "sourceFields": [
- "System.Description",
- "System.Status"
- ],
- "targetField": "System.Description",
- "formatExpression": "{0} \n {1}"
- }
- sampleFor: MigrationTools._EngineV1.Configuration.FieldMap.FieldMergeMapConfig
-description: Ever wanted to merge two or three fields? This mapping will let you do just that.
-className: FieldMergeMapConfig
-typeName: FieldMaps
-architecture: v2
-options:
-- parameterName: formatExpression
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: sourceFields
- type: List
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: targetField
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: WorkItemTypeName
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-status: ready
-processingTarget: Work Item Field
-classFile: /src/MigrationTools/_EngineV1/Configuration/FieldMap/FieldMergeMapConfig.cs
-optionsClassFile: /src/MigrationTools/_EngineV1/Configuration/FieldMap/FieldMergeMapConfig.cs
-
-redirectFrom: []
-layout: reference
-toc: true
-permalink: /Reference/v2/FieldMaps/FieldMergeMapConfig/
-title: FieldMergeMapConfig
-categories:
-- FieldMaps
-- v2
-topics:
-- topic: notes
- path: /docs/Reference/v2/FieldMaps/FieldMergeMapConfig-notes.md
- exists: false
- markdown: ''
-- topic: introduction
- path: /docs/Reference/v2/FieldMaps/FieldMergeMapConfig-introduction.md
- exists: false
- markdown: ''
-
----
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.v2.fieldmaps.fieldskipmapconfig.md b/docs/collections/_reference/reference.v2.fieldmaps.fieldskipmapconfig.md
deleted file mode 100644
index 28c2cd07a..000000000
--- a/docs/collections/_reference/reference.v2.fieldmaps.fieldskipmapconfig.md
+++ /dev/null
@@ -1,50 +0,0 @@
----
-optionsClassName: FieldSkipMapConfig
-optionsClassFullName: MigrationTools._EngineV1.Configuration.FieldMap.FieldSkipMapConfig
-configurationSamples:
-- name: default
- description:
- code: >-
- {
- "$type": "FieldSkipMapConfig",
- "WorkItemTypeName": "*",
- "targetField": "System.Description"
- }
- sampleFor: MigrationTools._EngineV1.Configuration.FieldMap.FieldSkipMapConfig
-description: Allows you to skip populating an existing field. Value in target with be reset to its OriginalValue.
-className: FieldSkipMapConfig
-typeName: FieldMaps
-architecture: v2
-options:
-- parameterName: targetField
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: WorkItemTypeName
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-status: ready
-processingTarget: Work Item
-classFile: /src/MigrationTools/_EngineV1/Configuration/FieldMap/FieldSkipMapConfig.cs
-optionsClassFile: /src/MigrationTools/_EngineV1/Configuration/FieldMap/FieldSkipMapConfig.cs
-
-redirectFrom: []
-layout: reference
-toc: true
-permalink: /Reference/v2/FieldMaps/FieldSkipMapConfig/
-title: FieldSkipMapConfig
-categories:
-- FieldMaps
-- v2
-topics:
-- topic: notes
- path: /docs/Reference/v2/FieldMaps/FieldSkipMapConfig-notes.md
- exists: false
- markdown: ''
-- topic: introduction
- path: /docs/Reference/v2/FieldMaps/FieldSkipMapConfig-introduction.md
- exists: false
- markdown: ''
-
----
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.v2.fieldmaps.fieldtofieldmapconfig.md b/docs/collections/_reference/reference.v2.fieldmaps.fieldtofieldmapconfig.md
deleted file mode 100644
index 8eafe95b9..000000000
--- a/docs/collections/_reference/reference.v2.fieldmaps.fieldtofieldmapconfig.md
+++ /dev/null
@@ -1,60 +0,0 @@
----
-optionsClassName: FieldtoFieldMapConfig
-optionsClassFullName: MigrationTools._EngineV1.Configuration.FieldMap.FieldtoFieldMapConfig
-configurationSamples:
-- name: default
- description:
- code: >-
- {
- "$type": "FieldtoFieldMapConfig",
- "WorkItemTypeName": "*",
- "sourceField": "System.StackRank",
- "targetField": "System.Rank",
- "defaultValue": "1000"
- }
- sampleFor: MigrationTools._EngineV1.Configuration.FieldMap.FieldtoFieldMapConfig
-description: Just want to map one field to another? This is the one for you.
-className: FieldtoFieldMapConfig
-typeName: FieldMaps
-architecture: v2
-options:
-- parameterName: defaultValue
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: sourceField
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: targetField
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: WorkItemTypeName
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-status: ready
-processingTarget: Work Item Field
-classFile: /src/MigrationTools/_EngineV1/Configuration/FieldMap/FieldtoFieldMapConfig.cs
-optionsClassFile: /src/MigrationTools/_EngineV1/Configuration/FieldMap/FieldtoFieldMapConfig.cs
-
-redirectFrom: []
-layout: reference
-toc: true
-permalink: /Reference/v2/FieldMaps/FieldtoFieldMapConfig/
-title: FieldtoFieldMapConfig
-categories:
-- FieldMaps
-- v2
-topics:
-- topic: notes
- path: /docs/Reference/v2/FieldMaps/FieldtoFieldMapConfig-notes.md
- exists: false
- markdown: ''
-- topic: introduction
- path: /docs/Reference/v2/FieldMaps/FieldtoFieldMapConfig-introduction.md
- exists: false
- markdown: ''
-
----
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.v2.fieldmaps.fieldtofieldmultimapconfig.md b/docs/collections/_reference/reference.v2.fieldmaps.fieldtofieldmultimapconfig.md
deleted file mode 100644
index 67c3b2bec..000000000
--- a/docs/collections/_reference/reference.v2.fieldmaps.fieldtofieldmultimapconfig.md
+++ /dev/null
@@ -1,55 +0,0 @@
----
-optionsClassName: FieldtoFieldMultiMapConfig
-optionsClassFullName: MigrationTools._EngineV1.Configuration.FieldMap.FieldtoFieldMultiMapConfig
-configurationSamples:
-- name: default
- description:
- code: >-
- {
- "$type": "FieldtoFieldMultiMapConfig",
- "WorkItemTypeName": "*",
- "SourceToTargetMappings": {
- "$type": "Dictionary`2",
- "Custom.Field1": "Custom.Field4",
- "Custom.Field2": "Custom.Field5",
- "Custom.Field3": "Custom.Field6"
- }
- }
- sampleFor: MigrationTools._EngineV1.Configuration.FieldMap.FieldtoFieldMultiMapConfig
-description: Want to setup a bunch of field maps in a single go. Use this shortcut!
-className: FieldtoFieldMultiMapConfig
-typeName: FieldMaps
-architecture: v2
-options:
-- parameterName: SourceToTargetMappings
- type: Dictionary
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: WorkItemTypeName
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-status: ready
-processingTarget: Work Item Field
-classFile: /src/MigrationTools/_EngineV1/Configuration/FieldMap/FieldtoFieldMultiMapConfig.cs
-optionsClassFile: /src/MigrationTools/_EngineV1/Configuration/FieldMap/FieldtoFieldMultiMapConfig.cs
-
-redirectFrom: []
-layout: reference
-toc: true
-permalink: /Reference/v2/FieldMaps/FieldtoFieldMultiMapConfig/
-title: FieldtoFieldMultiMapConfig
-categories:
-- FieldMaps
-- v2
-topics:
-- topic: notes
- path: /docs/Reference/v2/FieldMaps/FieldtoFieldMultiMapConfig-notes.md
- exists: false
- markdown: ''
-- topic: introduction
- path: /docs/Reference/v2/FieldMaps/FieldtoFieldMultiMapConfig-introduction.md
- exists: false
- markdown: ''
-
----
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.v2.fieldmaps.fieldtotagmapconfig.md b/docs/collections/_reference/reference.v2.fieldmaps.fieldtotagmapconfig.md
deleted file mode 100644
index a2c1ddadb..000000000
--- a/docs/collections/_reference/reference.v2.fieldmaps.fieldtotagmapconfig.md
+++ /dev/null
@@ -1,55 +0,0 @@
----
-optionsClassName: FieldtoTagMapConfig
-optionsClassFullName: MigrationTools._EngineV1.Configuration.FieldMap.FieldtoTagMapConfig
-configurationSamples:
-- name: default
- description:
- code: >-
- {
- "$type": "FieldtoTagMapConfig",
- "WorkItemTypeName": "*",
- "sourceField": "Custom.ProjectName",
- "formatExpression": "Project: {0}"
- }
- sampleFor: MigrationTools._EngineV1.Configuration.FieldMap.FieldtoTagMapConfig
-description: Want to take a field and convert its value to a tag? Done...
-className: FieldtoTagMapConfig
-typeName: FieldMaps
-architecture: v2
-options:
-- parameterName: formatExpression
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: sourceField
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: WorkItemTypeName
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-status: ready
-processingTarget: Work Item Field
-classFile: /src/MigrationTools/_EngineV1/Configuration/FieldMap/FieldtoTagMapConfig.cs
-optionsClassFile: /src/MigrationTools/_EngineV1/Configuration/FieldMap/FieldtoTagMapConfig.cs
-
-redirectFrom: []
-layout: reference
-toc: true
-permalink: /Reference/v2/FieldMaps/FieldtoTagMapConfig/
-title: FieldtoTagMapConfig
-categories:
-- FieldMaps
-- v2
-topics:
-- topic: notes
- path: /docs/Reference/v2/FieldMaps/FieldtoTagMapConfig-notes.md
- exists: false
- markdown: ''
-- topic: introduction
- path: /docs/Reference/v2/FieldMaps/FieldtoTagMapConfig-introduction.md
- exists: false
- markdown: ''
-
----
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.v2.fieldmaps.fieldvaluemapconfig.md b/docs/collections/_reference/reference.v2.fieldmaps.fieldvaluemapconfig.md
deleted file mode 100644
index 6c592bc0b..000000000
--- a/docs/collections/_reference/reference.v2.fieldmaps.fieldvaluemapconfig.md
+++ /dev/null
@@ -1,71 +0,0 @@
----
-optionsClassName: FieldValueMapConfig
-optionsClassFullName: MigrationTools._EngineV1.Configuration.FieldMap.FieldValueMapConfig
-configurationSamples:
-- name: default
- description:
- code: >-
- {
- "$type": "FieldValueMapConfig",
- "WorkItemTypeName": "*",
- "sourceField": "System.Status",
- "targetField": "System.Status",
- "defaultValue": "New",
- "valueMapping": {
- "$type": "Dictionary`2",
- "New": "New",
- "Active": "Committed",
- "Resolved": "Committed",
- "Closed": "Done"
- }
- }
- sampleFor: MigrationTools._EngineV1.Configuration.FieldMap.FieldValueMapConfig
-description: Need to map not just the field but also values? This is the default value mapper.
-className: FieldValueMapConfig
-typeName: FieldMaps
-architecture: v2
-options:
-- parameterName: defaultValue
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: sourceField
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: targetField
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: valueMapping
- type: Dictionary
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: WorkItemTypeName
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-status: ready
-processingTarget: Work Item Field
-classFile: /src/MigrationTools/_EngineV1/Configuration/FieldMap/FieldValueMapConfig.cs
-optionsClassFile: /src/MigrationTools/_EngineV1/Configuration/FieldMap/FieldValueMapConfig.cs
-
-redirectFrom: []
-layout: reference
-toc: true
-permalink: /Reference/v2/FieldMaps/FieldValueMapConfig/
-title: FieldValueMapConfig
-categories:
-- FieldMaps
-- v2
-topics:
-- topic: notes
- path: /docs/Reference/v2/FieldMaps/FieldValueMapConfig-notes.md
- exists: false
- markdown: ''
-- topic: introduction
- path: /docs/Reference/v2/FieldMaps/FieldValueMapConfig-introduction.md
- exists: false
- markdown: ''
-
----
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.v2.fieldmaps.fieldvaluetotagmapconfig.md b/docs/collections/_reference/reference.v2.fieldmaps.fieldvaluetotagmapconfig.md
deleted file mode 100644
index 800e0426d..000000000
--- a/docs/collections/_reference/reference.v2.fieldmaps.fieldvaluetotagmapconfig.md
+++ /dev/null
@@ -1,60 +0,0 @@
----
-optionsClassName: FieldValuetoTagMapConfig
-optionsClassFullName: MigrationTools._EngineV1.Configuration.FieldMap.FieldValuetoTagMapConfig
-configurationSamples:
-- name: default
- description:
- code: >-
- {
- "$type": "FieldValuetoTagMapConfig",
- "WorkItemTypeName": "*",
- "sourceField": "System.Status",
- "pattern": "(Active|Resolved)",
- "formatExpression": "Status: {0}"
- }
- sampleFor: MigrationTools._EngineV1.Configuration.FieldMap.FieldValuetoTagMapConfig
-description: Need to create a Tag based on a field value? Just create a regex match and choose how to populate the target.
-className: FieldValuetoTagMapConfig
-typeName: FieldMaps
-architecture: v2
-options:
-- parameterName: formatExpression
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: pattern
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: sourceField
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: WorkItemTypeName
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-status: ready
-processingTarget: Work Item Field
-classFile: /src/MigrationTools/_EngineV1/Configuration/FieldMap/FieldValuetoTagMapConfig.cs
-optionsClassFile: /src/MigrationTools/_EngineV1/Configuration/FieldMap/FieldValuetoTagMapConfig.cs
-
-redirectFrom: []
-layout: reference
-toc: true
-permalink: /Reference/v2/FieldMaps/FieldValuetoTagMapConfig/
-title: FieldValuetoTagMapConfig
-categories:
-- FieldMaps
-- v2
-topics:
-- topic: notes
- path: /docs/Reference/v2/FieldMaps/FieldValuetoTagMapConfig-notes.md
- exists: false
- markdown: ''
-- topic: introduction
- path: /docs/Reference/v2/FieldMaps/FieldValuetoTagMapConfig-introduction.md
- exists: false
- markdown: ''
-
----
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.v2.fieldmaps.multivalueconditionalmapconfig.md b/docs/collections/_reference/reference.v2.fieldmaps.multivalueconditionalmapconfig.md
deleted file mode 100644
index 1ac619aea..000000000
--- a/docs/collections/_reference/reference.v2.fieldmaps.multivalueconditionalmapconfig.md
+++ /dev/null
@@ -1,61 +0,0 @@
----
-optionsClassName: MultiValueConditionalMapConfig
-optionsClassFullName: MigrationTools._EngineV1.Configuration.FieldMap.MultiValueConditionalMapConfig
-configurationSamples:
-- name: default
- description:
- code: >-
- {
- "$type": "MultiValueConditionalMapConfig",
- "WorkItemTypeName": "*",
- "sourceFieldsAndValues": {
- "$type": "Dictionary`2",
- "Something": "SomethingElse"
- },
- "targetFieldsAndValues": {
- "$type": "Dictionary`2",
- "Something": "SomethingElse"
- }
- }
- sampleFor: MigrationTools._EngineV1.Configuration.FieldMap.MultiValueConditionalMapConfig
-description: ??? If you know how to use this please send a PR :)
-className: MultiValueConditionalMapConfig
-typeName: FieldMaps
-architecture: v2
-options:
-- parameterName: sourceFieldsAndValues
- type: Dictionary
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: targetFieldsAndValues
- type: Dictionary
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: WorkItemTypeName
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-status: ready
-processingTarget: Work Item Field
-classFile: /src/MigrationTools/_EngineV1/Configuration/FieldMap/MultiValueConditionalMapConfig.cs
-optionsClassFile: /src/MigrationTools/_EngineV1/Configuration/FieldMap/MultiValueConditionalMapConfig.cs
-
-redirectFrom: []
-layout: reference
-toc: true
-permalink: /Reference/v2/FieldMaps/MultiValueConditionalMapConfig/
-title: MultiValueConditionalMapConfig
-categories:
-- FieldMaps
-- v2
-topics:
-- topic: notes
- path: /docs/Reference/v2/FieldMaps/MultiValueConditionalMapConfig-notes.md
- exists: false
- markdown: ''
-- topic: introduction
- path: /docs/Reference/v2/FieldMaps/MultiValueConditionalMapConfig-introduction.md
- exists: false
- markdown: ''
-
----
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.v2.fieldmaps.regexfieldmapconfig.md b/docs/collections/_reference/reference.v2.fieldmaps.regexfieldmapconfig.md
deleted file mode 100644
index 569b998d8..000000000
--- a/docs/collections/_reference/reference.v2.fieldmaps.regexfieldmapconfig.md
+++ /dev/null
@@ -1,65 +0,0 @@
----
-optionsClassName: RegexFieldMapConfig
-optionsClassFullName: MigrationTools._EngineV1.Configuration.FieldMap.RegexFieldMapConfig
-configurationSamples:
-- name: default
- description:
- code: >-
- {
- "$type": "RegexFieldMapConfig",
- "WorkItemTypeName": "*",
- "sourceField": "Custom.MyVersion",
- "targetField": "Custom.MyVersionYearOnly",
- "pattern": "([0-9]{4})",
- "replacement": "$1"
- }
- sampleFor: MigrationTools._EngineV1.Configuration.FieldMap.RegexFieldMapConfig
-description: I just need that bit of a field... need to send "2016.2" to two fields, one for year and one for release? Done.
-className: RegexFieldMapConfig
-typeName: FieldMaps
-architecture: v2
-options:
-- parameterName: pattern
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: replacement
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: sourceField
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: targetField
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: WorkItemTypeName
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-status: ready
-processingTarget: Work Item Field
-classFile: /src/MigrationTools/_EngineV1/Configuration/FieldMap/RegexFieldMapConfig.cs
-optionsClassFile: /src/MigrationTools/_EngineV1/Configuration/FieldMap/RegexFieldMapConfig.cs
-
-redirectFrom: []
-layout: reference
-toc: true
-permalink: /Reference/v2/FieldMaps/RegexFieldMapConfig/
-title: RegexFieldMapConfig
-categories:
-- FieldMaps
-- v2
-topics:
-- topic: notes
- path: /docs/Reference/v2/FieldMaps/RegexFieldMapConfig-notes.md
- exists: false
- markdown: ''
-- topic: introduction
- path: /docs/Reference/v2/FieldMaps/RegexFieldMapConfig-introduction.md
- exists: false
- markdown: ''
-
----
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.v2.fieldmaps.treetotagmapconfig.md b/docs/collections/_reference/reference.v2.fieldmaps.treetotagmapconfig.md
deleted file mode 100644
index 6471fefb3..000000000
--- a/docs/collections/_reference/reference.v2.fieldmaps.treetotagmapconfig.md
+++ /dev/null
@@ -1,55 +0,0 @@
----
-optionsClassName: TreeToTagMapConfig
-optionsClassFullName: MigrationTools._EngineV1.Configuration.FieldMap.TreeToTagMapConfig
-configurationSamples:
-- name: default
- description:
- code: >-
- {
- "$type": "TreeToTagMapConfig",
- "WorkItemTypeName": "*",
- "toSkip": 2,
- "timeTravel": 0
- }
- sampleFor: MigrationTools._EngineV1.Configuration.FieldMap.TreeToTagMapConfig
-description: Need to clear out those nasty Area tree hierarchies? This creates Tags for each node in the Area Path...
-className: TreeToTagMapConfig
-typeName: FieldMaps
-architecture: v2
-options:
-- parameterName: timeTravel
- type: Int32
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: toSkip
- type: Int32
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: WorkItemTypeName
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-status: ready
-processingTarget: Work Item Field
-classFile: /src/MigrationTools/_EngineV1/Configuration/FieldMap/TreeToTagMapConfig.cs
-optionsClassFile: /src/MigrationTools/_EngineV1/Configuration/FieldMap/TreeToTagMapConfig.cs
-
-redirectFrom: []
-layout: reference
-toc: true
-permalink: /Reference/v2/FieldMaps/TreeToTagMapConfig/
-title: TreeToTagMapConfig
-categories:
-- FieldMaps
-- v2
-topics:
-- topic: notes
- path: /docs/Reference/v2/FieldMaps/TreeToTagMapConfig-notes.md
- exists: false
- markdown: ''
-- topic: introduction
- path: /docs/Reference/v2/FieldMaps/TreeToTagMapConfig-introduction.md
- exists: false
- markdown: ''
-
----
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.v2.processorenrichers.appendmigrationtoolsignaturefooter.md b/docs/collections/_reference/reference.v2.processorenrichers.appendmigrationtoolsignaturefooter.md
deleted file mode 100644
index 2ca13bfc6..000000000
--- a/docs/collections/_reference/reference.v2.processorenrichers.appendmigrationtoolsignaturefooter.md
+++ /dev/null
@@ -1,49 +0,0 @@
----
-optionsClassName: AppendMigrationToolSignatureFooterOptions
-optionsClassFullName: MigrationTools.Enrichers.AppendMigrationToolSignatureFooterOptions
-configurationSamples:
-- name: default
- description:
- code: >-
- {
- "$type": "AppendMigrationToolSignatureFooterOptions",
- "Enabled": true
- }
- sampleFor: MigrationTools.Enrichers.AppendMigrationToolSignatureFooterOptions
-description: missng XML code comments
-className: AppendMigrationToolSignatureFooter
-typeName: ProcessorEnrichers
-architecture: v2
-options:
-- parameterName: Enabled
- type: Boolean
- description: If enabled this will run this migrator
- defaultValue: true
-- parameterName: RefName
- type: String
- description: For internal use
- defaultValue: missng XML code comments
-status: missng XML code comments
-processingTarget: missng XML code comments
-classFile: /src/MigrationTools/ProcessorEnrichers/WorkItemProcessorEnrichers/AppendMigrationToolSignatureFooter.cs
-optionsClassFile: /src/MigrationTools/ProcessorEnrichers/WorkItemProcessorEnrichers/AppendMigrationToolSignatureFooterOptions.cs
-
-redirectFrom: []
-layout: reference
-toc: true
-permalink: /Reference/v2/ProcessorEnrichers/AppendMigrationToolSignatureFooter/
-title: AppendMigrationToolSignatureFooter
-categories:
-- ProcessorEnrichers
-- v2
-topics:
-- topic: notes
- path: /docs/Reference/v2/ProcessorEnrichers/AppendMigrationToolSignatureFooter-notes.md
- exists: false
- markdown: ''
-- topic: introduction
- path: /docs/Reference/v2/ProcessorEnrichers/AppendMigrationToolSignatureFooter-introduction.md
- exists: false
- markdown: ''
-
----
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.v2.processorenrichers.embededimagesrepairenricher.md b/docs/collections/_reference/reference.v2.processorenrichers.embededimagesrepairenricher.md
deleted file mode 100644
index d5f350675..000000000
--- a/docs/collections/_reference/reference.v2.processorenrichers.embededimagesrepairenricher.md
+++ /dev/null
@@ -1,33 +0,0 @@
----
-optionsClassName:
-optionsClassFullName:
-configurationSamples: []
-description: missng XML code comments
-className: EmbededImagesRepairEnricher
-typeName: ProcessorEnrichers
-architecture: v2
-options: []
-status: missng XML code comments
-processingTarget: missng XML code comments
-classFile: /src/MigrationTools.Clients.AzureDevops.Rest/Enrichers/EmbededImagesRepairEnricher.cs
-optionsClassFile:
-
-redirectFrom: []
-layout: reference
-toc: true
-permalink: /Reference/v2/ProcessorEnrichers/EmbededImagesRepairEnricher/
-title: EmbededImagesRepairEnricher
-categories:
-- ProcessorEnrichers
-- v2
-topics:
-- topic: notes
- path: /docs/Reference/v2/ProcessorEnrichers/EmbededImagesRepairEnricher-notes.md
- exists: false
- markdown: ''
-- topic: introduction
- path: /docs/Reference/v2/ProcessorEnrichers/EmbededImagesRepairEnricher-introduction.md
- exists: false
- markdown: ''
-
----
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.v2.processorenrichers.filterworkitemsthatalreadyexistintarget.md b/docs/collections/_reference/reference.v2.processorenrichers.filterworkitemsthatalreadyexistintarget.md
deleted file mode 100644
index 6c0207513..000000000
--- a/docs/collections/_reference/reference.v2.processorenrichers.filterworkitemsthatalreadyexistintarget.md
+++ /dev/null
@@ -1,58 +0,0 @@
----
-optionsClassName: FilterWorkItemsThatAlreadyExistInTargetOptions
-optionsClassFullName: MigrationTools.Enrichers.FilterWorkItemsThatAlreadyExistInTargetOptions
-configurationSamples:
-- name: default
- description:
- code: >-
- {
- "$type": "FilterWorkItemsThatAlreadyExistInTargetOptions",
- "Enabled": true,
- "Query": {
- "$type": "QueryOptions",
- "Query": "SELECT [System.Id], [System.Tags] FROM WorkItems WHERE [System.TeamProject] = @TeamProject AND [System.WorkItemType] NOT IN ('Test Suite', 'Test Plan') ORDER BY [System.ChangedDate] desc",
- "Parameters": null
- }
- }
- sampleFor: MigrationTools.Enrichers.FilterWorkItemsThatAlreadyExistInTargetOptions
-description: missng XML code comments
-className: FilterWorkItemsThatAlreadyExistInTarget
-typeName: ProcessorEnrichers
-architecture: v2
-options:
-- parameterName: Enabled
- type: Boolean
- description: If enabled this will run this migrator
- defaultValue: true
-- parameterName: Query
- type: QueryOptions
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: RefName
- type: String
- description: For internal use
- defaultValue: missng XML code comments
-status: missng XML code comments
-processingTarget: missng XML code comments
-classFile: /src/MigrationTools/ProcessorEnrichers/WorkItemProcessorEnrichers/FilterWorkItemsThatAlreadyExistInTarget.cs
-optionsClassFile: /src/MigrationTools/ProcessorEnrichers/WorkItemProcessorEnrichers/FilterWorkItemsThatAlreadyExistInTargetOptions.cs
-
-redirectFrom: []
-layout: reference
-toc: true
-permalink: /Reference/v2/ProcessorEnrichers/FilterWorkItemsThatAlreadyExistInTarget/
-title: FilterWorkItemsThatAlreadyExistInTarget
-categories:
-- ProcessorEnrichers
-- v2
-topics:
-- topic: notes
- path: /docs/Reference/v2/ProcessorEnrichers/FilterWorkItemsThatAlreadyExistInTarget-notes.md
- exists: false
- markdown: ''
-- topic: introduction
- path: /docs/Reference/v2/ProcessorEnrichers/FilterWorkItemsThatAlreadyExistInTarget-introduction.md
- exists: false
- markdown: ''
-
----
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.v2.processorenrichers.pauseaftereachitem.md b/docs/collections/_reference/reference.v2.processorenrichers.pauseaftereachitem.md
deleted file mode 100644
index ad0a8d708..000000000
--- a/docs/collections/_reference/reference.v2.processorenrichers.pauseaftereachitem.md
+++ /dev/null
@@ -1,49 +0,0 @@
----
-optionsClassName: PauseAfterEachItemOptions
-optionsClassFullName: MigrationTools.Enrichers.PauseAfterEachItemOptions
-configurationSamples:
-- name: default
- description:
- code: >-
- {
- "$type": "PauseAfterEachItemOptions",
- "Enabled": true
- }
- sampleFor: MigrationTools.Enrichers.PauseAfterEachItemOptions
-description: missng XML code comments
-className: PauseAfterEachItem
-typeName: ProcessorEnrichers
-architecture: v2
-options:
-- parameterName: Enabled
- type: Boolean
- description: If enabled this will run this migrator
- defaultValue: true
-- parameterName: RefName
- type: String
- description: For internal use
- defaultValue: missng XML code comments
-status: missng XML code comments
-processingTarget: missng XML code comments
-classFile: /src/MigrationTools/ProcessorEnrichers/PauseAfterEachItem.cs
-optionsClassFile: /src/MigrationTools/ProcessorEnrichers/PauseAfterEachItemOptions.cs
-
-redirectFrom: []
-layout: reference
-toc: true
-permalink: /Reference/v2/ProcessorEnrichers/PauseAfterEachItem/
-title: PauseAfterEachItem
-categories:
-- ProcessorEnrichers
-- v2
-topics:
-- topic: notes
- path: /docs/Reference/v2/ProcessorEnrichers/PauseAfterEachItem-notes.md
- exists: false
- markdown: ''
-- topic: introduction
- path: /docs/Reference/v2/ProcessorEnrichers/PauseAfterEachItem-introduction.md
- exists: false
- markdown: ''
-
----
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.v2.processorenrichers.skiptofinalrevisedworkitemtype.md b/docs/collections/_reference/reference.v2.processorenrichers.skiptofinalrevisedworkitemtype.md
deleted file mode 100644
index 617c8de68..000000000
--- a/docs/collections/_reference/reference.v2.processorenrichers.skiptofinalrevisedworkitemtype.md
+++ /dev/null
@@ -1,49 +0,0 @@
----
-optionsClassName: SkipToFinalRevisedWorkItemTypeOptions
-optionsClassFullName: MigrationTools.Enrichers.SkipToFinalRevisedWorkItemTypeOptions
-configurationSamples:
-- name: default
- description:
- code: >-
- {
- "$type": "SkipToFinalRevisedWorkItemTypeOptions",
- "Enabled": true
- }
- sampleFor: MigrationTools.Enrichers.SkipToFinalRevisedWorkItemTypeOptions
-description: missng XML code comments
-className: SkipToFinalRevisedWorkItemType
-typeName: ProcessorEnrichers
-architecture: v2
-options:
-- parameterName: Enabled
- type: Boolean
- description: If enabled this will run this migrator
- defaultValue: true
-- parameterName: RefName
- type: String
- description: For internal use
- defaultValue: missng XML code comments
-status: missng XML code comments
-processingTarget: missng XML code comments
-classFile: /src/MigrationTools/ProcessorEnrichers/WorkItemProcessorEnrichers/SkipToFinalRevisedWorkItemType.cs
-optionsClassFile: /src/MigrationTools/ProcessorEnrichers/WorkItemProcessorEnrichers/SkipToFinalRevisedWorkItemTypeOptions.cs
-
-redirectFrom: []
-layout: reference
-toc: true
-permalink: /Reference/v2/ProcessorEnrichers/SkipToFinalRevisedWorkItemType/
-title: SkipToFinalRevisedWorkItemType
-categories:
-- ProcessorEnrichers
-- v2
-topics:
-- topic: notes
- path: /docs/Reference/v2/ProcessorEnrichers/SkipToFinalRevisedWorkItemType-notes.md
- exists: false
- markdown: ''
-- topic: introduction
- path: /docs/Reference/v2/ProcessorEnrichers/SkipToFinalRevisedWorkItemType-introduction.md
- exists: false
- markdown: ''
-
----
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.v2.processorenrichers.stringmanipulatorenricher.md b/docs/collections/_reference/reference.v2.processorenrichers.stringmanipulatorenricher.md
deleted file mode 100644
index 2f48fdaf8..000000000
--- a/docs/collections/_reference/reference.v2.processorenrichers.stringmanipulatorenricher.md
+++ /dev/null
@@ -1,67 +0,0 @@
----
-optionsClassName: StringManipulatorEnricherOptions
-optionsClassFullName: MigrationTools.Enrichers.StringManipulatorEnricherOptions
-configurationSamples:
-- name: default
- description:
- code: >-
- {
- "$type": "StringManipulatorEnricherOptions",
- "Enabled": true,
- "MaxStringLength": 1000000,
- "Manipulators": [
- {
- "$type": "RegexStringManipulator",
- "Enabled": false,
- "Pattern": "[^( -~)\\n\\r\\t]+",
- "Replacement": "",
- "Description": "Remove all non-ASKI characters between ^ and ~."
- }
- ]
- }
- sampleFor: MigrationTools.Enrichers.StringManipulatorEnricherOptions
-description: Used to process the String fields of a work item. This is useful for cleaning up data. It will limit fields to a max length and apply regex replacements based on what is configured. Each regex replacement is applied in order and can be enabled or disabled.
-className: StringManipulatorEnricher
-typeName: ProcessorEnrichers
-architecture: v2
-options:
-- parameterName: Enabled
- type: Boolean
- description: If enabled this will run this migrator
- defaultValue: true
-- parameterName: Manipulators
- type: List
- description: List of regex based string manipulations to apply to all string fields. Each regex replacement is applied in order and can be enabled or disabled.
- defaultValue: '{}'
-- parameterName: MaxStringLength
- type: Int32
- description: Max number of chars in a string. Applied last, and set to 1000000 by default.
- defaultValue: 1000000
-- parameterName: RefName
- type: String
- description: For internal use
- defaultValue: missng XML code comments
-status: missng XML code comments
-processingTarget: missng XML code comments
-classFile: /src/MigrationTools/ProcessorEnrichers/WorkItemProcessorEnrichers/StringManipulatorEnricher.cs
-optionsClassFile: /src/MigrationTools/ProcessorEnrichers/WorkItemProcessorEnrichers/StringManipulatorEnricherOptions.cs
-
-redirectFrom: []
-layout: reference
-toc: true
-permalink: /Reference/v2/ProcessorEnrichers/StringManipulatorEnricher/
-title: StringManipulatorEnricher
-categories:
-- ProcessorEnrichers
-- v2
-topics:
-- topic: notes
- path: /docs/Reference/v2/ProcessorEnrichers/StringManipulatorEnricher-notes.md
- exists: false
- markdown: ''
-- topic: introduction
- path: /docs/Reference/v2/ProcessorEnrichers/StringManipulatorEnricher-introduction.md
- exists: false
- markdown: ''
-
----
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.v2.processorenrichers.tfsattachmentenricher.md b/docs/collections/_reference/reference.v2.processorenrichers.tfsattachmentenricher.md
deleted file mode 100644
index c2759b6ce..000000000
--- a/docs/collections/_reference/reference.v2.processorenrichers.tfsattachmentenricher.md
+++ /dev/null
@@ -1,59 +0,0 @@
----
-optionsClassName: TfsAttachmentEnricherOptions
-optionsClassFullName: MigrationTools.Enrichers.TfsAttachmentEnricherOptions
-configurationSamples:
-- name: default
- description:
- code: >-
- {
- "$type": "TfsAttachmentEnricherOptions",
- "Enabled": true,
- "ExportBasePath": "c:\\temp\\WorkItemAttachmentExport",
- "MaxAttachmentSize": 480000000
- }
- sampleFor: MigrationTools.Enrichers.TfsAttachmentEnricherOptions
-description: missng XML code comments
-className: TfsAttachmentEnricher
-typeName: ProcessorEnrichers
-architecture: v2
-options:
-- parameterName: Enabled
- type: Boolean
- description: If enabled this will run this migrator
- defaultValue: true
-- parameterName: ExportBasePath
- type: String
- description: '`AttachmentMigration` is set to true then you need to specify a working path for attachments to be saved locally.'
- defaultValue: C:\temp\Migration\
-- parameterName: MaxAttachmentSize
- type: Int32
- description: '`AttachmentMigration` is set to true then you need to specify a max file size for upload in bites. For Azure DevOps Services the default is 480,000,000 bites (60mb), for TFS its 32,000,000 bites (4mb).'
- defaultValue: 480000000
-- parameterName: RefName
- type: String
- description: For internal use
- defaultValue: missng XML code comments
-status: missng XML code comments
-processingTarget: missng XML code comments
-classFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/ProcessorEnrichers/TfsAttachmentEnricher.cs
-optionsClassFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/ProcessorEnrichers/TfsAttachmentEnricherOptions.cs
-
-redirectFrom: []
-layout: reference
-toc: true
-permalink: /Reference/v2/ProcessorEnrichers/TfsAttachmentEnricher/
-title: TfsAttachmentEnricher
-categories:
-- ProcessorEnrichers
-- v2
-topics:
-- topic: notes
- path: /docs/Reference/v2/ProcessorEnrichers/TfsAttachmentEnricher-notes.md
- exists: false
- markdown: ''
-- topic: introduction
- path: /docs/Reference/v2/ProcessorEnrichers/TfsAttachmentEnricher-introduction.md
- exists: false
- markdown: ''
-
----
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.v2.processorenrichers.tfsembededimagesenricher.md b/docs/collections/_reference/reference.v2.processorenrichers.tfsembededimagesenricher.md
deleted file mode 100644
index 3ddae4adb..000000000
--- a/docs/collections/_reference/reference.v2.processorenrichers.tfsembededimagesenricher.md
+++ /dev/null
@@ -1,33 +0,0 @@
----
-optionsClassName:
-optionsClassFullName:
-configurationSamples: []
-description: missng XML code comments
-className: TfsEmbededImagesEnricher
-typeName: ProcessorEnrichers
-architecture: v2
-options: []
-status: missng XML code comments
-processingTarget: missng XML code comments
-classFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Enrichers/TfsEmbededImagesEnricher.cs
-optionsClassFile:
-
-redirectFrom: []
-layout: reference
-toc: true
-permalink: /Reference/v2/ProcessorEnrichers/TfsEmbededImagesEnricher/
-title: TfsEmbededImagesEnricher
-categories:
-- ProcessorEnrichers
-- v2
-topics:
-- topic: notes
- path: /docs/Reference/v2/ProcessorEnrichers/TfsEmbededImagesEnricher-notes.md
- exists: false
- markdown: ''
-- topic: introduction
- path: /docs/Reference/v2/ProcessorEnrichers/TfsEmbededImagesEnricher-introduction.md
- exists: false
- markdown: ''
-
----
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.v2.processorenrichers.tfsgitrepositoryenricher.md b/docs/collections/_reference/reference.v2.processorenrichers.tfsgitrepositoryenricher.md
deleted file mode 100644
index c9880e418..000000000
--- a/docs/collections/_reference/reference.v2.processorenrichers.tfsgitrepositoryenricher.md
+++ /dev/null
@@ -1,33 +0,0 @@
----
-optionsClassName:
-optionsClassFullName:
-configurationSamples: []
-description: missng XML code comments
-className: TfsGitRepositoryEnricher
-typeName: ProcessorEnrichers
-architecture: v2
-options: []
-status: missng XML code comments
-processingTarget: missng XML code comments
-classFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Enrichers/TfsGitRepositoryEnricher.cs
-optionsClassFile:
-
-redirectFrom: []
-layout: reference
-toc: true
-permalink: /Reference/v2/ProcessorEnrichers/TfsGitRepositoryEnricher/
-title: TfsGitRepositoryEnricher
-categories:
-- ProcessorEnrichers
-- v2
-topics:
-- topic: notes
- path: /docs/Reference/v2/ProcessorEnrichers/TfsGitRepositoryEnricher-notes.md
- exists: false
- markdown: ''
-- topic: introduction
- path: /docs/Reference/v2/ProcessorEnrichers/TfsGitRepositoryEnricher-introduction.md
- exists: false
- markdown: ''
-
----
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.v2.processorenrichers.tfsrevisionmanager.md b/docs/collections/_reference/reference.v2.processorenrichers.tfsrevisionmanager.md
deleted file mode 100644
index 5fc782201..000000000
--- a/docs/collections/_reference/reference.v2.processorenrichers.tfsrevisionmanager.md
+++ /dev/null
@@ -1,59 +0,0 @@
----
-optionsClassName: TfsRevisionManagerOptions
-optionsClassFullName: MigrationTools.Enrichers.TfsRevisionManagerOptions
-configurationSamples:
-- name: default
- description:
- code: >-
- {
- "$type": "TfsRevisionManagerOptions",
- "Enabled": true,
- "ReplayRevisions": true,
- "MaxRevisions": 0
- }
- sampleFor: MigrationTools.Enrichers.TfsRevisionManagerOptions
-description: The TfsRevisionManager manipulates the revisions of a work item to reduce the number of revisions that are migrated.
-className: TfsRevisionManager
-typeName: ProcessorEnrichers
-architecture: v2
-options:
-- parameterName: Enabled
- type: Boolean
- description: If enabled this will run this migrator
- defaultValue: true
-- parameterName: MaxRevisions
- type: Int32
- description: Sets the maximum number of revisions that will be migrated. "First + Last N = Max". If this was set to 5 and there were 10 revisions you would get the first 1 (creation) and the latest 4 migrated.
- defaultValue: 0
-- parameterName: RefName
- type: String
- description: For internal use
- defaultValue: missng XML code comments
-- parameterName: ReplayRevisions
- type: Boolean
- description: You can choose to migrate the tip only (a single write) or all of the revisions (many writes). If you are setting this to `false` to migrate only the tip then you should set `BuildFieldTable` to `true`.
- defaultValue: true
-status: missng XML code comments
-processingTarget: missng XML code comments
-classFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/ProcessorEnrichers/TfsRevisionManager.cs
-optionsClassFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/ProcessorEnrichers/TfsRevisionManagerOptions.cs
-
-redirectFrom: []
-layout: reference
-toc: true
-permalink: /Reference/v2/ProcessorEnrichers/TfsRevisionManager/
-title: TfsRevisionManager
-categories:
-- ProcessorEnrichers
-- v2
-topics:
-- topic: notes
- path: /docs/Reference/v2/ProcessorEnrichers/TfsRevisionManager-notes.md
- exists: false
- markdown: ''
-- topic: introduction
- path: /docs/Reference/v2/ProcessorEnrichers/TfsRevisionManager-introduction.md
- exists: false
- markdown: ''
-
----
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.v2.processorenrichers.tfsteamsettingsenricher.md b/docs/collections/_reference/reference.v2.processorenrichers.tfsteamsettingsenricher.md
deleted file mode 100644
index 58f42da54..000000000
--- a/docs/collections/_reference/reference.v2.processorenrichers.tfsteamsettingsenricher.md
+++ /dev/null
@@ -1,69 +0,0 @@
----
-optionsClassName: TfsTeamSettingsEnricherOptions
-optionsClassFullName: MigrationTools.Enrichers.TfsTeamSettingsEnricherOptions
-configurationSamples:
-- name: default
- description:
- code: >-
- {
- "$type": "TfsTeamSettingsEnricherOptions",
- "Enabled": false,
- "MigrateTeamSettings": true,
- "UpdateTeamSettings": true,
- "MigrateTeamCapacities": true,
- "Teams": null
- }
- sampleFor: MigrationTools.Enrichers.TfsTeamSettingsEnricherOptions
-description: The TfsUserMappingEnricher is used to map users from the source to the target system. Run it with the ExportUsersForMappingContext to create a mapping file then with WorkItemMigrationContext to use the mapping file to update the users in the target system as you migrate the work items.
-className: TfsTeamSettingsEnricher
-typeName: ProcessorEnrichers
-architecture: v2
-options:
-- parameterName: Enabled
- type: Boolean
- description: If enabled this will run this migrator
- defaultValue: true
-- parameterName: MigrateTeamCapacities
- type: Boolean
- description: 'Migrate original team member capacities after their creation on the target team project. Note: It will only migrate team member capacity if the team member with same display name exists on the target collection otherwise it will be ignored.'
- defaultValue: false
-- parameterName: MigrateTeamSettings
- type: Boolean
- description: Migrate original team settings after their creation on target team project
- defaultValue: false
-- parameterName: RefName
- type: String
- description: For internal use
- defaultValue: missng XML code comments
-- parameterName: Teams
- type: List
- description: List of Teams to process. If this is `null` then all teams will be processed.
- defaultValue: missng XML code comments
-- parameterName: UpdateTeamSettings
- type: Boolean
- description: Reset the target team settings to match the source if the team exists
- defaultValue: false
-status: missng XML code comments
-processingTarget: missng XML code comments
-classFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/ProcessorEnrichers/TfsTeamSettingsEnricher.cs
-optionsClassFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/ProcessorEnrichers/TfsTeamSettingsEnricherOptions.cs
-
-redirectFrom: []
-layout: reference
-toc: true
-permalink: /Reference/v2/ProcessorEnrichers/TfsTeamSettingsEnricher/
-title: TfsTeamSettingsEnricher
-categories:
-- ProcessorEnrichers
-- v2
-topics:
-- topic: notes
- path: /docs/Reference/v2/ProcessorEnrichers/TfsTeamSettingsEnricher-notes.md
- exists: false
- markdown: ''
-- topic: introduction
- path: /docs/Reference/v2/ProcessorEnrichers/TfsTeamSettingsEnricher-introduction.md
- exists: false
- markdown: ''
-
----
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.v2.processorenrichers.tfsusermappingenricher.md b/docs/collections/_reference/reference.v2.processorenrichers.tfsusermappingenricher.md
deleted file mode 100644
index e1c36df86..000000000
--- a/docs/collections/_reference/reference.v2.processorenrichers.tfsusermappingenricher.md
+++ /dev/null
@@ -1,66 +0,0 @@
----
-optionsClassName: TfsUserMappingEnricherOptions
-optionsClassFullName: MigrationTools.Enrichers.TfsUserMappingEnricherOptions
-configurationSamples:
-- name: default
- description:
- code: >-
- {
- "$type": "TfsUserMappingEnricherOptions",
- "Enabled": false,
- "IdentityFieldsToCheck": [
- "System.AssignedTo",
- "System.ChangedBy",
- "System.CreatedBy",
- "Microsoft.VSTS.Common.ActivatedBy",
- "Microsoft.VSTS.Common.ResolvedBy",
- "Microsoft.VSTS.Common.ClosedBy"
- ],
- "UserMappingFile": "usermapping.json"
- }
- sampleFor: MigrationTools.Enrichers.TfsUserMappingEnricherOptions
-description: The TfsUserMappingEnricher is used to map users from the source to the target system. Run it with the ExportUsersForMappingContext to create a mapping file then with WorkItemMigrationContext to use the mapping file to update the users in the target system as you migrate the work items.
-className: TfsUserMappingEnricher
-typeName: ProcessorEnrichers
-architecture: v2
-options:
-- parameterName: Enabled
- type: Boolean
- description: If enabled this will run this migrator
- defaultValue: true
-- parameterName: IdentityFieldsToCheck
- type: List
- description: This is a list of the Identiy fields in the Source to check for user mapping purposes. You should list all identiy fields that you wan to map.
- defaultValue: missng XML code comments
-- parameterName: RefName
- type: String
- description: For internal use
- defaultValue: missng XML code comments
-- parameterName: UserMappingFile
- type: String
- description: This is the file that will be used to export or import the user mappings. Use the ExportUsersForMapping processor to create the file.
- defaultValue: missng XML code comments
-status: missng XML code comments
-processingTarget: missng XML code comments
-classFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/ProcessorEnrichers/TfsUserMappingEnricher.cs
-optionsClassFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/ProcessorEnrichers/TfsUserMappingEnricherOptions.cs
-
-redirectFrom: []
-layout: reference
-toc: true
-permalink: /Reference/v2/ProcessorEnrichers/TfsUserMappingEnricher/
-title: TfsUserMappingEnricher
-categories:
-- ProcessorEnrichers
-- v2
-topics:
-- topic: notes
- path: /docs/Reference/v2/ProcessorEnrichers/TfsUserMappingEnricher-notes.md
- exists: false
- markdown: ''
-- topic: introduction
- path: /docs/Reference/v2/ProcessorEnrichers/TfsUserMappingEnricher-introduction.md
- exists: false
- markdown: ''
-
----
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.v2.processorenrichers.tfsvalidaterequiredfield.md b/docs/collections/_reference/reference.v2.processorenrichers.tfsvalidaterequiredfield.md
deleted file mode 100644
index 0f8b2a64e..000000000
--- a/docs/collections/_reference/reference.v2.processorenrichers.tfsvalidaterequiredfield.md
+++ /dev/null
@@ -1,49 +0,0 @@
----
-optionsClassName: TfsValidateRequiredFieldOptions
-optionsClassFullName: MigrationTools.ProcessorEnrichers.TfsValidateRequiredFieldOptions
-configurationSamples:
-- name: default
- description:
- code: >-
- {
- "$type": "TfsValidateRequiredFieldOptions",
- "Enabled": true
- }
- sampleFor: MigrationTools.ProcessorEnrichers.TfsValidateRequiredFieldOptions
-description: missng XML code comments
-className: TfsValidateRequiredField
-typeName: ProcessorEnrichers
-architecture: v2
-options:
-- parameterName: Enabled
- type: Boolean
- description: If enabled this will run this migrator
- defaultValue: true
-- parameterName: RefName
- type: String
- description: For internal use
- defaultValue: missng XML code comments
-status: missng XML code comments
-processingTarget: missng XML code comments
-classFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/ProcessorEnrichers/TfsValidateRequiredField.cs
-optionsClassFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/ProcessorEnrichers/TfsValidateRequiredFieldOptions.cs
-
-redirectFrom: []
-layout: reference
-toc: true
-permalink: /Reference/v2/ProcessorEnrichers/TfsValidateRequiredField/
-title: TfsValidateRequiredField
-categories:
-- ProcessorEnrichers
-- v2
-topics:
-- topic: notes
- path: /docs/Reference/v2/ProcessorEnrichers/TfsValidateRequiredField-notes.md
- exists: false
- markdown: ''
-- topic: introduction
- path: /docs/Reference/v2/ProcessorEnrichers/TfsValidateRequiredField-introduction.md
- exists: false
- markdown: ''
-
----
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.v2.processorenrichers.tfsworkitemembededlinkenricher.md b/docs/collections/_reference/reference.v2.processorenrichers.tfsworkitemembededlinkenricher.md
deleted file mode 100644
index 04ad32913..000000000
--- a/docs/collections/_reference/reference.v2.processorenrichers.tfsworkitemembededlinkenricher.md
+++ /dev/null
@@ -1,33 +0,0 @@
----
-optionsClassName:
-optionsClassFullName:
-configurationSamples: []
-description: missng XML code comments
-className: TfsWorkItemEmbededLinkEnricher
-typeName: ProcessorEnrichers
-architecture: v2
-options: []
-status: missng XML code comments
-processingTarget: missng XML code comments
-classFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Enrichers/TfsWorkItemEmbededLinkEnricher.cs
-optionsClassFile:
-
-redirectFrom: []
-layout: reference
-toc: true
-permalink: /Reference/v2/ProcessorEnrichers/TfsWorkItemEmbededLinkEnricher/
-title: TfsWorkItemEmbededLinkEnricher
-categories:
-- ProcessorEnrichers
-- v2
-topics:
-- topic: notes
- path: /docs/Reference/v2/ProcessorEnrichers/TfsWorkItemEmbededLinkEnricher-notes.md
- exists: false
- markdown: ''
-- topic: introduction
- path: /docs/Reference/v2/ProcessorEnrichers/TfsWorkItemEmbededLinkEnricher-introduction.md
- exists: false
- markdown: ''
-
----
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.v2.processorenrichers.tfsworkitemlinkenricher.md b/docs/collections/_reference/reference.v2.processorenrichers.tfsworkitemlinkenricher.md
deleted file mode 100644
index 4f3d2c366..000000000
--- a/docs/collections/_reference/reference.v2.processorenrichers.tfsworkitemlinkenricher.md
+++ /dev/null
@@ -1,59 +0,0 @@
----
-optionsClassName: TfsWorkItemLinkEnricherOptions
-optionsClassFullName: MigrationTools.Enrichers.TfsWorkItemLinkEnricherOptions
-configurationSamples:
-- name: default
- description:
- code: >-
- {
- "$type": "TfsWorkItemLinkEnricherOptions",
- "Enabled": true,
- "FilterIfLinkCountMatches": true,
- "SaveAfterEachLinkIsAdded": false
- }
- sampleFor: MigrationTools.Enrichers.TfsWorkItemLinkEnricherOptions
-description: missng XML code comments
-className: TfsWorkItemLinkEnricher
-typeName: ProcessorEnrichers
-architecture: v2
-options:
-- parameterName: Enabled
- type: Boolean
- description: If enabled this will run this migrator
- defaultValue: true
-- parameterName: FilterIfLinkCountMatches
- type: Boolean
- description: Skip validating links if the number of links in the source and the target matches!
- defaultValue: missng XML code comments
-- parameterName: RefName
- type: String
- description: For internal use
- defaultValue: missng XML code comments
-- parameterName: SaveAfterEachLinkIsAdded
- type: Boolean
- description: Save the work item after each link is added. This will slow the migration as it will cause many saves to the TFS database.
- defaultValue: false
-status: missng XML code comments
-processingTarget: missng XML code comments
-classFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/ProcessorEnrichers/TfsWorkItemLinkEnricher.cs
-optionsClassFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/ProcessorEnrichers/TfsWorkItemLinkEnricherOptions.cs
-
-redirectFrom: []
-layout: reference
-toc: true
-permalink: /Reference/v2/ProcessorEnrichers/TfsWorkItemLinkEnricher/
-title: TfsWorkItemLinkEnricher
-categories:
-- ProcessorEnrichers
-- v2
-topics:
-- topic: notes
- path: /docs/Reference/v2/ProcessorEnrichers/TfsWorkItemLinkEnricher-notes.md
- exists: false
- markdown: ''
-- topic: introduction
- path: /docs/Reference/v2/ProcessorEnrichers/TfsWorkItemLinkEnricher-introduction.md
- exists: false
- markdown: ''
-
----
\ No newline at end of file
diff --git a/docs/collections/_reference/reference.v2.processors.tfsareaanditerationprocessor.md b/docs/collections/_reference/reference.v2.processors.tfsareaanditerationprocessor.md
deleted file mode 100644
index 25a262ab3..000000000
--- a/docs/collections/_reference/reference.v2.processors.tfsareaanditerationprocessor.md
+++ /dev/null
@@ -1,83 +0,0 @@
----
-optionsClassName: TfsAreaAndIterationProcessorOptions
-optionsClassFullName: MigrationTools.Processors.TfsAreaAndIterationProcessorOptions
-configurationSamples:
-- name: default
- description:
- code: >-
- {
- "$type": "TfsAreaAndIterationProcessorOptions",
- "Enabled": false,
- "NodeBasePaths": null,
- "AreaMaps": {
- "$type": "Dictionary`2"
- },
- "IterationMaps": {
- "$type": "Dictionary`2"
- },
- "ProcessorEnrichers": null,
- "SourceName": "sourceName",
- "TargetName": "targetName"
- }
- sampleFor: MigrationTools.Processors.TfsAreaAndIterationProcessorOptions
-description: The `TfsAreaAndIterationProcessor` migrates all of the Area nd Iteraion paths.
-className: TfsAreaAndIterationProcessor
-typeName: Processors
-architecture: v2
-options:
-- parameterName: AreaMaps
- type: Dictionary
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: Enabled
- type: Boolean
- description: If set to `true` then the processor will run. Set to `false` and the processor will not run.
- defaultValue: missng XML code comments
-- parameterName: IterationMaps
- type: Dictionary
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: NodeBasePaths
- type: String[]
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: ProcessorEnrichers
- 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.
- defaultValue: missng XML code comments
-- parameterName: 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.'
- defaultValue: missng XML code comments
-- parameterName: SourceName
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-- parameterName: TargetName
- type: String
- description: missng XML code comments
- defaultValue: missng XML code comments
-status: Beta
-processingTarget: Work Items
-classFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/TfsAreaAndIterationProcessor.cs
-optionsClassFile: /src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/TfsAreaAndIterationProcessorOptions.cs
-
-redirectFrom: []
-layout: reference
-toc: true
-permalink: /Reference/v2/Processors/TfsAreaAndIterationProcessor/
-title: TfsAreaAndIterationProcessor
-categories:
-- Processors
-- v2
-topics:
-- topic: notes
- path: /docs/Reference/v2/Processors/TfsAreaAndIterationProcessor-notes.md
- exists: false
- markdown: ''
-- topic: introduction
- path: /docs/Reference/v2/Processors/TfsAreaAndIterationProcessor-introduction.md
- exists: false
- markdown: ''
-
----
\ No newline at end of file
diff --git a/docs/getting-started.md b/docs/getting-started.md
index 015f5b1d7..166e8952f 100644
--- a/docs/getting-started.md
+++ b/docs/getting-started.md
@@ -2,11 +2,9 @@
title: Getting Started
layout: page
pageType: index
-template: getting-started-template.md
toc: true
pageStatus: published
discussionId:
-redirect_from: /getting-started.html
---
If you want to perform a bulk edit or a migration then you need to start here. This tool has been tested on updating from 100 to 250,000 work items by its users.
@@ -44,7 +42,7 @@ You can now customize the configuration depending on what you need to do. Howeve
{% include sampleConfig/configuration.json %}
```
-The default [WorkItemMigrationConfig](/docs/Reference/v1/Processors/WorkItemMigrationConfig.md) processor will perform the following operations:
+The default [WorkItemMigrationConfig](_reference/reference.v1.processors.workitempostprocessingcontext.md) processor will perform the following operations:
* Migrate iterations and sprints
* Attachments
@@ -52,7 +50,7 @@ The default [WorkItemMigrationConfig](/docs/Reference/v1/Processors/WorkItemMigr
## How to execute configuration.json with minimal adjustments
-> Remember to add custom field ['ReflectedWorkItemId'](/docs/server-configuration.md) to only the target team project before starting migration!
+> Remember to add custom field ['ReflectedWorkItemId'](server-configuration.md) to only the target team project before starting migration!
> [NOTE!]
> In older versions of the tool we updated the Source work items with a link back to the Target to make migration easier. This has been removed and replaced with the `FilterWorkItemsThatAlreadyExistInTarget` option instead. **You do not need to add the reflected work item ID custom field to the Source environment.**
diff --git a/docs/index.md b/docs/index.md
index 9525de80e..ed8f6b783 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -171,20 +171,11 @@ These tools are build by naked Agility Limited's DevOps & Agility consultants to
**Watch the [Video Overview](https://youtu.be/RCJsST0xBCE) to get you started in 30 minutes. This tool is complicated and its not always easy to discover what you need to do.**
-## Processors (v1 Architecture)
+## Processors
-There are a number processors that can be used to migrate, or process, different sorts of data in different ways. Which one is right for you depends on the situation at hand.
-Most of these processors need to be run in order. If you try to migrate work items before you have migrated Area and Iterations then ***bang*** you need to go back.
-{% include content-collection-table.html collection = "reference" typeName = "Processors" architecture = "v1" %}
-## Processors (v2 Architecture) [ PREVIEW ]
-
-**_These are experimental processors that should replace those above. We are interested in feedback of the new format of the config, as well as the functionality._**
-
-The new processor configuration is designed to allow the Migration Tools to support different Source and targets than just TFS/Azure DevOps, and we moved the Endpoints to the processor to allow both Object Model & REST in different processors.
-
-{% include content-collection-table.html collection = "reference" typeName = "Processors" architecture = "v2" %}
+{% include content-collection-table.html collection = "reference" typeName = "Processors" %}
## Field Maps
@@ -193,7 +184,7 @@ By default, when you are moving from source to target the system will map all of
However sometimes you want to move data to another field, or use a regex to parse out just the bits that you want. To help we have built a number of mapping tools that should give you the versatility you need.
-{% include content-collection-table.html collection = "reference" typeName = "FieldMaps" architecture = "v1" %}
+{% include content-collection-table.html collection = "reference" typeName = "FieldMaps" %}
## Code (TFVC)
diff --git a/docs/installation.md b/docs/installation.md
new file mode 100644
index 000000000..36a467779
--- /dev/null
+++ b/docs/installation.md
@@ -0,0 +1,42 @@
+---
+title: Installation
+layout: page
+pageType: index
+template: getting-started-template.md
+toc: true
+pageStatus: published
+discussionId:
+redirect_from: /getting-started.html
+---
+
+## Installing and running the tools
+
+These tools are available as a portable application and can be installed in a number of ways, including manually from a zip.
+For a more detailed getting started guide please see the [documentation](https://nkdagility.com/docs/azure-devops-migration-tools/getting-started.html).
+
+### Option 1: Winget
+
+We use [winget](https://learn.microsoft.com/en-us/windows/package-manager/winget/) to host the tools, and you can use the command `winget install nkdAgility.AzureDevOpsMigrationTools` to install them on Windows 10 and Windows 11.
+
+The tools will be installed to `%Localappdata%\Microsoft\WinGet\Packages\nkdAgility.AzureDevOpsMigrationTools_Microsoft.Winget.Source_XXXXXXXXXX` and a symbolic link to `devopsmigration.exe` that lets you run it from anywhere using `devopsmigration init`.
+
+**NOTE: Do not install using an elevated command prompt!**
+
+### Option 2: Chocolatey
+
+We also deploy to [Chocolatey](https://chocolatey.org/packages/nkdagility.azuredevopsmigrationtools) and you can use the command `choco install vsts-sync-migrator` to install them on Windows Server.
+
+The tools will be installed to `C:\Tools\MigrationTools\` which should be added to the path. You can run `devopsmigration.exe`
+
+### Option 3: Manual
+
+You can download the [latest release](https://github.com/nkdAgility/azure-devops-migration-tools/releases/latest) and unzip it to a folder of your choice.
+
+## Minimum Permission Requirements
+
+At this time the documented minimum required permissions for running the tools are:
+
+- Account in both the source and target projects with "Project Collection Administrator" rights
+- PAT with "full access" for both the Source and the Target
+
+Note: I have been informed by the Azure DevOps product team information that ObjectModel API only works with full scoped PATs, so it won't work with any PAT that has specific scopes.
diff --git a/spellcheck.yaml b/spellcheck.yaml
index f9b29009c..5ab95ae63 100644
--- a/spellcheck.yaml
+++ b/spellcheck.yaml
@@ -1,7 +1,9 @@
matrix:
- name: Markdown
sources:
- - '**/*.md'
+ - 'docs/**/*.md'
+ - 'src/**/*.md'
+ - '*.md'
default_encoding: utf-8
aspell:
lang: en
diff --git a/src/MigrationTools.Clients.AzureDevops.ObjectModel.Tests/Endpoints/TfsWorkItemEndPointTests.cs b/src/MigrationTools.Clients.AzureDevops.ObjectModel.Tests/Endpoints/TfsWorkItemEndPointTests.cs
index 4561ea89c..d34e2f1a4 100644
--- a/src/MigrationTools.Clients.AzureDevops.ObjectModel.Tests/Endpoints/TfsWorkItemEndPointTests.cs
+++ b/src/MigrationTools.Clients.AzureDevops.ObjectModel.Tests/Endpoints/TfsWorkItemEndPointTests.cs
@@ -1,29 +1,31 @@
-using System.Collections.Generic;
+using System;
+using System.Collections.Generic;
using System.Linq;
using Microsoft.Extensions.DependencyInjection;
+using Microsoft.Extensions.Options;
using Microsoft.VisualStudio.TestTools.UnitTesting;
+using MigrationTools._EngineV1.Clients;
using MigrationTools.DataContracts;
+using MigrationTools.EndpointEnrichers;
+using MigrationTools.Enrichers;
using MigrationTools.Options;
+using MigrationTools.Processors;
using MigrationTools.Tests;
+using MigrationTools.Tools;
+using MigrationTools.Tools.Interfaces;
+using MigrationTools.Tools.Shadows;
+using MigrationTools.Shadows;
namespace MigrationTools.Endpoints.Tests
{
[TestClass()]
public class TfsWorkItemEndPointTests
{
- public ServiceProvider Services { get; private set; }
-
- [TestInitialize]
- public void Setup()
- {
- Services = ServiceProviderHelper.GetServices();
- }
[TestMethod(), TestCategory("L3")]
public void TfsWorkItemEndPointTest()
{
- var endpoint = Services.GetRequiredService();
- endpoint.Configure(GetTfsWorkItemEndPointOptions("migrationSource1"));
+ var endpoint = GetTfsWorkItemEndPoint();
endpoint.GetWorkItems();
Assert.IsNotNull(endpoint);
}
@@ -31,16 +33,14 @@ public void TfsWorkItemEndPointTest()
[TestMethod(), TestCategory("L3")]
public void TfsWorkItemEndPointConfigureTest()
{
- var endpoint = Services.GetRequiredService();
- endpoint.Configure(GetTfsWorkItemEndPointOptions("migrationSource1"));
+ var endpoint = GetTfsWorkItemEndPoint();
Assert.IsNotNull(endpoint);
}
[TestMethod(), TestCategory("L3")]
public void TfsWorkItemEndPointGetWorkItemsTest()
{
- var endpoint = Services.GetRequiredService();
- endpoint.Configure(GetTfsWorkItemEndPointOptions("migrationSource1"));
+ var endpoint = GetTfsWorkItemEndPoint();
IEnumerable result = endpoint.GetWorkItems();
Assert.AreEqual(13, result.Count());
}
@@ -48,8 +48,7 @@ public void TfsWorkItemEndPointGetWorkItemsTest()
[TestMethod(), TestCategory("L3")]
public void TfsWorkItemEndPointGetWorkItemsQueryTest()
{
- TfsWorkItemEndpoint endpoint = Services.GetRequiredService();
- endpoint.Configure(GetTfsWorkItemEndPointOptions("migrationSource1"));
+ var endpoint = GetTfsWorkItemEndPoint();
QueryOptions qo = new QueryOptions()
{
Query = "SELECT [System.Id], [System.Tags] FROM WorkItems WHERE [System.TeamProject] = @TeamProject AND [System.WorkItemType] NOT IN ('Test Suite', 'Test Plan')",
@@ -59,24 +58,44 @@ public void TfsWorkItemEndPointGetWorkItemsQueryTest()
Assert.AreEqual(13, result.Count());
}
- private static TfsWorkItemEndpointOptions GetTfsWorkItemEndPointOptions(string project)
+ protected TfsWorkItemEndpoint GetTfsWorkItemEndPoint(string key = "Source", TfsWorkItemEndpointOptions options = null)
{
- return new TfsWorkItemEndpointOptions()
+ var services = new ServiceCollection();
+ services.AddMigrationToolServicesForUnitTests();
+ // Add required DI Bits
+ services.AddSingleton();
+ services.AddSingleton();
+ services.AddSingleton();
+ services.AddSingleton();
+ services.AddSingleton();
+ services.AddSingleton();
+ services.AddSingleton();
+ services.AddSingleton();
+
+ // Add the Endpoints
+ services.AddKeyedSingleton(typeof(IEndpoint), key, (sp, key) =>
{
- Organisation = "https://dev.azure.com/nkdagility-preview/",
- Project = "migrationSource1",
- AuthenticationMode = AuthenticationMode.AccessToken,
- AccessToken = TestingConstants.AccessToken,
- Query = new Options.QueryOptions()
+ IOptions wrappedOptions = Microsoft.Extensions.Options.Options.Create(new TfsWorkItemEndpointOptions()
{
- Query = "SELECT [System.Id], [System.Tags] " +
+ Organisation = options != null? options.Organisation : "https://dev.azure.com/nkdagility-preview/",
+ Project = options != null ? options.Project : "migrationSource1",
+ AuthenticationMode = options != null ? options.AuthenticationMode : AuthenticationMode.AccessToken,
+ AccessToken = options != null ? options.AccessToken : TestingConstants.AccessToken,
+ Query = options != null ? options.Query : new Options.QueryOptions()
+ {
+ Query = "SELECT [System.Id], [System.Tags] " +
"FROM WorkItems " +
"WHERE [System.TeamProject] = @TeamProject " +
"AND [System.WorkItemType] NOT IN ('Test Suite', 'Test Plan') " +
"ORDER BY [System.ChangedDate] desc",
- Parameters = new Dictionary() { { "TeamProject", "migrationSource1" } }
- }
- };
+ Parameters = new Dictionary() { { "TeamProject", "migrationSource1" } }
+ }
+ });
+ return ActivatorUtilities.CreateInstance(sp, typeof(TfsWorkItemEndpoint), wrappedOptions);
+ });
+
+ return (TfsWorkItemEndpoint)services.BuildServiceProvider().GetRequiredKeyedService(key);
}
+
}
}
\ No newline at end of file
diff --git a/src/MigrationTools.Clients.AzureDevops.ObjectModel.Tests/MigrationTools.Clients.AzureDevops.ObjectModel.Tests.csproj b/src/MigrationTools.Clients.AzureDevops.ObjectModel.Tests/MigrationTools.Clients.AzureDevops.ObjectModel.Tests.csproj
index 788bd0750..b035ace03 100644
--- a/src/MigrationTools.Clients.AzureDevops.ObjectModel.Tests/MigrationTools.Clients.AzureDevops.ObjectModel.Tests.csproj
+++ b/src/MigrationTools.Clients.AzureDevops.ObjectModel.Tests/MigrationTools.Clients.AzureDevops.ObjectModel.Tests.csproj
@@ -11,15 +11,15 @@
-
+
-
-
+
+
all
runtime; build; native; contentfiles; analyzers; buildtransitive
-
+
@@ -27,8 +27,7 @@
-
-
+
diff --git a/src/MigrationTools.Clients.AzureDevops.ObjectModel.Tests/Processors/Infra/FakeMigrationClientConfig.cs b/src/MigrationTools.Clients.AzureDevops.ObjectModel.Tests/Processors/Infra/FakeMigrationClientConfig.cs
new file mode 100644
index 000000000..7f010ed02
--- /dev/null
+++ b/src/MigrationTools.Clients.AzureDevops.ObjectModel.Tests/Processors/Infra/FakeMigrationClientConfig.cs
@@ -0,0 +1,21 @@
+using System;
+using MigrationTools._EngineV1.Configuration;
+using MigrationTools.Endpoints;
+using MigrationTools.Endpoints.Infrastructure;
+
+namespace _VstsSyncMigrator.Engine.Tests
+{
+ [Obsolete]
+ public class FakeMigrationClientConfig : EndpointOptions
+ {
+ public IEndpointOptions PopulateWithDefault()
+ {
+ return this;
+ }
+
+ public override string ToString()
+ {
+ return "FakeMigration";
+ }
+ }
+}
\ No newline at end of file
diff --git a/src/MigrationTools.Clients.AzureDevops.ObjectModel.Tests/Processors/TfsProcessorTests.cs b/src/MigrationTools.Clients.AzureDevops.ObjectModel.Tests/Processors/TfsProcessorTests.cs
index 22b4cc15a..92c574dc8 100644
--- a/src/MigrationTools.Clients.AzureDevops.ObjectModel.Tests/Processors/TfsProcessorTests.cs
+++ b/src/MigrationTools.Clients.AzureDevops.ObjectModel.Tests/Processors/TfsProcessorTests.cs
@@ -1,44 +1,172 @@
using Microsoft.Extensions.DependencyInjection;
using Microsoft.VisualStudio.TestTools.UnitTesting;
using MigrationTools.Tests;
+using MigrationTools.Processors.Infrastructure;
+using Microsoft.Extensions.Options;
+using MigrationTools.Enrichers;
+using MigrationTools.EndpointEnrichers;
+using MigrationTools.Tools;
+using MigrationTools.Tools.Interfaces;
+using MigrationTools.Tools.Shadows;
+using MigrationTools.Shadows;
+using MigrationTools.Endpoints;
+using MigrationTools._EngineV1.Clients;
+using MigrationTools.Endpoints.Infrastructure;
+using System;
+using System.Collections.Generic;
+using System.Xml.Linq;
+using Microsoft.VisualStudio.Services.Commerce;
namespace MigrationTools.Processors.Tests
{
public class TfsProcessorTests
{
- protected ServiceProvider Services = ServiceProviderHelper.GetServices();
[TestInitialize]
public void Setup()
{
}
- protected static TfsTeamSettingsProcessorOptions GetTfsTeamSettingsProcessorOptions()
+ protected TfsTeamSettingsProcessor GetTfsTeamSettingsProcessor(TfsTeamSettingsProcessorOptions options = null)
{
- // Tfs To Tfs
- var migrationConfig = new TfsTeamSettingsProcessorOptions()
+ string SourceName = options != null ? options.SourceName : "Target";
+ string TargetName = options != null ? options.TargetName : "Source";
+
+ var services = new ServiceCollection();
+ services.AddMigrationToolServicesForUnitTests();
+ // Add required DI Bits
+ services.AddSingleton();
+ services.AddSingleton();
+ services.AddSingleton();
+ services.AddSingleton();
+ services.AddSingleton();
+ services.AddSingleton();
+ services.AddSingleton();
+ services.AddSingleton();
+ // Add the Processor
+ services.AddSingleton();
+ // Add the Endpoints
+ services.AddKeyedSingleton(typeof(IEndpoint), SourceName, (sp, key) =>
+ {
+ IOptions options = Microsoft.Extensions.Options.Options.Create(new TfsTeamSettingsEndpointOptions()
+ {
+ Organisation = "https://dev.azure.com/nkdagility-preview/",
+ Project = "migrationSource1",
+ AccessToken = TestingConstants.AccessToken,
+ AuthenticationMode = AuthenticationMode.AccessToken,
+ ReflectedWorkItemIdField = "Custom.ReflectedWorkItemId",
+ });
+ return ActivatorUtilities.CreateInstance(sp, typeof(TfsTeamSettingsEndpoint), options);
+ });
+ services.AddKeyedSingleton(typeof(IEndpoint), TargetName, (sp, key) =>
{
- Enabled = true,
- MigrateTeamSettings = true,
- UpdateTeamSettings = true,
- PrefixProjectToNodes = false,
- SourceName = "TfsTeamSettingsSource",
- TargetName = "TfsTeamSettingsTarget"
- };
- return migrationConfig;
+ IOptions options = Microsoft.Extensions.Options.Options.Create(new TfsTeamSettingsEndpointOptions()
+ {
+ Organisation = "https://dev.azure.com/nkdagility-preview/",
+ Project = "migrationTarget1",
+ AccessToken = TestingConstants.AccessToken,
+ AuthenticationMode = AuthenticationMode.AccessToken,
+ ReflectedWorkItemIdField = "Custom.ReflectedWorkItemId",
+ });
+ return ActivatorUtilities.CreateInstance(sp, typeof(TfsTeamSettingsEndpoint), options);
+ });
+ // Add the settings
+ services.Configure((Action)(o =>
+ {
+ o.Enabled = options != null ? options.Enabled : true;
+ o.SourceName = SourceName;
+ o.TargetName = TargetName;
+ o.Enrichers = options != null ? options.Enrichers : null;
+ o.Enrichers = options != null ? options.Enrichers : null;
+ o.RefName = options != null ? options.RefName : null;
+ /// Add custom
+ o.PrefixProjectToNodes = options != null ? options.PrefixProjectToNodes : false;
+ o.MigrateTeamCapacities = options != null ? options.MigrateTeamCapacities : false;
+ o.MigrateTeamSettings = options != null ? options.MigrateTeamSettings : false;
+ o.Teams = options?.Teams != null ? options.Teams : new List() { "Team 1" };
+ }));
+ ///Return the processor
+ return services.BuildServiceProvider().GetService();
}
- protected static TfsSharedQueryProcessorOptions GetTfsSharedQueryProcessorOptions()
+
+ protected TfsSharedQueryProcessor GetTfsSharedQueryProcessor(TfsSharedQueryProcessorOptions options = null)
{
- // Tfs To Tfs
- var migrationConfig = new TfsSharedQueryProcessorOptions()
+ string SourceName = options != null ? options.SourceName : "Target";
+ string TargetName = options != null ? options.TargetName : "Source";
+
+ var services = new ServiceCollection();
+ services.AddMigrationToolServicesForUnitTests();
+
+ services.AddSingleton();
+ services.AddSingleton();
+ services.AddSingleton();
+ services.AddSingleton();
+ services.AddSingleton();
+ services.AddSingleton();
+
+ services.AddSingleton();
+
+ services.AddKeyedSingleton(typeof(IEndpoint), SourceName, (sp, key) =>
+ {
+ IOptions options = Microsoft.Extensions.Options.Options.Create(new TfsTeamProjectEndpointOptions()
+ {
+ Collection = new System.Uri("https://dev.azure.com/nkdagility-preview/"),
+ Project = "migrationSource1",
+ Authentication = new TfsAuthenticationOptions()
+ {
+ AuthenticationMode = AuthenticationMode.AccessToken,
+ AccessToken = TestingConstants.AccessToken
+ },
+ AllowCrossProjectLinking = false,
+ LanguageMaps = new TfsLanguageMapOptions()
+ {
+ AreaPath = "Area",
+ IterationPath = "Iteration"
+ },
+ });
+ var endpoint = ActivatorUtilities.CreateInstance(sp, typeof(TfsTeamProjectEndpoint), options);
+ return endpoint;
+ });
+
+ services.AddKeyedSingleton(typeof(IEndpoint), TargetName, (sp, key) =>
{
- Enabled = true,
- PrefixProjectToNodes = false,
- SourceName = "Source",
- TargetName = "Target"
- };
- return migrationConfig;
+ IOptions options = Microsoft.Extensions.Options.Options.Create(new TfsTeamProjectEndpointOptions()
+ {
+ Collection = new System.Uri("https://dev.azure.com/nkdagility-preview/"),
+ Project = "migrationTarget1",
+ Authentication = new TfsAuthenticationOptions()
+ {
+ AuthenticationMode = AuthenticationMode.AccessToken,
+ AccessToken = TestingConstants.AccessToken
+ },
+ AllowCrossProjectLinking = false,
+ LanguageMaps = new TfsLanguageMapOptions()
+ {
+ AreaPath = "Area",
+ IterationPath = "Iteration"
+ },
+ });
+ var endpoint = ActivatorUtilities.CreateInstance(sp, typeof(TfsTeamProjectEndpoint), options);
+ return endpoint;
+ });
+
+ services.Configure((Action)(o =>
+ {
+ o.Enabled = options != null ? options.Enabled : true;
+ o.SourceName = SourceName;
+ o.TargetName = TargetName;
+ o.Enrichers = options != null ? options.Enrichers : null;
+ o.Enrichers = options != null ? options.Enrichers : null;
+ o.RefName = options != null ? options.RefName : null;
+ /// Add custom
+ o.SourceToTargetFieldMappings = options != null ? options.SourceToTargetFieldMappings : new System.Collections.Generic.Dictionary { {"sourceFieldA", "targetFieldB" } };
+ o.PrefixProjectToNodes = options != null ? options.PrefixProjectToNodes : false;
+ o.SharedFolderName = options != null ? options.SharedFolderName : "Shared Queries";
+ }));
+
+ return services.BuildServiceProvider().GetService();
}
+
}
}
\ No newline at end of file
diff --git a/src/MigrationTools.Clients.AzureDevops.ObjectModel.Tests/Processors/TfsSharedQueryProcessorTests.cs b/src/MigrationTools.Clients.AzureDevops.ObjectModel.Tests/Processors/TfsSharedQueryProcessorTests.cs
index 2ce4cbd15..bb2a43d86 100644
--- a/src/MigrationTools.Clients.AzureDevops.ObjectModel.Tests/Processors/TfsSharedQueryProcessorTests.cs
+++ b/src/MigrationTools.Clients.AzureDevops.ObjectModel.Tests/Processors/TfsSharedQueryProcessorTests.cs
@@ -3,6 +3,7 @@
using Microsoft.VisualStudio.TestTools.UnitTesting;
using MigrationTools.Endpoints;
using MigrationTools.Tests;
+using MigrationTools.Processors.Infrastructure;
namespace MigrationTools.Processors.Tests
{
@@ -12,7 +13,7 @@ public class TfsSharedQueryProcessorTests : TfsProcessorTests
[TestMethod(), TestCategory("L0")]
public void TfsSharedQueryProcessorTest()
{
- var x = Services.GetRequiredService();
+ var x = GetTfsSharedQueryProcessor();
Assert.IsNotNull(x);
}
@@ -23,12 +24,13 @@ public void TfsSharedQueryProcessorConfigureTest()
{
Enabled = true,
PrefixProjectToNodes = false,
+ RefName = "fortyTwo",
SourceName = "Source",
TargetName = "Target"
};
- var x = Services.GetRequiredService();
- x.Configure(y);
+ var x = GetTfsSharedQueryProcessor(y);
Assert.IsNotNull(x);
+ Assert.AreEqual("fortyTwo", x.Options.RefName);
}
[TestMethod(), TestCategory("L0")]
@@ -41,40 +43,9 @@ public void TfsSharedQueryProcessorRunTest()
SourceName = "Source",
TargetName = "Target"
};
- var x = Services.GetRequiredService();
- x.Configure(y);
+ var x = GetTfsSharedQueryProcessor(y);
+ x.Execute();
Assert.IsNotNull(x);
}
-
- [TestMethod(), TestCategory("L3")]
- public void TfsSharedQueryProcessorNoEnrichersTest()
- {
- // Senario 1 Migration from Tfs to Tfs with no Enrichers.
- var migrationConfig = GetTfsSharedQueryProcessorOptions();
- var processor = Services.GetRequiredService();
- processor.Configure(migrationConfig);
- processor.Execute();
- Assert.AreEqual(ProcessingStatus.Complete, processor.Status);
- }
-
- private static TfsWorkItemEndpointOptions GetTfsWorkItemEndPointOptions(string project)
- {
- return new TfsWorkItemEndpointOptions()
- {
- Organisation = "https://dev.azure.com/nkdagility-preview/",
- Project = project,
- AuthenticationMode = AuthenticationMode.AccessToken,
- AccessToken = TestingConstants.AccessToken,
- Query = new Options.QueryOptions()
- {
- Query = "SELECT [System.Id], [System.Tags] " +
- "FROM WorkItems " +
- "WHERE [System.TeamProject] = @TeamProject " +
- "AND [System.WorkItemType] NOT IN ('Test Suite', 'Test Plan') " +
- "ORDER BY [System.ChangedDate] desc",
- Parameters = new Dictionary() { { "TeamProject", project } }
- }
- };
- }
}
}
\ No newline at end of file
diff --git a/src/MigrationTools.Clients.AzureDevops.ObjectModel.Tests/Processors/TfsTeamSettingsProcessorTests.cs b/src/MigrationTools.Clients.AzureDevops.ObjectModel.Tests/Processors/TfsTeamSettingsProcessorTests.cs
index 3a8ddb8e8..77db0da2b 100644
--- a/src/MigrationTools.Clients.AzureDevops.ObjectModel.Tests/Processors/TfsTeamSettingsProcessorTests.cs
+++ b/src/MigrationTools.Clients.AzureDevops.ObjectModel.Tests/Processors/TfsTeamSettingsProcessorTests.cs
@@ -1,5 +1,6 @@
using Microsoft.Extensions.DependencyInjection;
using Microsoft.VisualStudio.TestTools.UnitTesting;
+using MigrationTools.Processors.Infrastructure;
namespace MigrationTools.Processors.Tests
{
@@ -9,8 +10,8 @@ public class TfsTeamSettingsProcessorTests : TfsProcessorTests
[TestMethod(), TestCategory("L0")]
public void TfsTeamSettingsProcessorTest()
{
- var x = Services.GetRequiredService();
- Assert.IsNotNull(x);
+ var processor = GetTfsTeamSettingsProcessor();
+ Assert.IsNotNull(processor);
}
[TestMethod(), TestCategory("L0")]
@@ -25,35 +26,17 @@ public void TfsTeamSettingsProcessorConfigureTest()
SourceName = "TfsTeamSettingsSource",
TargetName = "TfsTeamSettingsTarget"
};
- var x = Services.GetRequiredService();
- x.Configure(y);
- Assert.IsNotNull(x);
- }
-
- [TestMethod(), TestCategory("L0")]
- public void TfsTeamSettingsProcessorRunTest()
- {
- var y = new TfsTeamSettingsProcessorOptions
- {
- Enabled = true,
- MigrateTeamSettings = true,
- UpdateTeamSettings = true,
- PrefixProjectToNodes = false,
- SourceName = "TfsTeamSettingsSource",
- TargetName = "TfsTeamSettingsTarget"
- };
- var x = Services.GetRequiredService();
- x.Configure(y);
+ var x = GetTfsTeamSettingsProcessor(y);
Assert.IsNotNull(x);
+ Assert.AreEqual(x.Options.SourceName, "TfsTeamSettingsSource");
+ Assert.IsNotNull(x.Source);
}
[TestMethod(), TestCategory("L3")]
public void TfsTeamSettingsProcessorNoEnrichersTest()
{
// Senario 1 Migration from Tfs to Tfs with no Enrichers.
- var migrationConfig = GetTfsTeamSettingsProcessorOptions();
- var processor = Services.GetRequiredService();
- processor.Configure(migrationConfig);
+ var processor = GetTfsTeamSettingsProcessor();
processor.Execute();
Assert.AreEqual(ProcessingStatus.Complete, processor.Status);
}
diff --git a/src/MigrationTools.Clients.AzureDevops.ObjectModel.Tests/ServiceProviderHelper.cs b/src/MigrationTools.Clients.AzureDevops.ObjectModel.Tests/ServiceProviderHelper.cs
index 2ba88f728..1fd2cc8e3 100644
--- a/src/MigrationTools.Clients.AzureDevops.ObjectModel.Tests/ServiceProviderHelper.cs
+++ b/src/MigrationTools.Clients.AzureDevops.ObjectModel.Tests/ServiceProviderHelper.cs
@@ -1,21 +1,30 @@
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.DependencyInjection;
+using Microsoft.Extensions.DependencyInjection.Extensions;
using MigrationTools.Endpoints;
-using MigrationTools.Helpers.Tests;
using MigrationTools.Services;
-using MigrationTools.TestExtensions;
+using MigrationTools.Services.Shadows;
+using MigrationTools.Shadows;
namespace MigrationTools.Tests
{
public static class ServiceProviderHelper
{
+ public static ServiceCollection GetMigrationToolServicesForUnitTests()
+ {
+ var configuration = new ConfigurationBuilder().Build();
+ var services = new ServiceCollection();
+ services.AddMigrationToolServicesForUnitTests();
+ return services;
+ }
+
public static ServiceProvider GetServices()
{
var configuration = new ConfigurationBuilder().Build();
var services = new ServiceCollection();
services.AddMigrationToolServicesForUnitTests();
- services.AddMigrationToolServices();
+ services.AddMigrationToolServices(configuration);
services.AddMigrationToolServicesForClientAzureDevOpsObjectModel(configuration);
services.AddMigrationToolServicesForClientLegacyAzureDevOpsObjectModel();
services.AddMigrationToolServicesLegacy();
@@ -33,11 +42,10 @@ public static ServiceProvider GetServices()
private static void AddTfsTeamEndpoint(IServiceCollection services, string name, string project)
{
- services.AddEndpoint(name, (provider) =>
+ services.AddKeyedSingleton(name, (sp, key) =>
{
- var options = GetTfsTeamEndPointOptions(project);
- var endpoint = provider.GetRequiredService();
- endpoint.Configure(options);
+ var options = GetTfsEndPointOptions(project);
+ var endpoint = ActivatorUtilities.CreateInstance(sp, options);
return endpoint;
});
}
@@ -55,11 +63,10 @@ private static TfsTeamSettingsEndpointOptions GetTfsTeamEndPointOptions(string p
private static void AddTfsEndpoint(IServiceCollection services, string name, string project)
{
- services.AddEndpoint(name, (provider) =>
+ services.AddKeyedSingleton(name, (sp, key) =>
{
var options = GetTfsEndPointOptions(project);
- var endpoint = provider.GetRequiredService();
- endpoint.Configure(options);
+ var endpoint = ActivatorUtilities.CreateInstance(sp, options);
return endpoint;
});
}
diff --git a/src/MigrationTools.Clients.AzureDevops.ObjectModel.Tests/ProcessorEnrichers/TfsNodeStructureTests.cs b/src/MigrationTools.Clients.AzureDevops.ObjectModel.Tests/Tools/TfsNodeStructureTests.cs
similarity index 60%
rename from src/MigrationTools.Clients.AzureDevops.ObjectModel.Tests/ProcessorEnrichers/TfsNodeStructureTests.cs
rename to src/MigrationTools.Clients.AzureDevops.ObjectModel.Tests/Tools/TfsNodeStructureTests.cs
index 80fb971c4..d1a3d3584 100644
--- a/src/MigrationTools.Clients.AzureDevops.ObjectModel.Tests/ProcessorEnrichers/TfsNodeStructureTests.cs
+++ b/src/MigrationTools.Clients.AzureDevops.ObjectModel.Tests/Tools/TfsNodeStructureTests.cs
@@ -1,48 +1,35 @@
using System.Collections.Generic;
+using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.DependencyInjection;
+using Microsoft.TeamFoundation.TestManagement.WebApi;
using Microsoft.VisualStudio.TestTools.UnitTesting;
-using MigrationTools.Enrichers;
using MigrationTools.Tests;
+using System.Threading.Tasks;
+using MigrationTools.Shadows;
+using System;
+using MigrationTools.Tools;
-
-namespace MigrationTools.ProcessorEnrichers.Tests
+namespace MigrationTools.Tests.Tools
{
[TestClass()]
- public class TfsNodeStructureTests
+ public class TfsNodeStructureToolTests
{
- private ServiceProvider _services;
- private TfsNodeStructure _structure;
- [TestInitialize]
- public void Setup()
+ [TestMethod(), TestCategory("L0")]
+ public void GetTfsNodeStructureTool_WithDifferentAreaPath()
{
- _services = ServiceProviderHelper.GetServices();
- _structure = _services.GetRequiredService();
- _structure.ApplySettings(new TfsNodeStructureSettings
- {
- FoundNodes = new Dictionary(),
- SourceProjectName = "SourceServer",
- TargetProjectName = "TargetServer",
- });
- _structure.Configure(new TfsNodeStructureOptions
+ var options = new TfsNodeStructureToolOptions();
+ options.Enabled = true;
+ options.Areas = new NodeOptions()
{
- AreaMaps = new Dictionary
+ Mappings = new Dictionary()
{
- { "SourceServer", "TargetServer" }
- },
- IterationMaps = new Dictionary
- {
- { "SourceServer", "TargetServer" }
- },
- });
- }
-
- [TestMethod(), TestCategory("L0")]
- public void GetTfsNodeStructure_WithDifferentAreaPath()
- {
- var nodeStructure = _services.GetRequiredService();
+ { @"^SourceProject\\PUL", "TargetProject\\test\\PUL" }
+ }
+ };
+ var nodeStructure = GetTfsNodeStructureTool(options);
- nodeStructure.ApplySettings(new TfsNodeStructureSettings
+ nodeStructure.ApplySettings(new TfsNodeStructureToolSettings
{
SourceProjectName = "SourceProject",
TargetProjectName = "TargetProject",
@@ -52,26 +39,23 @@ public void GetTfsNodeStructure_WithDifferentAreaPath()
}
});
- var options = new TfsNodeStructureOptions();
- options.SetDefaults();
- options.AreaMaps[@"^SourceProject\\PUL"] = "TargetProject\\test\\PUL";
- nodeStructure.Configure(options);
-
const string sourceNodeName = @"SourceProject\PUL";
const TfsNodeStructureType nodeStructureType = TfsNodeStructureType.Area;
var newNodeName = nodeStructure.GetNewNodeName(sourceNodeName, nodeStructureType);
- Assert.AreEqual(newNodeName, @"TargetProject\test\PUL");
+ Assert.AreEqual(@"TargetProject\test\PUL", newNodeName);
}
[TestMethod, TestCategory("L0")]
public void TestFixAreaPath_WhenNoAreaPathOrIterationPath_DoesntChangeQuery()
{
+ var nodeStructure = GetTfsNodeStructureTool();
+
string WIQLQueryBit = @"SELECT [System.Id] FROM WorkItems WHERE [System.TeamProject] = @TeamProject AND [Microsoft.VSTS.Common.ClosedDate] = '' AND [System.WorkItemType] NOT IN ('Test Suite', 'Test Plan')";
- string targetWIQLQueryBit = _structure.FixAreaPathAndIterationPathForTargetQuery(WIQLQueryBit, "SourceServer", "TargetServer", null);
+ string targetWIQLQueryBit = nodeStructure.FixAreaPathAndIterationPathForTargetQuery(WIQLQueryBit, "SourceServer", "TargetServer", null);
Assert.AreEqual(WIQLQueryBit, targetWIQLQueryBit);
}
@@ -80,10 +64,13 @@ public void TestFixAreaPath_WhenNoAreaPathOrIterationPath_DoesntChangeQuery()
[TestMethod, TestCategory("L0")]
public void TestFixAreaPath_WhenAreaPathInQuery_ChangesQuery()
{
+ var nodeStructure = GetTfsNodeStructureTool();
+
+
string WIQLQueryBit = @"SELECT [System.Id] FROM WorkItems WHERE [System.TeamProject] = @TeamProject AND [System.AreaPath] = 'SourceServer\Area\Path1' AND [Microsoft.VSTS.Common.ClosedDate] = '' AND [System.WorkItemType] NOT IN ('Test Suite', 'Test Plan')";
string expectTargetQueryBit = @"SELECT [System.Id] FROM WorkItems WHERE [System.TeamProject] = @TeamProject AND [System.AreaPath] = 'TargetServer\Area\Path1' AND [Microsoft.VSTS.Common.ClosedDate] = '' AND [System.WorkItemType] NOT IN ('Test Suite', 'Test Plan')";
- string targetWIQLQueryBit = _structure.FixAreaPathAndIterationPathForTargetQuery(WIQLQueryBit, "SourceServer", "TargetServer", null);
+ string targetWIQLQueryBit = nodeStructure.FixAreaPathAndIterationPathForTargetQuery(WIQLQueryBit, "SourceServer", "TargetServer", null);
Assert.AreEqual(expectTargetQueryBit, targetWIQLQueryBit);
}
@@ -91,26 +78,28 @@ public void TestFixAreaPath_WhenAreaPathInQuery_ChangesQuery()
[TestMethod, TestCategory("L1")]
public void TestFixAreaPath_WhenAreaPathInQuery_WithPrefixProjectToNodesEnabled_ChangesQuery()
{
- var nodeStructure = _services.GetRequiredService();
-
- // For this test we use the prefixing of the project node and no remapping rule
-
-
- nodeStructure.Configure(new TfsNodeStructureOptions
+ var options = new TfsNodeStructureToolOptions();
+ options.Enabled = true;
+ options.Areas = new NodeOptions()
{
- AreaMaps = new Dictionary()
+ Mappings = new Dictionary()
{
{ "^SourceServer\\\\(.*)" , "TargetServer\\SourceServer\\$1" }
- },
- IterationMaps = new Dictionary(){
- { "^SourceServer\\\\(.*)" , "TargetServer\\SourceServer\\$1" }
- },
- });
+ }
+ };
+ options.Iterations = new NodeOptions()
+ {
+ Mappings = new Dictionary()
+ {
+ { "^SourceServer\\\\(.*)" , "TargetServer\\SourceServer\\$1" }
+ }
+ };
+ var nodeStructure = GetTfsNodeStructureTool(options);
string WIQLQueryBit = @"SELECT [System.Id] FROM WorkItems WHERE [System.TeamProject] = @TeamProject AND [System.AreaPath] = 'SourceServer\Area\Path1' AND [Microsoft.VSTS.Common.ClosedDate] = '' AND [System.WorkItemType] NOT IN ('Test Suite', 'Test Plan')";
string expectTargetQueryBit = @"SELECT [System.Id] FROM WorkItems WHERE [System.TeamProject] = @TeamProject AND [System.AreaPath] = 'TargetServer\SourceServer\Area\Path1' AND [Microsoft.VSTS.Common.ClosedDate] = '' AND [System.WorkItemType] NOT IN ('Test Suite', 'Test Plan')";
- string targetWIQLQuery = _structure.FixAreaPathAndIterationPathForTargetQuery(WIQLQueryBit, "SourceServer", "TargetServer", null);
+ string targetWIQLQuery = nodeStructure.FixAreaPathAndIterationPathForTargetQuery(WIQLQueryBit, "SourceServer", "TargetServer", null);
Assert.AreEqual(expectTargetQueryBit, targetWIQLQuery);
}
@@ -118,26 +107,12 @@ public void TestFixAreaPath_WhenAreaPathInQuery_WithPrefixProjectToNodesEnabled_
[TestMethod, TestCategory("L1")]
public void TestFixAreaPath_WhenAreaPathInQuery_WithPrefixProjectToNodesDisabled_SupportsWhitespaces()
{
- var nodeStructure = _services.GetRequiredService();
+ var nodeStructure = GetTfsNodeStructureTool();
- nodeStructure.ApplySettings(new TfsNodeStructureSettings
- {
- FoundNodes = new Dictionary(),
- SourceProjectName = "Source Project",
- TargetProjectName = "Target Project",
- });
-
- // For this test we use no remapping rule
- nodeStructure.Configure(new TfsNodeStructureOptions
- {
- AreaMaps = new Dictionary(),
- IterationMaps = new Dictionary(),
- });
-
- string WIQLQueryBit = @"SELECT [System.Id] FROM WorkItems WHERE [System.TeamProject] = @TeamProject AND [System.AreaPath] = 'Source Project\Area\Path1' AND [Microsoft.VSTS.Common.ClosedDate] = '' AND [System.WorkItemType] NOT IN ('Test Suite', 'Test Plan')";
- string expectTargetQueryBit = @"SELECT [System.Id] FROM WorkItems WHERE [System.TeamProject] = @TeamProject AND [System.AreaPath] = 'Target Project\Area\Path1' AND [Microsoft.VSTS.Common.ClosedDate] = '' AND [System.WorkItemType] NOT IN ('Test Suite', 'Test Plan')";
+ string WIQLQueryBit = @"SELECT [System.Id] FROM WorkItems WHERE [System.TeamProject] = @TeamProject AND [System.AreaPath] = 'SourceServer\Area\Path1' AND [Microsoft.VSTS.Common.ClosedDate] = '' AND [System.WorkItemType] NOT IN ('Test Suite', 'Test Plan')";
+ string expectTargetQueryBit = @"SELECT [System.Id] FROM WorkItems WHERE [System.TeamProject] = @TeamProject AND [System.AreaPath] = 'TargetServer\Area\Path1' AND [Microsoft.VSTS.Common.ClosedDate] = '' AND [System.WorkItemType] NOT IN ('Test Suite', 'Test Plan')";
- string targetWIQLQueryBit = _structure.FixAreaPathAndIterationPathForTargetQuery(WIQLQueryBit, "Source Project", "Target Project", null);
+ string targetWIQLQueryBit = nodeStructure.FixAreaPathAndIterationPathForTargetQuery(WIQLQueryBit, "SourceServer", "TargetServer", null);
Assert.AreEqual(expectTargetQueryBit, targetWIQLQueryBit);
}
@@ -145,31 +120,30 @@ public void TestFixAreaPath_WhenAreaPathInQuery_WithPrefixProjectToNodesDisabled
[TestMethod, TestCategory("L1")]
public void TestFixAreaPath_WhenAreaPathInQuery_WithPrefixProjectToNodesEnabled_SupportsWhitespaces()
{
- var nodeStructure = _services.GetRequiredService();
-
- nodeStructure.ApplySettings(new TfsNodeStructureSettings
+ var options = new TfsNodeStructureToolOptions();
+ options.Enabled = true;
+ options.Areas = new NodeOptions()
{
- FoundNodes = new Dictionary(),
- SourceProjectName = "Source Project",
- TargetProjectName = "Target Project",
- });
+ Mappings = new Dictionary()
+ {
+ { "^Source Project\\\\(.*)" , "Target Project\\Source Project\\$1" }
+ }
+ };
- // For this test we use the prefixing of the project node and no remapping rules
- nodeStructure.Configure(new TfsNodeStructureOptions
+ options.Iterations = new NodeOptions()
{
- AreaMaps = new Dictionary()
+ Mappings = new Dictionary()
{
{ "^Source Project\\\\(.*)" , "Target Project\\Source Project\\$1" }
- },
- IterationMaps = new Dictionary(){
- { "^Source Project\\\\(.*)" , "Target Project\\Source Project\\$1" }
- },
- });
+ }
+ };
+ var settings = new TfsNodeStructureToolSettings() { SourceProjectName = "Source Project", TargetProjectName = "Target Project", FoundNodes = new Dictionary() };
+ var nodeStructure = GetTfsNodeStructureTool(options, settings);
var WIQLQueryBit = @"SELECT [System.Id] FROM WorkItems WHERE [System.TeamProject] = @TeamProject AND [System.AreaPath] = 'Source Project\Area\Path1' AND [Microsoft.VSTS.Common.ClosedDate] = '' AND [System.WorkItemType] NOT IN ('Test Suite', 'Test Plan')";
var expectTargetQueryBit = @"SELECT [System.Id] FROM WorkItems WHERE [System.TeamProject] = @TeamProject AND [System.AreaPath] = 'Target Project\Source Project\Area\Path1' AND [Microsoft.VSTS.Common.ClosedDate] = '' AND [System.WorkItemType] NOT IN ('Test Suite', 'Test Plan')";
- var targetWIQLQueryBit = _structure.FixAreaPathAndIterationPathForTargetQuery(WIQLQueryBit, "Source Project", "Target Project", null);
+ var targetWIQLQueryBit = nodeStructure.FixAreaPathAndIterationPathForTargetQuery(WIQLQueryBit, "Source Project", "Target Project", null);
Assert.AreEqual(expectTargetQueryBit, targetWIQLQueryBit);
}
@@ -177,10 +151,12 @@ public void TestFixAreaPath_WhenAreaPathInQuery_WithPrefixProjectToNodesEnabled_
[TestMethod, TestCategory("L0")]
public void TestFixAreaPath_WhenMultipleAreaPathInQuery_ChangesQuery()
{
+ var nodeStructure = GetTfsNodeStructureTool();
+
string WIQLQueryBit = @"SELECT [System.Id] FROM WorkItems WHERE [System.TeamProject] = @TeamProject AND [System.AreaPath] = 'SourceServer\Area\Path1' OR [System.AreaPath] = 'SourceServer\Area\Path2' AND [Microsoft.VSTS.Common.ClosedDate] = '' AND [System.WorkItemType] NOT IN ('Test Suite', 'Test Plan')";
string expectTargetQueryBit = @"SELECT [System.Id] FROM WorkItems WHERE [System.TeamProject] = @TeamProject AND [System.AreaPath] = 'TargetServer\Area\Path1' OR [System.AreaPath] = 'TargetServer\Area\Path2' AND [Microsoft.VSTS.Common.ClosedDate] = '' AND [System.WorkItemType] NOT IN ('Test Suite', 'Test Plan')";
- string targetWIQLQueryBit = _structure.FixAreaPathAndIterationPathForTargetQuery(WIQLQueryBit, "SourceServer", "TargetServer", null);
+ string targetWIQLQueryBit = nodeStructure.FixAreaPathAndIterationPathForTargetQuery(WIQLQueryBit, "SourceServer", "TargetServer", null);
Assert.AreEqual(expectTargetQueryBit, targetWIQLQueryBit);
}
@@ -188,10 +164,12 @@ public void TestFixAreaPath_WhenMultipleAreaPathInQuery_ChangesQuery()
[TestMethod, TestCategory("L0")]
public void TestFixAreaPath_WhenAreaPathAtEndOfQuery_ChangesQuery()
{
+ var nodeStructure = GetTfsNodeStructureTool();
+
string WIQLQueryBit = @"SELECT [System.Id] FROM WorkItems WHERE [System.TeamProject] = @TeamProject AND [Microsoft.VSTS.Common.ClosedDate] = '' AND [System.WorkItemType] NOT IN ('Test Suite', 'Test Plan') AND [System.AreaPath] = 'SourceServer\Area\Path1'";
string expectTargetQueryBit = @"SELECT [System.Id] FROM WorkItems WHERE [System.TeamProject] = @TeamProject AND [Microsoft.VSTS.Common.ClosedDate] = '' AND [System.WorkItemType] NOT IN ('Test Suite', 'Test Plan') AND [System.AreaPath] = 'TargetServer\Area\Path1'";
- string targetWIQLQueryBit = _structure.FixAreaPathAndIterationPathForTargetQuery(WIQLQueryBit, "SourceServer", "TargetServer", null);
+ string targetWIQLQueryBit = nodeStructure.FixAreaPathAndIterationPathForTargetQuery(WIQLQueryBit, "SourceServer", "TargetServer", null);
Assert.AreEqual(expectTargetQueryBit, targetWIQLQueryBit);
}
@@ -199,10 +177,12 @@ public void TestFixAreaPath_WhenAreaPathAtEndOfQuery_ChangesQuery()
[TestMethod, TestCategory("L0")]
public void TestFixIterationPath_WhenInQuery_ChangesQuery()
{
+ var nodeStructure = GetTfsNodeStructureTool();
+
string WIQLQueryBit = @"SELECT [System.Id] FROM WorkItems WHERE [System.TeamProject] = @TeamProject AND [System.IterationPath] = 'SourceServer\Iteration\Path1' AND [Microsoft.VSTS.Common.ClosedDate] = '' AND [System.WorkItemType] NOT IN ('Test Suite', 'Test Plan')";
string expectTargetQueryBit = @"SELECT [System.Id] FROM WorkItems WHERE [System.TeamProject] = @TeamProject AND [System.IterationPath] = 'TargetServer\Iteration\Path1' AND [Microsoft.VSTS.Common.ClosedDate] = '' AND [System.WorkItemType] NOT IN ('Test Suite', 'Test Plan')";
- string targetWIQLQueryBit = _structure.FixAreaPathAndIterationPathForTargetQuery(WIQLQueryBit, "SourceServer", "TargetServer", null);
+ string targetWIQLQueryBit = nodeStructure.FixAreaPathAndIterationPathForTargetQuery(WIQLQueryBit, "SourceServer", "TargetServer", null);
Assert.AreEqual(expectTargetQueryBit, targetWIQLQueryBit);
}
@@ -210,10 +190,12 @@ public void TestFixIterationPath_WhenInQuery_ChangesQuery()
[TestMethod, TestCategory("L0")]
public void TestFixAreaPathAndIteration_WhenMultipleOccuranceInQuery_ChangesQuery()
{
+ var nodeStructure = GetTfsNodeStructureTool();
+
string WIQLQueryBit = @"SELECT [System.Id] FROM WorkItems WHERE [System.TeamProject] = @TeamProject AND ([System.AreaPath] = 'SourceServer\Area\Path1' OR [System.AreaPath] = 'SourceServer\Area\Path2') AND ([System.IterationPath] = 'SourceServer\Iteration\Path1' OR [System.IterationPath] = 'SourceServer\Iteration\Path2') AND [Microsoft.VSTS.Common.ClosedDate] = '' AND [System.WorkItemType] NOT IN ('Test Suite', 'Test Plan')";
string expectTargetQueryBit = @"SELECT [System.Id] FROM WorkItems WHERE [System.TeamProject] = @TeamProject AND ([System.AreaPath] = 'TargetServer\Area\Path1' OR [System.AreaPath] = 'TargetServer\Area\Path2') AND ([System.IterationPath] = 'TargetServer\Iteration\Path1' OR [System.IterationPath] = 'TargetServer\Iteration\Path2') AND [Microsoft.VSTS.Common.ClosedDate] = '' AND [System.WorkItemType] NOT IN ('Test Suite', 'Test Plan')";
- string targetWIQLQueryBit = _structure.FixAreaPathAndIterationPathForTargetQuery(WIQLQueryBit, "SourceServer", "TargetServer", null);
+ string targetWIQLQueryBit = nodeStructure.FixAreaPathAndIterationPathForTargetQuery(WIQLQueryBit, "SourceServer", "TargetServer", null);
Assert.AreEqual(expectTargetQueryBit, targetWIQLQueryBit);
}
@@ -221,12 +203,56 @@ public void TestFixAreaPathAndIteration_WhenMultipleOccuranceInQuery_ChangesQuer
[TestMethod, TestCategory("L0")]
public void TestFixAreaPathAndIteration_WhenMultipleOccuranceWithMixtureOrEqualAndUnderOperatorsInQuery_ChangesQuery()
{
+ var nodeStructure = GetTfsNodeStructureTool();
+
string WIQLQueryBit = @"SELECT [System.Id] FROM WorkItems WHERE [System.TeamProject] = @TeamProject AND ([System.AreaPath] = 'SourceServer\Area\Path1' OR [System.AreaPath] UNDER 'SourceServer\Area\Path2') AND ([System.IterationPath] UNDER 'SourceServer\Iteration\Path1' OR [System.IterationPath] = 'SourceServer\Iteration\Path2') AND [Microsoft.VSTS.Common.ClosedDate] = '' AND [System.WorkItemType] NOT IN ('Test Suite', 'Test Plan')";
string expectTargetQueryBit = @"SELECT [System.Id] FROM WorkItems WHERE [System.TeamProject] = @TeamProject AND ([System.AreaPath] = 'TargetServer\Area\Path1' OR [System.AreaPath] UNDER 'TargetServer\Area\Path2') AND ([System.IterationPath] UNDER 'TargetServer\Iteration\Path1' OR [System.IterationPath] = 'TargetServer\Iteration\Path2') AND [Microsoft.VSTS.Common.ClosedDate] = '' AND [System.WorkItemType] NOT IN ('Test Suite', 'Test Plan')";
- string targetWIQLQueryBit = _structure.FixAreaPathAndIterationPathForTargetQuery(WIQLQueryBit, "SourceServer", "TargetServer", null);
+ string targetWIQLQueryBit = nodeStructure.FixAreaPathAndIterationPathForTargetQuery(WIQLQueryBit, "SourceServer", "TargetServer", null);
Assert.AreEqual(expectTargetQueryBit, targetWIQLQueryBit);
}
+
+ private static TfsNodeStructureTool GetTfsNodeStructureTool(TfsNodeStructureToolOptions options)
+ {
+ if (options == null)
+ {
+ throw new Exception();
+ }
+ var settings = new TfsNodeStructureToolSettings() { SourceProjectName = "SourceProject", TargetProjectName = "TargetProject", FoundNodes = new Dictionary() };
+ return GetTfsNodeStructureTool(options, settings);
+ }
+
+ private static TfsNodeStructureTool GetTfsNodeStructureTool()
+ {
+ var options = new TfsNodeStructureToolOptions() { Enabled = true, Areas = new NodeOptions { Mappings = new Dictionary() }, Iterations = new NodeOptions { Mappings = new Dictionary() } };
+ var settings = new TfsNodeStructureToolSettings() { SourceProjectName = "SourceServer", TargetProjectName = "TargetServer", FoundNodes = new Dictionary() };
+ return GetTfsNodeStructureTool(options, settings);
+ }
+
+ private static TfsNodeStructureTool GetTfsNodeStructureTool(TfsNodeStructureToolOptions options, TfsNodeStructureToolSettings settings)
+ {
+ var services = new ServiceCollection();
+ services.AddMigrationToolServicesForUnitTests();
+ services.AddSingleton();
+ services.Configure(o =>
+ {
+ o.Enabled = options.Enabled;
+ o.Areas = options.Areas;
+ o.Iterations = options.Iterations;
+ });
+
+ var nodeStructure = services.BuildServiceProvider().GetService();
+
+ nodeStructure.ApplySettings(new TfsNodeStructureToolSettings
+ {
+ SourceProjectName = settings.SourceProjectName,
+ TargetProjectName = settings.TargetProjectName,
+ FoundNodes = settings.FoundNodes
+ });
+
+ return nodeStructure;
+ }
+
}
}
\ No newline at end of file
diff --git a/src/MigrationTools.Clients.AzureDevops.ObjectModel.Tests/ProcessorEnrichers/TfsRevisionManagerTests.cs b/src/MigrationTools.Clients.AzureDevops.ObjectModel.Tests/Tools/TfsRevisionManagerTests.cs
similarity index 60%
rename from src/MigrationTools.Clients.AzureDevops.ObjectModel.Tests/ProcessorEnrichers/TfsRevisionManagerTests.cs
rename to src/MigrationTools.Clients.AzureDevops.ObjectModel.Tests/Tools/TfsRevisionManagerTests.cs
index 83ebad318..7aeaa9e27 100644
--- a/src/MigrationTools.Clients.AzureDevops.ObjectModel.Tests/ProcessorEnrichers/TfsRevisionManagerTests.cs
+++ b/src/MigrationTools.Clients.AzureDevops.ObjectModel.Tests/Tools/TfsRevisionManagerTests.cs
@@ -4,37 +4,19 @@
using Microsoft.Extensions.DependencyInjection;
using Microsoft.VisualStudio.TestTools.UnitTesting;
using MigrationTools.DataContracts;
-using MigrationTools.Enrichers;
using MigrationTools.Tests;
+using MigrationTools.Tools;
-namespace MigrationTools.ProcessorEnrichers.Tests
+namespace MigrationTools.Tests.Tools
{
[TestClass()]
- public class TfsRevisionManagerTests
+ public class TfsRevisionManagerToolTests
{
- private ServiceProvider Services = ServiceProviderHelper.GetServices();
-
- [TestInitialize]
- public void Setup()
- {
- }
-
- private static TfsRevisionManagerOptions GetTfsRevisionManagerOptions()
- {
- var migrationConfig = new TfsRevisionManagerOptions()
- {
- Enabled = true,
- MaxRevisions = 0,
- ReplayRevisions = true
-
- };
- return migrationConfig;
- }
private static List GetWorkItemWithRevisions(DateTime currentDateTime, int startHours = 1, int endHours = 1, bool dateIncreasing = true)
{
- var revisions = new System.Collections.Generic.SortedDictionary();
+ var revisions = new SortedDictionary();
for (int i = startHours; i < endHours + startHours; i++)
{
DateTime dateTime = dateIncreasing ? currentDateTime.AddHours(i) : currentDateTime;
@@ -46,13 +28,11 @@ private static List GetWorkItemWithRevisions(DateTime currentDateT
[TestMethod(), TestCategory("L0")]
- public void TfsRevisionManagerInSync1()
+ public void TfsRevisionManagerToolInSync1()
{
- var peOptions = GetTfsRevisionManagerOptions();
- var processorEnricher = Services.GetRequiredService();
- processorEnricher.Configure(peOptions);
+ var processorEnricher = GetTfsRevisionManagerTool();
- var currentDateTime = System.DateTime.Now;
+ var currentDateTime = DateTime.Now;
List source = GetWorkItemWithRevisions(currentDateTime, 1, 1);
List target = GetWorkItemWithRevisions(currentDateTime, 1, 1);
@@ -63,13 +43,11 @@ public void TfsRevisionManagerInSync1()
}
[TestMethod(), TestCategory("L0")]
- public void TfsRevisionManagerInSync10()
+ public void TfsRevisionManagerToolInSync10()
{
- var peOptions = GetTfsRevisionManagerOptions();
- var processorEnricher = Services.GetRequiredService();
- processorEnricher.Configure(peOptions);
+ var processorEnricher = GetTfsRevisionManagerTool();
- var currentDateTime = System.DateTime.Now;
+ var currentDateTime = DateTime.Now;
List source = GetWorkItemWithRevisions(currentDateTime, 1, 10);
List target = GetWorkItemWithRevisions(currentDateTime, 1, 10);
@@ -80,13 +58,11 @@ public void TfsRevisionManagerInSync10()
}
[TestMethod(), TestCategory("L0")]
- public void TfsRevisionManagerSync1()
+ public void TfsRevisionManagerToolSync1()
{
- var peOptions = GetTfsRevisionManagerOptions();
- var processorEnricher = Services.GetRequiredService();
- processorEnricher.Configure(peOptions);
+ var processorEnricher = GetTfsRevisionManagerTool();
- var currentDateTime = System.DateTime.Now;
+ var currentDateTime = DateTime.Now;
List source = GetWorkItemWithRevisions(currentDateTime, 1, 2);
List target = GetWorkItemWithRevisions(currentDateTime, 1, 1);
@@ -96,11 +72,9 @@ public void TfsRevisionManagerSync1()
}
[TestMethod(), TestCategory("L0")]
- public void TfsRevisionManagerSync10()
+ public void TfsRevisionManagerToolSync10()
{
- var peOptions = GetTfsRevisionManagerOptions();
- var processorEnricher = Services.GetRequiredService();
- processorEnricher.Configure(peOptions);
+ var processorEnricher = GetTfsRevisionManagerTool();
var currentDateTime = DateTime.Now;
List source = GetWorkItemWithRevisions(currentDateTime, 1, 11);
@@ -112,12 +86,14 @@ public void TfsRevisionManagerSync10()
}
[TestMethod(), TestCategory("L0")]
- public void TfsRevisionManagerReplayRevisionsOff()
+ public void TfsRevisionManagerToolReplayRevisionsOff()
{
- var peOptions = GetTfsRevisionManagerOptions();
- peOptions.ReplayRevisions = false;
- var processorEnricher = Services.GetRequiredService();
- processorEnricher.Configure(peOptions);
+ var processorEnricher = GetTfsRevisionManagerTool(new TfsRevisionManagerToolOptions()
+ {
+ Enabled = true,
+ MaxRevisions = 0,
+ ReplayRevisions = false,
+ });
var currentDateTime = DateTime.Now.AddDays(-100);
List source = GetWorkItemWithRevisions(currentDateTime, 1, 4);
@@ -130,12 +106,14 @@ public void TfsRevisionManagerReplayRevisionsOff()
[TestMethod(), TestCategory("L0")]
- public void TfsRevisionManagerMaxRevision51()
+ public void TfsRevisionManagerToolMaxRevision51()
{
- var peOptions = GetTfsRevisionManagerOptions();
- peOptions.MaxRevisions = 5;
- var processorEnricher = Services.GetRequiredService();
- processorEnricher.Configure(peOptions);
+ var processorEnricher = GetTfsRevisionManagerTool(new TfsRevisionManagerToolOptions()
+ {
+ Enabled = true,
+ MaxRevisions = 5,
+ ReplayRevisions = true,
+ });
var currentDateTime = DateTime.Now;
List source = GetWorkItemWithRevisions(currentDateTime, 1, 2);
@@ -147,12 +125,14 @@ public void TfsRevisionManagerMaxRevision51()
}
[TestMethod(), TestCategory("L0")]
- public void TfsRevisionManagerMaxRevision56()
+ public void TfsRevisionManagerToolMaxRevision56()
{
- var peOptions = GetTfsRevisionManagerOptions();
- peOptions.MaxRevisions = 5;
- var processorEnricher = Services.GetRequiredService();
- processorEnricher.Configure(peOptions);
+ var processorEnricher = GetTfsRevisionManagerTool(new TfsRevisionManagerToolOptions()
+ {
+ Enabled = true,
+ MaxRevisions = 5,
+ ReplayRevisions = true,
+ });
var currentDateTime = DateTime.Now;
List source = GetWorkItemWithRevisions(currentDateTime, 1, 7);
@@ -164,12 +144,14 @@ public void TfsRevisionManagerMaxRevision56()
}
[TestMethod(), TestCategory("L0")]
- public void TfsRevisionManagerMaxRevision59()
+ public void TfsRevisionManagerToolMaxRevision59()
{
- var peOptions = GetTfsRevisionManagerOptions();
- peOptions.MaxRevisions = 5;
- var processorEnricher = Services.GetRequiredService();
- processorEnricher.Configure(peOptions);
+ var processorEnricher = GetTfsRevisionManagerTool(new TfsRevisionManagerToolOptions()
+ {
+ Enabled = true,
+ MaxRevisions = 5,
+ ReplayRevisions = true,
+ });
var currentDateTime = DateTime.Now;
List source = GetWorkItemWithRevisions(currentDateTime, 1, 10);
@@ -180,11 +162,9 @@ public void TfsRevisionManagerMaxRevision59()
}
[TestMethod(), TestCategory("L0")]
- public void TfsRevisionManagerDatesMustBeIncreasing()
+ public void TfsRevisionManagerToolDatesMustBeIncreasing()
{
- var peOptions = GetTfsRevisionManagerOptions();
- var processorEnricher = Services.GetRequiredService();
- processorEnricher.Configure(peOptions);
+ var processorEnricher = GetTfsRevisionManagerTool();
var currentDateTime = DateTime.Now;
List source = GetWorkItemWithRevisions(currentDateTime, 1, 10, false);
@@ -207,5 +187,24 @@ private static bool CheckDateIncreasing(List revs)
}
return increasing;
}
+
+ private static TfsRevisionManagerTool GetTfsRevisionManagerTool()
+ {
+ return GetTfsRevisionManagerTool(new TfsRevisionManagerToolOptions() { Enabled = true, MaxRevisions = 0, ReplayRevisions = true });
+ }
+
+ private static TfsRevisionManagerTool GetTfsRevisionManagerTool(TfsRevisionManagerToolOptions options)
+ {
+
+ var sp = ServiceProviderHelper.GetMigrationToolServicesForUnitTests();
+ sp.AddSingleton();
+ sp.Configure(o =>
+ {
+ o.Enabled = options.Enabled;
+ o.MaxRevisions = options.MaxRevisions;
+ o.ReplayRevisions = options.ReplayRevisions;
+ });
+ return sp.BuildServiceProvider().GetService();
+ }
}
}
diff --git a/src/MigrationTools.Clients.AzureDevops.ObjectModel/_Enginev1/Clients/TfsReflectedWorkItemId.cs b/src/MigrationTools.Clients.AzureDevops.ObjectModel/Clients/TfsReflectedWorkItemId.cs
similarity index 100%
rename from src/MigrationTools.Clients.AzureDevops.ObjectModel/_Enginev1/Clients/TfsReflectedWorkItemId.cs
rename to src/MigrationTools.Clients.AzureDevops.ObjectModel/Clients/TfsReflectedWorkItemId.cs
diff --git a/src/MigrationTools.Clients.AzureDevops.ObjectModel/_Enginev1/Clients/TfsTestPlanMigrationClient.cs b/src/MigrationTools.Clients.AzureDevops.ObjectModel/Clients/TfsTestPlanMigrationClient.cs
similarity index 61%
rename from src/MigrationTools.Clients.AzureDevops.ObjectModel/_Enginev1/Clients/TfsTestPlanMigrationClient.cs
rename to src/MigrationTools.Clients.AzureDevops.ObjectModel/Clients/TfsTestPlanMigrationClient.cs
index 6b62ca4bd..2977b2e15 100644
--- a/src/MigrationTools.Clients.AzureDevops.ObjectModel/_Enginev1/Clients/TfsTestPlanMigrationClient.cs
+++ b/src/MigrationTools.Clients.AzureDevops.ObjectModel/Clients/TfsTestPlanMigrationClient.cs
@@ -1,19 +1,25 @@
using System;
using System.Collections.Generic;
+using Microsoft.Extensions.Options;
using MigrationTools._EngineV1.Configuration;
using MigrationTools._EngineV1.DataContracts;
+using MigrationTools.Endpoints;
+using MigrationTools.Endpoints.Infrastructure;
+using MigrationTools.Options;
namespace MigrationTools._EngineV1.Clients
{
public class TfsTestPlanMigrationClient : ITestPlanMigrationClient
{
- public IMigrationClientConfig Config => throw new NotImplementedException();
+
- public void Configure(IMigrationClient migrationClient, bool bypassRules = true)
+ public TfsTestPlanMigrationClient(IOptions options)
{
- // No current config
+ Options = options.Value;
}
+ public IEndpointOptions Options { get; set ; }
+
public TestPlanData CreateTestPlan()
{
throw new NotImplementedException();
diff --git a/src/MigrationTools.Clients.AzureDevops.ObjectModel/_Enginev1/Clients/TfsWorkItemMigrationClient.cs b/src/MigrationTools.Clients.AzureDevops.ObjectModel/Clients/TfsWorkItemMigrationClient.cs
similarity index 75%
rename from src/MigrationTools.Clients.AzureDevops.ObjectModel/_Enginev1/Clients/TfsWorkItemMigrationClient.cs
rename to src/MigrationTools.Clients.AzureDevops.ObjectModel/Clients/TfsWorkItemMigrationClient.cs
index 29bf3f9c8..1e451b83d 100644
--- a/src/MigrationTools.Clients.AzureDevops.ObjectModel/_Enginev1/Clients/TfsWorkItemMigrationClient.cs
+++ b/src/MigrationTools.Clients.AzureDevops.ObjectModel/Clients/TfsWorkItemMigrationClient.cs
@@ -4,11 +4,14 @@
using System.Text;
using Microsoft.ApplicationInsights.Channel;
using Microsoft.ApplicationInsights.DataContracts;
+using Microsoft.Extensions.Options;
using Microsoft.TeamFoundation.Client;
using Microsoft.TeamFoundation.WorkItemTracking.Client;
using MigrationTools._EngineV1.Configuration;
using MigrationTools._EngineV1.DataContracts;
using MigrationTools.DataContracts;
+using MigrationTools.Endpoints;
+using MigrationTools.Endpoints.Infrastructure;
using Serilog;
using static Microsoft.TeamFoundation.Client.CommandLine.Options;
@@ -19,18 +22,18 @@ public class TfsWorkItemMigrationClient : WorkItemMigrationClientBase
private ITelemetryLogger _telemetry;
private readonly IWorkItemQueryBuilderFactory _workItemQueryBuilderFactory;
private WorkItemStoreFlags _bypassRules;
- private IMigrationClientConfig _config;
private ProjectData _project;
private WorkItemStore _wistore;
- public TfsWorkItemMigrationClient(IWorkItemQueryBuilderFactory workItemQueryBuilderFactory, ITelemetryLogger telemetry)
- : base(telemetry)
+ public TfsWorkItemMigrationClient(IOptions options, IMigrationClient migrationClient, IWorkItemQueryBuilderFactory workItemQueryBuilderFactory, ITelemetryLogger telemetry)
+ : base(options, migrationClient, telemetry)
{
_telemetry = telemetry;
_workItemQueryBuilderFactory = workItemQueryBuilderFactory;
+ InnerConfigure(migrationClient);
}
- public override IMigrationClientConfig Config => _config;
+ new TfsTeamProjectEndpointOptions Options => (TfsTeamProjectEndpointOptions)base.Options;
public override ProjectData Project { get { return _project; } }
public WorkItemStore Store { get { return _wistore; } }
@@ -54,7 +57,7 @@ public List FilterExistingWorkItems(
var sourceWorkItems2 = sourceWorkItems.Where(p => targetFoundIds.All(p2 => p2.ToString() != sourceWorkItemMigrationClient.CreateReflectedWorkItemId(p).ToString())).ToList();
Log.Debug("FilterByTarget: After removing all found work items there are {SourceWorkItemCount} remaining to be migrated.", sourceWorkItems.Count);
Log.Debug("FilterByTarget: END");
- _telemetry.TrackEvent("FilterExistingWorkItems", new Dictionary { { "Project", sourceWorkItemMigrationClient.Config.AsTeamProjectConfig().Project }, { "CollectionName", sourceWorkItemMigrationClient.Config.AsTeamProjectConfig().CollectionName } }, new Dictionary { { "sourceWorkItems", sourceWorkItems.Count }, { "targetWorkItems", targetFoundItems.Count }, { "resultWorkItems", sourceWorkItems2.Count } });
+ _telemetry.TrackEvent("FilterExistingWorkItems", new Dictionary { { "Project", Options.Project }, { "CollectionName", Options.CollectionName } }, new Dictionary { { "sourceWorkItems", sourceWorkItems.Count }, { "targetWorkItems", targetFoundItems.Count }, { "resultWorkItems", sourceWorkItems2.Count } });
return sourceWorkItems2;
}
@@ -91,25 +94,31 @@ public override ProjectData GetProject()
Project y;
try
{
- y = (from Project x in Store.Projects where string.Equals(x.Name, MigrationClient.Config.AsTeamProjectConfig().Project, StringComparison.OrdinalIgnoreCase) select x).Single(); // Use Single instead of SingleOrDefault to force an exception here
+ y = (from Project x in Store.Projects where string.Equals(x.Name, Options.Project, StringComparison.OrdinalIgnoreCase) select x).SingleOrDefault(); // Use Single instead of SingleOrDefault to force an exception here
+ if (y == null)
+ {
+ Log.Fatal("The project `{ConfiguredProjectName}` does not exist in the collection. Please fix to continue.", Options.Project);
+ Log.Error("Valid options are: @{projects}", Store.Projects.Cast().Select(x => x.Name).ToList());
+ Environment.Exit(-1);
+ }
timer.Stop();
- Telemetry.TrackDependency(new DependencyTelemetry("TfsObjectModel", MigrationClient.Config.AsTeamProjectConfig().Collection.ToString(), "GetProject", null, startTime, timer.Elapsed, "200", true));
+ Telemetry.TrackDependency(new DependencyTelemetry("TfsObjectModel", Options.Collection.ToString(), "GetProject", null, startTime, timer.Elapsed, "200", true));
+ return y?.ToProjectData(); // With SingleOrDefault earlier this would result in a NullReferenceException which is hard to debug
}
catch (Exception ex)
{
timer.Stop();
- Telemetry.TrackDependency(new DependencyTelemetry("TfsObjectModel", MigrationClient.Config.AsTeamProjectConfig().Collection.ToString(), "GetProject", null, startTime, timer.Elapsed, "500", false));
+ Telemetry.TrackDependency(new DependencyTelemetry("TfsObjectModel", Options.Collection.ToString(), "GetProject", null, startTime, timer.Elapsed, "500", false));
Telemetry.TrackException(ex,
new Dictionary {
- { "CollectionUrl", MigrationClient.Config.AsTeamProjectConfig().Collection.ToString() }
+ { "CollectionUrl", Options.Collection.ToString() }
},
new Dictionary {
{ "Time",timer.ElapsedMilliseconds }
});
- Log.Error(ex, "Unable to get project with name {ConfiguredProjectName}", MigrationClient.Config.AsTeamProjectConfig().Project);
+ Log.Error(ex, "The project `{ConfiguredProjectName}` does not exist in the collection. Please fix to continue.", Options.Project);
throw;
}
- return y.ToProjectData(); // With SingleOrDefault earlier this would result in a NullReferenceException which is hard to debug
}
public override ReflectedWorkItemId CreateReflectedWorkItemId(WorkItemData workItem)
@@ -122,12 +131,12 @@ public override ReflectedWorkItemId GetReflectedWorkItemId(WorkItemData workItem
Log.Debug("GetReflectedWorkItemId: START");
var local = workItem.ToWorkItem();
- if (!local.Fields.Contains(Config.AsTeamProjectConfig().ReflectedWorkItemIDFieldName))
+ if (!local.Fields.Contains(Options.ReflectedWorkItemIDFieldName))
{
Log.Debug("GetReflectedWorkItemId: END - no reflected work item id on work item");
return null;
}
- string rwiid = local.Fields[Config.AsTeamProjectConfig().ReflectedWorkItemIDFieldName].Value.ToString();
+ string rwiid = local.Fields[Options.ReflectedWorkItemIDFieldName].Value.ToString();
if (!string.IsNullOrEmpty(rwiid))
{
Log.Debug("GetReflectedWorkItemId: END - Has ReflectedWorkItemIdField and has value");
@@ -161,14 +170,14 @@ public override WorkItemData GetWorkItem(int id, bool stopOnError = true)
Log.Debug("TfsWorkItemMigrationClient::GetWorkItem({id})", id);
y = Store.GetWorkItem(id);
timer.Stop();
- Telemetry.TrackDependency(new DependencyTelemetry("TfsObjectModel", MigrationClient.Config.AsTeamProjectConfig().Collection.ToString(), "GetWorkItem", null, startTime, timer.Elapsed, "200", true));
+ Telemetry.TrackDependency(new DependencyTelemetry("TfsObjectModel", Options.Collection.ToString(), "GetWorkItem", null, startTime, timer.Elapsed, "200", true));
}
catch (Exception ex)
{
Telemetry.TrackException(ex,
new Dictionary {
- { "CollectionUrl", MigrationClient.Config.AsTeamProjectConfig().Collection.ToString() },
- { "Project", MigrationClient.Config.AsTeamProjectConfig().Project.ToString() },
+ { "CollectionUrl", Options.Collection.ToString() },
+ { "Project", Options.Project.ToString() },
{ "WorkItem", id.ToString() }
},
new Dictionary {
@@ -182,7 +191,7 @@ public override WorkItemData GetWorkItem(int id, bool stopOnError = true)
} finally
{
timer.Stop();
- Telemetry.TrackDependency(new DependencyTelemetry("TfsObjectModel", MigrationClient.Config.AsTeamProjectConfig().Collection.ToString(), "GetWorkItem", null, startTime, timer.Elapsed, "500", false));
+ Telemetry.TrackDependency(new DependencyTelemetry("TfsObjectModel", Options.Collection.ToString(), "GetWorkItem", null, startTime, timer.Elapsed, "500", false));
}
return y?.AsWorkItemData();
@@ -207,7 +216,7 @@ public override List GetWorkItems(string WIQLQuery)
public override List GetWorkItems(IWorkItemQueryBuilder queryBuilder)
{
- queryBuilder.AddParameter("TeamProject", MigrationClient.Config.AsTeamProjectConfig().Project);
+ queryBuilder.AddParameter("TeamProject", Options.Project);
return queryBuilder.BuildWIQLQuery(MigrationClient).GetWorkItems();
}
@@ -215,17 +224,16 @@ private Endpoints.IWorkItemQuery GetWorkItemQuery(string WIQLQuery)
{
var wiqb = _workItemQueryBuilderFactory.Create();
wiqb.Query = WIQLQuery;
- wiqb.AddParameter("TeamProject", MigrationClient.Config.AsTeamProjectConfig().Project);
- wiqb.AddParameter("ReflectedWorkItemIdFieldName", MigrationClient.Config.AsTeamProjectConfig().ReflectedWorkItemIDFieldName);
+ wiqb.AddParameter("TeamProject", Options.Project);
+ wiqb.AddParameter("ReflectedWorkItemIdFieldName", Options.ReflectedWorkItemIDFieldName);
return wiqb.BuildWIQLQuery(MigrationClient);
}
- protected override void InnerConfigure(IMigrationClient migrationClient, bool bypassRules = true)
+ protected void InnerConfigure(IMigrationClient migrationClient, bool bypassRules = true)
{
- _config = MigrationClient.Config;
_bypassRules = bypassRules ? WorkItemStoreFlags.BypassRules : WorkItemStoreFlags.None;
_wistore = GetWorkItemStore();
- _project = migrationClient.WorkItems.GetProject();
+ _project = GetProject();
}
public override WorkItemData PersistWorkItem(WorkItemData workItem)
@@ -241,7 +249,7 @@ protected WorkItemData FindReflectedWorkItemByReflectedWorkItemId(ReflectedWorkI
var workItemQueryBuilder = CreateReflectedWorkItemQuery(refId.ToString());
var query = workItemQueryBuilder.BuildWIQLQuery(MigrationClient);
var items = query.GetWorkItems();
- var reflectedFielName = MigrationClient.Config.AsTeamProjectConfig().ReflectedWorkItemIDFieldName;
+ var reflectedFielName = Options.ReflectedWorkItemIDFieldName;
foundWorkItem = items.FirstOrDefault(wi => wi.ToWorkItem().Fields[reflectedFielName].Value.ToString() == refId.ToString());
if (cache && foundWorkItem is not null)
{
@@ -257,13 +265,13 @@ private IWorkItemQueryBuilder CreateReflectedWorkItemQuery(string refId)
StringBuilder queryBuilder = new StringBuilder();
queryBuilder.Append("SELECT [System.Id] FROM WorkItems");
queryBuilder.Append(" WHERE ");
- if (!MigrationClient.Config.AsTeamProjectConfig().AllowCrossProjectLinking)
+ if (!Options.AllowCrossProjectLinking)
{
queryBuilder.Append("[System.TeamProject]=@TeamProject AND ");
- workItemQueryBuilder.AddParameter("TeamProject", MigrationClient.Config.AsTeamProjectConfig().Project);
+ workItemQueryBuilder.AddParameter("TeamProject", Options.Project);
}
- queryBuilder.AppendFormat("[{0}] = @idToFind", MigrationClient.Config.AsTeamProjectConfig().ReflectedWorkItemIDFieldName);
+ queryBuilder.AppendFormat("[{0}] = @idToFind", Options.ReflectedWorkItemIDFieldName);
workItemQueryBuilder.AddParameter("idToFind", refId);
workItemQueryBuilder.Query = queryBuilder.ToString();
return workItemQueryBuilder;
@@ -286,11 +294,11 @@ private WorkItemStore GetWorkItemStore()
WorkItemStore store;
try
{
- Log.Debug("TfsWorkItemMigrationClient::GetWorkItemStore({InternalCollection}, {bypassRules})", _config.AsTeamProjectConfig().Collection, _bypassRules);
+ Log.Debug("TfsWorkItemMigrationClient::GetWorkItemStore({InternalCollection}, {bypassRules})", Options.Collection, _bypassRules);
store = new WorkItemStore((TfsTeamProjectCollection)MigrationClient.InternalCollection, _bypassRules);
timer.Stop();
- Telemetry.TrackDependency(new DependencyTelemetry("TfsObjectModel", MigrationClient.Config.AsTeamProjectConfig().Collection.ToString(), "GetWorkItemStore", null, startTime, timer.Elapsed, "200", true));
- Log.Information("Work Item Store connected to {InternalCollection} with BypassRules set to {bypassRules}", _config.AsTeamProjectConfig().Collection, store.BypassRules);
+ Telemetry.TrackDependency(new DependencyTelemetry("TfsObjectModel", Options.Collection.ToString(), "GetWorkItemStore", null, startTime, timer.Elapsed, "200", true));
+ Log.Information("Work Item Store connected to {InternalCollection} with BypassRules set to {bypassRules}", Options.Collection, store.BypassRules);
if (_bypassRules == WorkItemStoreFlags.BypassRules)
{
if (store.BypassRules == false)
@@ -303,10 +311,10 @@ private WorkItemStore GetWorkItemStore()
catch (Exception ex)
{
timer.Stop();
- Telemetry.TrackDependency(new DependencyTelemetry("TfsObjectModel", MigrationClient.Config.AsTeamProjectConfig().Collection.ToString(), "GetWorkItemStore", null, startTime, timer.Elapsed, "500", false));
+ Telemetry.TrackDependency(new DependencyTelemetry("TfsObjectModel", Options.Collection.ToString(), "GetWorkItemStore", null, startTime, timer.Elapsed, "500", false));
Telemetry.TrackException(ex,
new Dictionary {
- { "CollectionUrl", MigrationClient.Config.AsTeamProjectConfig().Collection.ToString() }
+ { "CollectionUrl", Options.Collection.ToString() }
},
new Dictionary {
{ "Time",timer.ElapsedMilliseconds }
diff --git a/src/MigrationTools.Clients.AzureDevops.ObjectModel/_Enginev1/Clients/TfsWorkItemQuery.cs b/src/MigrationTools.Clients.AzureDevops.ObjectModel/Clients/TfsWorkItemQuery.cs
similarity index 89%
rename from src/MigrationTools.Clients.AzureDevops.ObjectModel/_Enginev1/Clients/TfsWorkItemQuery.cs
rename to src/MigrationTools.Clients.AzureDevops.ObjectModel/Clients/TfsWorkItemQuery.cs
index 6e82f5ef2..008239a44 100644
--- a/src/MigrationTools.Clients.AzureDevops.ObjectModel/_Enginev1/Clients/TfsWorkItemQuery.cs
+++ b/src/MigrationTools.Clients.AzureDevops.ObjectModel/Clients/TfsWorkItemQuery.cs
@@ -17,6 +17,8 @@ public TfsWorkItemQuery(ITelemetryLogger telemetry)
{
}
+ new TfsTeamProjectEndpoint MigrationClient => (TfsTeamProjectEndpoint)base.MigrationClient;
+
public override List GetWorkItemIds()
{
return GetInternalWorkItems().Select(wi => wi.Id).ToList();
@@ -80,19 +82,19 @@ private IList GetWorkItemsFromQuery(TfsWorkItemMigrationClient wiClien
}
}
timer.Stop();
- Telemetry.TrackDependency(new DependencyTelemetry("TfsObjectModel", MigrationClient.Config.AsTeamProjectConfig().Collection.ToString(), "GetWorkItemsFromQuery", null, startTime, timer.Elapsed, "200", true));
+ Telemetry.TrackDependency(new DependencyTelemetry("TfsObjectModel", MigrationClient.Options.Collection.ToString(), "GetWorkItemsFromQuery", null, startTime, timer.Elapsed, "200", true));
}
catch (ValidationException ex)
{
timer.Stop();
- Telemetry.TrackDependency(new DependencyTelemetry("TfsObjectModel", MigrationClient.Config.AsTeamProjectConfig().Collection.ToString(), "GetWorkItemsFromQuery", null, startTime, timer.Elapsed, "500", false));
+ Telemetry.TrackDependency(new DependencyTelemetry("TfsObjectModel", MigrationClient.Options.Collection.ToString(), "GetWorkItemsFromQuery", null, startTime, timer.Elapsed, "500", false));
Log.Error(ex, " Error running query");
Environment.Exit(-1);
}
catch (Exception ex)
{
timer.Stop();
- Telemetry.TrackDependency(new DependencyTelemetry("TfsObjectModel", MigrationClient.Config.AsTeamProjectConfig().Collection.ToString(), "GetWorkItemsFromQuery", null, startTime, timer.Elapsed, "500", false));
+ Telemetry.TrackDependency(new DependencyTelemetry("TfsObjectModel", MigrationClient.Options.Collection.ToString(), "GetWorkItemsFromQuery", null, startTime, timer.Elapsed, "500", false));
Telemetry.TrackException(ex,
new Dictionary {
{ "CollectionUrl", wiClient.Store.TeamProjectCollection.Uri.ToString() }
diff --git a/src/MigrationTools.Clients.AzureDevops.ObjectModel/EndPoints/Infrastructure/TfsTeamProjectAuthentication.cs b/src/MigrationTools.Clients.AzureDevops.ObjectModel/EndPoints/Infrastructure/TfsTeamProjectAuthentication.cs
new file mode 100644
index 000000000..fd47f02a9
--- /dev/null
+++ b/src/MigrationTools.Clients.AzureDevops.ObjectModel/EndPoints/Infrastructure/TfsTeamProjectAuthentication.cs
@@ -0,0 +1,21 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+using MigrationTools.Options;
+using Newtonsoft.Json;
+using Newtonsoft.Json.Converters;
+
+
+namespace MigrationTools.Endpoints.Infrastructure
+{
+ public class TfsAuthenticationOptions
+ {
+ [JsonConverter(typeof(StringEnumConverter))]
+ public AuthenticationMode AuthenticationMode { get; set; }
+
+ public NetworkCredentials NetworkCredentials { get; set; }
+ public string AccessToken { get; set; }
+ }
+}
diff --git a/src/MigrationTools.Clients.AzureDevops.ObjectModel/EndPoints/TfsTeamProjectEndPointOptions.cs b/src/MigrationTools.Clients.AzureDevops.ObjectModel/EndPoints/TfsTeamProjectEndPointOptions.cs
new file mode 100644
index 000000000..2c6994d80
--- /dev/null
+++ b/src/MigrationTools.Clients.AzureDevops.ObjectModel/EndPoints/TfsTeamProjectEndPointOptions.cs
@@ -0,0 +1,35 @@
+using System;
+using Microsoft.VisualStudio.Services.Client;
+using MigrationTools.Endpoints;
+using MigrationTools.Endpoints.Infrastructure;
+using MigrationTools.Options;
+using Newtonsoft.Json;
+using Newtonsoft.Json.Converters;
+using TfsUrlParser;
+
+namespace MigrationTools.Endpoints
+{
+ public class TfsTeamProjectEndpointOptions : EndpointOptions
+ {
+ public Uri Collection { get; set; }
+ public string Project { get; set; }
+
+ public TfsAuthenticationOptions Authentication { get; set; }
+ public string ReflectedWorkItemIDFieldName { get; set; }
+ public bool AllowCrossProjectLinking { get; set; }
+
+ public TfsLanguageMapOptions LanguageMaps { get; set; }
+
+ [JsonIgnore]
+ public string CollectionName { get { return GetCollectionName(); } }
+
+ public string GetCollectionName()
+ {
+ //var repositoryDescription = new RepositoryDescription(Collection);
+ //return repositoryDescription.CollectionName;
+ // Pending fix from https://github.com/bbtsoftware/TfsUrlParser
+ return Collection != null ? Collection.ToString() : "https://dev.azure.com/sampleAccount";
+ }
+
+ }
+}
\ No newline at end of file
diff --git a/src/MigrationTools.Clients.AzureDevops.ObjectModel/EndpointEnrichers/TfsWorkItemAttachmentEnricher.cs b/src/MigrationTools.Clients.AzureDevops.ObjectModel/EndpointEnrichers/TfsWorkItemAttachmentEnricher.cs
deleted file mode 100644
index e0063c11f..000000000
--- a/src/MigrationTools.Clients.AzureDevops.ObjectModel/EndpointEnrichers/TfsWorkItemAttachmentEnricher.cs
+++ /dev/null
@@ -1,25 +0,0 @@
-using System;
-using Microsoft.Extensions.Logging;
-using MigrationTools.DataContracts;
-using MigrationTools.Endpoints;
-
-namespace MigrationTools.EndpointEnrichers
-{
- ///
- /// The `TfsWorkItemAttachmentEnricher` processes the attachements for a specific work item.
- ///
- /// WorkItem
- public class TfsWorkItemAttachmentEnricher : WorkItemAttachmentEnricher
- {
- private WorkItemAttachmentEnricherOptions _Options;
-
- public TfsWorkItemAttachmentEnricher(IServiceProvider services, ITelemetryLogger telemetry, ILogger logger) : base(services, telemetry, logger)
- {
- }
-
- public override void EnrichWorkItemData(IEndpoint endpoint, object dataSource, RevisionItem dataTarget)
- {
- throw new NotImplementedException();
- }
- }
-}
\ No newline at end of file
diff --git a/src/MigrationTools.Clients.AzureDevops.ObjectModel/EndpointEnrichers/TfsWorkItemAttachmentEnricherOptions.cs b/src/MigrationTools.Clients.AzureDevops.ObjectModel/EndpointEnrichers/TfsWorkItemAttachmentEnricherOptions.cs
deleted file mode 100644
index 2b41069f7..000000000
--- a/src/MigrationTools.Clients.AzureDevops.ObjectModel/EndpointEnrichers/TfsWorkItemAttachmentEnricherOptions.cs
+++ /dev/null
@@ -1,9 +0,0 @@
-using System;
-
-namespace MigrationTools.EndpointEnrichers
-{
- public class TfsWorkItemAttachmentEnricherOptions : WorkItemAttachmentEnricherOptions
- {
- public override Type ToConfigure => typeof(TfsWorkItemAttachmentEnricher);
- }
-}
\ No newline at end of file
diff --git a/src/MigrationTools.Clients.AzureDevops.ObjectModel/Endpoints/TfsEndpoint.cs b/src/MigrationTools.Clients.AzureDevops.ObjectModel/Endpoints/TfsEndpoint.cs
index 14d0e5a02..f994ee5ee 100644
--- a/src/MigrationTools.Clients.AzureDevops.ObjectModel/Endpoints/TfsEndpoint.cs
+++ b/src/MigrationTools.Clients.AzureDevops.ObjectModel/Endpoints/TfsEndpoint.cs
@@ -1,6 +1,7 @@
using System;
using Microsoft.ApplicationInsights.DataContracts;
using Microsoft.Extensions.Logging;
+using Microsoft.Extensions.Options;
using Microsoft.TeamFoundation.Client;
using Microsoft.TeamFoundation.WorkItemTracking.Client;
using Microsoft.VisualStudio.Services.Common;
@@ -10,8 +11,7 @@ namespace MigrationTools.Endpoints
{
public class TfsEndpoint : GenericTfsEndpoint
{
- public TfsEndpoint(EndpointEnricherContainer endpointEnrichers, ITelemetryLogger telemetry, ILogger logger)
- : base(endpointEnrichers, telemetry, logger)
+ public TfsEndpoint(IOptions options, EndpointEnricherContainer endpointEnrichers, IServiceProvider serviceProvider, ITelemetryLogger telemetry, ILogger> logger) : base(options, endpointEnrichers, serviceProvider, telemetry, logger)
{
}
}
@@ -23,6 +23,10 @@ public class GenericTfsEndpoint : Endpoint
private Project _Project;
private WorkItemStore _Store;
+ public GenericTfsEndpoint(IOptions options, EndpointEnricherContainer endpointEnrichers, IServiceProvider serviceProvider, ITelemetryLogger telemetry, ILogger> logger) : base(options, endpointEnrichers, serviceProvider, telemetry, logger)
+ {
+ }
+
public string Project => Options.Project;
internal TfsTeamProjectCollection TfsCollection
@@ -53,28 +57,8 @@ public Uri TfsProjectUri
public override int Count => 0;
- public GenericTfsEndpoint(EndpointEnricherContainer endpointEnrichers, ITelemetryLogger telemetry, ILogger> logger)
- : base(endpointEnrichers, telemetry, logger)
- {
- }
- public override void Configure(TTfsOptions options)
- {
- base.Configure(options);
- Log.LogDebug("TfsEndpoint::Configure");
- if (string.IsNullOrEmpty(Options.Organisation))
- {
- throw new ArgumentNullException(nameof(Options.Organisation));
- }
- if (string.IsNullOrEmpty(Options.Project))
- {
- throw new ArgumentNullException(nameof(Options.Project));
- }
- if (string.IsNullOrEmpty(Options.AccessToken) && Options.AuthenticationMode == AuthenticationMode.AccessToken)
- {
- throw new ArgumentNullException(nameof(Options.AccessToken));
- }
- }
+
private TfsTeamProjectCollection GetTfsCollection()
{
diff --git a/src/MigrationTools.Clients.AzureDevops.ObjectModel/Endpoints/TfsEndpointOptions.cs b/src/MigrationTools.Clients.AzureDevops.ObjectModel/Endpoints/TfsEndpointOptions.cs
index a3dfa7fd2..133f111bc 100644
--- a/src/MigrationTools.Clients.AzureDevops.ObjectModel/Endpoints/TfsEndpointOptions.cs
+++ b/src/MigrationTools.Clients.AzureDevops.ObjectModel/Endpoints/TfsEndpointOptions.cs
@@ -1,4 +1,6 @@
-using Newtonsoft.Json;
+using System.ComponentModel.DataAnnotations;
+using MigrationTools.Endpoints.Infrastructure;
+using Newtonsoft.Json;
using Newtonsoft.Json.Converters;
namespace MigrationTools.Endpoints
@@ -6,17 +8,23 @@ namespace MigrationTools.Endpoints
public class TfsEndpointOptions : EndpointOptions
{
[JsonConverter(typeof(StringEnumConverter))]
+ [Required]
public AuthenticationMode AuthenticationMode { get; set; }
+ [Required]
public string AccessToken { get; set; }
[JsonProperty(Order = -3)]
+ [Required]
public string Organisation { get; set; }
[JsonProperty(Order = -2)]
+ [Required]
public string Project { get; set; }
[JsonProperty(Order = -1)]
+ [Required]
public string ReflectedWorkItemIdField { get; set; }
+ [Required]
public TfsLanguageMapOptions LanguageMaps { get; set; }
diff --git a/src/MigrationTools.Clients.AzureDevops.ObjectModel/Endpoints/TfsTeamProjectEndpoint.cs b/src/MigrationTools.Clients.AzureDevops.ObjectModel/Endpoints/TfsTeamProjectEndpoint.cs
new file mode 100644
index 000000000..fcd2be8f9
--- /dev/null
+++ b/src/MigrationTools.Clients.AzureDevops.ObjectModel/Endpoints/TfsTeamProjectEndpoint.cs
@@ -0,0 +1,183 @@
+using System;
+using System.Collections.Generic;
+using System.Net;
+using Microsoft.ApplicationInsights.DataContracts;
+using Microsoft.Extensions.DependencyInjection;
+using Microsoft.Extensions.Logging;
+using Microsoft.Extensions.Options;
+using Microsoft.TeamFoundation;
+using Microsoft.TeamFoundation.Client;
+using Microsoft.VisualStudio.Services.Client;
+using Microsoft.VisualStudio.Services.Common;
+using Microsoft.VisualStudio.Services.WebApi;
+using MigrationTools._EngineV1.Configuration;
+using MigrationTools.EndpointEnrichers;
+using MigrationTools.Endpoints;
+using MigrationTools.Endpoints.Infrastructure;
+using MigrationTools.Options;
+using Serilog;
+
+namespace MigrationTools._EngineV1.Clients
+{
+ public class TfsTeamProjectEndpoint : Endpoint, IMigrationClient // TODO: Rename IMigrationClient to ITfsTeamProjectEndpoint
+ {
+ private TfsTeamProjectCollection _collection;
+ private VssCredentials _vssCredentials;
+ private IWorkItemMigrationClient _workItemClient;
+ private ITestPlanMigrationClient _testPlanClient;
+
+ public TfsTeamProjectEndpoint(
+ IOptions options,
+ EndpointEnricherContainer endpointEnrichers,
+ ITelemetryLogger telemetry,
+ ILogger logger,
+ IServiceProvider Services
+ ) : base(options, endpointEnrichers, Services, telemetry, logger)
+ {
+ _testPlanClient = new TfsTestPlanMigrationClient(options);
+
+ _workItemClient = ActivatorUtilities.CreateInstance(Services, this, options);
+ //networkCredentials IOptions networkCredentials,
+
+ }
+
+ public override int Count => 0;
+
+
+ public IWorkItemMigrationClient WorkItems
+ {
+ get
+ {
+ return _workItemClient;
+ }
+ }
+
+ public ITestPlanMigrationClient TestPlans
+ {
+ get
+ {
+ return _testPlanClient;
+ }
+ }
+
+ public object InternalCollection
+ {
+ get
+ {
+ EnsureCollection();
+ return _collection;
+ }
+ }
+
+ private void EnsureCollection()
+ {
+ if (_collection == null)
+ {
+ Telemetry.TrackEvent("TeamProjectContext.EnsureCollection",
+ new Dictionary {
+ { "Name", Options.Project},
+ { "Target Project", Options.Project},
+ { "Target Collection",Options.Collection.ToString() },
+ { "ReflectedWorkItemID Field Name",Options.ReflectedWorkItemIDFieldName }
+ }, null);
+ _collection = GetDependantTfsCollection();
+ }
+ }
+
+ private TfsTeamProjectCollection GetDependantTfsCollection()
+ {
+ var startTime = DateTime.UtcNow;
+ var timer = System.Diagnostics.Stopwatch.StartNew();
+ TfsTeamProjectCollection y = null;
+ try
+ {
+ Log.LogDebug("TfsMigrationClient::GetDependantTfsCollection:AuthenticationMode({0})", Options.Authentication.AuthenticationMode.ToString());
+ switch (Options.Authentication.AuthenticationMode)
+ {
+ case AuthenticationMode.AccessToken:
+ Log.LogInformation("Connecting with AccessToken ");
+ if (string.IsNullOrEmpty(Options.Authentication.AccessToken))
+ {
+ Log.LogCritical("You must provide a PAT to use 'AccessToken' as the authentication mode. You can set this through the config at 'MigrationTools:Endpoints:{name}:Authentication:AccessToken', or you can set an environemnt variable of 'MigrationTools__Endpoints__{name}__Authentication__AccessToken'. Check the docs on https://nkdagility.com/learn/azure-devops-migration-tools/Reference/Endpoints/TfsTeamProjectEndpoint/");
+ Environment.Exit(-1);
+ }
+ var pat = Options.Authentication.AccessToken;
+ _vssCredentials = new VssBasicCredential(string.Empty, pat);
+ y = new TfsTeamProjectCollection(Options.Collection, _vssCredentials);
+ break;
+ case AuthenticationMode.Windows:
+ Log.LogInformation("Connecting with NetworkCredential ");
+ if (Options.Authentication.NetworkCredentials == null)
+ {
+ Log.LogCritical("You must set NetworkCredential to use 'Windows' as the authentication mode. You can set this through the config at 'MigrationTools:Endpoints:{name}:Authentication:AccessToken', or you can set an environemnt variable of 'MigrationTools__Endpoints__{name}__Authentication__AccessToken'. Check the docs on https://nkdagility.com/learn/azure-devops-migration-tools/Reference/Endpoints/TfsTeamProjectEndpoint/");
+ Environment.Exit(-1);
+ }
+ var cred = new NetworkCredential(Options.Authentication.NetworkCredentials.UserName, Options.Authentication.NetworkCredentials.Password, Options.Authentication.NetworkCredentials.Domain);
+ _vssCredentials = new VssCredentials(new Microsoft.VisualStudio.Services.Common.WindowsCredential(cred));
+ y = new TfsTeamProjectCollection(Options.Collection, _vssCredentials);
+ break;
+ case AuthenticationMode.Prompt:
+ Log.LogInformation("Prompting for credentials ");
+ _vssCredentials = new VssClientCredentials();
+ _vssCredentials.PromptType = CredentialPromptType.PromptIfNeeded;
+ y = new TfsTeamProjectCollection(Options.Collection, _vssCredentials);
+ break;
+
+ default:
+ Log.LogInformation("Setting _vssCredentials to Null ");
+ y = new TfsTeamProjectCollection(Options.Collection);
+ break;
+ }
+ Log.LogDebug("MigrationClient: Connecting to {CollectionUrl} ", Options.Collection);
+ Log.LogTrace("MigrationClient: validating security for {@AuthorizedIdentity} ", y.AuthorizedIdentity);
+ y.EnsureAuthenticated();
+ timer.Stop();
+ Log.LogInformation("Access granted to {CollectionUrl} for {Name} ({Account})", Options.Collection, y.AuthorizedIdentity.DisplayName, y.AuthorizedIdentity.UniqueName);
+ Telemetry.TrackDependency(new DependencyTelemetry("TfsObjectModel", Options.Collection.ToString(), "GetWorkItem", null, startTime, timer.Elapsed, "200", true));
+ }
+ catch (TeamFoundationServerUnauthorizedException ex)
+ {
+ timer.Stop();
+ Telemetry.TrackDependency(new DependencyTelemetry("TfsObjectModel", Options.Collection.ToString(), "GetWorkItem", null, startTime, timer.Elapsed, "401", false));
+ Log.LogError(ex, "Unable to configure store: Check persmissions and credentials for {AuthenticationMode}!", Options.Authentication.AuthenticationMode);
+ Environment.Exit(-1);
+ }
+ catch (Exception ex)
+ {
+ timer.Stop();
+ Telemetry.TrackDependency(new DependencyTelemetry("TfsObjectModel", Options.Collection.ToString(), "GetWorkItem", null, startTime, timer.Elapsed, "500", false));
+ Telemetry.TrackException(ex,
+ new Dictionary {
+ { "CollectionUrl", Options.Collection.ToString() },
+ { "TeamProjectName", Options.Project}
+ },
+ new Dictionary {
+ { "Time",timer.ElapsedMilliseconds }
+ });
+ Log.LogError("Unable to configure store: Check persmissions and credentials for {AuthenticationMode}: " + ex.Message, Options.Authentication.AuthenticationMode);
+ switch (Options.Authentication.AuthenticationMode)
+ {
+ case AuthenticationMode.AccessToken:
+ Log.LogError("The PAT MUST be 'full access' for it to work with the Object Model API.");
+ break;
+ default:
+ break;
+ }
+ Environment.Exit(-1);
+ }
+ return y;
+ }
+
+ public T GetService()
+ {
+ EnsureCollection();
+ return _collection.GetService();
+ }
+
+ public T GetClient() where T : IVssHttpClient
+ {
+ EnsureCollection();
+ return _collection.GetClient();
+ }
+ }
+}
\ No newline at end of file
diff --git a/src/MigrationTools.Clients.AzureDevops.ObjectModel/Endpoints/TfsTeamSettingsEndpoint.cs b/src/MigrationTools.Clients.AzureDevops.ObjectModel/Endpoints/TfsTeamSettingsEndpoint.cs
index 7702022f7..2e250f137 100644
--- a/src/MigrationTools.Clients.AzureDevops.ObjectModel/Endpoints/TfsTeamSettingsEndpoint.cs
+++ b/src/MigrationTools.Clients.AzureDevops.ObjectModel/Endpoints/TfsTeamSettingsEndpoint.cs
@@ -1,4 +1,6 @@
-using Microsoft.Extensions.Logging;
+using System;
+using Microsoft.Extensions.Logging;
+using Microsoft.Extensions.Options;
using Microsoft.TeamFoundation.Client;
using Microsoft.TeamFoundation.ProcessConfiguration.Client;
using Microsoft.TeamFoundation.Work.WebApi;
@@ -8,8 +10,7 @@ namespace MigrationTools.Endpoints
{
public class TfsTeamSettingsEndpoint : GenericTfsEndpoint, ISourceEndPoint, ITargetEndPoint
{
- public TfsTeamSettingsEndpoint(EndpointEnricherContainer endpointEnrichers, ITelemetryLogger telemetry, ILogger logger)
- : base(endpointEnrichers, telemetry, logger)
+ public TfsTeamSettingsEndpoint(IOptions options, EndpointEnricherContainer endpointEnrichers, IServiceProvider serviceProvider, ITelemetryLogger telemetry, ILogger> logger) : base(options, endpointEnrichers, serviceProvider, telemetry, logger)
{
}
diff --git a/src/MigrationTools.Clients.AzureDevops.ObjectModel/Endpoints/TfsWorkItemEndpoint.cs b/src/MigrationTools.Clients.AzureDevops.ObjectModel/Endpoints/TfsWorkItemEndpoint.cs
index 139cb1ffc..35f5c26da 100644
--- a/src/MigrationTools.Clients.AzureDevops.ObjectModel/Endpoints/TfsWorkItemEndpoint.cs
+++ b/src/MigrationTools.Clients.AzureDevops.ObjectModel/Endpoints/TfsWorkItemEndpoint.cs
@@ -1,6 +1,7 @@
using System;
using System.Collections.Generic;
using Microsoft.Extensions.Logging;
+using Microsoft.Extensions.Options;
using Microsoft.TeamFoundation.WorkItemTracking.Client;
using MigrationTools.DataContracts;
using MigrationTools.EndpointEnrichers;
@@ -11,21 +12,10 @@ namespace MigrationTools.Endpoints
{
public class TfsWorkItemEndpoint : GenericTfsEndpoint, IWorkItemSourceEndpoint, IWorkItemTargetEndpoint
{
- public TfsWorkItemEndpoint(EndpointEnricherContainer endpointEnrichers, ITelemetryLogger telemetry, ILogger logger)
- : base(endpointEnrichers, telemetry, logger)
+ public TfsWorkItemEndpoint(IOptions options, EndpointEnricherContainer endpointEnrichers, IServiceProvider serviceProvider, ITelemetryLogger telemetry, ILogger> logger) : base(options, endpointEnrichers, serviceProvider, telemetry, logger)
{
}
- public override void Configure(TfsWorkItemEndpointOptions options)
- {
- base.Configure(options);
- Log.LogDebug("TfsWorkItemEndPoint::Configure");
- if (string.IsNullOrEmpty(Options.Query?.Query))
- {
- throw new ArgumentNullException(nameof(Options.Query));
- }
- }
-
public void Filter(IEnumerable workItems)
{
Log.LogDebug("TfsWorkItemEndPoint::Filter");
diff --git a/src/MigrationTools.Clients.AzureDevops.ObjectModel/MigrationTools.Clients.AzureDevops.ObjectModel.csproj b/src/MigrationTools.Clients.AzureDevops.ObjectModel/MigrationTools.Clients.AzureDevops.ObjectModel.csproj
index 150c36619..0d163944c 100644
--- a/src/MigrationTools.Clients.AzureDevops.ObjectModel/MigrationTools.Clients.AzureDevops.ObjectModel.csproj
+++ b/src/MigrationTools.Clients.AzureDevops.ObjectModel/MigrationTools.Clients.AzureDevops.ObjectModel.csproj
@@ -10,8 +10,28 @@
..\..\docs\Reference\Generated\MigrationTools.Clients.AzureDevops.ObjectModel.xml
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
@@ -25,5 +45,14 @@
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/src/MigrationTools.Clients.AzureDevops.ObjectModel/MigrationTools.Clients.AzureDevops.ObjectModel.xml b/src/MigrationTools.Clients.AzureDevops.ObjectModel/MigrationTools.Clients.AzureDevops.ObjectModel.xml
index 6af0343a1..a69a00d42 100644
--- a/src/MigrationTools.Clients.AzureDevops.ObjectModel/MigrationTools.Clients.AzureDevops.ObjectModel.xml
+++ b/src/MigrationTools.Clients.AzureDevops.ObjectModel/MigrationTools.Clients.AzureDevops.ObjectModel.xml
@@ -4,10 +4,10 @@
MigrationTools.Clients.AzureDevops.ObjectModel
-
+
from https://gist.github.com/pietergheysens/792ed505f09557e77ddfc1b83531e4fb
-
+
Checks node-to-be-created with allowed BasePath's
diff --git a/src/MigrationTools.Clients.AzureDevops.ObjectModel/ProcessorEnrichers/TfsNodeStructureOptions.cs b/src/MigrationTools.Clients.AzureDevops.ObjectModel/ProcessorEnrichers/TfsNodeStructureOptions.cs
deleted file mode 100644
index acca3a29b..000000000
--- a/src/MigrationTools.Clients.AzureDevops.ObjectModel/ProcessorEnrichers/TfsNodeStructureOptions.cs
+++ /dev/null
@@ -1,64 +0,0 @@
-using System;
-using System.Collections.Generic;
-using System.Text.Json.Serialization;
-using Microsoft.TeamFoundation.Build.Client;
-using Newtonsoft.Json.Schema;
-
-namespace MigrationTools.Enrichers
-{
-
- public class TfsNodeStructureOptions : ProcessorEnricherOptions, ITfsNodeStructureOptions
- {
- public override Type ToConfigure => typeof(TfsNodeStructure);
-
-
- ///
- /// The root paths of the Ares / Iterations you want migrate. See [NodeBasePath Configuration](#nodebasepath-configuration)
- ///
- /// ["/"]
- public string[] NodeBasePaths { get; set; }
-
- ///
- /// Remapping rules for area paths, implemented with regular expressions. The rules apply with a higher priority than the `PrefixProjectToNodes`,
- /// that is, if no rule matches the path and the `PrefixProjectToNodes` option is enabled, then the old `PrefixProjectToNodes` behavior is applied.
- ///
- /// {}
- public Dictionary AreaMaps { get; set; }
-
- ///
- /// Remapping rules for iteration paths, implemented with regular expressions. The rules apply with a higher priority than the `PrefixProjectToNodes`,
- /// that is, if no rule matches the path and the `PrefixProjectToNodes` option is enabled, then the old `PrefixProjectToNodes` behavior is applied.
- ///
- /// {}
- public Dictionary IterationMaps { get; set; }
-
- ///
- /// When set to True the susyem will try to create any missing missing area or iteration paths from the revisions.
- ///
- public bool ShouldCreateMissingRevisionPaths { get; set; }
- public bool ReplicateAllExistingNodes { get; set; }
-
- public override void SetDefaults()
- {
- Enabled = true;
- AreaMaps = new Dictionary();
- IterationMaps = new Dictionary();
- ShouldCreateMissingRevisionPaths = true;
- ReplicateAllExistingNodes = false;
- }
-
- static public TfsNodeStructureOptions GetDefaults()
- {
- var result = new TfsNodeStructureOptions();
- result.SetDefaults();
- return result;
- }
- }
-
- public interface ITfsNodeStructureOptions
- {
- public string[] NodeBasePaths { get; set; }
- public Dictionary AreaMaps { get; set; }
- public Dictionary IterationMaps { get; set; }
- }
-}
\ No newline at end of file
diff --git a/src/MigrationTools.Clients.AzureDevops.ObjectModel/ProcessorEnrichers/TfsUserMappingEnricherOptions.cs b/src/MigrationTools.Clients.AzureDevops.ObjectModel/ProcessorEnrichers/TfsUserMappingEnricherOptions.cs
deleted file mode 100644
index 308b36511..000000000
--- a/src/MigrationTools.Clients.AzureDevops.ObjectModel/ProcessorEnrichers/TfsUserMappingEnricherOptions.cs
+++ /dev/null
@@ -1,50 +0,0 @@
-using System;
-using System.Collections.Generic;
-using Microsoft.TeamFoundation.Build.Client;
-using MigrationTools.ProcessorEnrichers;
-
-namespace MigrationTools.Enrichers
-{
- public class TfsUserMappingEnricherOptions : ProcessorEnricherOptions, ITfsUserMappingEnricherOptions
- {
-
-
- public override Type ToConfigure => typeof(TfsUserMappingEnricher);
-
- ///
- /// This is a list of the Identiy fields in the Source to check for user mapping purposes. You should list all identiy fields that you wan to map.
- ///
- public List IdentityFieldsToCheck { get; set; }
-
- ///
- /// This is the file that will be used to export or import the user mappings. Use the ExportUsersForMapping processor to create the file.
- ///
- public string UserMappingFile { get; set; }
-
- public override void SetDefaults()
- {
- Enabled = false;
- UserMappingFile = "usermapping.json";
- IdentityFieldsToCheck = new List {
- "System.AssignedTo",
- "System.ChangedBy",
- "System.CreatedBy",
- "Microsoft.VSTS.Common.ActivatedBy",
- "Microsoft.VSTS.Common.ResolvedBy",
- "Microsoft.VSTS.Common.ClosedBy" };
- }
-
- static public TfsUserMappingEnricherOptions GetDefaults()
- {
- var result = new TfsUserMappingEnricherOptions();
- result.SetDefaults();
- return result;
- }
- }
-
- public interface ITfsUserMappingEnricherOptions
- {
- List IdentityFieldsToCheck { get; set; }
- string UserMappingFile { get; set; }
- }
-}
\ No newline at end of file
diff --git a/src/MigrationTools.Clients.AzureDevops.ObjectModel/ProcessorEnrichers/TfsValidateRequiredFieldOptions.cs b/src/MigrationTools.Clients.AzureDevops.ObjectModel/ProcessorEnrichers/TfsValidateRequiredFieldOptions.cs
deleted file mode 100644
index 65d912904..000000000
--- a/src/MigrationTools.Clients.AzureDevops.ObjectModel/ProcessorEnrichers/TfsValidateRequiredFieldOptions.cs
+++ /dev/null
@@ -1,15 +0,0 @@
-using System;
-using MigrationTools.Enrichers;
-
-namespace MigrationTools.ProcessorEnrichers
-{
- public class TfsValidateRequiredFieldOptions : ProcessorEnricherOptions
- {
- public override Type ToConfigure => typeof(TfsValidateRequiredField);
-
- public override void SetDefaults()
- {
- Enabled = true;
- }
- }
-}
\ No newline at end of file
diff --git a/src/VstsSyncMigrator.Core/Execution/ProcessingContext/CreateTeamFolders.cs b/src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/CreateTeamFoldersProcessor.cs
similarity index 78%
rename from src/VstsSyncMigrator.Core/Execution/ProcessingContext/CreateTeamFolders.cs
rename to src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/CreateTeamFoldersProcessor.cs
index 7748450f2..792b81142 100644
--- a/src/VstsSyncMigrator.Core/Execution/ProcessingContext/CreateTeamFolders.cs
+++ b/src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/CreateTeamFoldersProcessor.cs
@@ -9,41 +9,38 @@
using MigrationTools;
using MigrationTools._EngineV1.Clients;
using MigrationTools._EngineV1.Configuration;
-using VstsSyncMigrator._EngineV1.Processors;
+using MigrationTools.Processors.Infrastructure;
+using MigrationTools.Tools;
+using MigrationTools.Processors.Infrastructure;
+using Microsoft.Extensions.Options;
+using MigrationTools.Enrichers;
-namespace VstsSyncMigrator.Engine
+
+namespace MigrationTools.Processors
{
///
/// Creates folders in Sared Queries for each Team
///
/// alpha
/// Shared Queries
- public class CreateTeamFolders : StaticProcessorBase
+ public class CreateTeamFolders : TfsProcessor
{
- public CreateTeamFolders(IServiceProvider services, IMigrationEngine me, ITelemetryLogger telemetry, ILogger logger)
- : base(services, me, telemetry, logger)
+ public CreateTeamFolders(IOptions options, TfsCommonTools tfsCommonTools, ProcessorEnricherContainer processorEnrichers, IServiceProvider services, ITelemetryLogger telemetry, ILogger logger) : base(options, tfsCommonTools, processorEnrichers, services, telemetry, logger)
{
}
- public override string Name
- {
- get
- {
- return "CreateTeamFolders";
- }
- }
+ new TfsTeamProjectEndpoint Source => (TfsTeamProjectEndpoint)base.Source;
+
+ new TfsTeamProjectEndpoint Target => (TfsTeamProjectEndpoint)base.Target;
- public override void Configure(IProcessorConfig config)
- {
- }
protected override void InternalExecute()
{
Stopwatch stopwatch = Stopwatch.StartNew();
//////////////////////////////////////////////////
- TfsTeamService teamService = Engine.Target.GetService();
- QueryHierarchy qh = ((TfsWorkItemMigrationClient)Engine.Target.WorkItems).Store.Projects[Engine.Target.Config.AsTeamProjectConfig().Project].QueryHierarchy;
- List teamList = teamService.QueryTeams(Engine.Target.Config.AsTeamProjectConfig().Project).ToList();
+ TfsTeamService teamService = Target.GetService();
+ QueryHierarchy qh = ((TfsWorkItemMigrationClient)Target.WorkItems).Store.Projects[Target.Options.Project].QueryHierarchy;
+ List teamList = teamService.QueryTeams(Target.Options.Project).ToList();
Log.LogInformation("Found {0} teams?", teamList.Count);
//////////////////////////////////////////////////
diff --git a/src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/EmptyProcessorOptions.cs b/src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/EmptyProcessorOptions.cs
new file mode 100644
index 000000000..4767c7b32
--- /dev/null
+++ b/src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/EmptyProcessorOptions.cs
@@ -0,0 +1,14 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+using MigrationTools.Processors.Infrastructure;
+
+namespace MigrationTools.Processors
+{
+ public class EmptyProcessorOptions : ProcessorOptions
+ {
+
+ }
+}
diff --git a/src/VstsSyncMigrator.Core/Execution/ProcessingContext/ExportProfilePictureFromADContext.cs b/src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/ExportProfilePictureFromADProcessor.cs
similarity index 78%
rename from src/VstsSyncMigrator.Core/Execution/ProcessingContext/ExportProfilePictureFromADContext.cs
rename to src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/ExportProfilePictureFromADProcessor.cs
index b01d2e742..705874c85 100644
--- a/src/VstsSyncMigrator.Core/Execution/ProcessingContext/ExportProfilePictureFromADContext.cs
+++ b/src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/ExportProfilePictureFromADProcessor.cs
@@ -12,38 +12,35 @@
using MigrationTools;
using MigrationTools._EngineV1.Configuration;
using MigrationTools._EngineV1.Configuration.Processing;
-using VstsSyncMigrator._EngineV1.Processors;
-namespace VstsSyncMigrator.Engine
+using Microsoft.Extensions.Options;
+using MigrationTools.Tools;
+using MigrationTools.Processors.Infrastructure;
+using MigrationTools._EngineV1.Clients;
+using MigrationTools.Enrichers;
+
+namespace MigrationTools.Processors
{
///
/// Downloads corporate images and updates TFS/Azure DevOps profiles
///
/// alpha
/// Profiles
- public class ExportProfilePictureFromADContext : StaticProcessorBase
+ public class ExportProfilePictureFromADProcessor : Processor
{
private IIdentityManagementService2 ims2;
- private ExportProfilePictureFromADConfig config;
- public override string Name
+ public ExportProfilePictureFromADProcessor(IOptions options, CommonTools commonTools, ProcessorEnricherContainer processorEnrichers, IServiceProvider services, ITelemetryLogger telemetry, ILogger logger) : base(options, commonTools, processorEnrichers, services, telemetry, logger)
{
- get
- {
- return "ExportProfilePictureFromADContext";
- }
+ //http://www.codeproject.com/Articles/18102/Howto-Almost-Everything-In-Active-Directory-via-C
+ ims2 = Target.GetService();
}
- public ExportProfilePictureFromADContext(IServiceProvider services, IMigrationEngine me, ITelemetryLogger telemetry, ILogger logger) : base(services, me, telemetry, logger)
- {
- }
+ new ExportProfilePictureFromADProcessorOptions Options => (ExportProfilePictureFromADProcessorOptions)base.Options;
- public override void Configure(IProcessorConfig config)
- {
- //http://www.codeproject.com/Articles/18102/Howto-Almost-Everything-In-Active-Directory-via-C
- ims2 = Engine.Target.GetService();
- this.config = (ExportProfilePictureFromADConfig)config;
- }
+ new TfsTeamProjectEndpoint Source => (TfsTeamProjectEndpoint)base.Source;
+
+ new TfsTeamProjectEndpoint Target => (TfsTeamProjectEndpoint)base.Target;
protected override void InternalExecute()
{
@@ -69,7 +66,7 @@ protected override void InternalExecute()
}
var folks = (from IdentityDescriptor id in SIDS.Members where id.IdentityType == "System.Security.Principal.WindowsIdentity" select id);
- DirectoryContext objContext = new DirectoryContext(DirectoryContextType.Domain, config.Domain, config.Username, config.Password);
+ DirectoryContext objContext = new DirectoryContext(DirectoryContextType.Domain, Options.Domain, Options.Username, Options.Password);
Domain objDomain = Domain.GetDomain(objContext);
string ldapName = string.Format("LDAP://{0}", objDomain.Name);
@@ -81,7 +78,7 @@ protected override void InternalExecute()
TeamFoundationIdentity i = ims2.ReadIdentity(IdentitySearchFactor.Identifier, id.Identifier, MembershipQuery.Direct, ReadIdentityOptions.None);
if (!(i == null) && i.IsContainer == false)
{
- DirectoryEntry d = new DirectoryEntry(ldapName, config.Username, config.Password);
+ DirectoryEntry d = new DirectoryEntry(ldapName, Options.Username, Options.Password);
DirectorySearcher dssearch = new DirectorySearcher(d)
{
Filter = string.Format("(sAMAccountName={0})", i.UniqueName.Split(char.Parse(@"\"))[1])
@@ -96,9 +93,9 @@ protected override void InternalExecute()
string newImage = Path.Combine(exportPath, string.Format("{0}.jpg", i.UniqueName.Replace(@"\", "-")));
if (!File.Exists(newImage))
{
- DirectoryEntry deUser = new DirectoryEntry(sresult.Path, config.Username, config.Password);
+ DirectoryEntry deUser = new DirectoryEntry(sresult.Path, Options.Username, Options.Password);
Log.LogInformation("{0} [PROCESS] {1}: {2}", current, deUser.Name, newImage);
- string empPic = string.Format(config.PictureEmpIDFormat, deUser.Properties["employeeNumber"].Value);
+ string empPic = string.Format(Options.PictureEmpIDFormat, deUser.Properties["employeeNumber"].Value);
try
{
webClient.DownloadFile(empPic, newImage);
diff --git a/src/MigrationTools/_EngineV1/Configuration/Processing/ExportProfilePictureFromADConfig.cs b/src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/ExportProfilePictureFromADProcessorOptions.cs
similarity index 64%
rename from src/MigrationTools/_EngineV1/Configuration/Processing/ExportProfilePictureFromADConfig.cs
rename to src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/ExportProfilePictureFromADProcessorOptions.cs
index d57bf33df..448ae05f2 100644
--- a/src/MigrationTools/_EngineV1/Configuration/Processing/ExportProfilePictureFromADConfig.cs
+++ b/src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/ExportProfilePictureFromADProcessorOptions.cs
@@ -1,9 +1,14 @@
using System.Collections.Generic;
+using MigrationTools._EngineV1.Configuration;
+using MigrationTools.Enrichers;
+using MigrationTools.Processors.Infrastructure;
-namespace MigrationTools._EngineV1.Configuration.Processing
+namespace MigrationTools.Processors
{
- public class ExportProfilePictureFromADConfig : IProcessorConfig
+ public class ExportProfilePictureFromADProcessorOptions : ProcessorOptions
{
+
+
///
/// The source domain where the pictures should be exported.
///
@@ -28,19 +33,5 @@ public class ExportProfilePictureFromADConfig : IProcessorConfig
/// String.Empty
public string PictureEmpIDFormat { get; set; }
- ///
- public bool Enabled { get; set; }
-
- ///
- public string Processor
- {
- get { return "ExportProfilePictureFromADContext"; }
- }
-
- ///
- public bool IsProcessorCompatible(IReadOnlyList otherProcessors)
- {
- return true;
- }
}
}
\ No newline at end of file
diff --git a/src/VstsSyncMigrator.Core/Execution/ProcessingContext/ExportTeamList.cs b/src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/ExportTeamListProcessor.cs
similarity index 62%
rename from src/VstsSyncMigrator.Core/Execution/ProcessingContext/ExportTeamList.cs
rename to src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/ExportTeamListProcessor.cs
index 7f435e331..cf5e5635a 100644
--- a/src/VstsSyncMigrator.Core/Execution/ProcessingContext/ExportTeamList.cs
+++ b/src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/ExportTeamListProcessor.cs
@@ -2,43 +2,42 @@
using System.Diagnostics;
using System.Linq;
using Microsoft.Extensions.Logging;
+using Microsoft.Extensions.Options;
using Microsoft.TeamFoundation.Client;
using Microsoft.TeamFoundation.Framework.Common;
using Microsoft.TeamFoundation.Server;
using MigrationTools;
+using MigrationTools._EngineV1.Clients;
using MigrationTools._EngineV1.Configuration;
-using VstsSyncMigrator._EngineV1.Processors;
+using MigrationTools.Enrichers;
+using MigrationTools.Processors.Infrastructure;
+using MigrationTools.Tools;
-namespace VstsSyncMigrator.Engine
+
+
+namespace MigrationTools.Processors
{
- public class ExportTeamList : StaticProcessorBase
+ public class ExportTeamListProcessor : TfsProcessor
{
- public ExportTeamList(IServiceProvider services, IMigrationEngine me, ITelemetryLogger telemetry, ILogger logger) : base(services, me, telemetry, logger)
+ public ExportTeamListProcessor(IOptions options, TfsCommonTools tfsCommonTools, ProcessorEnricherContainer processorEnrichers, IServiceProvider services, ITelemetryLogger telemetry, ILogger logger) : base(options, tfsCommonTools, processorEnrichers, services, telemetry, logger)
{
}
- public override string Name
- {
- get
- {
- return "ExportTeamList";
- }
- }
+ new TfsTeamProjectEndpoint Source => (TfsTeamProjectEndpoint)base.Source;
+
+ new TfsTeamProjectEndpoint Target => (TfsTeamProjectEndpoint)base.Target;
- public override void Configure(IProcessorConfig config)
- {
- }
protected override void InternalExecute()
{
Stopwatch stopwatch = Stopwatch.StartNew();
//////////////////////////////////////////////////
// Retrieve the project URI. Needed to enumerate teams.
- var css4 = Engine.Target.GetService();
- ProjectInfo projectInfo = css4.GetProjectFromName(Engine.Target.Config.AsTeamProjectConfig().Project);
+ var css4 = Target.GetService();
+ ProjectInfo projectInfo = css4.GetProjectFromName(Target.Options.Project);
// Retrieve a list of all teams on the project.
- TfsTeamService teamService = Engine.Target.GetService();
- TfsConnection connection = (TfsConnection)Engine.Target.InternalCollection;
+ TfsTeamService teamService = Target.GetService();
+ TfsConnection connection = (TfsConnection)Target.InternalCollection;
foreach (ProjectInfo p in css4.ListAllProjects())
{
diff --git a/src/VstsSyncMigrator.Core/Execution/MigrationContext/ExportUsersForMapping.cs b/src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/ExportUsersForMappingProcessor.cs
similarity index 50%
rename from src/VstsSyncMigrator.Core/Execution/MigrationContext/ExportUsersForMapping.cs
rename to src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/ExportUsersForMappingProcessor.cs
index acdb6043c..896a95774 100644
--- a/src/VstsSyncMigrator.Core/Execution/MigrationContext/ExportUsersForMapping.cs
+++ b/src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/ExportUsersForMappingProcessor.cs
@@ -6,19 +6,20 @@
using Microsoft.Extensions.Logging;
using Microsoft.Extensions.Options;
using MigrationTools;
+using MigrationTools._EngineV1.Clients;
using MigrationTools._EngineV1.Configuration;
using MigrationTools._EngineV1.Configuration.Processing;
-using MigrationTools._EngineV1.Processors;
+
using MigrationTools.DataContracts;
using MigrationTools.DataContracts.Process;
using MigrationTools.EndpointEnrichers;
using MigrationTools.Enrichers;
-using MigrationTools.ProcessorEnrichers;
-using MigrationTools.ProcessorEnrichers.WorkItemProcessorEnrichers;
+using MigrationTools.Processors.Infrastructure;
+using MigrationTools.Tools;
using Newtonsoft.Json;
-using VstsSyncMigrator._EngineV1.Processors;
-namespace VstsSyncMigrator.Core.Execution.MigrationContext
+
+namespace MigrationTools.Processors
{
///
/// ExportUsersForMappingContext is a tool used to create a starter mapping file for users between the source and target systems.
@@ -26,83 +27,52 @@ namespace VstsSyncMigrator.Core.Execution.MigrationContext
///
/// ready
/// Work Items
- public class ExportUsersForMappingContext : MigrationProcessorBase
+ public class ExportUsersForMappingProcessor : TfsProcessor
{
- private ExportUsersForMappingConfig _config;
- private TfsUserMappingEnricher _TfsUserMappingEnricher;
-
-
-
- public override string Name
+ public ExportUsersForMappingProcessor(IOptions options, TfsCommonTools tfsCommonTools, ProcessorEnricherContainer processorEnrichers, IServiceProvider services, ITelemetryLogger telemetry, ILogger logger) : base(options, tfsCommonTools, processorEnrichers, services, telemetry, logger)
{
- get
- {
- return "ExportUsersForMappingContext";
- }
}
- public ILogger Logger { get; }
- private EngineConfiguration _engineConfig;
+ new ExportUsersForMappingProcessorOptions Options => (ExportUsersForMappingProcessorOptions)base.Options;
- public ExportUsersForMappingContext(IMigrationEngine engine, IServiceProvider services, ITelemetryLogger telemetry, ILogger logger, IOptions engineConfig, TfsUserMappingEnricher userMappingEnricher) : base(engine, services, telemetry, logger)
- {
- Logger = logger;
- _engineConfig = engineConfig.Value;
- _TfsUserMappingEnricher = userMappingEnricher;
- }
+ new TfsTeamProjectEndpoint Source => (TfsTeamProjectEndpoint)base.Source;
- public override void Configure(IProcessorConfig config)
- {
- _config = (ExportUsersForMappingConfig)config;
- ImportCommonEnricherConfigs();
-
- }
-
- private void ImportCommonEnricherConfigs()
- {
- /// setup _engineConfig.CommonEnrichersConfig
- if (_engineConfig.CommonEnrichersConfig == null)
- {
- Log.LogError("CommonEnrichersConfig cant be Null! it must be a minimum of `[]`");
- Environment.Exit(-1);
- }
- PullCommonEnrichersConfig(_engineConfig.CommonEnrichersConfig, _TfsUserMappingEnricher);
- }
+ new TfsTeamProjectEndpoint Target => (TfsTeamProjectEndpoint)base.Target;
protected override void InternalExecute()
{
Stopwatch stopwatch = Stopwatch.StartNew();
- if(string.IsNullOrEmpty(_TfsUserMappingEnricher.Options.UserMappingFile))
+ if(string.IsNullOrEmpty(CommonTools.UserMapping.Options.UserMappingFile))
{
Log.LogError("UserMappingFile is not set");
- throw new ArgumentNullException("UserMappingFile must be set on the TfsUserMappingEnricherOptions in CommonEnrichersConfig.");
+ throw new ArgumentNullException("UserMappingFile must be set on the TfsUserMappingToolOptions in CommonEnrichersConfig.");
}
List usersToMap = new List();
- if (_config.OnlyListUsersInWorkItems)
+ if (Options.OnlyListUsersInWorkItems)
{
Log.LogInformation("OnlyListUsersInWorkItems is true, only users in work items will be listed");
- List sourceWorkItems = Engine.Source.WorkItems.GetWorkItems(_config.WIQLQuery);
+ List sourceWorkItems = Source.WorkItems.GetWorkItems(Options.WIQLQuery);
Log.LogInformation("Processed {0} work items from Source", sourceWorkItems.Count);
- usersToMap = _TfsUserMappingEnricher.GetUsersInSourceMappedToTargetForWorkItems(sourceWorkItems);
+ usersToMap = CommonTools.UserMapping.GetUsersInSourceMappedToTargetForWorkItems(this, sourceWorkItems);
Log.LogInformation("Found {usersToMap} total mapped", usersToMap.Count);
}
else
{
Log.LogInformation("OnlyListUsersInWorkItems is false, all users will be listed");
- usersToMap = _TfsUserMappingEnricher.GetUsersInSourceMappedToTarget();
+ usersToMap = CommonTools.UserMapping.GetUsersInSourceMappedToTarget(this);
Log.LogInformation("Found {usersToMap} total mapped", usersToMap.Count);
}
usersToMap = usersToMap.Where(x => x.Source.FriendlyName != x.target?.FriendlyName).ToList();
Log.LogInformation("Filtered to {usersToMap} total viable mappings", usersToMap.Count);
Dictionary usermappings = usersToMap.ToDictionary(x => x.Source.FriendlyName, x => x.target?.FriendlyName);
- System.IO.File.WriteAllText(_TfsUserMappingEnricher.Options.UserMappingFile, Newtonsoft.Json.JsonConvert.SerializeObject(usermappings, Formatting.Indented));
- Log.LogInformation("Writen to: {LocalExportJsonFile}", _TfsUserMappingEnricher.Options.UserMappingFile);
+ System.IO.File.WriteAllText(CommonTools.UserMapping.Options.UserMappingFile, Newtonsoft.Json.JsonConvert.SerializeObject(usermappings, Formatting.Indented));
+ Log.LogInformation("Writen to: {LocalExportJsonFile}", CommonTools.UserMapping.Options.UserMappingFile);
//////////////////////////////////////////////////
stopwatch.Stop();
Log.LogInformation("DONE in {Elapsed} seconds");
diff --git a/src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/ExportUsersForMappingProcessorOptions.cs b/src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/ExportUsersForMappingProcessorOptions.cs
new file mode 100644
index 000000000..940921e4b
--- /dev/null
+++ b/src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/ExportUsersForMappingProcessorOptions.cs
@@ -0,0 +1,19 @@
+using System.Collections.Generic;
+using MigrationTools._EngineV1.Configuration;
+using MigrationTools.Enrichers;
+using MigrationTools.Processors.Infrastructure;
+
+namespace MigrationTools.Processors
+{
+ public class ExportUsersForMappingProcessorOptions : ProcessorOptions
+ {
+
+ public string WIQLQuery { get; set; }
+
+ /// `OnlyListUsersInWorkItems`
+ ///
+ /// true
+ public bool OnlyListUsersInWorkItems { get; set; } = true;
+
+ }
+}
\ No newline at end of file
diff --git a/src/VstsSyncMigrator.Core/Execution/MigrationContext/FakeProcessor.cs b/src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/FakeProcessor.cs
similarity index 58%
rename from src/VstsSyncMigrator.Core/Execution/MigrationContext/FakeProcessor.cs
rename to src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/FakeProcessor.cs
index f2f7115ee..ea54d21ec 100644
--- a/src/VstsSyncMigrator.Core/Execution/MigrationContext/FakeProcessor.cs
+++ b/src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/FakeProcessor.cs
@@ -4,32 +4,28 @@
using Microsoft.Extensions.Logging;
using MigrationTools;
using MigrationTools._EngineV1.Configuration;
-using MigrationTools._EngineV1.Processors;
+using MigrationTools.Processors.Infrastructure;
using MigrationTools.DataContracts;
+using MigrationTools.Tools;
+using Microsoft.Extensions.Options;
+using MigrationTools.Enrichers;
+using MigrationTools._EngineV1.Clients;
-namespace VstsSyncMigrator.Engine
+namespace MigrationTools.Processors
{
///
/// Note: this is only for internal usage. Don't use this in your configurations.
///
- public class FakeProcessor : MigrationProcessorBase
+ public class FakeProcessor : TfsProcessor
{
- public FakeProcessor(IMigrationEngine engine, IServiceProvider services, ITelemetryLogger telemetry, ILogger logger) : base(engine, services, telemetry, logger)
+ public FakeProcessor(IOptions options, TfsCommonTools tfsCommonTools, ProcessorEnricherContainer processorEnrichers, IServiceProvider services, ITelemetryLogger telemetry, ILogger logger) : base(options, tfsCommonTools, processorEnrichers, services, telemetry, logger)
{
}
- public override string Name
- {
- get
- {
- return "FakeProcessor";
- }
- }
- public override void Configure(IProcessorConfig config)
- {
- // FakeProcessorConfig config
- }
+ new TfsTeamProjectEndpoint Source => (TfsTeamProjectEndpoint)base.Source;
+
+ new TfsTeamProjectEndpoint Target => (TfsTeamProjectEndpoint)base.Target;
protected override void InternalExecute()
{
@@ -37,7 +33,7 @@ protected override void InternalExecute()
//////////////////////////////////////////////////
var query = @"SELECT [System.Id] FROM WorkItems WHERE [System.TeamProject] = @TeamProject ";// AND [System.Id] = 188708 ";
- List sourceWIS = Engine.Source.WorkItems.GetWorkItems(query);
+ List sourceWIS = Source.WorkItems.GetWorkItems(query);
Log.LogDebug("Migrate {0} work items?", sourceWIS.Count);
//////////////////////////////////////////////////
diff --git a/src/VstsSyncMigrator.Core/Execution/ProcessingContext/ImportProfilePictureContext.cs b/src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/ImportProfilePictureProcessor.cs
similarity index 88%
rename from src/VstsSyncMigrator.Core/Execution/ProcessingContext/ImportProfilePictureContext.cs
rename to src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/ImportProfilePictureProcessor.cs
index bcd83047e..167412e98 100644
--- a/src/VstsSyncMigrator.Core/Execution/ProcessingContext/ImportProfilePictureContext.cs
+++ b/src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/ImportProfilePictureProcessor.cs
@@ -7,36 +7,39 @@
using System.IO;
using System.Text.RegularExpressions;
using Microsoft.Extensions.Logging;
+using Microsoft.Extensions.Options;
using Microsoft.TeamFoundation.Framework.Client;
using Microsoft.TeamFoundation.Framework.Common;
using MigrationTools;
+using MigrationTools._EngineV1.Clients;
using MigrationTools._EngineV1.Configuration;
-using VstsSyncMigrator._EngineV1.Processors;
+using MigrationTools.Enrichers;
+using MigrationTools.Processors.Infrastructure;
+using MigrationTools.Tools;
-namespace VstsSyncMigrator.Engine
+
+namespace MigrationTools.Processors
{
///
/// Downloads corporate images and updates TFS/Azure DevOps profiles
///
/// alpha
/// Profiles
- public class ImportProfilePictureContext : StaticProcessorBase
+ public class ImportProfilePictureProcessor : TfsProcessor
{
private readonly IIdentityManagementService2 ims2;
- public ImportProfilePictureContext(IServiceProvider services, IMigrationEngine me, ITelemetryLogger telemetry, ILogger logger) : base(services, me, telemetry, logger)
+ public ImportProfilePictureProcessor(IOptions options, TfsCommonTools tfsCommonTools, ProcessorEnricherContainer processorEnrichers, IServiceProvider services, ITelemetryLogger telemetry, ILogger logger) : base(options, tfsCommonTools, processorEnrichers, services, telemetry, logger)
{
//http://www.codeproject.com/Articles/18102/Howto-Almost-Everything-In-Active-Directory-via-C
- ims2 = (IIdentityManagementService2)me.Target.GetService();
+ ims2 = (IIdentityManagementService2)Target.GetService();
}
- public override string Name
- {
- get
- {
- return "ImportProfilePictureContext";
- }
- }
+ new ImportProfilePictureProcessorOptions Options => (ImportProfilePictureProcessorOptions)base.Options;
+
+ new TfsTeamProjectEndpoint Source => (TfsTeamProjectEndpoint)base.Source;
+
+ new TfsTeamProjectEndpoint Target => (TfsTeamProjectEndpoint)base.Target;
public static string FriendlyDomainToLdapDomain(string friendlyDomainName)
{
@@ -91,10 +94,6 @@ public bool ClearProfileImage(string identity, out string message)
return ret;
}
- public override void Configure(IProcessorConfig config)
- {
- }
-
[System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Design", "CA1031:DoNotCatchGeneralExceptionTypes", Justification = "Need to kill all errors")]
public bool SetProfileImage(string identity, string imagePath, out string message)
{
diff --git a/src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/ImportProfilePictureProcessorOptions.cs b/src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/ImportProfilePictureProcessorOptions.cs
new file mode 100644
index 000000000..593111ac3
--- /dev/null
+++ b/src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/ImportProfilePictureProcessorOptions.cs
@@ -0,0 +1,12 @@
+using System.Collections.Generic;
+using MigrationTools._EngineV1.Configuration;
+using MigrationTools.Enrichers;
+using MigrationTools.Processors.Infrastructure;
+
+namespace MigrationTools.Processors
+{
+ public class ImportProfilePictureProcessorOptions : ProcessorOptions
+ {
+
+ }
+}
\ No newline at end of file
diff --git a/src/VstsSyncMigrator.Core/Execution/MigrationContext/ConfigException.cs b/src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/Infra/ConfigException.cs
similarity index 91%
rename from src/VstsSyncMigrator.Core/Execution/MigrationContext/ConfigException.cs
rename to src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/Infra/ConfigException.cs
index 299bfb305..ed9473e9e 100644
--- a/src/VstsSyncMigrator.Core/Execution/MigrationContext/ConfigException.cs
+++ b/src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/Infra/ConfigException.cs
@@ -1,7 +1,7 @@
using System;
using System.Runtime.Serialization;
-namespace VstsSyncMigrator.Engine
+namespace MigrationTools.Processors.Infrastructure
{
[Serializable]
internal class ConfigException : Exception
diff --git a/src/VstsSyncMigrator.Core/Execution/ComponentContext/TestManagementContext.cs b/src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/Infra/TestManagementContext.cs
similarity index 80%
rename from src/VstsSyncMigrator.Core/Execution/ComponentContext/TestManagementContext.cs
rename to src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/Infra/TestManagementContext.cs
index 10f16d226..16014189b 100644
--- a/src/VstsSyncMigrator.Core/Execution/ComponentContext/TestManagementContext.cs
+++ b/src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/Infra/TestManagementContext.cs
@@ -4,7 +4,7 @@
using MigrationTools;
using MigrationTools._EngineV1.Clients;
-namespace VstsSyncMigrator.Engine.ComponentContext
+namespace MigrationTools.Processors.Infrastructure
{
public class TestManagementContext
{
@@ -14,16 +14,16 @@ public class TestManagementContext
internal ITestManagementTeamProject Project { get; }
- public TestManagementContext(IMigrationClient source) : this(source, null)
+ public TestManagementContext(TfsTeamProjectEndpoint source) : this(source, null)
{
}
- public TestManagementContext(IMigrationClient source, string testPlanQuery)
+ public TestManagementContext(TfsTeamProjectEndpoint source, string testPlanQuery)
{
this.testPlanQuery = testPlanQuery;
_source = source;
tms = _source.GetService();
- Project = tms.GetTeamProject(source.Config.AsTeamProjectConfig().Project);
+ Project = tms.GetTeamProject(source.Options.Project);
}
internal List GetTestPlans()
diff --git a/src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/Infra/TfsProcessor.cs b/src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/Infra/TfsProcessor.cs
new file mode 100644
index 000000000..e3caaa14a
--- /dev/null
+++ b/src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/Infra/TfsProcessor.cs
@@ -0,0 +1,29 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+using Microsoft.Extensions.Logging;
+using Microsoft.Extensions.Options;
+using MigrationTools;
+using MigrationTools._EngineV1.Clients;
+using MigrationTools.Enrichers;
+using MigrationTools.Tools;
+
+namespace MigrationTools.Processors.Infrastructure
+{
+ public abstract class TfsProcessor : Processor
+ {
+ protected TfsProcessor(IOptions options, TfsCommonTools tfsCommonTools, ProcessorEnricherContainer processorEnrichers, IServiceProvider services, ITelemetryLogger telemetry, ILogger logger) : base(options, tfsCommonTools, processorEnrichers, services, telemetry, logger)
+ {
+
+ }
+
+ new public TfsTeamProjectEndpoint Source => (TfsTeamProjectEndpoint)base.Source;
+
+ new public TfsTeamProjectEndpoint Target => (TfsTeamProjectEndpoint)base.Target;
+
+ new public TfsCommonTools CommonTools => (TfsCommonTools)base.CommonTools;
+
+ }
+}
diff --git a/src/VstsSyncMigrator.Core/Execution/MigrationContext/TestConfigurationsMigrationContext.cs b/src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/TestConfigurationsMigrationProcessor.cs
similarity index 73%
rename from src/VstsSyncMigrator.Core/Execution/MigrationContext/TestConfigurationsMigrationContext.cs
rename to src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/TestConfigurationsMigrationProcessor.cs
index 2fa751f91..9438c051b 100644
--- a/src/VstsSyncMigrator.Core/Execution/MigrationContext/TestConfigurationsMigrationContext.cs
+++ b/src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/TestConfigurationsMigrationProcessor.cs
@@ -1,43 +1,42 @@
using System;
using System.Linq;
using Microsoft.Extensions.Logging;
+using Microsoft.Extensions.Options;
using Microsoft.TeamFoundation.TestManagement.Client;
using MigrationTools;
+using MigrationTools._EngineV1.Clients;
using MigrationTools._EngineV1.Configuration;
-using MigrationTools._EngineV1.Processors;
-using VstsSyncMigrator.Engine.ComponentContext;
+using MigrationTools.Enrichers;
+using MigrationTools.Processors.Infrastructure;
+using MigrationTools.Tools;
-namespace VstsSyncMigrator.Engine
+namespace MigrationTools.Processors
{
///
/// This processor can migrate `test configuration`. This should be run before `LinkMigrationConfig`.
///
/// Beta
/// Suites & Plans
- public class TestConfigurationsMigrationContext : MigrationProcessorBase
+ public class TestConfigurationsMigrationProcessor : TfsProcessor
{
- // http://blogs.microsoft.co.il/shair/2015/02/02/tfs-api-part-56-test-configurations/
-
- public TestConfigurationsMigrationContext(IMigrationEngine engine, IServiceProvider services, ITelemetryLogger telemetry, ILogger logger) : base(engine, services, telemetry, logger)
+ public TestConfigurationsMigrationProcessor(IOptions options, TfsCommonTools tfsCommonTools, ProcessorEnricherContainer processorEnrichers, IServiceProvider services, ITelemetryLogger telemetry, ILogger logger) : base(options, tfsCommonTools, processorEnrichers, services, telemetry, logger)
{
}
- public override string Name
- {
- get
- {
- return "TestConfigurationsMigrationContext";
- }
- }
- public override void Configure(IProcessorConfig config)
- {
- }
+ // http://blogs.microsoft.co.il/shair/2015/02/02/tfs-api-part-56-test-configurations/
+
+ new TestConfigurationsMigrationProcessorOptions Options => (TestConfigurationsMigrationProcessorOptions)base.Options;
+
+ new TfsTeamProjectEndpoint Source => (TfsTeamProjectEndpoint)base.Source;
+
+ new TfsTeamProjectEndpoint Target => (TfsTeamProjectEndpoint)base.Target;
+
protected override void InternalExecute()
{
- TestManagementContext SourceTmc = new TestManagementContext(Engine.Source);
- TestManagementContext targetTmc = new TestManagementContext(Engine.Target);
+ TestManagementContext SourceTmc = new TestManagementContext(Source);
+ TestManagementContext targetTmc = new TestManagementContext(Target);
ITestConfigurationCollection tc = SourceTmc.Project.TestConfigurations.Query("Select * From TestConfiguration");
Log.LogDebug("Plan to copy {TestCaseCount} Configurations", tc.Count);
@@ -55,7 +54,7 @@ protected override void InternalExecute()
{
Log.LogDebug("{sourceTestConfName} - Create new", sourceTestConf.Name);
targetTc = targetTmc.Project.TestConfigurations.Create();
- targetTc.AreaPath = sourceTestConf.AreaPath.Replace(Engine.Source.Config.AsTeamProjectConfig().Project, Engine.Target.Config.AsTeamProjectConfig().Project);
+ targetTc.AreaPath = sourceTestConf.AreaPath.Replace(Source.Options.Project, Target.Options.Project);
targetTc.Description = sourceTestConf.Description;
targetTc.IsDefault = sourceTestConf.IsDefault;
targetTc.Name = sourceTestConf.Name;
diff --git a/src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/TestConfigurationsMigrationProcessorOptions.cs b/src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/TestConfigurationsMigrationProcessorOptions.cs
new file mode 100644
index 000000000..72a620eea
--- /dev/null
+++ b/src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/TestConfigurationsMigrationProcessorOptions.cs
@@ -0,0 +1,12 @@
+using System.Collections.Generic;
+using MigrationTools.Processors.Infrastructure;
+using MigrationTools.Enrichers;
+using MigrationTools.Processors;
+
+namespace MigrationTools.Processors
+{
+ public class TestConfigurationsMigrationProcessorOptions : ProcessorOptions
+ {
+
+ }
+}
\ No newline at end of file
diff --git a/src/VstsSyncMigrator.Core/Execution/MigrationContext/TestPlansAndSuitesMigrationContext.cs b/src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/TestPlansAndSuitesMigrationProcessor.cs
similarity index 88%
rename from src/VstsSyncMigrator.Core/Execution/MigrationContext/TestPlansAndSuitesMigrationContext.cs
rename to src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/TestPlansAndSuitesMigrationProcessor.cs
index b733f11d4..f07af6cf2 100644
--- a/src/VstsSyncMigrator.Core/Execution/MigrationContext/TestPlansAndSuitesMigrationContext.cs
+++ b/src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/TestPlansAndSuitesMigrationProcessor.cs
@@ -7,7 +7,6 @@
using System.Xml.Linq;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Logging;
-using Microsoft.Extensions.Options;
using Microsoft.TeamFoundation.Framework.Client;
using Microsoft.TeamFoundation.Framework.Common;
using Microsoft.TeamFoundation.TestManagement.Client;
@@ -20,25 +19,26 @@
using MigrationTools._EngineV1.Clients;
using MigrationTools._EngineV1.Configuration;
using MigrationTools._EngineV1.Configuration.Processing;
-using MigrationTools._EngineV1.Processors;
+
using MigrationTools.DataContracts;
using MigrationTools.DataContracts.Pipelines;
-using MigrationTools.Enrichers;
-using VstsSyncMigrator.Engine.ComponentContext;
using Environment = System.Environment;
+using Microsoft.Extensions.Options;
+using MigrationTools.Tools;
+using MigrationTools.Processors.Infrastructure;
+using MigrationTools.Enrichers;
-namespace VstsSyncMigrator.Engine
+namespace MigrationTools.Processors
{
///
/// Rebuilds Suits and plans for Test Cases migrated using the WorkItemMigration
///
/// Beta
/// Suites & Plans
- public class TestPlansAndSuitesMigrationContext : MigrationProcessorBase
+ public class TestPlansAndSuitesMigrationProcessor : TfsProcessor
{
private int __currentSuite = 0;
private int __totalSuites = 0;
- private TestPlansAndSuitesMigrationConfig _config;
private int _currentPlan = 0;
private int _currentTestCases = 0;
private IIdentityManagementService _sourceIdentityManagementService;
@@ -49,49 +49,31 @@ public class TestPlansAndSuitesMigrationContext : MigrationProcessorBase
private TestManagementContext _targetTestStore;
private int _totalPlans = 0;
private int _totalTestCases = 0;
- private TfsNodeStructure _nodeStructureEnricher;
- private readonly EngineConfiguration _engineConfig;
-
- public TestPlansAndSuitesMigrationContext(IMigrationEngine engine,
- IServiceProvider services,
- ITelemetryLogger telemetry,
- ILogger logger,
- TfsNodeStructure nodeStructureEnricher,
- IOptions engineConfig)
- : base(engine, services, telemetry, logger)
- {
- _engineConfig = engineConfig.Value;
- _nodeStructureEnricher = nodeStructureEnricher;
- }
- public override string Name
+ public TestPlansAndSuitesMigrationProcessor(IOptions options, TfsCommonTools tfsCommonTools, ProcessorEnricherContainer processorEnrichers, IServiceProvider services, ITelemetryLogger telemetry, ILogger logger) : base(options, tfsCommonTools, processorEnrichers, services, telemetry, logger)
{
- get
- {
- return "TestPlansAndSuitesMigrationContext";
- }
}
- public override void Configure(IProcessorConfig config)
- {
- _config = (TestPlansAndSuitesMigrationConfig)config;
+ new TestPlansAndSuitesMigrationProcessorOptions Options => (TestPlansAndSuitesMigrationProcessorOptions)base.Options;
+
+ new TfsTeamProjectEndpoint Source => (TfsTeamProjectEndpoint)base.Source;
+
+ new TfsTeamProjectEndpoint Target => (TfsTeamProjectEndpoint)base.Target;
+
- PullCommonEnrichersConfig(_engineConfig.CommonEnrichersConfig, _nodeStructureEnricher);
-
- }
protected override void InternalExecute()
{
- _sourceTestStore = new TestManagementContext(Engine.Source, _config.TestPlanQuery);
- _targetTestStore = new TestManagementContext(Engine.Target);
+ _sourceTestStore = new TestManagementContext(Source, Options.TestPlanQuery);
+ _targetTestStore = new TestManagementContext(Target);
_sourceTestConfigs = _sourceTestStore.Project.TestConfigurations.Query("Select * From TestConfiguration");
_targetTestConfigs = _targetTestStore.Project.TestConfigurations.Query("Select * From TestConfiguration");
- _sourceIdentityManagementService = Engine.Source.GetService();
- _targetIdentityManagementService = Engine.Target.GetService();
+ _sourceIdentityManagementService = Source.GetService();
+ _targetIdentityManagementService = Target.GetService();
- _nodeStructureEnricher.ProcessorExecutionBegin(null);
+ CommonTools.NodeStructure.ProcessorExecutionBegin(this);
- bool filterByCompleted = _config.FilterCompleted;
+ bool filterByCompleted = Options.FilterCompleted;
var stopwatch = Stopwatch.StartNew();
var starttime = DateTime.Now;
@@ -117,7 +99,7 @@ protected override void InternalExecute()
if (CanSkipElementBecauseOfTags(sourcePlan.Id))
{
- Log.LogInformation("TestPlansAndSuitesMigrationContext: Skipping Test Plan {Id}:'{Name}' as is not tagged with '{Tag}'.", sourcePlan.Id, sourcePlan.Name, _config.OnlyElementsWithTag);
+ Log.LogInformation("TestPlansAndSuitesMigrationContext: Skipping Test Plan {Id}:'{Name}' as is not tagged with '{Tag}'.", sourcePlan.Id, sourcePlan.Name, Options.OnlyElementsWithTag);
continue;
}
ProcessTestPlan(sourcePlan);
@@ -144,7 +126,7 @@ private void AddChildTestCases(ITestSuiteBase source, ITestSuiteBase target, ITe
if (CanSkipElementBecauseOfTags(source.Id))
{
- Log.LogInformation("TestPlansAndSuitesMigrationContext::AddChildTestCases: Skipping Test Case {Id}:'{Name}' as is not tagged with '{Tag}'.", source.Id, source.Title, _config.OnlyElementsWithTag);
+ Log.LogInformation("TestPlansAndSuitesMigrationContext::AddChildTestCases: Skipping Test Case {Id}:'{Name}' as is not tagged with '{Tag}'.", source.Id, source.Title, Options.OnlyElementsWithTag);
return;
}
@@ -161,12 +143,12 @@ private void AddChildTestCases(ITestSuiteBase source, ITestSuiteBase target, ITe
if (CanSkipElementBecauseOfTags(sourceTestCaseEntry.Id))
{
- Log.LogInformation("TestPlansAndSuitesMigrationContext::AddChildTestCases: Skipping Test Suite {Id}:'{Name}' as is not tagged with '{Tag}'.", sourceTestCaseEntry.Id, sourceTestCaseEntry.Title, _config.OnlyElementsWithTag);
+ Log.LogInformation("TestPlansAndSuitesMigrationContext::AddChildTestCases: Skipping Test Suite {Id}:'{Name}' as is not tagged with '{Tag}'.", sourceTestCaseEntry.Id, sourceTestCaseEntry.Title, Options.OnlyElementsWithTag);
continue;
}
InnerLog(source, string.Format(" Processing {0} : {1} - {2} ", sourceTestCaseEntry.EntryType.ToString(), sourceTestCaseEntry.Id, sourceTestCaseEntry.Title), 15);
- WorkItemData wi = Engine.Target.WorkItems.FindReflectedWorkItem(sourceTestCaseEntry.TestCase.WorkItem.AsWorkItemData(), false);
+ WorkItemData wi = Target.WorkItems.FindReflectedWorkItem(sourceTestCaseEntry.TestCase.WorkItem.AsWorkItemData(), false);
if (wi == null)
{
InnerLog(source, string.Format(" Can't find work item for Test Case. Has it been migrated? {0} : {1} - {2} ", sourceTestCaseEntry.EntryType.ToString(), sourceTestCaseEntry.Id, sourceTestCaseEntry.Title), 15);
@@ -253,7 +235,7 @@ private void ApplyConfigurationsAndAssignTesters(ITestSuiteBase sourceSuite, ITe
var stopwatch = Stopwatch.StartNew();
var starttime = DateTime.Now;
_currentTestCases++;
- WorkItemData wi = Engine.Target.WorkItems.FindReflectedWorkItem(sourceTce.TestCase.WorkItem.AsWorkItemData(), false);
+ WorkItemData wi = Target.WorkItems.FindReflectedWorkItem(sourceTce.TestCase.WorkItem.AsWorkItemData(), false);
ITestSuiteEntry targetTce;
if (wi != null)
{
@@ -290,8 +272,8 @@ where tc.TestCase.WorkItem.Id.ToString() == wi.Id
|| e.EntryType == TestSuiteEntryType.StaticTestSuite))
{
//Find migrated suite in target
- WorkItemData sourceSuiteWi = Engine.Source.WorkItems.GetWorkItem(sourceSuiteChild.Id.ToString());
- WorkItemData targetSuiteWi = Engine.Target.WorkItems.FindReflectedWorkItem(sourceSuiteWi, false);
+ WorkItemData sourceSuiteWi = Source.WorkItems.GetWorkItem(sourceSuiteChild.Id.ToString());
+ WorkItemData targetSuiteWi = Target.WorkItems.FindReflectedWorkItem(sourceSuiteWi, false);
if (targetSuiteWi != null)
{
ITestSuiteEntry targetSuiteChild = (from tc in ((IStaticTestSuite)targetSuite).Entries
@@ -352,13 +334,13 @@ private void ApplyDefaultConfigurations(ITestSuiteBase source, ITestSuiteBase ta
private void ApplyFieldMappings(int sourceWIId, int targetWIId)
{
- var sourceWI = Engine.Source.WorkItems.GetWorkItem(sourceWIId.ToString());
- var targetWI = Engine.Target.WorkItems.GetWorkItem(targetWIId.ToString());
+ var sourceWI = Source.WorkItems.GetWorkItem(sourceWIId.ToString());
+ var targetWI = Target.WorkItems.GetWorkItem(targetWIId.ToString());
- targetWI.ToWorkItem().AreaPath = _nodeStructureEnricher.GetNewNodeName(sourceWI.ToWorkItem().AreaPath, TfsNodeStructureType.Area);
- targetWI.ToWorkItem().IterationPath = _nodeStructureEnricher.GetNewNodeName(sourceWI.ToWorkItem().IterationPath, TfsNodeStructureType.Iteration);
+ targetWI.ToWorkItem().AreaPath = CommonTools.NodeStructure.GetNewNodeName(sourceWI.ToWorkItem().AreaPath, TfsNodeStructureType.Area);
+ targetWI.ToWorkItem().IterationPath = CommonTools.NodeStructure.GetNewNodeName(sourceWI.ToWorkItem().IterationPath, TfsNodeStructureType.Iteration);
- Engine.FieldMaps.ApplyFieldMappings(sourceWI, targetWI);
+ CommonTools.FieldMappingTool.ApplyFieldMappings(sourceWI, targetWI);
targetWI.SaveToAzureDevOps();
}
@@ -373,9 +355,9 @@ private void ApplyTestSuiteQuery(ITestSuiteBase source, IDynamicTestSuite target
private void AssignReflectedWorkItemId(int sourceWIId, int targetWIId)
{
- var sourceWI = Engine.Source.WorkItems.GetWorkItem(sourceWIId.ToString());
- var targetWI = Engine.Target.WorkItems.GetWorkItem(targetWIId.ToString());
- targetWI.ToWorkItem().Fields[Engine.Target.Config.AsTeamProjectConfig().ReflectedWorkItemIDFieldName].Value = Engine.Source.WorkItems.CreateReflectedWorkItemId(sourceWI).ToString();
+ var sourceWI = Source.WorkItems.GetWorkItem(sourceWIId.ToString());
+ var targetWI = Target.WorkItems.GetWorkItem(targetWIId.ToString());
+ targetWI.ToWorkItem().Fields[Target.Options.ReflectedWorkItemIDFieldName].Value = Source.WorkItems.CreateReflectedWorkItemId(sourceWI).ToString();
targetWI.SaveToAzureDevOps();
}
@@ -394,7 +376,7 @@ private void AssignTesters(ITestSuiteBase sourceSuite, ITestSuiteBase targetSuit
{
_currentTestCases++;
// find target testcase id for this source tce
- WorkItemData targetTc = Engine.Target.WorkItems.FindReflectedWorkItem(sourceTce.TestCase.WorkItem.AsWorkItemData(), false);
+ WorkItemData targetTc = Target.WorkItems.FindReflectedWorkItem(sourceTce.TestCase.WorkItem.AsWorkItemData(), false);
if (targetTc == null)
{
@@ -483,12 +465,12 @@ private bool TryToRefreshTesterIdentity(ITestSuiteBase targetSuite, ITestPointAs
private bool CanSkipElementBecauseOfTags(int workItemId)
{
- if (_config.OnlyElementsWithTag == null)
+ if (Options.OnlyElementsWithTag == null)
{
return false;
}
- var sourcePlanWorkItem = Engine.Source.WorkItems.GetWorkItem(workItemId.ToString());
- var tagWhichMustBePresent = _config.OnlyElementsWithTag;
+ var sourcePlanWorkItem = Source.WorkItems.GetWorkItem(workItemId.ToString());
+ var tagWhichMustBePresent = Options.OnlyElementsWithTag;
return !sourcePlanWorkItem.ToWorkItem().Tags.Contains(tagWhichMustBePresent);
}
@@ -510,16 +492,16 @@ private ITestSuiteBase CreateNewRequirementTestSuite(ITestSuiteBase source, Work
IRequirementTestSuite targetSuiteChild;
try
{
- string token = Engine.Target.Config.AsTeamProjectConfig().PersonalAccessToken;
- string project = Engine.Target.Config.AsTeamProjectConfig().Project;
- Uri collectionUri = Engine.Target.Config.AsTeamProjectConfig().Collection;
+ string token = Target.Options.Authentication.AccessToken;
+ string project = Target.Options.Project;
+ Uri collectionUri = Target.Options.Collection;
VssConnection connection = new VssConnection(collectionUri, new VssClientCredentials());
if (!string.IsNullOrEmpty(token)) connection = new VssConnection(collectionUri, new VssBasicCredential(string.Empty, token));
TestPlanHttpClient testPlanHttpClient = connection.GetClient();
- WorkItemData sourceSuite = Engine.Source.WorkItems.GetWorkItem(source.Parent.Id);
- WorkItemData targetSuite = Engine.Target.WorkItems.FindReflectedWorkItemByReflectedWorkItemId(sourceSuite);
- WorkItemData sourcePlan = Engine.Source.WorkItems.GetWorkItem(source.Plan.Id);
- WorkItemData targetPlan = Engine.Target.WorkItems.FindReflectedWorkItemByReflectedWorkItemId(sourcePlan);
+ WorkItemData sourceSuite = Source.WorkItems.GetWorkItem(source.Parent.Id);
+ WorkItemData targetSuite = Target.WorkItems.FindReflectedWorkItemByReflectedWorkItemId(sourceSuite);
+ WorkItemData sourcePlan = Source.WorkItems.GetWorkItem(source.Plan.Id);
+ WorkItemData targetPlan = Target.WorkItems.FindReflectedWorkItemByReflectedWorkItemId(sourcePlan);
TestSuiteCreateParams testSuiteCreateParams = new TestSuiteCreateParams()
{
RequirementId = int.Parse(requirement.Id),
@@ -571,8 +553,8 @@ private ITestPlan CreateNewTestPlanFromSource(ITestPlan sourcePlan, string newPl
// Set area and iteration to root of the target project.
// We will set the correct values later, when we actually have a work item available
- targetPlan.Iteration = Engine.Target.Config.AsTeamProjectConfig().Project;
- targetPlan.AreaPath = Engine.Target.Config.AsTeamProjectConfig().Project;
+ targetPlan.Iteration = Target.Options.Project;
+ targetPlan.AreaPath = Target.Options.Project;
// Remove testsettings reference because VSTS Sync doesn't support migrating these artifacts
if (targetPlan.ManualTestSettingsId != 0)
@@ -599,14 +581,14 @@ private ITestSuiteBase FindSuiteEntry(IStaticTestSuite staticSuite, string title
{
Log.LogDebug("TestPlansAndSuitesMigrationContext::FindSuiteEntry::FOUND Test Suit {id}", testSuit.Id);
//Get Source ReflectedWorkItemId
- var sourceWI = Engine.Source.WorkItems.GetWorkItem(sourceSuit.Id.ToString());
+ var sourceWI = Source.WorkItems.GetWorkItem(sourceSuit.Id.ToString());
Log.LogDebug("TestPlansAndSuitesMigrationContext::FindSuiteEntry::SourceWorkItem[{workItemId]", sourceWI.Id);
- string expectedReflectedId = Engine.Source.WorkItems.CreateReflectedWorkItemId(sourceWI).ToString();
+ string expectedReflectedId = Source.WorkItems.CreateReflectedWorkItemId(sourceWI).ToString();
Log.LogDebug("TestPlansAndSuitesMigrationContext::FindSuiteEntry::SourceWorkItem[{workItemId] ~[{ReflectedWorkItemId]", sourceWI.Id, expectedReflectedId);
//Get Target ReflectedWorkItemId
- var targetWI = Engine.Target.WorkItems.GetWorkItem(testSuit.Id.ToString());
+ var targetWI = Target.WorkItems.GetWorkItem(testSuit.Id.ToString());
Log.LogDebug("TestPlansAndSuitesMigrationContext::FindSuiteEntry::TargetWorkItem[{workItemId]", targetWI.Id);
- string workItemReflectedId = (string)targetWI.Fields[Engine.Target.Config.AsTeamProjectConfig().ReflectedWorkItemIDFieldName].Value;
+ string workItemReflectedId = (string)targetWI.Fields[Target.Options.ReflectedWorkItemIDFieldName].Value;
Log.LogDebug("TestPlansAndSuitesMigrationContext::FindSuiteEntry::TargetWorkItem[{workItemId] [{ReflectedWorkItemId]", targetWI.Id, workItemReflectedId);
//Compaire
if (workItemReflectedId != expectedReflectedId)
@@ -627,19 +609,19 @@ private ITestPlan FindTestPlan(string planName, int sourcePlanId)
{
Log.LogDebug("TestPlansAndSuitesMigrationContext::FindTestPlan:: FOUND Test Plan with {name}", planName);
//Get Source ReflectedWorkItemId
- var sourceWI = Engine.Source.WorkItems.GetWorkItem(sourcePlanId);
+ var sourceWI = Source.WorkItems.GetWorkItem(sourcePlanId);
Log.LogDebug("TestPlansAndSuitesMigrationContext::FindTestPlan::SourceWorkItem[{workItemId]", sourceWI.Id);
- string expectedReflectedId = Engine.Source.WorkItems.CreateReflectedWorkItemId(sourceWI).ToString();
+ string expectedReflectedId = Source.WorkItems.CreateReflectedWorkItemId(sourceWI).ToString();
Log.LogDebug("TestPlansAndSuitesMigrationContext::FindTestPlan::SourceWorkItem[{workItemId] ~[{ReflectedWorkItemId]", sourceWI.Id, expectedReflectedId);
//Get Target ReflectedWorkItemId
- var targetWI = Engine.Target.WorkItems.GetWorkItem(testPlan.Id.ToString());
+ var targetWI = Target.WorkItems.GetWorkItem(testPlan.Id.ToString());
Log.LogDebug("TestPlansAndSuitesMigrationContext::FindTestPlan::TargetWorkItem[{workItemId]", targetWI.Id);
- if (!targetWI.Fields.ContainsKey(Engine.Target.Config.AsTeamProjectConfig().ReflectedWorkItemIDFieldName))
+ if (!targetWI.Fields.ContainsKey(Target.Options.ReflectedWorkItemIDFieldName))
{
- Log.LogError("TestPlansAndSuitesMigrationContext::FindTestPlan::TargetWorkItem[{workItemId} does not have ReflectedWorkItemId field {ReflectedWorkItemIDFieldName}", targetWI.Id, Engine.Target.Config.AsTeamProjectConfig().ReflectedWorkItemIDFieldName);
+ Log.LogError("TestPlansAndSuitesMigrationContext::FindTestPlan::TargetWorkItem[{workItemId} does not have ReflectedWorkItemId field {ReflectedWorkItemIDFieldName}", targetWI.Id, Target.Options.ReflectedWorkItemIDFieldName);
Environment.Exit(-1);
}
- string workItemReflectedId = (string)targetWI.Fields[Engine.Target.Config.AsTeamProjectConfig().ReflectedWorkItemIDFieldName].Value;
+ string workItemReflectedId = (string)targetWI.Fields[Target.Options.ReflectedWorkItemIDFieldName].Value;
Log.LogDebug("TestPlansAndSuitesMigrationContext::FindTestPlan::TargetWorkItem[{workItemId] [{ReflectedWorkItemId]", targetWI.Id, workItemReflectedId);
//Compaire
if (workItemReflectedId != expectedReflectedId)
@@ -657,8 +639,8 @@ private ITestPlan FindTestPlan(string planName, int sourcePlanId)
private void FixAssignedToValue(int sourceWIId, int targetWIId)
{
- var sourceWI = Engine.Source.WorkItems.GetWorkItem(sourceWIId.ToString());
- var targetWI = Engine.Target.WorkItems.GetWorkItem(targetWIId.ToString());
+ var sourceWI = Source.WorkItems.GetWorkItem(sourceWIId.ToString());
+ var targetWI = Target.WorkItems.GetWorkItem(targetWIId.ToString());
targetWI.ToWorkItem().Fields["System.AssignedTo"].Value = sourceWI.ToWorkItem().Fields["System.AssignedTo"].Value;
targetWI.SaveToAzureDevOps();
}
@@ -730,8 +712,8 @@ private void FixWorkItemIdInQuery(ITestSuiteBase targetSuitChild)
foreach (Match match in matches)
{
var qid = match.Value.Split('=')[1].Trim();
- TfsReflectedWorkItemId reflectedString = new TfsReflectedWorkItemId(int.Parse(qid), Engine.Source.Config.AsTeamProjectConfig().Project, Engine.Source.Config.AsTeamProjectConfig().Collection);
- var targetWi = Engine.Target.WorkItems.FindReflectedWorkItemByReflectedWorkItemId(reflectedString.ToString());
+ TfsReflectedWorkItemId reflectedString = new TfsReflectedWorkItemId(int.Parse(qid), Source.Options.Project, Source.Options.Collection);
+ var targetWi = Target.WorkItems.FindReflectedWorkItemByReflectedWorkItemId(reflectedString.ToString());
if (targetWi == null)
{
@@ -870,7 +852,7 @@ private void ProcessTestPlan(ITestPlan sourcePlan)
RemoveInvalidLinks(targetPlan);
- if (_config.RemoveAllLinks)
+ if (Options.RemoveAllLinks)
{
targetPlan.Links.Clear();
}
@@ -942,9 +924,9 @@ private void ProcessTestSuite(ITestSuiteBase sourceSuite, ITestSuiteBase targetP
return;
//////////////////////////////////////////
var stopwatch = Stopwatch.StartNew();
- if (_config.MigrationDelay > 0)
+ if (Options.MigrationDelay > 0)
{
- System.Threading.Thread.Sleep(_config.MigrationDelay);
+ System.Threading.Thread.Sleep(Options.MigrationDelay);
}
var starttime = DateTime.Now;
var metrics = new Dictionary();
@@ -978,7 +960,7 @@ private void ProcessTestSuite(ITestSuiteBase sourceSuite, ITestSuiteBase targetP
WorkItemData targetReq = null;
try
{
- sourceReq = Engine.Source.WorkItems.GetWorkItem(sourceRid.ToString());
+ sourceReq = Source.WorkItems.GetWorkItem(sourceRid.ToString());
if (sourceReq == null)
{
InnerLog(sourceSuite, " Source work item not found", 5);
@@ -992,7 +974,7 @@ private void ProcessTestSuite(ITestSuiteBase sourceSuite, ITestSuiteBase targetP
}
try
{
- targetReq = Engine.Target.WorkItems.FindReflectedWorkItemByReflectedWorkItemId(sourceReq);
+ targetReq = Target.WorkItems.FindReflectedWorkItemByReflectedWorkItemId(sourceReq);
if (targetReq == null)
{
@@ -1003,7 +985,7 @@ private void ProcessTestSuite(ITestSuiteBase sourceSuite, ITestSuiteBase targetP
catch (Exception ex)
{
InnerLog(sourceSuite, " Source work item not migrated to target, cannot be found", 5);
- Log.LogError("Unable to locate SourceWI:{SourceWI} in the Target. ReflectedWorkItemId:{ReflectedWorkItemId}", sourceReq.Id, Engine.Target.WorkItems.CreateReflectedWorkItemId(sourceReq), ex);
+ Log.LogError("Unable to locate SourceWI:{SourceWI} in the Target. ReflectedWorkItemId:{ReflectedWorkItemId}", sourceReq.Id, Target.WorkItems.CreateReflectedWorkItemId(sourceReq), ex);
break;
}
targetSuiteChild = CreateNewRequirementTestSuite(sourceSuite, targetReq);
@@ -1087,7 +1069,7 @@ private void RemoveInvalidLinks(ITestPlan targetPlan)
if (linksToRemove.Any())
{
- if (!_config.RemoveInvalidTestSuiteLinks)
+ if (!Options.RemoveInvalidTestSuiteLinks)
{
InnerLog(targetPlan, "We have detected test suite links that probably can't be migrated. You might receive an error 'The URL specified has a potentially unsafe URL protocol' when migrating to VSTS.", 5);
InnerLog(targetPlan, "Please see https://github.com/nkdAgility/azure-devops-migration-tools/issues/178 for more details.", 5);
@@ -1120,10 +1102,10 @@ private void SaveNewTestSuiteToPlan(ITestPlan testPlan, IStaticTestSuite parent,
Log.LogError(ex, " FAILED {TestSuiteType} : {Id} - {Title}", newTestSuite.TestSuiteType.ToString(), newTestSuite.Id.ToString(), newTestSuite.Title,
new Dictionary {
{ "Name", Name},
- { "Target Project", Engine.Target.Config.AsTeamProjectConfig().Project},
- { "Target Collection", Engine.Target.Config.AsTeamProjectConfig().Collection.ToString() },
- { "Source Project", Engine.Source.Config.AsTeamProjectConfig().Project},
- { "Source Collection", Engine.Source.Config.AsTeamProjectConfig().Collection.ToString() },
+ { "Target Project", Target.Options.Project},
+ { "Target Collection", Target.Options.Collection.ToString() },
+ { "Source Project", Source.Options.Project},
+ { "Source Collection", Source.Options.Collection.ToString() },
{ "Status", Status.ToString() },
{ "Task", "SaveNewTestSuitToPlan" },
{ "Id", newTestSuite.Id.ToString()},
@@ -1141,14 +1123,14 @@ private void SaveNewTestSuiteToPlan(ITestPlan testPlan, IStaticTestSuite parent,
private void TagCompletedTargetPlan(int workItemId)
{
// Remvoed to fix bug #852
- //var targetPlanWorkItem = Engine.Target.WorkItems.GetWorkItem(workItemId.ToString());
+ //var targetPlanWorkItem = Target.WorkItems.GetWorkItem(workItemId.ToString());
//targetPlanWorkItem.ToWorkItem().Tags = targetPlanWorkItem.ToWorkItem().Tags + ";migrated";
//targetPlanWorkItem.SaveToAzureDevOps();
}
private bool TargetPlanContansTag(int workItemId)
{
- var targetPlanWorkItem = Engine.Target.WorkItems.GetWorkItem(workItemId.ToString());
+ var targetPlanWorkItem = Target.WorkItems.GetWorkItem(workItemId.ToString());
return targetPlanWorkItem.ToWorkItem().Tags.Contains("migrated");
}
diff --git a/src/MigrationTools/_EngineV1/Configuration/Processing/TestPlansAndSuitesMigrationConfig.cs b/src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/TestPlansAndSuitesMigrationProcessorOptions.cs
similarity index 87%
rename from src/MigrationTools/_EngineV1/Configuration/Processing/TestPlansAndSuitesMigrationConfig.cs
rename to src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/TestPlansAndSuitesMigrationProcessorOptions.cs
index 44b91f75d..7c06075e8 100644
--- a/src/MigrationTools/_EngineV1/Configuration/Processing/TestPlansAndSuitesMigrationConfig.cs
+++ b/src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/TestPlansAndSuitesMigrationProcessorOptions.cs
@@ -1,12 +1,12 @@
using System.Collections.Generic;
+using MigrationTools.Enrichers;
+using MigrationTools.Processors;
+using MigrationTools.Processors.Infrastructure;
namespace MigrationTools._EngineV1.Configuration.Processing
{
- public class TestPlansAndSuitesMigrationConfig : IProcessorConfig
+ public class TestPlansAndSuitesMigrationProcessorOptions : ProcessorOptions
{
-
- public bool Enabled { get; set; }
-
///
/// The tag name that is present on all elements that must be migrated. If this option isn't present this processor will migrate all.
///
@@ -36,11 +36,6 @@ public class TestPlansAndSuitesMigrationConfig : IProcessorConfig
///
/// false
- public string Processor
- {
- get { return "TestPlansAndSuitesMigrationContext"; }
- }
-
///
/// Remove Invalid Links, see https://github.com/nkdAgility/azure-devops-migration-tools/issues/178
///
@@ -54,7 +49,7 @@ public bool IsProcessorCompatible(IReadOnlyList otherProcessor
return true;
}
- public TestPlansAndSuitesMigrationConfig()
+ public TestPlansAndSuitesMigrationProcessorOptions()
{
MigrationDelay = 0;
RemoveAllLinks = false;
diff --git a/src/VstsSyncMigrator.Core/Execution/MigrationContext/TestVariablesMigrationContext.cs b/src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/TestVariablesMigrationProcessor.cs
similarity index 77%
rename from src/VstsSyncMigrator.Core/Execution/MigrationContext/TestVariablesMigrationContext.cs
rename to src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/TestVariablesMigrationProcessor.cs
index a28239be5..647a6ddc9 100644
--- a/src/VstsSyncMigrator.Core/Execution/MigrationContext/TestVariablesMigrationContext.cs
+++ b/src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/TestVariablesMigrationProcessor.cs
@@ -5,30 +5,32 @@
using Microsoft.TeamFoundation.TestManagement.Client;
using MigrationTools;
using MigrationTools._EngineV1.Configuration;
-using MigrationTools._EngineV1.Processors;
-using VstsSyncMigrator.Engine.ComponentContext;
+using MigrationTools.Processors.Infrastructure;
+using MigrationTools.Tools;
+using MigrationTools.Processors.Infrastructure;
+using Microsoft.Extensions.Options;
+using MigrationTools.Enrichers;
+using MigrationTools._EngineV1.Clients;
-namespace VstsSyncMigrator.Engine
+
+namespace MigrationTools.Processors
{
///
/// This processor can migrate test variables that are defined in the test plans / suites. This must run before `TestPlansAndSuitesMigrationConfig`.
///
/// Beta
/// Suites & Plans
- public class TestVariablesMigrationContext : MigrationProcessorBase
+ public class TestVariablesMigrationProcessor : Processor
{
- public TestVariablesMigrationContext(IMigrationEngine engine, IServiceProvider services, ITelemetryLogger telemetry, ILogger logger) : base(engine, services, telemetry, logger)
+ public TestVariablesMigrationProcessor(IOptions options, CommonTools commonTools, ProcessorEnricherContainer processorEnrichers, IServiceProvider services, ITelemetryLogger telemetry, ILogger logger) : base(options, commonTools, processorEnrichers, services, telemetry, logger)
{
}
- public override string Name
- {
- get { return "TestVariablesMigrationContext"; }
- }
+ new TestVariablesMigrationProcessorOptions Options => (TestVariablesMigrationProcessorOptions)base.Options;
- public override void Configure(IProcessorConfig config)
- {
- }
+ new TfsTeamProjectEndpoint Source => (TfsTeamProjectEndpoint)base.Source;
+
+ new TfsTeamProjectEndpoint Target => (TfsTeamProjectEndpoint)base.Target;
internal ITestVariableValue GetVal(ITestVariable targetVar, string valueToFind)
{
@@ -48,8 +50,8 @@ internal ITestVariable GetVar(ITestVariableHelper tvh, string variableToFind)
// http://blogs.microsoft.co.il/shair/2015/02/02/tfs-api-part-56-test-configurations/
protected override void InternalExecute()
{
- TestManagementContext SourceTmc = new TestManagementContext(Engine.Source);
- TestManagementContext targetTmc = new TestManagementContext(Engine.Target);
+ TestManagementContext SourceTmc = new TestManagementContext(Source);
+ TestManagementContext targetTmc = new TestManagementContext(Target);
List sourceVars = SourceTmc.Project.TestVariables.Query().ToList();
Log.LogInformation("Plan to copy {0} Veriables?", sourceVars.Count);
diff --git a/src/MigrationTools/_EngineV1/Configuration/Processing/TestVariablesMigrationConfig.cs b/src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/TestVariablesMigrationProcessorOptions.cs
similarity index 64%
rename from src/MigrationTools/_EngineV1/Configuration/Processing/TestVariablesMigrationConfig.cs
rename to src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/TestVariablesMigrationProcessorOptions.cs
index c0e9aecd0..1156ff32e 100644
--- a/src/MigrationTools/_EngineV1/Configuration/Processing/TestVariablesMigrationConfig.cs
+++ b/src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/TestVariablesMigrationProcessorOptions.cs
@@ -1,8 +1,11 @@
using System.Collections.Generic;
+using MigrationTools._EngineV1.Configuration;
+using MigrationTools.Enrichers;
+using MigrationTools.Processors.Infrastructure;
-namespace MigrationTools._EngineV1.Configuration.Processing
+namespace MigrationTools.Processors
{
- public class TestVariablesMigrationConfig : IProcessorConfig
+ public class TestVariablesMigrationProcessorOptions : ProcessorOptions
{
///
public bool Enabled { get; set; }
diff --git a/src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/TfsAreaAndIterationProcessor.cs b/src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/TfsAreaAndIterationProcessor.cs
deleted file mode 100644
index e27359fd4..000000000
--- a/src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/TfsAreaAndIterationProcessor.cs
+++ /dev/null
@@ -1,72 +0,0 @@
-using System;
-using Microsoft.Extensions.Logging;
-using MigrationTools.Endpoints;
-using MigrationTools.Enrichers;
-
-namespace MigrationTools.Processors
-{
- ///
- /// The `TfsAreaAndIterationProcessor` migrates all of the Area nd Iteraion paths.
- ///
- /// Beta
- /// Work Items
- public class TfsAreaAndIterationProcessor : Processor
- {
- private TfsAreaAndIterationProcessorOptions _options;
- private TfsNodeStructure _nodeStructureEnricher;
-
- public TfsAreaAndIterationProcessor(
- TfsNodeStructure tfsNodeStructure,
- ProcessorEnricherContainer processorEnrichers,
- IEndpointFactory endpointFactory,
- IServiceProvider services,
- ITelemetryLogger telemetry,
- ILogger logger)
- : base(processorEnrichers, endpointFactory, services, telemetry, logger)
- {
- _nodeStructureEnricher = tfsNodeStructure;
- }
-
- public override void Configure(IProcessorOptions options)
- {
- base.Configure(options);
- Log.LogInformation("TfsAreaAndIterationProcessor::Configure");
- _options = (TfsAreaAndIterationProcessorOptions)options;
- }
-
- protected override void InternalExecute()
- {
- Log.LogInformation("Processor::InternalExecute::Start");
- EnsureConfigured();
- ProcessorEnrichers.ProcessorExecutionBegin(this);
- var nodeStructurOptions = new TfsNodeStructureOptions()
- {
- Enabled = true,
- NodeBasePaths = _options.NodeBasePaths,
- AreaMaps = _options.AreaMaps,
- IterationMaps = _options.IterationMaps,
- };
- _nodeStructureEnricher.Configure(nodeStructurOptions);
- _nodeStructureEnricher.ProcessorExecutionBegin(null);
- ProcessorEnrichers.ProcessorExecutionEnd(this);
- Log.LogInformation("Processor::InternalExecute::End");
- }
-
- private void EnsureConfigured()
- {
- Log.LogInformation("Processor::EnsureConfigured");
- if (_options == null)
- {
- throw new Exception("You must call Configure() first");
- }
- if (Source is not TfsWorkItemEndpoint)
- {
- throw new Exception("The Source endpoint configured must be of type TfsWorkItemEndpoint");
- }
- if (Target is not TfsWorkItemEndpoint)
- {
- throw new Exception("The Target endpoint configured must be of type TfsWorkItemEndpoint");
- }
- }
- }
-}
\ No newline at end of file
diff --git a/src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/TfsAreaAndIterationProcessorOptions.cs b/src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/TfsAreaAndIterationProcessorOptions.cs
deleted file mode 100644
index 56e143e54..000000000
--- a/src/MigrationTools.Clients.AzureDevops.ObjectModel/Processors/TfsAreaAndIterationProcessorOptions.cs
+++ /dev/null
@@ -1,29 +0,0 @@
-using System;
-using System.Collections.Generic;
-using MigrationTools.Enrichers;
-
-namespace MigrationTools.Processors
-{
- public class TfsAreaAndIterationProcessorOptions : ProcessorOptions, ITfsNodeStructureOptions
- {
-
- public string[] NodeBasePaths { get; set; }
- public Dictionary AreaMaps { get; set; }
- public Dictionary IterationMaps { get; set; }
-
- public override Type ToConfigure => typeof(TfsAreaAndIterationProcessor);
-
- public override IProcessorOptions GetDefault()
- {
- return this;
- }
-
- public override void SetDefaults()
- {
- SourceName = "sourceName";
- TargetName = "targetName";
- AreaMaps = new Dictionary();
- IterationMaps = new Dictionary