ALM Migration Wizard is a unique API-driven solution that lets you migrate data from HP ALM directly to Zephyr Enterprise (the wizard uses REST API operations to extract data from HP ALM and import it to Zephyr Enterprise). The solution works with both On-Prem and Cloud editions of Zephyr Enterprise. For information on the latest version of the wizard, see Version history.
Supported Zephyr, HP ALM, and wizard versions
Zephyr Enterprise 7.5 and above | ALM Migration Wizard 1.5.9
We highly recommend that you use the latest versions of Zephyr Enterprise and ALM Migration Wizard.
Supported migration entities
The current version of the wizard supports migration of the following entities:
Test cases and test steps
Mapping of test cases to requirements
Test runs and test cycles
Test Folder Organization
The migration procedure comprises several steps: you start the Migration Wizard, configure a migration session and start migrating your project. For detailed information on how to plan migration and perform all the required steps, see the following topics:
Should you have any questions, please contact our Zephyr Customer Care team. Before sending a request, please create an archive containing system information and various logs, and attach it to your request. It will help us debug the issue faster.
For answers to frequently asked questions, see FAQ.
Compatible with Zephyr Enterprise 7.5 and later.
ALM Migration Wizard can now migrate multi-select custom fields from HP ALM.
Compatible with Zephyr Enterprise 6.7 to Zephyr Enterprise 7.4.1.
Sometimes, files attached to test cases could not be migrated.
In some cases, test results could not be migrated to Zephyr’s Test Execution folder.
Compatible with Zephyr Enterprise 6.7 to Zephyr Enterprise 7.4.1
Sometimes, test executions were migrated.
If a username contained a tab character (\t), an error occurred during migration, and the migration failed.
April , 2021
Various back-end improvements.
Sometimes, duplicate custom fields were created during migration.
Some test case field values were not migrated.
March 2, 2021
HP ALM might have custom fields that already exist in Zephyr. To avoid duplicating custom fields, version 1.5.5 introduces the following changes:
If a custom field coming from HP ALM already exists in Zephyr:
No new custom field is created, the existing field will be used.
If an ALM field has a different data type, a new custom field with the same name postfixed with ALM is created in Zephyr.
In case of custom picklist fields, the items of the ALM field are appended to the existing picklist field.
In HP ALM, test cases can be assigned multiple time to the same cycle phase. To replicate this behavior in Zephyr, a number of test case copies are created in Zephyr and are assigned to such a phase.
Old logs are no longer deleted. Previously, the adapter kept only the last 8 logs. You can still delete old logs manually.
Sometimes, the status of certain test cases was not migrated.
January 7, 2021
You can now perform parallel migration, which speeds up the migration process when migrating several projects.
Performance improvements (multi-threading and bulk operations)
Support for proxy.
Support for HP ALM 15.0.
Additional check points to control migration.
October 13, 2020
Support for migrating test sets not assigned to any cycle in HP ALM.
Support for migrating unexecuted test cases.
Support for migrating Actual Results data from HP ALM.
Support for migrating attachments at the Test Step and Evidence levels.
When a test set is not assigned to a cycle, keep the hierarchy at the Test Case Repo level.
Support for migrating test cases even if the HP ALM user has been deleted.
Additional help when authentication fails.
Updated time measurements from milliseconds.
September 3, 2020
Compatibility with Zephyr Enterprise 6.8.
July 16, 2020
June 18, 2020
Compatibility with Zephyr Enterprise 6.7.x.
July 16, 2020
June 18, 2020
October 30, 2019
Test cases have been moved to the project level.
Test cases can now be added to releases as cycles and phases.
Now you can map a requirement to a test case if it is mapped in HP ALM:
Test cases which do not belong to a test set will be moved to the default release of Zephyr Enterprise along with mapped requirements to maintain mapping coverage.
September 16, 2019
Improved migration of test cases to a specific Releases instead of at the Project level.