You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 8 Next »

Since Xray v3.0, there is a basic built-in tests importer for HP ALM/QC v12.5x.

This importer is able to import test cases from HP ALM's "Test Plan" (not in any way related with Xray's Test Plan issue) by using HP ALM's REST API.

The current implementation is essentialy limited to import manual test specifications, their steps and their attachments.

Features and Limitations


Supported FeaturesUnsupported
  • import Test case specification from HP ALM's "Test Plan"
    • tests without parameters
    • tests without called steps
    • tests that are not marked as being "templates"
    • tests of type "MANUAL"
  • import Test attachments and Test step level attachments
  • import formatted Test description
  • tests whose type is not "MANUAL"
  • tests with parameters
  • tests with called steps
  • tests that marked as being "templates"
  • defects and requirements
  • links to defects/requirements
  • hierarchical organization information
  • test runs
  • Test Lab related information (tests, runs, etc)


Please note

The current importer is relatively basic. If you need to migrate more information and have further control over the migrated data, we recommend to contact an Atlassian partner with expertise on these kind of migrations. Note that migrating "all" information may be a complex process to implement and some things may not be mappable at all.


How to use

Imagine that you have a project in HP ALM (see above for supported version/s) and that you wish to import the tests from HP ALM's "Test Plan", as seen bellow.

  


To start the importation process:

  1. Log in with an administrator account
  2. go to System>Import and Export>External System Import
  3. Choose the Xray "Test Case Importer" like shown in the image bellow



Then you need to fill out the details of HP ALM/QC instance, including its host name/IP, port, domain, project and authentication credentials.



Please note

Whenever clicking Next, the connection is validated. If the connection fails, an error message is shown and you won't be able to proceed with the importation process.


Upon successful connection, you can optionaly define a label to assign to the Test issues that will be created. This may be quite useful if you need afterwards a quick way of identifying the newly created issues. The label syntax is restricted in the same way as the label fields in JIRA (we recommend on using an unique label, with numbering).


Then you need to choose the project where you want the Test issues to be created in.


A final confirmation dialog presents information about the total amount of Tests that will be imported.

This amound may be greater than the actual amount of Test issues that will be created; this happens because Xray will only be able to import some of the tests, depending on their characteristics which can only be obtained during the actual importation.


In the end, a brief summary is shown mentioned the total number of Test issues created and any warnings that occurred during the process.


From this screen, you can also see the list of created issues based on the label you provided and you can also consult detailed logs about the process.

Logging

Logging is done to a separate log file named "hpqc_log.log", available in the "log" directory of your application data directory.

Logging level can be controlled by using the package "com.xpandit.raven" (which applies to all the classes of Xray) or "com.xpandit.raven.hpqcimport", in case you want only to only control de logs related with the importation process.


Example of log:

2017-10-25 2017 13:30:28,050 INFO  - HP QC/ALM details, credentials, project domain and name are valid.
2017-10-25 2017 13:30:28,055 INFO  - --------------------------------------------------------------
2017-10-25 2017 13:31:00,124 INFO  - --------------------------------------------------------------
2017-10-25 2017 13:31:00,138 INFO  - Label "iteration1" will be associated to new issues created.
2017-10-25 2017 13:31:00,138 INFO  - --------------------------------------------------------------
2017-10-25 2017 13:32:02,861 INFO  - Exists 7 potential HP QC/ALM tests to be imported.
2017-10-25 2017 13:32:34,344 INFO  - --------------------------------------------------------------
2017-10-25 2017 13:32:34,344 INFO  - Starting to obtain tests from HP QC/ALM.
2017-10-25 2017 13:32:35,160 INFO  - Successfully obtained HP QC/ALM Test with id 1. It will be imported.
2017-10-25 2017 13:32:36,995 INFO  - Successfully obtained HP QC/ALM Test with id 4. It will be imported.
2017-10-25 2017 13:32:36,996 WARN  - HP QC/ALM Test with id 11 has Description blank.
2017-10-25 2017 13:32:37,116 WARN  - HP QC/ALM Test Parameter with id 7 in test with id 11 has Default Value blank.
2017-10-25 2017 13:32:37,247 WARN  - HP QC/ALM Design-Step 1 in test with id 1016 has Expected Result blank.
2017-10-25 2017 13:32:37,606 WARN  - HP QC/ALM Design-Step 4 in test with id 1017 has Expected Result blank.
2017-10-25 2017 13:32:37,725 INFO  - Successfully obtained HP QC/ALM Test with id 11. It will NOT be imported.
2017-10-25 2017 13:32:38,097 WARN  - HP QC/ALM Design-Step 1 in test with id 1015 has Description blank.
2017-10-25 2017 13:32:38,220 INFO  - Successfully obtained HP QC/ALM Test with id 12. It will NOT be imported.
2017-10-25 2017 13:32:39,817 INFO  - Successfully obtained HP QC/ALM Test with id 15. It will NOT be imported.
2017-10-25 2017 13:32:39,817 WARN  - HP QC/ALM Test with id 16 has Description blank.
2017-10-25 2017 13:32:40,173 INFO  - Successfully obtained HP QC/ALM Test with id 16. It will be imported.
2017-10-25 2017 13:32:40,291 INFO  - 3 HP QC/ALM Tests will be imported to project with key CALC.
2017-10-25 2017 13:32:40,291 INFO  - --------------------------------------------------------------
2017-10-25 2017 13:32:40,291 INFO  - Starting to import tests from HP QC/ALM into JIRA Issues.
2017-10-25 2017 13:32:42,437 INFO  - Finished importing 3 HP QC/ALM tests. 3 JIRA Issues created.
2017-10-25 2017 13:32:42,438 INFO  - Finished import with 0 errors and 1 warnings.
2017-10-25 2017 13:32:42,441 INFO  - Warnings:
2017-10-25 2017 13:32:42,441 INFO  - 1 - HP QC/ALM Test with id 16 has Description blank.
  • No labels