org.safs.rational

Class CFJCTable

java.lang.Object

org.safs.Processor

org.safs.ComponentFunction

org.safs.rational.CFComponent

org.safs.rational.CFTable

org.safs.rational.CFJCTable

All Implemented Interfaces:

ITestRecordStackable, RuntimeDataInterface

public class CFJCTable
extends CFTable

Purpose: CFJCTable, process a JCTable component
Lifetime: instantiated by TestStepProcessor

Since:

JUL 18, 2003
JUL 18, 2003 (DBauman) Original Release
JAN 07, 2004 (BNat) Added New Keyword GETCELLCOORDINATES
JAN 19, 2004 (BNat) Added New Keywords VERIFYROWLABEL,VERIFYCOLUMNLABEL
FEB 04, 2004 (BNat) Added New Keywords CLICKROWLABEL, DOUBLECLICKROWLABEL, ACTIVATEROWLABEL
CLICKCOLUMNLABEL, DOUBLECLICKCOLUMNLABEL, ACTIVATECOLUMNLABEL
FEB 06, 2004 (BNat) Added New Keyword VERIFYCELLEDITABLE
FEB 09, 2004 (BNat) Added New Keyword SELECTCELLTEXTSPECIAL
FEB 10, 2004 (BNat) Added New Keyword GETTABLEROWCOLUMNCOUNT
MAR 22, 2004 (BNat) Modified the code for VerifyCellEditable keyword first to look for the table level edit property then cell level.
MAR 23, 2004 (BNat) Added Illegal Access Exception catch code for VerifyCellEditable keyword.
APR 19, 2004 (BNat) getLocalCoords method updated to work more roboust with frozen column(s).

Author:

Doug Bauman

Nested Class Summary

Nested classes/interfaces inherited from class org.safs.rational.CFTable

CFTable.TableCell

Nested classes/interfaces inherited from class org.safs.ComponentFunction

ComponentFunction.Window

Field Summary

Fields

Modifier and Type	Field and Description
protected int[]	columnMap
protected int[]	rowMap

Fields inherited from class org.safs.rational.CFTable

ACTIVATECELL, ACTIVATECOLUMNLABEL, ACTIVATEROWLABEL, ASSIGNCELLCONTAINSTEXTROW, ASSIGNCELLTEXTROW, ASSIGNVARIABLECELLTEXT, ASSIGNVARIABLEFUZZYCELLTEXT, CAPTUREFUZZYRANGETOFILE, CAPTURERANGETOFILE, CLICKCELL, CLICKCELLOFCOLWITHROWVALUES, CLICKCOLUMNLABEL, CLICKROWLABEL, customCellObjects, DOUBLECLICKCELL, DOUBLECLICKCELLOFCOLWITHROWVALUES, DOUBLECLICKCOLUMNLABEL, DOUBLECLICKROWLABEL, GETCELLCOORDINATES, GETTABLEROWCOLUMNCOUNT, RFTGENERALVALUEPACKAGENAME, RIGHTCLICKCELL, RIGHTCLICKCOLUMNLABEL, SELECTCELL, SELECTCELLCONTAINSTEXTFIND, SELECTCELLTEXT, SELECTCELLTEXTFIND, SELECTCELLTEXTSPECIAL, SELECTFUZZYCELLTEXT, SELECTFUZZYCELLTEXTFIND, SELECTROWWITHROWVALUES, VERIFYCELLEDITABLE, VERIFYCELLTEXT, VERIFYCELLTEXTCONTAINS, VERIFYCELLTEXTFIND, VERIFYCOLUMNLABEL, VERIFYFUZZYCELLTEXT, VERIFYFUZZYCELLTEXTCONTAINS, VERIFYFUZZYCELLTEXTFIND, VERIFYROWLABEL

Fields inherited from class org.safs.rational.CFComponent

keepEncodingConsistent, obj1, script, winObject

Fields inherited from class org.safs.ComponentFunction

action, ALTCLICK, ALTLEFTDRAG, altText, ASSIGNPROPERTYVARIABLE, CAPTUREOBJECTDATATOFILE, CAPTUREPROPERTIESTOFILE, CAPTUREPROPERTYTOFILE, CLEARAPPMAPCACHE, CLICK, CLOSEWINDOW, compName, COMPONENTCLICK, CTRLALTLEFTDRAG, CTRLCLICK, CTRLLEFTDRAG, CTRLRIGHTCLICK, CTRLSHIFTLEFTDRAG, DOUBLECLICK, GETGUIIMAGE, GETTEXTFROMGUI, GUIDOESEXIST, GUIDOESNOTEXIST, HOVERMOUSE, HSCROLLTO, INPUTCHARACTERS, INPUTKEYS, ISPROPERTYEXIST, iterator, LEFTDRAG, LOCATESCREENIMAGE, mapname, MAXIMIZE, MINIMIZE, MOUSECLICK, OBJECT_DATA, PARAM_FILTER, PARAM_UUID, PROPERTY_DOT_itemText, PROPERTY_innerHTML, PROPERTY_innerText, PROPERTY_Items, PROPERTY_text, PROPERTY_textContent, RELATIVE_TO_PARENT, RELATIVE_TO_SCREEN, RESTORE, RIGHTCLICK, RIGHTDRAG, SAVETEXTFROMGUI, SELECTMENUITEM, SELECTMENUITEMCONTAINS, SENDEVENT, SETPOSITION, SETPROPERTYVALUE, SHIFTCLICK, SHIFTLEFTDRAG, TEST_DATA_SUFFIX, utils, VERIFYARRAYPROPERTYTOFILE, VERIFYBINARYFILETOFILE, VERIFYCLIPBOARDTOFILE, VERIFYFILETOFILE, VERIFYGUIIMAGETOFILE, VERIFYMENUITEM, VERIFYMENUITEMCONTAINS, VERIFYOBJECTDATATOFILE, VERIFYPROPERTY, VERIFYPROPERTYCONTAINS, VERIFYPROPERTYTOFILE, VERIFYTEXTFILETOFILE, VERIFYVALUECONTAINS, VERIFYVALUEEQUALS, VERIFYVALUES, VERIFYVALUESIGNORECASE, VSCROLLTO, WAITFORGUI, windowName

Fields inherited from class org.safs.Processor

breakpointsOn, CASE_INSENSITIVE_FLAG, CASEINSENSITIVE_FLAG, clearProxiesAlways, commandLineBreakpoint, customStr, customText, DEBUG_MESSAGE, debugStr, debugText, DEFAULT_CUSTOM_PROCESSOR_PACKAGE, DEFAULT_CUSTOM_PROCESSOR_SUBPACKAGE, DEFAULT_PROCESSOR_PACKAGE, FAILED_MESSAGE, FAILED_OK_MESSAGE, failedStr, failedText, FAILURE_DETAIL, GENERIC_MESSAGE, genericStr, genericText, LINE_FAILURE_4, log, myBreakpointsOn, otherStr, otherText, PARAM_SIZE_1, PARAM_SIZE_2, PARAM_SIZE_3, PARAM_SIZE_4, params, PASSED_MESSAGE, passedStr, passedText, PRE_TXT_SUCCESS_4, PRE_TXT_SUCCESS_5, processorConfigSet, processorMap, recordProcessed, RECTYPE_DRIVER_COMMAND, RECTYPE_DRIVER_COMMAND_F, RECTYPE_DRIVER_COMMAND_W, RECTYPE_TEST_STEP, RECTYPE_TEST_STEP_F, RECTYPE_TEST_STEP_W, RFSMCache, RFSMOnly, RFT_FIND_SEARCH_MODE_ALGORITHM, RFT_FIND_SEARCH_MODE_CACHE, SAFS_CLEARPROXIESALWAYS_ITEM, SAFS_COMMANDLINEBREAKPOINT_ITEM, SAFS_COMMANDLINEBREAKPOINT_VARIABLE, SAFS_PARAMS_FILE, SAFS_RESBUN_NAME, SAFS_SECSWAITFORCOMPONENT_ITEM, SAFS_SECSWAITFORCOMPONENT_VARIABLE, SAFS_SECSWAITFORWINDOW_ITEM, SAFS_SECSWAITFORWINDOW_VARIABLE, SAFS_TESTDOMAINS_ITEM, SAFS_TESTDOMAINS_VARIABLE, secsWaitForComponent, secsWaitForWindow, SENT_MSG_3, testDomains, testRecordData, testrecordStackable, TXT_FAILURE_1, TXT_FAILURE_2, TXT_FAILURE_3, TXT_FAILURE_4, TXT_FAILURE_5, TXT_SUCCESS_1, TXT_SUCCESS_2, TXT_SUCCESS_2a, TXT_SUCCESS_3, TXT_SUCCESS_3a, TXT_SUCCESS_4, TXT_SUCCESS_5, unexpectedAlertBehaviour, WARNING_MESSAGE, WARNING_OK_MESSAGE, warningStr, warningText

Constructor Summary

Constructors

Constructor and Description
CFJCTable() Purpose: constructor, calls super

Method Summary

Modifier and Type	Method and Description
protected void	actionClick(GuiTestObject guiObj, int row, int col, java.lang.Integer rrow2, java.lang.Integer ccol2, java.lang.String rowval, java.lang.String column) Purpose: actually do the click action, this version takes 4 coords
protected void	actionClick(GuiTestObject guiObj, int row, int col, java.lang.String rowval, java.lang.String column) Purpose: actually do the click action
protected void	actionClickColumnLabel(GuiTestObject guiObj, int col, int yoffset) Purpose: ClickColumnLabel, this overrides the version in our parent
protected void	actionClickRowLabel(GuiTestObject guiObj, int row, int xoffset) Purpose: ClickRowLabel, this overrides the version in our parent
protected void	actionGetCellCoordinates(GuiTestObject guiObj, int row, int col, java.lang.String xCoordVariable, java.lang.String yCoordVariable) Purpose: GetCellCoordinates, this overrides the version in our parent
protected void	actionGetTableRowColumnCount(GuiTestObject guiObj, java.lang.String rowCountVariable, java.lang.String colCountVariable) Purpose: GetTableRowColumnCount, this overrides the version in our parent
protected void	actionSelectCellTextSpecial(GuiTestObject guiObj, int row, int col, java.lang.String rowval, java.lang.String column, boolean control, boolean shift, boolean leftRight) Purpose: actually do the right or left click action with Contorl or Shift key pressed.
protected void	actionVerify(GuiTestObject guiObj, int row, int col, java.lang.String rowval, java.lang.String column, boolean fuzzy, java.lang.String val) Purpose: actually do the verify action
protected void	actionVerifyCellEditable(GuiTestObject guiObj, int row, int col, boolean verifyFlag) Purpose: VerifyCellEditable, this overrides the version in our parent
protected void	actionVerifyColumnLabel(GuiTestObject guiObj, java.lang.String val, int col) Purpose: VerifyColumnLabel, this overrides the version in our parent
protected void	actionVerifyRowLabel(GuiTestObject guiObj, java.lang.String val, int row) Purpose: VerifyRowLabel, this overrides the version in our parent
protected void	adjustForFrozenCells(TestObject jctable) Purpose: Refine the columnMap and rowMap variables by reordering the arrays if certain frozen rows or frozen columns are placed in the table in an abnormal way.
protected void	commandCaptureRangeToFile(boolean fuzzy) Purpose: commandCaptureRangeToFile: process commands like: CaptureRangeToFile, CaptureFuzzyRangeToFile
protected java.util.Collection	extractCellText(TestObject jctable, TestObject tblDataSource)
protected java.lang.Object	getCell(TestObject jctable, int row, int col) Purpose: get a cell based on row and col, uses 'getCells' method
protected java.util.Collection	getCells(TestObject jctable) Purpose: get all cells of the testobject (JCTable)
protected int	getColi(boolean fuzzy, java.lang.String column, GuiTestObject guiObj) Purpose: get the column number based on fuzzy match
protected int	getColTot(int col, GuiTestObject jctable)
protected java.awt.Point	getLocalCoords(GuiTestObject jctable, int row, int col)
protected int	getNumRows(TestObject jctable) Purpose: get number of rows in table
protected int	getRowLabelY(GuiTestObject jctable, int row, int y) Purpose: getRowLabelY This method let you implement the the custom calculation to find the y position for any frozen row labels in the JCTable.
protected int	getRowOffset()
protected int	getRowTot(int row, GuiTestObject jctable)
protected void	purgeHiddenCells(TestObject jctable) Purpose: Refine the columnMap and rowMap variables by removing all of the hidden columns and rows from the arrays.
protected void	setDefaultColumnMap(TestObject jctable)
protected void	setDefaultRowMap(TestObject jctable)
protected boolean	setLocalSelection(GuiTestObject jctable, int row, int col, int row2, int col2, boolean left, boolean right)
protected void	setLocalSelectionSpecial(GuiTestObject jctable, int row, int col, boolean control, boolean shift, boolean leftRight)
protected boolean	setSelection(GuiTestObject jctable, int row, int col, int row2, int col2) Purpose: set selection (NOTE: currently doesn't allow edit of cell when selected, looks like this is just a highlight, rather than a selection).
protected boolean	setSelection(GuiTestObject jctable, int row, int col, int row2, int col2, boolean left, boolean right) Purpose: set selection Does a click in the cell based on the result of invoking getCellPosition on the jctable.
protected void	setSelectionSpecial(GuiTestObject guiObj, int row, int col, boolean control, boolean shift, boolean leftRight) Purpose: setSelectionSpecial Does a click in the cell based on the result of invoking getCellPosition on the jctable.
protected void	setTextValue(TestObject jctable, int row, int col, java.lang.String text) Purpose: set text value of cell

Methods inherited from class org.safs.rational.CFTable

actionAssign, actionCaptureRangeToFile, actionLocalSelectCellTextSpecial, captureObjectData, commandAssignCellTextRow, commandAssignVariableCellText, commandClick, commandClickCellOfColWithRowValues, commandClickColumnLabel, commandClickFind, commandClickRowLabel, commandGetCellCoordinates, commandGetTableRowColumnCount, commandSelectCellTextSpecial, commandSelectRowWithRowValues, commandVerifyCellEditable, commandVerifyCellText, commandVerifyCellTextFind, commandVerifyColumnLabel, commandVerifyRowLabel, convertCoords, doActionClick, formatObjectData, getCell, getCellText, getCellText, getColumnName, getJCTable, getLocalRect, getNumColumns, getObjectData, getRealTable, getRowi, getTableCellSubItemText, getTextProperty, isCustomCellObject, localProcess, performClick, processCustomCellObject, selectCellText

Methods inherited from class org.safs.rational.CFComponent

_maximize, _minimize, _restore, _setPosition, _setSize, captureObjectDataToFile, capturePropertiesToFile, capturePropertyToFile, clearAppMapCache, closeWindow, componentClick, convertObjectValueToString, exist, extractTreeItemsSub, findMenuBars, getAppletsBrowser, getComponentRectangle, getComponentRectangleOnScreen, getHelpers, getKeepEncodingConsistent, getObjectProperty, getObjectPropertyFromProperties, getProperties, getPropertyObject, getUserObject, getWindowRectangleOnScreen, inputKeystrokes, isDotnetDomain, isFlexDomain, isHtmlDomain, isJavaDomain, isSwtDomain, isSWTWidget, isWinDomain, listAllProperties, listAllProperties, listMethods, listNonValueProperties, listProperties, matchedPathOfMenuItem, mouseClick, parseWhereInfo, performDrag, performHoverMouse, performScorll, process, selectMenuItem, sendEvent, sendFlexEvent, setKeepEncodingConsistent, setPropertyValue, tobj, verifyClipboardToFile, verifyFileToFile, verifyMenuItem, verifyObjectDataToFile, verifyPropertyContains, verifyPropertyToFile, verifyValueContains, verifyValues

Methods inherited from class org.safs.ComponentFunction

_close, action_ComputedStyle, action_getGuiImage, action_GetSaveTextFromGUI, action_showOnPage, action_verifyGuiImageToFile, assignPropertyVariable, captureObjectData, checkForCoord, checkForCoord, clearCache, close, componentExecutedFailureMessage, componentFailureMessage, componentProcess, componentSuccessMessage, convertLine, convertNum, convertWindowPosition, ConvertWindowPosition, deduceImageRect, dragTo, executeScript, getAlternateParams, getHelpersWorker, getPossibleMapItem, getProperty, getPropertyCollection, getPropertyCollection, getRectangleImage, getStringValue, getUUIDBoolean, guiDoesExist, hoverMouse, hoverScreenLocation, isClickAction, isPropertyExist, issueFileErrorFailure, issueParameterCountFailure, issueParameterCountFailure, issueParameterValueFailure, issuePassedSuccess, issuePassedSuccessUsing, issueUnknownErrorFailure, isSupportedRecordType, locateScreenImage, lookupAppMapCoordReference, lookupAppMapLineReference, lookupAppMapNumReference, lookupAppMapReference, maximize, minimize, normalizeFileEncoding, normalizePropertyCollection, restore, setIterator, setPosition, setRectVars, showComponentAsMuchPossible, updateFromTestRecordData, verifyPropertiesToFile, verifyProperty, waitForGUI, waitForObject

Methods inherited from class org.safs.Processor

activateBreakpoint, checkBreakpoints, checkMyBreakpoints, deduceBenchFile, deduceDiffFile, deduceProjectFile, deduceTestFile, delay, distributeConfigInformation, getAbsolutFileName, getAppMapItem, getChainedProcessor, getClassInstance, getClearProxiesAlways, getCustomProcClassNames, getCustomProcInstancePath, getLogUtilities, getParams, getProcClassNames, getProcInstance, getProcInstancePath, getRequiredField, getSecsWaitForComponent, getSecsWaitForWindow, getStandardErrorMessage, getTestRecordData, getUnexpectedAlertBehaviour, getVariable, hasChainedProcessor, initProcessorAndProcess, instanceProcessorAndProcess, isBreakpointsOn, isComponentFunctionRecord, isDriverCommandRecord, isEngineCommandRecord, isMyBreakpointsOn, isRecordProcessed, isRFSMCache, isRFSMOnly, issueActionFailure, issueActionOnXFailure, issueErrorPerformingAction, issueErrorPerformingActionOnX, issueErrorPerformingActionUsing, issueInputRecordFailure, issueInputRecordFailure, issuePassedSuccess, logFailureMessage, normalizeTestFileName, paramsFailedMsg, paramsFailedMsg, popTestRecord, processCustomProcessor, processSubclassProcessor, pushTestRecord, setAtEndOfProcess, setBreakpointsOn, setChainedProcessor, setClearProxiesAlways, setCommandLineBreakpoint, setCustomProcInstancePath, setLogUtilities, setMyBreakpointsOn, setParams, setProcInstance, setProcInstancePath, setRecordProcessed, setRFSMCache, setRFSMOnly, setSecsWaitForComponent, setSecsWaitForWindow, setTestDomains, setTestRecordData, setUnexpectedAlertBehaviour, setVariable, standardFailureMessage, substituteVariable, validateParamSize, validProcessorClassName

Methods inherited from class java.lang.Object

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

Field Detail

columnMap

protected int[] columnMap

rowMap

protected int[] rowMap

Constructor Detail

CFJCTable

public CFJCTable()

Purpose: constructor, calls super

Method Detail

getCell

protected java.lang.Object getCell(TestObject jctable,
                                   int row,
                                   int col)
                            throws SAFSException

Purpose: get a cell based on row and col, uses 'getCells' method

Overrides:

getCell in class CFTable

Parameters:

jctable, - TestObject

row, - int

col, - int

Returns:

Object, contents of cell

Throws:

SAFSException - based on caught Exception, like index out of bounds, etc.

getCells

protected java.util.Collection getCells(TestObject jctable)
                                 throws SAFSException

Purpose: get all cells of the testobject (JCTable)

Parameters:

jctable, - TestObject

Returns:

Collection of Collections, contents of cells

Throws:

SAFSException - based on caught Exception

purgeHiddenCells

protected void purgeHiddenCells(TestObject jctable)

Purpose: Refine the columnMap and rowMap variables by removing all of the hidden columns and rows from the arrays.

Parameters:

jctable -

adjustForFrozenCells

protected void adjustForFrozenCells(TestObject jctable)

Purpose: Refine the columnMap and rowMap variables by reordering the arrays if certain frozen rows or frozen columns are placed in the table in an abnormal way. Columns: The placement can be either on the left side of the table or on the right side of the table. If the placement is on the right, adjustments must be made to the columnMap array so that the designated frozen columns are placed at the end of the column map. Rows: The placement can be either on the top of the table or on the bottom of the table. If the placement is on the bottom, adjustments must be made to the rowMap array so that the designated frozen rows are placed at the end of the row map.

Parameters:

jctable -

extractCellText

protected java.util.Collection extractCellText(TestObject jctable,
                                               TestObject tblDataSource)

setSelection

protected boolean setSelection(GuiTestObject jctable,
                               int row,
                               int col,
                               int row2,
                               int col2)
                        throws SAFSException

Purpose: set selection (NOTE: currently doesn't allow edit of cell when selected, looks like this is just a highlight, rather than a selection). Also does a click in the cell

Parameters:

jctable, - TestObject

row, - int

col, - int

row2, - int

col2, - int

Returns:

boolean if success

Throws:

SAFSException - based on caught Exception

getLocalCoords

protected java.awt.Point getLocalCoords(GuiTestObject jctable,
                                        int row,
                                        int col)

setLocalSelection

protected boolean setLocalSelection(GuiTestObject jctable,
                                    int row,
                                    int col,
                                    int row2,
                                    int col2,
                                    boolean left,
                                    boolean right)
                             throws SAFSException,
                                    com.rational.test.ft.UnsupportedActionException,
                                    MethodNotFoundException

Throws:

SAFSException

com.rational.test.ft.UnsupportedActionException

MethodNotFoundException

setSelection

protected boolean setSelection(GuiTestObject jctable,
                               int row,
                               int col,
                               int row2,
                               int col2,
                               boolean left,
                               boolean right)
                        throws SAFSException

Purpose: set selection
Does a click in the cell based on the result of invoking getCellPosition on the jctable. if this doesn't work, this method catches MethodNotFoundException and assumes that the parent is the table and tries again. this works if the mapped object is actually a 'CellArea' which is contained by the JCTable, and it was not possible to get to the JCTable itself.

Parameters:

jctable, - TestObject

row, - int

col, - int

row2, - int

col2, - int

left, - boolean, is it a left click

right, - boolean, is it a right click

Returns:

boolean if success

Throws:

SAFSException - based on caught Exception

setTextValue

protected void setTextValue(TestObject jctable,
                            int row,
                            int col,
                            java.lang.String text)
                     throws SAFSException

Purpose: set text value of cell

Parameters:

jctable, - TestObject

row, - int

col, - int

text, - String

Throws:

SAFSException - based on caught Exception

actionClick

protected void actionClick(GuiTestObject guiObj,
                           int row,
                           int col,
                           java.lang.String rowval,
                           java.lang.String column)
                    throws SAFSException

Purpose: actually do the click action

Overrides:

actionClick in class CFTable

Parameters:

guiObj, - GuiTestObject

row, - int

col, - int

Throws:

SAFSException

actionClick

protected void actionClick(GuiTestObject guiObj,
                           int row,
                           int col,
                           java.lang.Integer rrow2,
                           java.lang.Integer ccol2,
                           java.lang.String rowval,
                           java.lang.String column)
                    throws SAFSException

Purpose: actually do the click action, this version takes 4 coords

Overrides:

actionClick in class CFTable

Parameters:

guiObj, - GuiTestObject

row, - int

col, - int

Throws:

SAFSException

getRowOffset

protected int getRowOffset()

commandCaptureRangeToFile

protected void commandCaptureRangeToFile(boolean fuzzy)
                                  throws SAFSException

Purpose: commandCaptureRangeToFile: process commands like: CaptureRangeToFile, CaptureFuzzyRangeToFile

example step commands:

T, JavaWin, JTable, CaptureRangeToFile, AFileName.txt
CaptureRange entire table To File AFileName.txt

T, JavaWin, JTable, CaptureRangeToFile, AFileName.txt, 4, "Field5", 2, 5
Saves a 2 rows by 5 columns range of cells starting at cell 4, Field5.
The starting column is determined by matching the text "Field5" to the field headers in the JTable. The values are saved into AFileName.txt

T, JavaWin, JTable, CaptureRangeToFile, AFileName.txt, "ADatum", 5, , 2
Saves a range of all remaining rows by 2 columns wide starting at cell "ADatum", 5.
The starting row is determined by matching the text "ADatum" to the first cell in column 1 in the JTable that contains "ADatum". Since no ROWS parameter was provided, all subsequest rows from the 2 columns are captured. The values are saved into AFileName.txt

NOTE: if fuzzy is true then: (case is ignored; if matching columns, or if matching cell values, use substrings)

Overrides:

commandCaptureRangeToFile in class CFTable

Parameters:

fuzzy, - boolean, if true then substrings or case insensitive match

Throws:

SAFSException

actionGetCellCoordinates

protected void actionGetCellCoordinates(GuiTestObject guiObj,
                                        int row,
                                        int col,
                                        java.lang.String xCoordVariable,
                                        java.lang.String yCoordVariable)
                                 throws SAFSException

Purpose: GetCellCoordinates, this overrides the version in our parent

example step commands:

T, JavaWin, JCTable, GetCellCoordinates, 2, 4, xCoordVar, yCoordVar
Returns the X and Y coordinates value of row 2 and col 4 in JCTable.

Overrides:

actionGetCellCoordinates in class CFTable

Parameters:

guiObj, - GuiTestObject

row, - int

col, - int

xCoordVariable, - String

yCoordVariable, - String

Throws:

SAFSException

actionVerifyRowLabel

protected void actionVerifyRowLabel(GuiTestObject guiObj,
                                    java.lang.String val,
                                    int row)
                             throws SAFSException

Purpose: VerifyRowLabel, this overrides the version in our parent

example step commands:

T, JavaWin, JCTable, VerifyRowLabel, "BenchValue", 2
Compares the value (Frozen row label) of row 2, in JCTable to bench text "BenchValue".

Overrides:

actionVerifyRowLabel in class CFTable

Parameters:

guiObj, - GuiTestObject

val, - String

row, - int

Throws:

SAFSException

actionVerifyColumnLabel

protected void actionVerifyColumnLabel(GuiTestObject guiObj,
                                       java.lang.String val,
                                       int col)
                                throws SAFSException

Purpose: VerifyColumnLabel, this overrides the version in our parent

example step commands:

T, JavaWin, JCTable, VerifyColumnLabel, "BenchValue", 3
Compares the value (Frozen column label) of column 3, in JCTable to bench text "BenchValue".

NOTE: When you work with the column lable which consist of multiple column to find
the next column label in the table you need to add one to the number of columns
under the column label.

Overrides:

actionVerifyColumnLabel in class CFTable

Parameters:

guiObj, - GuiTestObject

val, - String

col, - int

Throws:

SAFSException

getRowLabelY

protected int getRowLabelY(GuiTestObject jctable,
                           int row,
                           int y)

Purpose: getRowLabelY
This method let you implement the the custom calculation to find the y position for any
frozen row labels in the JCTable. You can override this method in any of the custom class
which is inherited from the this (CFJCTable) class...!
p>

Parameters:

jctable, - TestObject

row, - int

y, - int

actionClickRowLabel

protected void actionClickRowLabel(GuiTestObject guiObj,
                                   int row,
                                   int xoffset)
                            throws SAFSException

Purpose: ClickRowLabel, this overrides the version in our parent

example step commands:

T, JavaWin, JCTable, ClickRowLabel, 2
Make a single click on the specified forzen row label. In this example the keyword makes
click on the second forzen row label in the JCTable.

T,windowName,TableName,doubleclickRowLabel,2
T,windowName,TableName,activateRowLabel,2
Make a double click on the specified forzen row label. In this example the keyword makes
click on the second forzen row label in the JCTable.

NOTE: This keyword is implemeted using the co-ordinates. This keyword internally calculates
the co-ordinates of any given frozen row label cell location and executes a single or double
click on that frozen row label.

Overrides:

actionClickRowLabel in class CFTable

Parameters:

guiObj, - GuiTestObject

row, - int

Throws:

SAFSException

actionClickColumnLabel

protected void actionClickColumnLabel(GuiTestObject guiObj,
                                      int col,
                                      int yoffset)
                               throws SAFSException

Purpose: ClickColumnLabel, this overrides the version in our parent

example step commands:

T, JavaWin, JCTable, ClickColumnLabel, 2
Make a single click on the specified forzen col label. In this example the keyword makes
click on the second forzen col label in the JCTable.

T,windowName,TableName,DoubleClickColumnLabel,2
T,windowName,TableName,ActivateColumnLabel,2
Make a double click on the specified forzen col label. In this example the keyword makes
click on the second forzen col label in the JCTable.

NOTE: This keyword is implemeted using the co-ordinates. This keyword internally calculates
the co-ordinates of any given frozen col label cell location and executes a single or
double click on that frozen col label.

Overrides:

actionClickColumnLabel in class CFTable

Parameters:

guiObj, - GuiTestObject

col, - int

Throws:

SAFSException

actionVerifyCellEditable

protected void actionVerifyCellEditable(GuiTestObject guiObj,
                                        int row,
                                        int col,
                                        boolean verifyFlag)
                                 throws SAFSException

Purpose: VerifyCellEditable, this overrides the version in our parent

example step commands:

T, JavaWin, JCTable, VerifyCellEditable, 2,5,true
Verifies the cell in JCTable, at row = 2, col = 5 is ediable. Validates the cell property
to a known value.

Overrides:

actionVerifyCellEditable in class CFTable

Parameters:

guiObj, - GuiTestObject

row, - int

col, - int

verifyFlag, - boolean

Throws:

SAFSException

setLocalSelectionSpecial

protected void setLocalSelectionSpecial(GuiTestObject jctable,
                                        int row,
                                        int col,
                                        boolean control,
                                        boolean shift,
                                        boolean leftRight)
                                 throws SAFSException,
                                        com.rational.test.ft.UnsupportedActionException,
                                        MethodNotFoundException

Throws:

SAFSException

com.rational.test.ft.UnsupportedActionException

MethodNotFoundException

setSelectionSpecial

protected void setSelectionSpecial(GuiTestObject guiObj,
                                   int row,
                                   int col,
                                   boolean control,
                                   boolean shift,
                                   boolean leftRight)
                            throws SAFSException,
                                   SubitemNotFoundException

Purpose: setSelectionSpecial
Does a click in the cell based on the result of invoking getCellPosition on the jctable. If this doesn't work, this method catches MethodNotFoundException and assumes that the parent is the table and tries again. This works if the mapped object is actually a 'CellArea' which is contained by the JCTable, and it was not possible to get to the JCTable itself.

Parameters:

jctable, - TestObject

row, - int

col, - int

row2, - int

col2, - int

left, - boolean, is it a left click

right, - boolean, is it a right click

Throws:

SAFSException - based on caught Exception

SubitemNotFoundException

actionSelectCellTextSpecial

protected void actionSelectCellTextSpecial(GuiTestObject guiObj,
                                           int row,
                                           int col,
                                           java.lang.String rowval,
                                           java.lang.String column,
                                           boolean control,
                                           boolean shift,
                                           boolean leftRight)
                                    throws SAFSException

Purpose: actually do the right or left click action with Contorl or Shift key pressed.

Overrides:

actionSelectCellTextSpecial in class CFTable

Parameters:

guiObj, - GuiTestObject

row, - int

col, - int

control, - boolean

shift, - boolean

leftRight, - boolean

Throws:

SAFSException

actionGetTableRowColumnCount

protected void actionGetTableRowColumnCount(GuiTestObject guiObj,
                                            java.lang.String rowCountVariable,
                                            java.lang.String colCountVariable)
                                     throws SAFSException

Purpose: GetTableRowColumnCount, this overrides the version in our parent

example step commands:

T, JavaWin, JCTable, GetTableRowColumnCount, rowCountVar, colCountVar
Returns the total count of rows and columns in JCTable.

Overrides:

actionGetTableRowColumnCount in class CFTable

Parameters:

guiObj, - GuiTestObject

rowCountVariable, - String

colCountVariable, - String

Throws:

SAFSException

actionVerify

protected void actionVerify(GuiTestObject guiObj,
                            int row,
                            int col,
                            java.lang.String rowval,
                            java.lang.String column,
                            boolean fuzzy,
                            java.lang.String val)
                     throws SAFSException

Description copied from class: CFTable

Purpose: actually do the verify action

Overrides:

actionVerify in class CFTable

Throws:

SAFSException

getColi

protected int getColi(boolean fuzzy,
                      java.lang.String column,
                      GuiTestObject guiObj)
               throws SAFSException

Purpose: get the column number based on fuzzy match

Overrides:

getColi in class CFTable

Parameters:

fuzzy, - boolean

column, - String

guiObj, - GuiSubitemTestObject

Returns:

Integer

Throws:

SAFSException

setDefaultColumnMap

protected void setDefaultColumnMap(TestObject jctable)

Parameters:

columnMap -

setDefaultRowMap

protected void setDefaultRowMap(TestObject jctable)

Parameters:

rowMap -

getNumRows

protected int getNumRows(TestObject jctable)
                  throws SAFSException

Description copied from class: CFTable

Purpose: get number of rows in table

Overrides:

getNumRows in class CFTable

Returns:

int

Throws:

SAFSException - based on caught Exception

getColTot

protected int getColTot(int col,
                        GuiTestObject jctable)

getRowTot

protected int getRowTot(int row,
                        GuiTestObject jctable)