Ranorex Launcher (ranorex.jar)

The Ranorex launcher allows interfacing with Ranorex native executables.
It has been tested with Ranorex 2.


Configuration

The ranorex.xml file allows pre-configuring the launcher with some default values:


Parameter Description
General
Test root path This must indicate where are located all the executables.
This is a root path. Each test in XStudio has a canonical path that will be appended to this path.
This path MUST not include an ending slash.

Default value is: C:/Documents and Settings/keynux/Mes documents/RanorexStudio Projects/Samples


These values can be changed while creating the campaign session from XStudio.


Requirements

  • Each test in XStudio must have his dedicated .exe file. The name of the executable MUST be equal to the name of the test.

  • The interpreter is executed by the launcher using this syntax:

    "<testRootPath>/<testPath>/<testName>.exe"

    and from the working directory "<testRootPath>/<testPath>"

  • The executable will generate a .rxlog file and optionally some screenshots during its execution.
    This file MUST describe all the actions performed by the test as well as the result of each action.
    This file will be parsed by the launcher and all the information will be passed/stored automatically in the XStudio database.
    Screenshots will be uploaded to the database as well.

Tutorial: Creating and executing Ranorex tests

In this tutorial, we will learn to run a Ranorex test.


Prerequisites

All the sample tests included within the ranorex package must have been compiled.



Create a dedicated category for Ranorex tests and create a test

  • create a category Ranorex associated to the launcher ranorex.jar
  • under this category, create (somewhere in the tree) a test with name Word Pad Test and with a canonical path set to WordPad Test Sample/bin/debug.



Creating a test campaign

  • create a campaign including only the test Word Pad Test
  • create a campaign session specifying in the configuration:
    • Test root path: C:/Documents and Settings/<your login account>/<My Documents folder name>/RanorexStudio Projects/Samples



Run a campaign session

Run the campaign session