v16.0.4-Preview.2 (Preview)
Pre-releaseAzure 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
, andTfsWorkItemMigrationProcessorOptions
classes now implement theIValidateOptions
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
inServiceCollectionExtensions.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
andTfsWorkItemMigrationProcessorOptions
, 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 inTfsTeamProjectAuthentication.cs
andTfsEndpointOptions.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 changingEndpointType
toAzureDevOpsEndpoint
andTfsTeamProjectEndpoint
. 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
Full Changelog: v16.0.4-Preview.1...v16.0.4-Preview.2