org.safs.rational

Class Script

java.lang.Object

com.rational.test.ft.script.DatapoolScriptSupport

com.rational.test.ft.script.SubitemFactory

com.rational.test.ft.script.RationalTestScript

org.safs.rational.Script

All Implemented Interfaces:

com.rational.test.ft.script.IObjectManagerEventListener, com.rational.test.ft.script.RationalTestScriptConstants

public abstract class Script
extends com.rational.test.ft.script.RationalTestScript

Extends RationalTestScript, and primarily makes many of its protected methods public so that we can use them.

Custom scripts invoked via the CallScript Driver Command should get a reference to the topmost executing script which will be a subclass of this org.safs.rational.Script class.

Below is the sample code for such a custom script:

 (existing imports)
 import org.safs.*;
 import org.safs.rational.*;
 import org.safs.rational.logging.RLogUtilities;
 ...
 public void testMain(Object[] args) 
 {
           Log.info("Custom Script beginning execution...");
           try{
                        // get reference to SAFS\RFT Hook
                        Script safs = (Script) getScriptCaller(); 
                        RLogUtilities safslog = safs.getLogUtilities();
                        RRobotJHook hook = safs.getRobotJHook();
                        RTestRecordData testdata = hook.getRTestRecordData();
                        STAFHelper staf = hook.getHelper();
                        
                        // do real stuff like getting values from SAFSVARS                      
                        String value = staf.getVariable("varname");

                        // sample of writing to the running test log 
                        String logname = testdata.getFac();
                        safslog.logMessage(logname, "CustomScript received varname value:"+ value);
                        safslog.logMessage(logname, "CustomScript changing the varname value to: somevalue");
 
                        // do real stuff like setting values in SAFSVARS                        
                    staf.setVariable("varname", "somevalue");
                }catch(Exception x){
                    Log.error("An error occurred in my custom script:"+ x.getMessage(),x);      
                }       
 }
...
 Then play with SAFS stuff as much as necessary.
 

Since:

JUN 24, 2003
JUN 24, 2003 (DBauman) Original Release
FEB 11, 2008 (Carl Nagle) Updated for CallScript usage.
JUN 24, 2009 (Carl Nagle) Updated doc for custom script usage

Author:

Doug Bauman

Field Summary

Fields

Modifier and Type	Field and Description
protected RRobotJHook	_hook
protected RLogUtilities	_logUtils
static int	count
static int	info

Fields inherited from class com.rational.test.ft.script.RationalTestScript

ANY, DEFAULT_ARGS

Fields inherited from class com.rational.test.ft.script.DatapoolScriptSupport

DP_ALL, DP_DEFAULT_EQUIVALENCE_CLASS, DP_SHARE_CURRENT_RECORD

Fields inherited from interface com.rational.test.ft.script.RationalTestScriptConstants

ALT_LEFT, ALT_MIDDLE, ALT_RIGHT, ALT_SHIFT_LEFT, ALT_SHIFT_MIDDLE, ALT_SHIFT_RIGHT, ARROW, BACK_BUTTON, BACKGROUND, BOTTOM_EDGE, CAPTION, CHECK, CHECKBOX, CLOSE_BUTTON, COLLAPSE, COLLAPSE_AND_EXTEND_SELECT, COLLAPSE_AND_SELECT, CONTEXTHELP_BUTTON, CTRL_ALT_LEFT, CTRL_ALT_MIDDLE, CTRL_ALT_RIGHT, CTRL_ALT_SHIFT_LEFT, CTRL_ALT_SHIFT_MIDDLE, CTRL_ALT_SHIFT_RIGHT, CTRL_LEFT, CTRL_MIDDLE, CTRL_RIGHT, CTRL_SHIFT_LEFT, CTRL_SHIFT_MIDDLE, CTRL_SHIFT_RIGHT, DEFAULT, DEFAULT_FLAGS, DESELECT, DESELECT_ALL, DISABLE_LOGGING, DISABLED, DROPDOWN, ENABLE_LOGGING, ENABLED, EXPAND, EXPAND_AND_EXTEND_SELECT, EXPAND_AND_SELECT, EXTEND_SELECT, HEADER_ICON, INDETERMINATE, LEFT, LEFT_EDGE, LOADED, LOADING, LOG_DISABLE_GUI_ACTION, LOG_DISABLE_GUI_SNAPSHOT_ACTION, LOG_ENABLE_GUI_ACTION, LOG_ENABLE_GUI_SNAPSHOT_ACTION, LOG_FAILURES, LOG_FAILURES_WARNINGS, LOG_FAILURES_WARNINGS_PASS, LOG_FAILURES_WARNINGS_PASS_INFO, MAXIMIZE_BUTTON, MAY_EXIT, MIDDLE, MINIMIZE_BUTTON, MONTH, NO_FLAGS, NO_STATE, NOT_SELECTED, NOT_SHOWING, PARENTROWS, PLUS_MINUS, POPUP, READY, RIGHT, RIGHT_EDGE, SCROLL_DOWN, SCROLL_DOWNBUTTON, SCROLL_ELEVATOR, SCROLL_HORIZONTAL_ELEVATOR, SCROLL_LEFT, SCROLL_LEFTBUTTON, SCROLL_LINEDOWN, SCROLL_LINELEFT, SCROLL_LINERIGHT, SCROLL_LINEUP, SCROLL_PAGEDOWN, SCROLL_PAGELEFT, SCROLL_PAGERIGHT, SCROLL_PAGEUP, SCROLL_RIGHT, SCROLL_RIGHTBUTTON, SCROLL_UP, SCROLL_UPBUTTON, SCROLL_VERTICAL_ELEVATOR, SELECT, SELECTED, SHIFT_LEFT, SHIFT_MIDDLE, SHIFT_RIGHT, SHOWHIDE_BUTTON, SHOWING, SINGLE_SELECT, SYSTEM_MENU, THUMB, TODAY, TOP_EDGE, UNCHECK, UNDETERMINED, UNINITIALIZED, VERSION, YEAR

Constructor Summary

Constructors

Constructor and Description
Script()

Method Summary

Modifier and Type	Method and Description
protected com.rational.test.ft.vp.IFtVerificationPoint	Dummy_contentsVP() Locate and return the verification point Dummy_contents object in the SUT.
protected com.rational.test.ft.vp.IFtVerificationPoint	Dummy_contentsVP(com.rational.test.ft.object.interfaces.TestObject anchor)
RDDGUIUtilities	getGuiUtilities() Used internally and made available to scripts invoked by the CallScript Driver Commands.
RLogUtilities	getLogUtilities() Used internally and made available to scripts invoked by the CallScript Driver Commands.
RRobotJHook	getRobotJHook() Used internally and made available to scripts invoked by the CallScript Driver Commands.
STAFHelper	getSTAFHelper() Used internally and made available to scripts invoked by the CallScript Driver Commands
RTestRecordData	getTestRecordData() Used internally and made available to scripts invoked by the CallScript Driver Commands.
static com.rational.test.ft.script.Cell	localAtCell(com.rational.test.ft.script.Column c, com.rational.test.ft.script.Row r)
static com.rational.test.ft.script.Column	localAtColumn(int i)
static com.rational.test.ft.script.Column	localAtColumn(java.lang.String key)
static com.rational.test.ft.script.Column	localAtColumn(java.lang.String key, java.lang.Object val)
static com.rational.test.ft.script.Column	localAtColumn(java.lang.String key1, java.lang.Object val1, java.lang.String key2, java.lang.Object val2)
static com.rational.test.ft.script.Column	localAtColumn(java.lang.String key1, java.lang.Object val1, java.lang.String key2, java.lang.Object val2, java.lang.String key3, java.lang.Object val3)
static com.rational.test.ft.script.Index	localAtIndex(int index)
static com.rational.test.ft.script.List	localAtPath(java.lang.String path)
static java.awt.Point	localAtPoint(int row, int col)
static com.rational.test.ft.script.Row	localAtRow(int i)
static com.rational.test.ft.script.Row	localAtRow(java.lang.String key, java.lang.Object val)
static com.rational.test.ft.script.Row	localAtRow(java.lang.String key1, java.lang.Object val1, java.lang.String key2, java.lang.Object val2)
static com.rational.test.ft.script.Row	localAtRow(java.lang.String key1, java.lang.Object val1, java.lang.String key2, java.lang.Object val2, java.lang.String key3, java.lang.Object val3)
static com.rational.test.ft.script.Text	localAtText(java.lang.String name)
void	localCallScript(java.lang.String script)
java.lang.String	localGetenv(java.lang.String name) Purpose: Gets the value of an environment variable.
void	localLogError(java.lang.String error)
void	localLogInfo(java.lang.String info)
void	localLogTestResult(java.lang.String message, boolean passed)
void	localLogTestResult(java.lang.String message, boolean passed, java.lang.String description)
void	localLogWarning(java.lang.String warning)
com.rational.test.ft.object.interfaces.ProcessTestObject	localRun(java.lang.String command, java.lang.String workingDirectory) Purpose: Provides the basic command-line execution functionality.
com.rational.test.ft.object.interfaces.ProcessTestObject	localRunJava(java.lang.String main, java.lang.String classpath, java.lang.String workingDirectory, java.lang.String jvm, java.lang.String jvmOptions) Starts a Java application with the specified options.
void	localUnregister(java.lang.Object[] testobjects)
void	localUnregisterAll()
com.rational.test.ft.vp.IFtVerificationPoint	localVp(java.lang.String name)
protected void	processArgs(java.lang.Object[] args) Process any -args passed into subclasses storing each as a System.property.
void	testMain(java.lang.Object[] args)

Methods inherited from class com.rational.test.ft.script.RationalTestScript

callScript, callScript, callScript, callScript, callScript, callScript, cleanup, derefAll, doesVariablesManagerExist, downloadProjectFiles, dpNext, find, find, getApplications, getBrowsers, getCurrentBrowser, getCurrentJVM, getCurrentProject, getCurrentScriptIterationCount, getDomains, getenv, getJVMs, getLineNumber, getLineNumber, getMap, getMap, getMappedTestObject, getOperatingSystem, getOption, getProject, getProjectByLocation, getRegisteredTestObjects, getRootTestObject, getScreen, getScriptArgs, getScriptCaller, getScriptDefinition, getScriptName, getSimplifiedAction, getSimplifiedScriptLine, getSystemClipboard, getTimerValue, getTopScript, getTopScriptLineNumber, getTopScriptName, getTopWindows, getVariablesManager, getVersion, getVisualScriptTestElements, isApplicationDefined, isBrowserDefined, isJVMDefined, isMainScript, logError, logError, logException, logInfo, logInfo, logTestResult, logTestResult, logWarning, logWarning, objectAtPoint, onAmbiguousRecognition, onCallScriptException, onInitialize, onObjectNotFound, onRecognitionWarning, onRun, onSubitemNotFound, onTerminate, onTestObjectMethodException, onUnexpectedActiveWindow, onUnhandledException, onVpFailure, resetInvocationTimeout, resetOption, resetTOCreationUnregisterCounts, run, runJava, runMain, runMain, runMain, runMain, runMain, runMain, setCurrentBrowser, setCurrentJVM, setCurrentLogFilter, setDatapool, setenv, setInvocationTimeout, setOption, setOption, setOption, setOption, setOption, setOption, setScriptName, setSimplifiedScriptLine, shellExecute, sleep, startApp, startApp, startBrowser, startBrowser, stop, stopTimer, timerStart, timerStop, trimStackTrace, unregister, unregisterAll, unsetenv, updateTOCreationCount, updateTOUnregisterCount, vp, vp, vpDynamic, vpDynamic, vpManual, vpManual

Methods inherited from class com.rational.test.ft.script.SubitemFactory

_S, atArea, atButton, atButton, atCell, atCell, atChild, atChild, atChild, atColor, atColumn, atColumn, atColumn, atColumn, atColumn, atColumn, atColumn, atColumnHeader, atDate, atDate, atDescendant, atDescendant, atDescendant, atDPoint, atDPosition, atFile, atFile, atHeader, atHref, atId, atImage, atImage, atIndex, atLink, atLink, atList, atList, atList, atList, atList, atLocation, atModifiers, atName, atName, atPath, atPoint, atPosition, atProperty, atRecognitionIndex, atRow, atRow, atRow, atRow, atRow, atRow, atRow, atRowColumnIndex, atRowHeader, atSeparator, atText, atText, atTextPosition, atToolTipText, atToolTipText, atTopLeftHeader, atValue, atWeek, atWeekDay, delay, keyDown, keyUp, leftMouseButtonDown, leftMouseButtonUp, middleMouseButtonDown, middleMouseButtonUp, mouseMove, mouseWheel, rightMouseButtonDown, rightMouseButtonUp, toScreenPoint

Methods inherited from class com.rational.test.ft.script.DatapoolScriptSupport

dpBoolean, dpBoolean, dpBoolean, dpByte, dpByte, dpByte, dpChar, dpChar, dpChar, dpCurrent, dpDone, dpDouble, dpDouble, dpDouble, dpFactory, dpFloat, dpFloat, dpFloat, dpInitialization, dpInitialization, dpInitialize, dpInt, dpInt, dpInt, dpLong, dpLong, dpLong, dpReset, dpShort, dpShort, dpShort, dpString, dpString, dpString, dpTermination, dpValue, dpValue, dpValue, getDatapool, setCurrentdp, setDatapool, storeDatapool, unsetDatapool

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

count

public static int count

info

public static int info

_hook

protected RRobotJHook _hook

_logUtils

protected RLogUtilities _logUtils

Constructor Detail

Script

public Script()

Method Detail

localAtPath

public static com.rational.test.ft.script.List localAtPath(java.lang.String path)

localAtText

public static com.rational.test.ft.script.Text localAtText(java.lang.String name)

localAtPoint

public static java.awt.Point localAtPoint(int row,
                                          int col)

localAtCell

public static com.rational.test.ft.script.Cell localAtCell(com.rational.test.ft.script.Column c,
                                                           com.rational.test.ft.script.Row r)

localAtRow

public static com.rational.test.ft.script.Row localAtRow(int i)

localAtColumn

public static com.rational.test.ft.script.Column localAtColumn(int i)

localAtRow

public static com.rational.test.ft.script.Row localAtRow(java.lang.String key,
                                                         java.lang.Object val)

localAtRow

public static com.rational.test.ft.script.Row localAtRow(java.lang.String key1,
                                                         java.lang.Object val1,
                                                         java.lang.String key2,
                                                         java.lang.Object val2)

localAtRow

public static com.rational.test.ft.script.Row localAtRow(java.lang.String key1,
                                                         java.lang.Object val1,
                                                         java.lang.String key2,
                                                         java.lang.Object val2,
                                                         java.lang.String key3,
                                                         java.lang.Object val3)

localAtColumn

public static com.rational.test.ft.script.Column localAtColumn(java.lang.String key)

localAtColumn

public static com.rational.test.ft.script.Column localAtColumn(java.lang.String key,
                                                               java.lang.Object val)

localAtColumn

public static com.rational.test.ft.script.Column localAtColumn(java.lang.String key1,
                                                               java.lang.Object val1,
                                                               java.lang.String key2,
                                                               java.lang.Object val2)

localAtColumn

public static com.rational.test.ft.script.Column localAtColumn(java.lang.String key1,
                                                               java.lang.Object val1,
                                                               java.lang.String key2,
                                                               java.lang.Object val2,
                                                               java.lang.String key3,
                                                               java.lang.Object val3)

localAtIndex

public static com.rational.test.ft.script.Index localAtIndex(int index)

localVp

public com.rational.test.ft.vp.IFtVerificationPoint localVp(java.lang.String name)

localCallScript

public void localCallScript(java.lang.String script)

localUnregister

public void localUnregister(java.lang.Object[] testobjects)

localUnregisterAll

public void localUnregisterAll()

localGetenv

public java.lang.String localGetenv(java.lang.String name)

Purpose: Gets the value of an environment variable.

Parameters:

name, - String

Returns:

String

localLogInfo

public void localLogInfo(java.lang.String info)

localLogWarning

public void localLogWarning(java.lang.String warning)

localLogError

public void localLogError(java.lang.String error)

localLogTestResult

public void localLogTestResult(java.lang.String message,
                               boolean passed,
                               java.lang.String description)

localLogTestResult

public void localLogTestResult(java.lang.String message,
                               boolean passed)

localRun

public com.rational.test.ft.object.interfaces.ProcessTestObject localRun(java.lang.String command,
                                                                         java.lang.String workingDirectory)

Purpose: Provides the basic command-line execution functionality. The supplied command line is executed in host-specific fashion with the working directory set to the specified location. If the working directory is null, the script's working directory is used

Parameters:

command, - String, the command line to execute

workingDirectory, - String, The directory that the command should use as its execution context

Returns:

ProcessTestObject

localRunJava

public com.rational.test.ft.object.interfaces.ProcessTestObject localRunJava(java.lang.String main,
                                                                             java.lang.String classpath,
                                                                             java.lang.String workingDirectory,
                                                                             java.lang.String jvm,
                                                                             java.lang.String jvmOptions)

Starts a Java application with the specified options. The JVM and classpath are split out because they tend to be host specific.

Parameters:

main - - The full Java class name of the class to be run. Package and class names must be included.

classpath - - Specifies the classpath that is used to run the main class. If this argument is null, the system classpath environment variable is used.

workingDirectory - - The directory that the command uses as its execution context

jvm - - The JVM that is used to execute the main class

jvmOptions - - JVM-specific options

getRobotJHook

public RRobotJHook getRobotJHook()

Used internally and made available to scripts invoked by the CallScript Driver Commands.

Scripts should get a reference to the topmost executing script which should be a subclass of this org.safs.rational.Script class.

Returns:

org.safs.rational.RRobotJHook

getSTAFHelper

public STAFHelper getSTAFHelper()

Used internally and made available to scripts invoked by the CallScript Driver Commands

Scripts should get a reference to the topmost executing script which should be a subclass of this org.safs.rational.Script class.

Returns:

org.safs.STAFHelper

getLogUtilities

public RLogUtilities getLogUtilities()

Used internally and made available to scripts invoked by the CallScript Driver Commands.

Scripts should get a reference to the topmost executing script which should be a subclass of this org.safs.rational.Script class.

Returns:

org.safs.rational.RLogUtilities

getGuiUtilities

public RDDGUIUtilities getGuiUtilities()

Used internally and made available to scripts invoked by the CallScript Driver Commands.

Scripts should get a reference to the topmost executing script which should be a subclass of this org.safs.rational.Script class.

Returns:

org.safs.rational.RDDGUIUtilities

getTestRecordData

public RTestRecordData getTestRecordData()

Used internally and made available to scripts invoked by the CallScript Driver Commands.

Scripts should get a reference to the topmost executing script which should be a subclass of this org.safs.rational.Script class.

Returns:

new (empty) org.safs.rational.RTestRecordData

testMain

public void testMain(java.lang.Object[] args)

processArgs

protected void processArgs(java.lang.Object[] args)

Process any -args passed into subclasses storing each as a System.property.

Parameters:

args - -- array of Strings formatted as name=value pairs. If an arg does not contain "=" then it will be stored as a name=name System.property.

Dummy_contentsVP

protected com.rational.test.ft.vp.IFtVerificationPoint Dummy_contentsVP()

Locate and return the verification point Dummy_contents object in the SUT.

Dummy_contentsVP

protected com.rational.test.ft.vp.IFtVerificationPoint Dummy_contentsVP(com.rational.test.ft.object.interfaces.TestObject anchor)