Rational Quality Manager and Rational RequisitePro Integration

Content

This whitepaper contains the following sections:

How to configure the Rational Quality Manager integrations

Troubleshooting, Tips and Tricks summary

Known issues and Solutions

Improvements in Rational Quality Manager 2.0

Additional Resources

Important: To achieve better performance and feature improvements, Users with Rational Quality Manager 1.0.1.1 and RequisitePro7.1.0.x should upgrade RequisitePro to 7.1.0.2 ifix01 first, then contact the IBM Rational Support to get the Rational Quality Manager 1.0.1.1 patch. The details of the patch can be found in the “Known issues and Solutions” section.

1. Log in to the Jazz administration page, then go to Admin -> Jazz Server Administration -> Advanced Properties, and make sure the Rational Quality Manager Repository URL is correct.
   
   
   
   
   
2. Set up RequisitePro connection on System Properties,
3. Select ADMIN> System Properties from the top right corner of the drop down box.
4. Click on RequisitePro Host Properties from the list box on the left.
5. Click on the green “+” sign to add new connection.
6. Fill in required URL of RequisitePro Server. For example: http://<RequisitePro Server IP>:11080 and https://<RequisitePro Server IP>:11443
7. Click on the ()connection icon, and make sure the connection is set up successfully.
   
   
   
   
   
8. Setup RequisitePro connection on Import Requirement(s) dialog.
9. Navigate to Requirement> Import Requirement(s) page.
10. Click on the radio button of ‘Import from an external requirement system (Rational RequisitePro)’, then click on button ‘Browse’ .
11. Fill in the required RequisitePro connection URL, like ’http://<RequisitePro Server IP>:11080’, click Next.
12. As all RequisitePro Web projects appear, this connection has been set up successfully.
    
    Note: If the connection to the RequisitePro server has already been established, you can simply select the URL. You can set up the connection to the RequisitePro server in advance by following step 2 above.
    
    
    
13. After import successfully, Point to the Requirements icon (), and click View Requirements. The requirements you imported display in the Requirements editor.
14. Synchronization In schedule.
15. Set up Synchronization interval time in ‘Admin -> Jazz Server Administration -> Advanced Properties’.
    
    
    
    
16. Synchronization Manually.
17. Check on the connection which you want to synchronize with RequisitePro.
18. Click on ‘Synchronize Now’ button, the following pop-up box appear :
    
    
    
    
    
19. Click the Yes button, when the synchronization is in progress dialog pops up.
    
    
    
    
    

    Back to top

Troubleshooting, Tips and Tricks

Importing Requirements

See this topic in the Rational Quality Manager Information Center on how to Import Requirements from Rational RequistePro into Rational Quality Manager.


Technotes

Review the following Technotes regarding related issues between Rational Quality Manager and Rational RequistePro integrations:

Known Issues and the Solutions

There are known issues are addressed in the following test fix for RequisitePro 7.1.0.2 ifix01 and Rational Quality Manager 1.0.1.1. This test fix will be included in the future release of Rational Quality Manager 1.0.1.2. The fixes are already included in the released Rational Quality Manager 2.0. Please contact IBM Rational Support to get this patch.

Problems adressed in this patch:

1. Deleted RequisitePro requirements still show up in Rational Quality Manager. After applying the patch, the deleted requirements will be marked with deleted icons on the requirement list.
2. Querying requirements is slow. It takes much less time to query the same requirements after the patch.
3. Getting error during large number of requirements "Error: 500 Post too large".
4. Rational Quality Manager fails during import requirements, with a UTF-8 error regarding parsing. RequisitePro REST API return invalid xml to Rational Quality Manager...This patch provides a filter to escape these invalid characters for RequisitePro.
5. Rational Quality Manager didn't handle the "empty string" requirement name correctly

Instructions on how to apply the fix:

1. Stop Rational Quality Manager server.
2. Back up Rational Quality Manager 1.0.1.1 original jars
3. Apply the patch.
4. Delete the Catalina directory under the C:\Program Files\IBM\RQM20\server\tomcat\work\
5. Delete the RequisitePro connection
6. Recreate a new RequisitePro connection and try to import again

Additional Improvements in Rational Quality Manager 2.0

The above known problems are fixed in Rational Quality Manager 2.0. In addition to the performance improvements, Rational Quality Manager 2.0 also provides the following major feature improvements:

Rational Quality Manager 2.0 supports multiple-select in requirement view. Navigate to Requirement> View Requirements. Users can multiple-select requirements. For example: After clicking the synchronization button, only requirement status is changed - 'normal', 'updated' or 'deleted'. Users need to 'Reset status' to fetch/see the latest data and also it will clear up related test case's suspect status automatically. In 1011, users have to reset it one by one. In 2.0, they can select many requirements and reset them in one time.

Rational Quality Manager 2.0 can archive requirements, so after delete, they will not remain in the requirement view. Check on one or more requirements, click on ‘Delete’ button to ‘archive requirements’, and select ‘Yes’.

Other Resources on this Topic in the Rational Quality Manager 1.0.x Information Center

• Managing requirements in your test plan
• How to integrate
• How to import