Versions: 8.0+

Versions:3.6+

QuerySurge QC/ALM Connector with Local Host Execution

Preparation

The QuerySurge QC/ALM Test Management Tool Connector needs to be installed and configured on the boxes that you plan to log into QC/ALM on. You can install the QC/ALM Test Management Tool Connector from your QuerySurge Installer (make sure to use the same installer version you used to install QuerySurge). Instructions for installing the Test Management Tool Connectors can be found here.

Setup

Note: The steps in this section can be done with any login to QC/ALM from any PC on you corporate network. Some steps in this section refer to the install directories for the QuerySurge QC/ALM Connector, so please make sure that you have access to a Connector installation.

1. Log into HP Application Lifecycle Management
   
   
   
   
2. In HP Application Lifecycle Management, click on Test Plan View
   
   
   
   
3. Click Tests->New Folder
   
   
   
   
4. Give the folder a Test Folder Name and press the OK button
   
   
   
   
5. Right Click on the folder and choose New Test
   
   
   
   
6. Enter a Test Name, make sure to choose the Type of VAPI-XP-TEST, and press the OK button
   
   
   
   
7. Click the Finish button
   
   
   
   
8. In your QuerySurge Test Management Tool Connector installation directory, open the qsapi.properties file, which, if you chose the default options while installing QuerySurge, is found in the C:\Program Files\QuerySurge\cli folder. 
   
   
   
   
9. In the file, insert a line right after # Client API and type your QuerySurge credentials, in the following form: QuerySurgeUserName=QuerySurgePassword
   
   
   
   
10. Open the sample vbs file (ALM_QC_Script.vbs), which, if you chose the default options while installing QuerySurge, is found in the C:\Program Files\QuerySurge\cli\samples folder
    
    
    
    
11. In the section between the START OF CONFIGURATION VARIABLES and END OF CONFIGURATION VARIABLES, Edit the variables to the specifics on your machine
    
    
    
    
12. Back in HP Application Lifecycle Management, click the Test Scripts tab
    
    
    
    
13. Copy the entire text found in the vbs file into the Test Scripts window:
    
    
    
    
14. Click the Save button
    
    
    
    
15. Click Test Lab
    
    
    
    
16. Choose Test Sets->New Folder
    
    
    
    
17. Give the folder a Test Set Folder Name and press the OK button
    
    
    
    
18. Right click on the folder just created and choose New Test
    
    
    
    
19. Type in a Name ("Demo Test Set" in this example) and press the OK button.
    
    
    
    
20. Click the Select Tests button
    
    
    
    
21. Navigate to your test
    
    
    
    
22. Click the "left arrow" button to add the Test to the Test Set.
    
    
    
    
23. Click the X button
    
    
    
    

Running QuerySurge from QC/ALM on a Local Host

Go to top

Note: The steps in this section must be done by a user logged into a computer where the QuerySurge QC/ALM Connector is already installed. The Connector can be installed from the QuerySurge installer.

1. Log into HP Application Lifecycle Management
   
   
   
   
2. Navigate to your test set and select Run Test Set 
   
   
   
   
3. On the Automatic Runner Dialog: Click on the Run All Tests Locally
   
   
   
   
4. Click the Run button
   
   
   
   
5. When the test finishes close the Automatic runner to view the high level results
   
   
6. Click Test Runs
   
   
   
   
7. Click the Refresh button
   
   
   
   
8. Click on your test result
   
   
   
   
9. Click on Report
   
   
   
   
10. You will see a URL provided in the Actual section, so copy and paste this result into a browser
    
    
    
    
11. Type in your QuerySurge username and password
    
    
    
    
12. You will be navigated right to the particular QueryPair you selected from HP Application Lifecycle Management
    
    
    
    
13. Click on Steps
    
    
    
    
14. Notice you will see the same URL in the Actual section as you did when you were in Report
    
    
    
    
15. Click on the paperclip next to a QueryPair
    
    
    
    
16. Click on the link to QuerySurge
    
    
    
    
17. Type in your QuerySurge username and password
    
    
    
    
18. You will be navigated right to the particular QueryPair you selected from HP Application Lifecycle Management
    
    
    
    

Troubleshooting

Go to top

Running QuerySurge from QC/ALM

This section describes post-install, post-setup issues that may occur.

User Receives an “Error loading results” error message when running a test from HP Application Lifecycle Management

Please note that this error may be related to the user not having rights to the location where the cli folder is installed (Typically: C:\Program Files\QuerySurge\cli).  Should this occur, please follow the following steps:

1. Copy the cli folder to a location where you have access (such as Documents)
   
   
   
   
2. Open up the bat file
   
   
   
   
3. Make sure that the following line is reflective of the new location of the cli folder
   
   
   
   
4. Please follow steps 9 and 10 above in the QuerySurge QC/ALM Connector with Local Host Execution Setup section on how to open the vbs file
5. Pay careful attention to change the cliPath value to reflect the location of the bat found in the location where you copied the cli folder
   
   
   
   
6. Please follow steps 11 and onward above in the QuerySurge QC/ALM Connector with Local Host Execution Setup section

VAPI-XP Test runs in QC/ALM, Pass-Fail results return, but No Steps are Created

This issue is usually related to the user permissions granted to the QC/ALM user by the QC/ALM admin.

• For QC/ALM to populate the run steps for a QuerySurge test execution the QC/ALM user login executing the test must have the appropriate QC/ALM permissions.
  
  
• QC/ALM permissions are set at the group level in the Project Customization section. Make sure that the correct ALM users are in the group whose permissions are modified for use with QuerySurge.
  
  
• In the QC/ALM Project Customization section, choose Groups and Permissions. Select Test Lab permissions. Choose a group that your QC/ALM users are in, and assign permissions for Create and Update rights, for the following:
• Result
• Run
• Run Step
• Test Instance
• Test Set
• Test Set Folder
  
  
• Make sure to Save your changes.

Note: Newer ALM versions will have more "child" options than previous QC/ALM versions (which may have no child options). Some of these will interact with higher-level choices, so selecting Create or Update will automatically configure the child options.

In the sample image below, a Group has been created by a QC/ALM Admin user for QC/ALM users who will execute QuerySurge VAPI-XP tests. This Group, called "QuerySurge Tester" has Test Lab permissions assigned as described above.