Skip to main content

skip to main content

developerWorks  >  Rational  >

Integrating IBM Rational Test RealTime with TestManager

developerWorks
Document options

Document options requiring JavaScript are not displayed

Discuss


Rate this page

Help us improve this content


Level: Introductory

Fiona Foster (ffoster@ca.ibm.com), Software Developer, IBM

27 Jan 2004

You can execute IBM Rational Test RealTime tests and view results from within TestManager. This tutorial gets you started.

IBM® Rational® Test RealTime is a great tool for component testing and runtime analysis across platforms. Integrating it with IBM Rational TestManager (on Microsoft Windows® installations only) enables you to manage test execution more easily and to view test and runtime analysis results through the TestManager test log. You can associate TestManager test inputs via test cases with Test RealTime test nodes and group nodes. This article takes you step by step through the process of enabling the integration, configuring the project, creating and running a test case, and viewing results. It also gives some troubleshooting pointers.

Editor's Note: This article is based on Version 2003.06.12.043.001 of Test RealTime and Version 2003.06.12 of TestManager.

Installing the programs and enabling the integration

For the integration to work properly, TestManager and Test RealTime must be installed on the same workstation. TestManager must be installed first; otherwise, Enable Rational Project TestManager Integration won't appear in the Test RealTime Tools menu.

Before you can use the two products together, you must enable the integration as follows:

  1. From the Windows Start menu, select Programs > Rational Software > Test RealTime > Tools > Enable Rational Project TestManager Integration.
  2. Click OK in the resulting dialog.

Figure showing resulting dialog

Note that you must not be running TestManager when you enable the integration.



Back to top


Configuring the project

Before you can use the integration, you need to set some configuration properties in Rational Administrator.

Creating a new project

First you create a new project.

  1. Launch Rational Administrator by selecting Start > Programs > Rational Software > Rational Administrator.
  2. Create a new project by selecting File > New Project. The New Project - General window appears.

Figure showing General window

  1. Enter a name and a location for the project and click Next. (Note that the project location must be an empty directory; otherwise, a dialog box asking you to specify an empty directory will be displayed. Note also that if you want other users to be able to access the Rational project over the network, you must use a shared directory and specify the pathname in UNC format.) This opens the New Project - Security window.

Figure showing the Security window

  1. Click Next without specifying a password. This opens the New Project - Summary window.

Figure showing the Summary window

  1. Make sure that "Configure Project Now" is checked and click Finish.

Creating a test asset

Now you need to create a test asset.

  1. In the Configure Project window, click Create under "Test Assets."

Figure showing Test Assets

  1. You'll be prompted to select the type of datastore -- either SQL or Microsoft Access. Choose Microsoft Access and click Next.

Prompt to select the type of datastore

  1. Specify the datastore path. By default this field contains the project location directory followed by a subdirectory called TestDatastore. You can accept the default or click Browse to select a different location.

Figure showing datastore path

  1. Keep the defaults in "Initialization Options" and click Next.

Figure showing default values

  1. You're then presented with a Test Datastore summary box that shows all the options you entered in the previous setup screens. Click Finish.

The Test Datastore summary box

  1. The Test Datastore will then be created. Click OK in the resulting dialog.

Figure showing the resulting dialog

  1. You'll be taken back to the Configure Project window, where the "Test Assets" field has been populated with the Test Datastore that you just created. Click OK and exit Rational Administrator.

Figure showing the Rational Administrator



Back to top


Creating a test case

Now you'll create a test case in Rational TestManager and associate it with a Test RealTime project.

  1. Launch Rational TestManager by selecting Start > Programs > Rational Software > Rational TestManager.
  2. On the Rational Test Login screen, click OK. (You don't need to enter a password since you didn't specify one when you created the new project.)

Rational Test Login screen

  1. Once TestManager is open, expand Test Plans in the left pane.

Expanding Test Plans in the left pane

  1. Right-click Test Plan 1 and select Open.

Figure showing Test Plan 1

  1. In the left pane expand Iterations, and in the right pane highlight the folder Default.

Highlighting the folder Default

  1. Right-click the folder Default and select Insert Test Case.

Figure showing selected Insert Test Case

  1. In the New Test Case dialog on the General tab, enter a name for the test case. (In this example, I used "foo3.")

Figure: naming the test case

  1. Click the Implementation tab. Under "Automated implementation," click Select. From the list of available implementations, select Rational Test RealTime.

The Implementation tab

  1. To select the Test RealTime project, click the Browse button in the Rational Test RealTime Test Selection dialog and go to the location where the project is saved, then click Open. The Test RealTime Project field will be populated with the location and name of the Test RealTime project.
  2. Click Open again so that the Test Node/Group Node box is populated. Then expand ChainedList and highlight BasicTest.

Figure showing highlight BasicTest

  1. Click OK in the Test RealTime Test Selection dialog, then click OK again in the New Test Case dialog.



Back to top


Running a test case

Now you'll run the test case you just created.

  1. In the right pane of the Rational TestManager window, right-click the name of the test case you just created (in this example, "foo3") and select Run.

Figure showing Run selected

  1. In the Run Test Cases dialog, click OK.

Figure showing Run Test Cases dialog

The test is then executed:

Figure showing Run Test Cases dialog
(click here to enlarge)



Back to top


Viewing test results

Now you'll access the test results in the Test RealTime GUI through the TestManager test log.

At the end of test execution, you should see something like the following. This is the Test Case Results tab of the Test Log pane.

Test Case Results tab of the Test Log pane

  1. In this pane, click the Details tab at the bottom.

Figure showing the Details tab
(click here to enlarge)

  1. Right-click User Defined in the "Event Type" box and click Properties.

Figure showing properties selected
(click here to enlarge)

  1. In the resulting dialog, click the View Test RealTime Logs tab.

Figure: Test RealTime Logs tab

  1. Click Open. The Test RealTime GUI is then launched and graphical reports are displayed.



Back to top


Troubleshooting

Here are some pointers on how to solve common problems:

  • Once the test has finished executing, when I try to view the reports through the Detail tab, Test RealTime launches but no graphical results are shown.

When you select the Test RealTime project, it's important for you to also select a test node (as shown below). If you don't select a test node, the test will pass but no reports will be generated and no results will be loaded into Test RealTime.

a test node

  • In configuring the test case properties, when I click Select under "Automated implementation," the General Data Store error is displayed.

There are two possible causes of this error:

  1. The TestRTConsoleAdapter.dll has been placed in Rational\Rational Test\tsea instead of ...\Rational\Rational Test.
  2. The wrong version of the TestRTConsoleAdapter.dll file has been installed. For example, in Test RealTime Version 2003.06.00, by default the 2003.06.00 file hasn't been replaced by the Test RealTime Version 2003.06.12 file.
  • In configuring the test case properties, when I click Select under "Automated implementation," Rational Test RealTime doesn't show up in the list of available implementations.

When Test RealTime isn't available as an automated implementation, it means that the integration hasn't been enabled for the project. Enable the integration by going to the Windows Start menu and selecting Programs > Rational Software > Test RealTime > Tools > Enable Rational Project TestManager Integration. You'll see this dialog if the integration is successful:

Enable the integration

Test RealTime should now be in the list when you click Select under "Automated implementation."

This problem can also occur if you tried to enable the integration while TestManager was running. You must not be running TestManager when you enable the integration.



Back to top


Resources



About the author

Fiona Foster has worked for IBM Rational as a software developer since July 2000, first supporting the Rational Rose RealTime product and more recently supporting the Test RealTime product by writing tech notes and white papers and delivering training. She can be reached by e-mail.




Rate this page


Please take a moment to complete this form to help us better serve you.



 


 


Not
useful		Extremely
useful
 


Share this....

digg Digg this story del.icio.us del.icio.us Slashdot Slashdot it!



Back to top