Integrating and running performance test scripts in Micro Focus ALM

You can integrate Micro Focus Application Lifecycle Management (ALM) by using a readily available template from the installation directory of IBM® Rational® Performance Tester to run performance test scripts and obtain test result details.

About this task

You must copy the contents of the template to a new VAPI-XP VBScript test script in Micro Focus ALM, add your test script details into the VAPI-XP VBScript test script, and then run the test script.
Note: For more information about supported environments, refer to Micro Focus ALM System Requirements.

Procedure

  1. Navigate to the following installation directory of Rational® Performance Tester: IBM\SDP\alm.

    You can use PT_ALM_Windows.txt file for performance test scripts.

  2. Copy the contents of the template.
  3. Log in to the Micro Focus ALM portal, if you are not already logged in.
    The Micro Focus ALM dashboard is displayed.
  4. Create an new integration test from the Micro Focus ALM dashboard by performing the following actions:
    1. Expand Testing from the left pane and then click Test Plan.
    2. Expand Integration.
    3. Right-click Integration and click New Test to create a new test.
    4. Enter a test name in the Test Name field.
    5. Select VAPI-XP-TEST as test type from the Type drop-down list.
    6. Click OK.

      The VAPI-XP Wizard is displayed.

    7. Select a test script language by performing the following steps:
      1. Select VBScript from the Script Language drop-down list.
      2. Enter a script name (for example, script) in the Script Name field.
      3. Click Next and select a test type if required.
        Note: The COM/DCOM Server Test test type is already selected as a test type.
      4. Click Finish.

      The test is created.

  5. Click the Test Script tab.
  6. Paste the content of the template that you copied in step 2 to the test script.
  7. Enter the test details in the VAPI-XP Vbscript test script by referring to the following table:
    Parameters Descriptions
    Workspace Required. The complete path to the Eclipse workspace.
    Project Required. The path, including the file name of the project relative to the workspace.
    TestsuiteName Required. The path, including the file name of the test to run relative to the project.
    IMSharedLocation Optional. The complete path to IBMIMShared location.
    Varfile Optional. The complete path to the XML file that contains the variable name and value pairs.
    Configfile Optional. The complete path to a file that contains the parameters for a test or schedule run.
    ResultsFile Optional. The name of the result file. The default result file is the test or schedule name with a time stamp appended.
    OverwriteResultsFile Optional. Determines whether a result file with the same name is overwritten. The default value is true, which means the result file can be overwritten.
    Users Optional. For a schedule, the default value is the number of users specified in the schedule editor. For a test, the default value is one user. Overrides the default number of users, if required.
    VMArgs Optional. You can use this parameter to pass Java™ virtual machine arguments.
    DatasetOverride Optional. For a test, the default value is the dataset specified in the test editor.

    You must use the Dataset Override option to replace the dataset values during a test or schedule run. You must ensure that both original and new datasets are in the same workspace and have the same column names. You must also include the path to the dataset.

    For example, /project_name/ds_path/ds_filename.csv:/project_name/ds_path/new_ds_filename.csv

    You can swap multiple datasets that are saved in a different project by adding multiple paths to the dataset separated by a semicolon (;).
    ResourceMonitoringLabelsOverride Optional. For a schedule (Rate schedule or VU schedule), use ResourceMonitoringLabelsOverride to perform any of the following actions:

    • To enable the Resource Monitoring from Service option for a performance schedule if the Resource Monitoring from Service option is not enabled from the schedule editor in Rational® Performance Tester.

    • To ignore Resource Monitoring sources that were set in the performance schedule and to change for a label matching mode.

    • To replace an existing set of Resource Monitoring labels that were set in the performance schedule and run the schedule with a new set of Resource Monitoring labels.

    Note: You can add multiple Resource Monitoring labels separated by a , (comma).
    Important: You must add the Resource Monitoring labels to the Resource Monitoring sources on the Resource Monitoring page in your Rational® Test Automation Server project.
    ExportStatsFile Optional. The complete path to a directory that you can use to store exported statistical report data.
    ExportStatReportlist Optional. A comma-separated list of absolute paths to custom report format files (.view files) that you can use to export statistical report data with ExportStatsFile.
    ExportStatsHtml Optional. The complete path to a directory that you can use to export web analytic results. The results are exported to the specified directory. You can analyze the results on a web browser without using the test workbench.
    UserComments Optional. You can add text within the double quotation mark to display it in the User Comments row of the report.
  8. Run the VAPI-XP Vbscript test script.

Results

You have integrated and run performance test scripts in Micro Focus ALM.

What to do next

The test result details are displayed in the Output window of Micro Focus ALM.