Graphical User Interface - studio

Purpose

The OneTest Embedded Graphical User Interface (GUI) is an integrated environment that provides access to all of the capabilities packaged with the product.

Syntax

studio [<options>] [<filename>{ <filename>}]

studio <.jpt file> <.txf file> <.tpf file>

where:

Options

-r <node>

where <node> is a project node to be executed.

The -r option launches the GUI and automatically executes the specified node. Use the following syntax to indicate the path in the Project Explorer to the specified node:

<workspace_node>{[.<child_node>]}

 

Nodes in the path are separated by period ('.') symbols. If no node is specified, the GUI executes the entire project.

When using the -r option, an .rtp project file must be specified.

-html <directory>

where <directory> is an output directory for HTML reports.

When used with the -r option, the -html  option directly outputs all reports in HTML format to the specified directory.

-config <configuration>

where <configuration> is a valid Configuration name.

The -config option allows you to specify a particular Configuration which is used when the studio GUI is opened. When combined with the -r option, you can build and execute any particular node with any particular Configuration.

Example

The following command opens the project.rtp project file in the GUI, and runs the app_2 node, located in app_group_1  of user_workspace:

studio -r user_workspace.app_group_1.app_2 project.rtp

 

The following example opens a UML sequence diagram created by Runtime Tracing.

studio my_app.tsf my_app.tdf

 

Return Codes

After execution, the program exits with the following return codes

 

Code

Description

0

Execution of the project failed

1

Execution succeeded

5

Execution did not complete

 

These codes help you decide on a course of action after studio has finished running the test. You can obtain these return codes after execution with the following methods:

Windows:

studio -r -config test.rtp

echo  "Build Result : " %ERRORLEVEL%

UNIX:

studio -r -config test.rtp

echo  "Build Result : " $?

 

All messages are sent to the standard error output device.