Testing with Rational Integration Tester

Before you begin

To be able to work with Integration Tester tests, you must install Rational Performance Tester Extension for Rational Integration Tester with Rational Performance Tester. You also need a Rational Performance Tester agent and a Rational Integration Tester agent to execute the tests on remote. Moreover, if you update a Rational Integration Tester test in Rational Performance Tester and want to apply the updates to Rational Integration Tester, you must installRational Integration Tester and define the path to the installation directory to set a connection to the Integration Tester workbench.

Connecting to an existing Integration Tester project

A project must have been created in Rational Integration Tester with the tests. Connection to a Rational Integration Tester project does not copy, nor duplicate the project. But any change or delete action made in one product workspace is reflected on the other product workspace, if Rational Integration Tester is installed on your machine.

Warning: If you delete an Integration Tester project from the Test Navigator, be sure that the option Delete project contents on disk is not selected in the Delete Resources dialog, otherwise the project would be deleted in Rational Integration Tester if it is connected.

• In Rational Performance Tester test workbench, right-click on the Test Navigator, select New > Others > Integration Tester > Integration Tester > Connect to an Integration Tester Project and click Next.

  

• In the wizard page, click Browse and select the root folder that contains the project.

  If the path contains an Integration Tester project, its name should automatically appear in Project Name and the Finish button should be enabled.

• In When project is connected, you have to perform one of the following actions:
  • Click Do nothing to only import the project.
  • Click Open Create Performance Schedule wizard to select the test from Rational Integration Tester, create a Schedule, and add the test to the Schedule.
  • Click Open Create Compound Test Wizard to select the test from Rational Integration Tester, create a Compound test, and add the test to the Compound test.

    For example: select the Open Create Performance Schedule wizard action and click Next.

    The Create Performance Schedule for Integration Tester wizard displays the list of Integration tests contained in your project.

  • Select one or more tests and click Next.
  • In Schedule File Name and Location wizard, select a schedule in an existing Performance Tester project, or create it from this window. You just need to enter a name for the new schedule and click Finish. The procedure is the same for the compound test.
  • The Test Navigator displays the projects:

    • The Integration Tester project you are connected to, or that you imported, with the tests.
    • The Performance Tester project containing the schedule or compound test. The schedule or compound test contains the selected Integration Tester tests. If Rational Integration Tester is installed, Connected is indicated near the name of the project in the Test Navigator. The Schedule or compound test automatically opens in the dedicated editor.

    

    

Setting Integration Tester preferences

Opening Integration Tester resources from the Test Navigator

• Once the preferences are set, you can open an Integration Tester project.
• In the Test Navigator, open the project root node and children nodes, and at any level, right-click and select Open in Integration Tester Workbench.
  

  If Rational Integration Tester is automatically detected, the Integration Tester workspace opens on the selected resources.

  If Rational Integration Tester workbench is not detected, a dialog opens on a preference page where you need to verify the path to Rational Integration Tester execution file.

• Warning: Rational Integration Tester cannot open more than one project at a time. If you have another project open in Rational Integration Tester, you will get an error. In that case, close Rational Integration Tester and try to open the project from Rational Performance Tester Test Navigator.

Importing Integration Tester project

If Rational Integration Tester is not installed on the same machine with Rational Performance Tester you can import an Integration Tester project in your workspace. Another reason for importing an Integration Tester project, is when you have Rational Integration Tester installed but you don't want to connect to the Integration Tester project. In that case, the project is duplicated, any updates in one product workspace won't reflect in the other product workspace.

• To import an Integration Tester project:
• Right-click on the Test Navigator, choose Import and select Existing project into workspace.
• Choose Select root directory or Select archive file; select a project to import and click Finish.

  The selected project appears in the Test Navigator and the compound test or schedule editor automatically opens.

Modifying Integration Tester environments in Performance Tester workbench

In the schedule or compound test, you can select other Integration tester tests, and change the environment of each Integration test individually. The environments are set in Rational Integration Tester, you can only change the selection from the edited schedule or compound test.

• Open the schedule or compound editor and select an Integration Tester test.
• In the Integration Test details, you can browse and change the selected Integration Tester test. The Test path, the Environments and Decription are automatically updated accordingly.
  
• To select another environment for the Integration Tester test, use the dropdown menu.

Alternatively, you can change the environment selection for an Integration Tester test for a collection of tests:

• Right-click on the tree at any level under a node in the schedule or compound test and select Replace Integration Tester Environments.
• In the Set Invocation Tester Environments wizard, the first page displays the list of projects that use the selected environment and the number of tests from Integration Tester project that use this environment in the schedule or compound test.
  
• Select another used environment in the dropdown list. Click Finish. The new choice applies to the selected node and its children.

Next step is to create a compound test or schedule in Performance Tester to run the Integration tests, see Creating a schedule and Creating a compound test.

You can add a datapool mapper in the compound test or schedule for tests that are using multiple tags. See Adding Datapool Mapper to map tags in the Integration Tester tests with the variable values of Performance Tester.