Skip to content

v16.0.4-Preview.2 (Preview)

Pre-release
Pre-release
Compare
Choose a tag to compare
@nkdagility-actions-bot nkdagility-actions-bot released this 16 Sep 00:07
· 196 commits to main since this release
76c49c7

Azure DevOps Migration Tools v16.0.4-Preview.2

Version: 16.0.4-Preview.2
Ring: (Preview)

Release Summary for Azure DevOps Migration Tools

Overview

This release of the Azure DevOps Migration Tools introduces several enhancements, bug fixes, and documentation updates aimed at improving the overall functionality and user experience. The changes focus on refining validation processes, enhancing logging capabilities, and updating documentation to ensure clarity and accuracy.

Detailed Changes

New Features, ✨

  • ConfigurationValidationException: A new exception type is introduced in TfsProcessor.cs to handle invalid endpoint types more effectively. This addition enhances error handling and provides clearer feedback to users when configuration issues arise.
  • IValidateOptions Implementation: The NetworkCredentialsOptions, TfsAuthenticationOptions, TfsEndpointOptions, TfsLanguageMapOptions, and TfsWorkItemMigrationProcessorOptions classes now implement the IValidateOptions interface, allowing for more robust validation of configuration options.

Enhancements, 💡

  • Warning Log for Disabled Enricher: A warning log is added in TfsNodeStructureTool.cs to notify users when the node structure enricher is disabled. This improvement helps users understand the state of their configuration better.
  • Improved Validation for PAT Tokens: The validation process for TfsEndpoint PAT tokens is enhanced, ensuring that users receive accurate feedback regarding their authentication tokens.

Bug Fixes, 🐛

  • Type Registration Fix: The type registration for TfsWorkItemMigrationProcessorOptions in ServiceCollectionExtensions.cs is corrected, resolving issues that could lead to improper validation.
  • Configuration Validation Exception Fixes: Several bugs related to the ConfigurationValidationException are addressed, including property name corrections and constructor overloads to improve usability.

Performance Improvements, ⚡️

  • Refactoring for Clarity: The validation logic is moved to a separate validator class in TfsWorkItemMigrationProcessorOptions, which streamlines the code and enhances maintainability.

Refactoring, ♻️

  • Code Structure Enhancements: Various classes, including ProcessorOptions and TfsWorkItemMigrationProcessorOptions, undergo refactoring to integrate validation logic more effectively and remove redundant components. This restructuring improves code clarity and maintainability.

Documentation Updates, 📝

  • Updated Documentation: The MigrationTools.xml file is updated to reflect the latest changes in the codebase, including new branch and commit details. Additionally, error messages in TfsTeamProjectAuthentication.cs and TfsEndpointOptions.cs are revised to include links to relevant documentation, enhancing user guidance.

Dependency Updates, 📌

  • Endpoint Type Updates: The configuration.json file is updated to reflect changes in endpoint types, specifically changing EndpointType to AzureDevOpsEndpoint and TfsTeamProjectEndpoint. This ensures that the configuration aligns with the latest service offerings.

Conclusion

The changes in this release significantly enhance the Azure DevOps Migration Tools by improving validation processes, enhancing logging, and updating documentation. These updates not only resolve existing issues but also provide a clearer and more user-friendly experience. As a result, users can expect a more reliable and efficient tool that aligns with their migration needs, ultimately supporting the broader business goals of improving project management and collaboration within Azure DevOps.

For further details, please refer to the relevant Pull Requests.

Get the tools

  • Download the MigrationTools-16.0.4-Preview.2.zip file below
  • Install with Winget with winget install nkdagility.azure-devops-migration-tools.Preview --version 16.0.4-Preview.2 . There is a delay for aprovals on the winget store, so you may need to wait a few days before this is available.
  • Install with Chocolatey with choco install vsts-sync-migrator --version 16.0.4-preview0002. There is a delay for aprovals on the chocolatey store, so you may need to wait a few hours before this is available.

What's Changed

🏕 Features

  • add warning log when node structure enricher is disabled by @MrHinsh in #2370

Full Changelog: v16.0.4-Preview.1...v16.0.4-Preview.2