Introduction to Custom Test Script Types |
A TSEA can support test script options. The API calls that support options, documented in the next chapter, are: SessionSetOption()
, SessionGetOption()
, TaskSetOption()
, and TaskGetOption()
.
If a TSEA supports test script options, TestManager users can set or display the values of the options as explained below. Also, a test script (or other application) can get the current value of an option using TSSGetScriptOption()
.
Whether or not a TSEA uses test script options, a TestManager user can define and use new options. For example, a user can:
repeat_count
and assign it the value 3.
TSSGetScriptOption()
, and branch based on the returned value of the option.
Test script options can be set at these levels of generality, where 1 is the highest:
The Test Script Execution Engine implements identically-named options hierarchically, with lower level settings overriding higher level settings. Thus, if you set the option named repeat_count
to a different value at each of the levels listed above, the lower level settings override the higher level settings:
Conversely, if you set an option only at the Test Script Type level, that setting will apply globally for this type of test script. Thus, if you set the option named repeat_count
to the value 3 and the Test Script Type level, the option will have this value in all instances.
To edit a test script option from Test Manager at the Test Script Type level:
A test script source is a location where designated test scripts are stored. To edit a test script option at the Test Script Source level:
To edit a test script option at the Test Script Asset level:
The Test Script Options dialog box opens. Set or change the desired option values as explained in Setting or Viewing Option Values.
To edit a test script option for a script instance in a suite:
To edit a test script option for a test case instance:
You edit test script options from the Test Script Options dialog box. To open this dialog box, in TestManager, click View > Test Scripts. Right-click a test script type, test script source, or test script, and then click Test Script Options.
To set a new option value, type its name in the Option Name column and its value in the corresponding Option Value column, and click OK. To change an existing option setting, click the Option Value column of the appropriate row, type its value, and click OK.
Rational TestManager Extensibility Reference | Rational Software Corporation |
Copyright (c) 2003, Rational Software Corporation | http://www.rational.com support@rational.com info@rational.com |