v16.0.5-Preview.1 (Preview)

Azure DevOps Migration Tools v16.0.5-Preview.1

Version: 16.0.5-Preview.1
Ring: (Preview)

Release Summary for Azure DevOps Migration Tools

Overview

This release introduces several enhancements and new features aimed at improving the functionality and reliability of the Azure DevOps Migration Tools. Key updates include the addition of validation checks, improved logging capabilities, and updates to dependencies, ensuring the tools remain robust and efficient for users.

Detailed Changes

New Features, ✨

• Validation and Logging for TfsGitRepositoryTool Options
  Commit: a07a4bc
  This feature adds validation and logging capabilities for the TfsGitRepositoryTool options. This enhancement allows users to ensure that their configurations are correct before execution, reducing the likelihood of errors during migration processes.

Enhancements, 💡

• Debug Logging for User Identity Mapping
  Commit: 40f3c5e
  The addition of debug logging for user identity mapping enhances the tool's ability to trace and diagnose issues related to user mappings. This improvement is crucial for users who require detailed insights into the mapping process.

Bug Fixes, 🐛

• Validator for TfsGitRepositoryTool
  Commit: e79d28b
  This update resolves issues related to the validation of the TfsGitRepositoryTool, ensuring that the tool correctly honours the enabled:false setting. This fix is essential for maintaining the integrity of migration operations.

Performance Improvements, ⚡️

• Update GitHub Actions to Latest Versions
  Commit: a043f67
  The workflows have been updated to the latest versions of GitHub Actions, which enhances the performance and reliability of the CI/CD processes. This update ensures that the development team can leverage the latest features and improvements from GitHub Actions.

Dependency Updates, 📌

• Dependabot Check for Actions
  Commit: 95ec5f1
  The addition of a Dependabot check for actions ensures that the project remains up-to-date with the latest dependencies, reducing security vulnerabilities and improving overall stability.

Other, 🧱

• UserMapping Shenanigans
  Commit: af279b1
  This commit addresses various internal changes related to user mapping, although specific details are not provided. These changes are likely aimed at improving the overall functionality of user mapping within the tools.

Conclusion

The changes introduced in this release significantly enhance the Azure DevOps Migration Tools, providing users with improved validation, logging, and dependency management. These updates not only streamline the migration process but also bolster the tools' reliability and performance. As a result, users can expect a more efficient and error-free experience, aligning with our commitment to delivering high-quality software solutions.

Get the tools

• Download the MigrationTools-16.0.5-Preview.1.zip file below
• Install with Winget with winget install nkdagility.azure-devops-migration-tools.Preview --version 16.0.5-Preview.1 . 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.5-preview0001. 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

• UserMpaping shenanigans by @MrHinsh in #2422

Full Changelog: v16.0.4-Preview.9...v16.0.5-Preview.1

v16.0.4 (Release)

Azure DevOps Migration Tools v16.0.4

Version: 16.0.4
Ring: (Release)

Release Summary for Azure DevOps Migration Tools

Overview

This release of the Azure DevOps Migration Tools introduces several significant enhancements, new features, and critical bug fixes aimed at improving the overall functionality and user experience. The changes reflect our commitment to providing robust tools for seamless migration processes while ensuring high standards of performance and security.

Detailed Changes

New Features ✨

• Validation and Logging for TfsGitRepositoryTool Options
  Commit: e79d28b73326a5b972af9e7fe0053f4a7278f83b
  This feature adds validation and logging capabilities to the TfsGitRepositoryTool options, ensuring that users receive immediate feedback on their configurations, which enhances usability and reduces errors.

• Order Property in ConfigurationSample Class
  Commit: 6d3fe268de4733b7e3ab0b07ef75c877b4c8a2af
  The addition of the 'Order' property allows for more structured configuration management, improving the clarity and organisation of configuration samples.

Enhancements 💡

• Improved Exception Handling
  Commits: 4076a323b0d10df71a8267a3a424e9c4ec0efd66, 65ebf5362d5b9bd243f6c5dc952daa1ad7a98180
  Refactoring of exception handling improves the robustness of the application, making it easier to manage errors and enhancing the overall reliability of the migration tools.

• Configuration Updates
  Commits: df545d9c84c0fe957e49b130b5f6484015666ebe, 7165c5ce48c5a97a641c942ca02566e25c256b3e
  Updates to the configuration files reflect changes in the testing environment, ensuring that the tools are aligned with current project structures.

Bug Fixes 🐛

• URL Validation Logic Improvement
  Commits: cf9e4445856c9cb732b3bcc438d2d3fc23b3fa23, a8f0fd48dbed03cda9a2a967176f1fb811b9ef28
  Enhancements to the URL validation logic for the Collection property resolve issues that could lead to misconfigurations, thereby improving the reliability of the migration process.

• User Mapping Logic Error Fix
  Commit: 62941905d11ec5fdb595d59b3b250fc36ec144f4
  This fix addresses a critical error in user mapping logic, ensuring accurate user data handling during migrations.

Performance Improvements ⚡️

• Centralised Log Path Creation
  Commits: 2a8128826c38e7bdfcc20d4850ad44ca36de07de, aa08a9a866d6934b2f76fde481ab011de2209d2d
  Improvements in logging mechanisms enhance performance by centralising log path creation, which simplifies log management and improves the efficiency of logging operations.

Refactoring ♻️

• Refactoring of Processor Options
  Commits: 58b4cd56b96b8180b2cf8c197dbebace0835768c, ec114b7c6d087972e010a6b5c9203fa65bfbd673
  Refactoring efforts focus on improving the structure of the codebase, making it easier to maintain and extend in the future without altering existing functionality.

Documentation Updates 📝

• Updated Documentation for MigrationTools
  Commits: 81a6ce471f28bf6e216f6509cda423585a1da9f3, 8de6230394166ad9f44bfdbc4fbf304185b2d39e
  Documentation updates ensure that users have access to the latest information regarding features and configurations, enhancing user experience and support.

Conclusion

The changes introduced in this release significantly enhance the Azure DevOps Migration Tools, providing users with improved functionality, better performance, and a more reliable migration experience. These updates not only address existing issues but also lay the groundwork for future enhancements, aligning with our business goals of delivering high-quality, user-friendly migration solutions. We anticipate that these improvements will lead to increased user satisfaction and adoption of the tools in various migration scenarios.

Get the tools

• Download the MigrationTools-16.0.4.zip file below
• Install with Winget with winget install nkdagility.azure-devops-migration-tools --version 16.0.4 . 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. 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 defaults for AzureDevOpsEndpoint and rebuild docs. by @MrHinsh in #2355
• Niggles v16 (Docs) + Bugs by @MrHinsh in #2358
• Update validator errors to be more clear that is is a user error. by @MrHinsh in #2363
• Improve validation for TfsEndpoint PAT tokens and message by @MrHinsh in #2368
• add warning log when node structure enricher is disabled by @MrHinsh in #2370
• Fix for Endpoint Samples not being rendered correctly in Docs by @MrHinsh in #2377
• Update to also publish to Azure Static Sites by @MrHinsh in #2378
• 🔧 centralize log path creation and improve logging by @MrHinsh in #2385
• 🐛 (TfsEndpointOptions.cs): improve URL validation logic for Collection property by @MrHinsh in #2388
• Update Docs and Defaults by @MrHinsh in #2392
• Publish to Static Sites by @MrHinsh in #2384
• User mapping logic error by @MrHinsh in #2417
• Exception enhancement by @MrHinsh in #2418
• refactor exception handling and update XML references by @MrHinsh in #2419

Full Changelog: v16.0.2...v16.0.4

v16.0.4-Preview.9 (Preview)

Azure DevOps Migration Tools v16.0.4-Preview.9

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

Release Summary for Azure DevOps Migration Tools

Overview

This release of the Azure DevOps Migration Tools introduces several significant enhancements, new features, and critical bug fixes aimed at improving the overall functionality and user experience. The changes reflect our commitment to providing robust tools for seamless migration processes while ensuring high standards of code quality and maintainability.

Detailed Changes

New Features ✨

• Validation and Logging for TfsGitRepositoryTool Options
  Commit: e79d28b73326a5b972af9e7fe0053f4a7278f83b
  This feature adds validation and logging capabilities for the TfsGitRepositoryTool options, ensuring that users receive immediate feedback on configuration issues, which enhances usability and reduces errors during migration.

• Support for 'Order' Property in ConfigurationSample Class
  Commit: 6d3fe268de4733b7e3ab0b07ef75c877b4c8a2af
  The addition of the 'Order' property allows for more structured configuration management, improving the clarity and organisation of configuration samples.

Enhancements 💡

• Improved Exception Handling
  Commits: 4076a323b0d10df71a8267a3a424e9c4ec0efd66, 65ebf5362d5b9bd243f6c5dc952daa1ad7a98180
  Refactoring of exception handling improves the robustness of the application, making it easier to diagnose and resolve issues that may arise during migration.

• Centralised Log Path Creation
  Commit: aa08a9a866d6934b2f76fde481ab011de2209d2d
  This enhancement centralises the log path creation process, improving logging consistency and making it easier to manage log files.

Bug Fixes 🐛

• Improved URL Validation Logic
  Commits: cf9e4445856c9cb732b3bcc438d2d3fc23b3fa23, a8f0fd48dbed03cda9a2a967176f1fb811b9ef28
  The URL validation logic for the Collection property is enhanced, ensuring that users can only input valid URLs, thus preventing potential migration failures.

• Fix for User Mapping Logic Error
  Commit: 62941905d11ec5fdb595d59b3b250fc36ec144f4
  This fix addresses a critical error in user mapping logic, ensuring accurate user data migration.

Performance Improvements ⚡️

• Optimisation of JSON Serialization Handling
  Commit: 48d5f5ca760b9065ccf9c4f28d5c10493fb857d6
  Improvements in JSON serialization handling lead to faster processing times and reduced memory usage during migrations.

Refactoring ♻️

• Refactor of Processor Options and Validation Logic
  Commits: 58b4cd56b96b8180b2cf8c197dbebace0835768c, ec114b7c6d087972e010a6b5c9203fa65bfbd673
  Refactoring efforts focus on improving code structure and maintainability without altering existing functionality, which is crucial for long-term project sustainability.

Documentation Updates 📝

• Updated Documentation to Reflect Latest Changes
  Commits: 81a6ce471f28bf6e216f6509cda423585a1da9f3, a249caf19931b605c708dd66691cb9ec44a7ccc0
  Documentation is updated to include new features, configuration changes, and improved error messages, ensuring that users have access to the most current information.

Dependency Updates 📌

• Updated Configuration for Migration Testing
  Commit: df545d9c84c0fe957e49b130b5f6484015666ebe
  The project name in the configuration file is updated to reflect changes in the testing environment, ensuring consistency across development and testing phases.

Conclusion

The changes introduced in this release significantly enhance the functionality, performance, and reliability of the Azure DevOps Migration Tools. By addressing critical bugs, adding new features, and improving existing functionalities, this release positions the project for greater user satisfaction and operational efficiency. As we continue to evolve the tools, we remain committed to delivering high-quality solutions that meet the needs of our users and support their migration efforts effectively.

Get the tools

• Download the MigrationTools-16.0.4-Preview.9.zip file below
• Install with Winget with winget install nkdagility.azure-devops-migration-tools.Preview --version 16.0.4-Preview.9 . 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-preview0009. 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

• Validator for TfsGitRepositoryTool and honor the enabled:false by @MrHinsh in #2420

Full Changelog: v16.0.4...v16.0.4-Preview.9

v16.0.4-Preview.8 (Preview)

Azure DevOps Migration Tools v16.0.4-Preview.8

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

Release Summary for Azure DevOps Migration Tools

Overview

This release of the Azure DevOps Migration Tools introduces several enhancements, bug fixes, and new features aimed at improving the overall functionality and user experience. The changes reflect our commitment to maintaining high-quality software and addressing user feedback effectively.

Detailed Changes

New Features ✨

• Order Property Addition: The Order property is added to the ConfigurationSample class, enhancing the sample creation logic. This change allows for better organisation and retrieval of configuration samples, improving usability. PR #2392

Enhancements 💡

• Exception Handling Refactor: The exception handling mechanism is refactored and XML references are updated. This improvement enhances the robustness of the application by ensuring that exceptions are managed more effectively. PR #2419
• User Mapping Logic Improvement: The user mapping logic is enhanced to address previous errors, ensuring more accurate user data handling. PR #2417
• Configuration Updates: The project name in configuration.json is updated to reflect changes in the testing environment, ensuring clarity and consistency in project settings. PR #2418

Bug Fixes 🐛

• URL Validation Logic Improvement: The URL validation logic for the Collection property is improved, addressing issues that could lead to incorrect URL formats. This fix enhances the reliability of the application when interacting with external services. PR #2388
• Type Registration Fix: An incorrect type registration for TfsWorkItemMigrationProcessorOptions is fixed, ensuring that the application correctly validates options. PR #2363

Performance Improvements ⚡️

• Centralised Log Path Creation: The log path creation is centralised and logging is improved, which enhances the performance of logging operations and simplifies log management. PR #2385

Refactoring ♻️

• Validation Logic Refactor: The validation logic for various options is refactored to improve clarity and maintainability. This change does not alter functionality but enhances the code structure for future development. PR #2368

Documentation Updates 📝

• Documentation Enhancements: The documentation is updated to reflect the latest changes, including new branch and commit details. This ensures that users have access to the most current information regarding the tool's functionality. PR #2392

Dependency Updates 📌

• Configuration Fields Update: New configuration fields are added and JSON serialization handling is improved, ensuring that the application can handle configuration data more effectively. PR #2385

Conclusion

The changes introduced in this release significantly enhance the Azure DevOps Migration Tools, making it more robust, user-friendly, and efficient. By addressing user feedback and improving existing functionalities, we aim to provide a better experience for our users and support their migration needs more effectively. The ongoing commitment to quality and performance positions the project for future success and aligns with our business goals of delivering reliable and effective software solutions.

Get the tools

• Download the MigrationTools-16.0.4-Preview.8.zip file below
• Install with Winget with winget install nkdagility.azure-devops-migration-tools.Preview --version 16.0.4-Preview.8 . 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-preview0008. 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

• refactor exception handling and update XML references by @MrHinsh in #2419

Full Changelog: v16.0.4-Preview.7...v16.0.4-Preview.8

v16.0.4-Preview.7 (Preview)

Azure DevOps Migration Tools v16.0.4-Preview.7

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

Release Summary for Azure DevOps Migration Tools

Overview

This release of the Azure DevOps Migration Tools introduces several enhancements, bug fixes, and new features aimed at improving the overall functionality and user experience. The changes reflect our commitment to providing a robust and efficient migration tool that meets the evolving needs of our users.

Detailed Changes

New Features, ✨

• Added 'Order' Property: The ConfigurationSample class now includes an 'Order' property, enhancing the sample creation logic. This addition allows for better organisation and retrieval of configuration samples. PR #2392
• Support for IsKeyed Configuration Metadata: The ClassDataLoader.cs file is updated to support IsKeyed configuration metadata, providing more flexibility in configuration management. PR #2392

Enhancements, 💡

• Improved Logging: The logging mechanism is centralised, and enhancements are made to improve logging clarity and efficiency. This change aids in better tracking and debugging of migration processes. PR #2385
• Configuration Updates: The configuration.json file is updated to reflect changes in project names and to add new configuration fields, improving the clarity and usability of configuration settings. PR #2418

Bug Fixes, 🐛

• User Mapping Logic Error: A critical error in user mapping logic is resolved, ensuring that user data is accurately processed during migrations. PR #2417
• URL Validation Logic: The URL validation logic for the Collection property is improved, enhancing the reliability of endpoint configurations. PR #2388

Performance Improvements, ⚡️

• Centralised Log Path Creation: The log path creation process is centralised, which streamlines logging operations and improves performance during migration tasks. PR #2385

Refactoring, ♻️

• Validation Logic Refactor: The validation logic for various options is refactored to improve maintainability and clarity. This includes moving validation logic to separate classes, which enhances the overall structure of the codebase. PR #2368

Documentation Updates, 📝

• Updated Documentation: The documentation is updated to reflect the latest changes, including new features and configuration options. This ensures that users have access to the most current information. PR #2392

Dependency Updates, 📌

• GitHub Actions Workflow: A new GitHub Actions workflow is added to clean up PR environments, enhancing the CI/CD process and ensuring a cleaner development environment. PR #2378

Other, 🧱

• Commit Renames and Merges: Various commits are renamed for clarity, and branches are merged to maintain a clean and organised codebase.

Conclusion

The changes introduced in this release significantly enhance the functionality, performance, and usability of the Azure DevOps Migration Tools. By addressing critical bugs, adding new features, and improving existing functionalities, we are better positioned to meet the needs of our users and support their migration efforts effectively. These updates not only improve the user experience but also align with our business goals of delivering a reliable and efficient migration solution.

Get the tools

• Download the MigrationTools-16.0.4-Preview.7.zip file below
• Install with Winget with winget install nkdagility.azure-devops-migration-tools.Preview --version 16.0.4-Preview.7 . 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-preview0007. 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

• Exception enhancement by @MrHinsh in #2418

Full Changelog: v16.0.4-Preview.6...v16.0.4-Preview.7

v16.0.4-Preview.6 (Preview)

Azure DevOps Migration Tools v16.0.4-Preview.6

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

Release Summary for Azure DevOps Migration Tools

Overview

This release of the Azure DevOps Migration Tools introduces several enhancements, bug fixes, and new features aimed at improving user experience and system performance. The changes reflect our commitment to providing a robust and efficient tool for migrating work items and managing configurations effectively.

Detailed Changes

New Features, ✨

• Added 'Order' Property: The ConfigurationSample class now includes an 'Order' property, enhancing the sample creation logic. This addition allows for better organisation and retrieval of configuration samples. PR #6
• Support for IsKeyed Configuration Metadata: The ClassDataLoader.cs now supports IsKeyed configuration metadata, which improves the flexibility of configuration management. PR #e675cdc7e5e701a422a09303ec6333b6cabf1d1c

Enhancements, 💡

• Improved User Mapping Configuration: The TfsUserMappingTool configuration has been added to streamline user mapping processes, making it easier for users to configure their settings. PR #7165
• Centralised Log Path Creation: The logging mechanism has been centralised, improving the clarity and consistency of log outputs across the application. PR #2a8128826c38e7bdfcc20d4850ad44ca36de07de

Bug Fixes, 🐛

• User Mapping Logic Error: A critical error in the user mapping logic has been resolved, ensuring that user mappings are processed correctly. PR #2417
• URL Validation Logic Improvement: The URL validation logic for the Collection property has been enhanced, ensuring that invalid URLs are correctly identified and handled. PR #2388

Performance Improvements, ⚡️

• Optimised JSON Serialization Handling: The handling of JSON serialization has been improved across several configuration files, leading to better performance and reduced errors during data processing. PR #48d5f5ca760b9065ccf9c4f28d5c10493fb857d6

Refactoring, ♻️

• Validation Logic Refactor: The validation logic for various options has been refactored to improve clarity and maintainability. This includes moving validation logic to dedicated classes, which enhances the overall structure of the codebase. PR #58b4cd56b96b8180b2cf8c197dbebace0835768c

Documentation Updates, 📝

• Updated Documentation: The documentation has been updated to reflect the latest changes, including new features and configuration options. This ensures that users have access to the most current information. PR #aa4680fa35d6b31f850b5a65d263c7e94b1878d9

Dependency Updates, 📌

• Updated GitHub Actions Workflow: The GitHub Actions workflow has been updated to improve the deployment process, ensuring that the latest changes are published efficiently. PR #9217f5bacc35403a50079e185323fd2d2d69dca8

Conclusion

The changes introduced in this release significantly enhance the functionality and reliability of the Azure DevOps Migration Tools. By addressing critical bugs, improving performance, and adding new features, we aim to provide a more seamless experience for our users. These updates not only improve the tool's usability but also align with our business goals of delivering high-quality software solutions that meet the evolving needs of our clients. We look forward to your feedback and continued support as we strive to enhance our offerings further.

Get the tools

• Download the MigrationTools-16.0.4-Preview.6.zip file below
• Install with Winget with winget install nkdagility.azure-devops-migration-tools.Preview --version 16.0.4-Preview.6 . 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-preview0006. 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

• Publish to Static Sites by @MrHinsh in #2384
• User mapping logic error by @MrHinsh in #2417

Full Changelog: v16.0.4-Preview.5...v16.0.4-Preview.6

v16.0.4-Preview.5 (Preview)

Azure DevOps Migration Tools v16.0.4-Preview.5

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

Release Summary for Azure DevOps Migration Tools

Overview

This release of the Azure DevOps Migration Tools introduces several enhancements, new features, and critical bug fixes aimed at improving the overall functionality and user experience. The updates focus on refining configuration management, enhancing validation logic, and improving documentation to support users effectively.

Detailed Changes

New Features, ✨

• Added 'Order' Property: The ConfigurationSample class now includes an 'Order' property, enhancing the sample creation logic. This addition allows for better organisation and retrieval of configuration samples. PR #2392

Enhancements, 💡

• Improved Logging: Centralised log path creation and enhanced logging mechanisms have been implemented, providing clearer insights into the migration process. This change aids in troubleshooting and monitoring. PR #2385
• Updated Documentation: Documentation has been updated to reflect the latest changes, ensuring that users have access to accurate and comprehensive information. This includes updates to the MigrationTools.xml file. PR #2377

Bug Fixes, 🐛

• URL Validation Logic: The URL validation logic for the Collection property in TfsEndpointOptions.cs has been improved, addressing issues that could lead to incorrect URL formats. This fix enhances the reliability of endpoint configurations. PR #2388
• Type Registration Fix: An incorrect type registration for TfsWorkItemMigrationProcessorOptions has been rectified, ensuring that the validation process functions correctly. PR #2368

Performance Improvements, ⚡️

• Centralised Configuration Handling: New configuration fields have been added, and JSON serialization handling has been improved, optimising the performance of configuration management. This change streamlines the process of managing application settings. PR #2385

Refactoring, ♻️

• Validation Logic Refactor: The validation logic for various options has been refactored to use the IValidateOptions interface, promoting cleaner code and better separation of concerns. This change enhances maintainability and readability of the codebase. PR #2368

Documentation Updates, 📝

• Enhanced Error Messages: Error messages in TfsTeamProjectAuthentication.cs and TfsEndpointOptions.cs have been updated to include links to relevant documentation, providing users with immediate access to help resources when encountering issues. PR #2363

Dependency Updates, 📌

• Updated Build Commands: The Jekyll build command in main.yml has been updated to ensure compatibility with Azure Static Sites, allowing for smoother deployment processes. PR #2378

Conclusion

The changes introduced in this release significantly enhance the Azure DevOps Migration Tools, making them more robust and user-friendly. By addressing critical bugs, improving performance, and updating documentation, the team ensures that users can rely on the tools for efficient migration processes. These updates align with our commitment to continuous improvement and user satisfaction, ultimately supporting our business goals of providing high-quality software solutions.

Get the tools

• Download the MigrationTools-16.0.4-Preview.5.zip file below
• Install with Winget with winget install nkdagility.azure-devops-migration-tools.Preview --version 16.0.4-Preview.5 . 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-preview0005. 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

• 🐛 (TfsEndpointOptions.cs): improve URL validation logic for Collection property by @MrHinsh in #2388
• Update Docs and Defaults by @MrHinsh in #2392

Full Changelog: v16.0.4-Preview.4...v16.0.4-Preview.5

v16.0.4-Preview.4 (Preview)

Azure DevOps Migration Tools v16.0.4-Preview.4

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

Release Summary

This release introduces a series of enhancements and fixes aimed at improving the functionality, performance, and usability of the Azure DevOps Migration Tools. The changes reflect our commitment to providing a robust and user-friendly experience for our users, ensuring that the tools remain effective and reliable.

Detailed Changes

New Features, ✨

• Support for IsKeyed Configuration Metadata
  Commit: e675cdc7e5e701a422a09303ec6333b6cabf1d1c
  This feature enhances the ClassDataLoader by adding support for IsKeyed configuration metadata, allowing for more flexible data handling.

Enhancements, 💡

• Centralised Log Path Creation and Improved Logging
  Commits: 2a8128826c38e7bdfcc20d4850ad44ca36de07de, aa08a9a866d6934b2f76fde481ab011de2209d2d
  The logging system is centralised, which simplifies log management and enhances the clarity of log outputs.

• Updated Jekyll Build Command
  Commits: 6ce0236b2e4f5a32b21d71c92fb848d8ffb6a9b3, 0c5a33438a6be9076c0fd372476f4393278c2475
  The Jekyll build command is updated to use an empty baseurl, improving the deployment process for static sites.

Bug Fixes, 🐛

• Fix for Incorrect Type Registration
  Commit: a9e012b05801421a57a109dc86b8827c02524855
  This fix resolves an issue with the type registration for TfsWorkItemMigrationProcessorOptions, ensuring proper validation.

• Rendering Issue in Documentation
  Commit: 718c31903c2750f5170ac91a202c51682b4ebb13
  The documentation now correctly renders Endpoint Samples, enhancing user understanding.

Performance Improvements, ⚡️

• Validation Logic Enhancements
  Commits: 58b4cd56b96b8180b2cf8c197dbebace0835768c, c1dc8d13597a011053009949861c3795a12918d7
  The validation logic for various options is refactored and enhanced, improving the overall performance and reliability of the migration process.

Refactoring, ♻️

• Refactor of Processor Properties
  Commits: ec114b7c6d087972e010a6b5c9203fa65bfbd673, 5bcbf704aace8fee9668f6f92725633ba7db1c14
  The properties in TfsProcessor are refactored to include type validation, enhancing code maintainability without altering functionality.

Documentation Updates, 📝

• Updated Documentation to Reflect Changes
  Commits: ab8aed07c34066bb2c7aa6c708a5066768fa8c08, 3b8d3d67d360c2cb6d80395f53551ead9bc0ce4a
  Documentation is updated to include the latest changes and improvements, ensuring users have access to accurate and helpful information.

Dependency Updates, 📌

• Updated GitHub Actions Workflow
  Commit: 93a233c94c964d88b1c0fa08229327dec036cb16
  The workflow is updated to download and deploy new artifacts, streamlining the deployment process.

Conclusion

The changes in this release significantly enhance the functionality, performance, and usability of the Azure DevOps Migration Tools. By addressing bugs, improving logging, and refining validation processes, we ensure a more reliable and efficient experience for our users. These updates align with our business goals of delivering high-quality tools that meet the evolving needs of our customers. We look forward to further enhancements in future releases.

Get the tools

• Download the MigrationTools-16.0.4-Preview.4.zip file below
• Install with Winget with winget install nkdagility.azure-devops-migration-tools.Preview --version 16.0.4-Preview.4 . 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-preview0004. 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

• Update to also publish to Azure Static Sites by @MrHinsh in #2378
• 🔧 centralize log path creation and improve logging by @MrHinsh in #2385

Full Changelog: v16.0.4-Preview.3...v16.0.4-Preview.4

v16.0.4-Preview.3 (Preview)

Azure DevOps Migration Tools v16.0.4-Preview.3

Version: 16.0.4-Preview.3
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 reflect our commitment to providing a robust and user-friendly tool for migrating work items and managing configurations effectively.

Detailed Changes

New Features, ✨

• Support for IsKeyed Configuration Metadata: The ClassDataLoader.cs file now includes support for IsKeyed configuration metadata, enhancing the flexibility of configuration management. This feature allows users to better define and manage their data structures, which is crucial for complex migration scenarios. PR #2377

Enhancements, 💡

• Warning Log for Disabled Node Structure 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 and avoid potential issues during migration.
• Validation Logic Enhancements: The validation logic for TfsWorkItemMigrationProcessorOptions is enhanced to provide clearer error messages, ensuring users can quickly identify and rectify configuration issues. This is part of a broader effort to improve user experience and reduce errors during migration.

Bug Fixes, 🐛

• Fix for Incorrect Type Registration: The ServiceCollectionExtensions.cs file is updated to correct the type registration for TfsWorkItemMigrationProcessorOptions, resolving issues that could lead to incorrect behaviour during migrations.
• Configuration Validation Exception Fixes: The ConfigurationValidationException class is updated to fix property names and add constructor overloads, ensuring that exceptions are thrown correctly for missing endpoints.

Performance Improvements, ⚡️

• Refactoring for Improved Validation Logic: The validation logic is refactored across several classes, including TfsWorkItemMigrationProcessorOptions and ProcessorOptions, to streamline the validation process and enhance performance. This refactoring reduces redundancy and improves maintainability.

Refactoring, ♻️

• Code Structure Improvements: Several classes, including TfsProcessor.cs and TfsWorkItemMigrationProcessorOptions, undergo refactoring to improve code structure and readability. This includes integrating validation logic into the ProcessorOptions class and removing redundant classes, which simplifies the codebase and enhances maintainability.

Documentation Updates, 📝

• Updated Documentation: The documentation in MigrationTools.xml is updated to reflect the latest changes, including new branch and commit details. This ensures that users have access to the most current information regarding the tool's functionality and usage.
• Error Messages Enhancement: Error messages in TfsTeamProjectAuthentication.cs and TfsEndpointOptions.cs are updated to include links to relevant documentation, providing users with immediate access to help resources when encountering issues.

Dependency Updates, 📌

• Configuration Updates: The configuration.json file is updated to rename endpoint keys for clarity, ensuring that users can easily understand and configure their endpoints.

Other, 🧱

• Logging Improvements: A new warning log is introduced when the node structure enricher is disabled, providing users with better insights into their configuration state.

Conclusion

The changes in this release significantly enhance the Azure DevOps Migration Tools, making it more user-friendly and efficient. By addressing bugs, improving validation logic, and updating documentation, we aim to reduce user errors and streamline the migration process. These updates not only improve the tool's performance but also align with our business goals of delivering high-quality software that meets the needs of our users. We look forward to continued improvements and user feedback as we evolve the tool further.

Get the tools

• Download the MigrationTools-16.0.4-Preview.3.zip file below
• Install with Winget with winget install nkdagility.azure-devops-migration-tools.Preview --version 16.0.4-Preview.3 . 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-preview0003. 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

• Fix for Endpoint Samples not being rendered correctly in Docs by @MrHinsh in #2377

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

v16.0.4-Preview.2 (Preview)

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