This chapter provides a complete listing and reference for the methods in the OpenScript FormsService Class of Forms Functional Module Application Programming Interface (API).
The following section provides an alphabetical listing of the methods in the OpenScript FormsService API.
The following table lists the FormsService API methods in alphabetical order.
Table 14-1 List of FormsService Methods
Method | Description |
---|---|
Identifies an Oracle Forms alertDialog object by its path. |
|
Identifies an Oracle Forms AppletAdapter object by its applet name. |
|
Construct property data of a single attribute. |
|
Utility function to return a list of property tests. |
|
Identifies an Oracle Forms blockScroller object by its path. |
|
Identifies an Oracle Forms Button object by its path. |
|
Identifies an Oracle Forms calendar object by its path. |
|
Capture the screen shot at runtime. |
|
Constructs the test data of a table cell. |
|
Constructs the list of table cell tests. |
|
Identifies an Oracle Forms checkBox object by its path. |
|
Identifies an Oracle Forms choiceBox object by its path. |
|
Close the running forms. |
|
Identifies an Oracle Forms comboBox object by its path. |
|
Identifies an Oracle Forms editBox object by its path. |
|
Identifies an Oracle Forms EditorDialog object by its path. |
|
Identifies an Oracle Forms FlexWindow object by its path. |
|
Gets all forms objects. |
|
Gets the bar count shown in the bottom of the forms client. |
|
Gets the error code shown in the status bar of the forms client. |
|
Gets the item shown in the status bar of forms client. |
|
Gets the item count shown in the status bar of forms client. |
|
Gets the message shown in the status bar of forms client. |
|
Gets the record info shown in the status bar of the forms client. |
|
Identifies an Oracle Forms HGridApp object by its path. |
|
Identifies an Oracle Forms helpDialog object by its path. |
|
Identifies an Oracle Forms imageItem object by its path. |
|
Identifies an Oracle Forms infoBox object by its path. |
|
Identifies an Oracle Forms list object by its path. |
|
Identifies an Oracle Forms listOfValues object by its path. |
|
Identifies an Oracle Forms logonDialog object by its path. |
|
Identifies an Oracle Forms otsHGrid object by its path. |
|
Identifies an Oracle Forms radioButton object by its path. |
|
Identifies an Oracle Forms responseBox object by its path. |
|
Identifies an Oracle Forms schedulingDataClient object by its path. |
|
Identifies an Oracle Forms spreadTable object by its path. |
|
Identifies an Oracle Forms StatusBar object by its recorded ID and path. |
|
Identifies an Oracle Forms tab object by its path. |
|
Identifies an Oracle Forms tableBox object by its path. |
|
Identifies an Oracle Forms textField object by its path. |
|
Identifies an Oracle Forms tree object by its path. |
|
Identifies an Oracle Forms treeList object by its path. |
|
Identifies an Oracle Forms window object by its path. |
The following sections provide detailed reference information for each method and enum in the FormsService Class of Forms Functional Module Application Programming Interface.
Identifies an Oracle Forms alertDialog object by its path.
The forms.alertDialog method has the following command format(s):
forms.alertDialog(path);
forms.alertDialog(recid, path);
Optional the ID of a previously recorded navigation, used for comparison purposes. May be null
.
a String specifying the path to identify the forms alertDialog. For example, //forms:alertDialog
. Must not be null
. Since it is only possible to show one alertDialog in Oracle Forms at runtime, it is not necessary to specify additional conditions in the path to locate the alertDialog object.
represents an exception that may be thrown during the execution of a script where the exception should be reported to an end user through the controller.
Identifies an Oracle Forms AppletAdapter object by its applet name.
The forms.appletAdapter method has the following command format(s):
forms.appletAdapter(path);
forms.appletAdapter(recid, path);
Optional the ID of a previously recorded navigation, used for comparison purposes. May be null
.
a String specifying the applet name to identify the forms appletAdater. For example, //forms:appletAdapter[(@appletName='NAV_CONTROLS_EXPAND_ALL_0')]
. Must not be null
.
represents an exception that may be thrown during the execution of a script where the exception should be reported to an end user through the controller.
Construct property data of a single attribute.
The forms.attribute method has the following command format(s):
forms.attribute(property, expectedValue, operator);
a String specifying the property name.
a String specifying the expected value.
a TestOperator enum defining the type and the match approach of the data.
Specify the attributes of an object.
forms.textField(248, "//forms:textField[" + "(@name='STUB_APPLICATION_NAME_0')]") .setFocus(); forms.textField(249,"//forms:textField[" + "(@name='STUB_APPLICATION_NAME_0')]") .setText("abc"); forms.textField("//forms:textField[" + "(@name='STUB_APPLICATION_NAME_0')]") .verifyAttributes("test1",forms.attributes( forms.attribute("enabled", "true", TestOperator.StringExact), forms.attribute("text", "Sales", TestOperator.StringExact), forms.attribute("visible", "true", TestOperator.StringExact), forms.attribute("name", "STUB_APPLICATION_NAME_0", TestOperator.StringExact), forms.attribute("showing", "true", TestOperator.StringExact), forms.attribute("prompt", "Application", TestOperator.StringExact), forms.attribute("editable", "true", TestOperator.StringExact)));
Utility function to return a list of property tests.
an array of PropertyTest attribute objects specifying all the tests included in the forms object test.
Specify the attributes of an object.
forms.textField(248, "//forms:textField[" +
"(@name='STUB_APPLICATION_NAME_0')]")
.setFocus();
forms.textField(249,"//forms:textField[" +
"(@name='STUB_APPLICATION_NAME_0')]")
.setText("abc");
forms.textField("//forms:textField[" +
"(@name='STUB_APPLICATION_NAME_0')]")
.verifyAttributes("test1",forms.attributes(
forms.attribute("enabled", "true",
TestOperator.StringExact),
forms.attribute("text", "Sales",
TestOperator.StringExact),
forms.attribute("visible", "true",
TestOperator.StringExact),
forms.attribute("name", "STUB_APPLICATION_NAME_0",
TestOperator.StringExact),
forms.attribute("showing", "true",
TestOperator.StringExact),
forms.attribute("prompt", "Application",
TestOperator.StringExact),
forms.attribute("editable", "true",
TestOperator.StringExact)));
Identifies an Oracle Forms blockScroller object by its path.
The forms.blockScroller method has the following command format(s):
forms.blockScroller(path);
forms.blockScroller(recid, path);
Optional the ID of a previously recorded navigation, used for comparison purposes. May be null
.
a String specifying the path to identify the forms blockScroller. For example, //forms:blockScroller
. Must not be null
. Without further notice, this method only works properly when only one blockScroller exists in a window.
represents an exception that may be thrown during the execution of a script where the exception should be reported to an end user through the controller.
Performs an action on an Oracle Forms blockScroller object specified by its recorded ID and path.
int maxNum=forms.blockScroller(50, "//forms:blockScroller") .getMaximum(); int minNum=forms.blockScroller50, "//forms:blockScroller") .getMinimum(); int value=forms.blockScroller(50, "//forms:blockScroller") .getValue(); info("maxNum:"+maxNum+" minNum:"+minNum+" value8:"+value); forms.blockScroller(50, "//forms:blockScroller") .scrollDown(); int scrollDownValue=forms.blockScroller(50, "//forms:blockScroller") .getValue(); forms.blockScroller(50, "//forms:blockScroller") .scrollUp(); int scrollUpValue=forms.blockScroller(50, "//forms:blockScroller") .getValue(); if(value!=8)warn("scroll to error!"); if(scrollDownValue!=9)warn("scroll to error!"); if(scrollUpValue!=8)warn("scroll up error!");
Identifies an Oracle Forms Button object by its path.
The forms.button method has the following command format(s):
forms.button(path);
forms.button(recid, path);
Optional the ID of a previously recorded navigation, used for comparison purposes. May be null
.
a String specifying the path to identify the forms button. For example, //forms:button[(@name='NAV_CONTROLS_EXPAND_ALL_0')]
. Must not be null
.
represents an exception that may be thrown during the execution of a script where the exception should be reported to an end user through the controller.
Performs an action on an Oracle Forms Button object specified by its recorded ID and path.
forms.button(32, "//forms:button[(@name='CALENDAR_OK_0')]")
.setFocus();
String accName1=forms.button(32, "//forms:button[(@name='CALENDAR_OK_0')]")
.getAccessibleName();
String label1=forms.button(32, "//forms:button[(@name='CALENDAR_OK_0')]")
.getLabel();
info("accssibleName: " + accName1);
info("Label: " + label1);
Identifies an Oracle Forms calendar object by its path.
The forms.calendar method has the following command format(s):
forms.calendar(path);
forms.calendar(recid, path);
Optional the ID of a previously recorded navigation, used for comparison purposes. May be null
.
a String specifying the path to identify the forms calendar. For example, //forms:calendar
. Must not be null
. Since it is only possible to show one calendar in Oracle Forms at runtime, it is not necessary to specify additional conditions in the path to locate the calendar object.
represents an exception that may be thrown during the execution of a script where the exception should be reported to an end user through the controller.
Performs an action on an Oracle Forms calendar object specified by its recorded ID and path.
forms.textField(111, "//forms:textField[" + "(@name='GROUPS_EXPENDITURE_ENDING_DATE_0')]") .openDialog(); forms.button(114, "//forms:button[" + "(@name='CALENDAR_OK_0')]") .setFocus(); forms.calendar(115, "//forms:calendar") .enter("06-JAN-2011"); forms.window(118, "//forms:window[" + "(@name='GROUPS_DETAIL')]") .activate(true); forms.textField(119, "//forms:textField[" + "(@name='GROUPS_EXPENDITURE_ENDING_DATE_0')]") .openDialog(); forms.button(122, "//forms:button[" + "(@name='CALENDAR_OK_0')]") .setFocus(); forms.calendar(123, "//forms:calendar") .clickOk();
Capture the screen shot at runtime. Please refer to {@link #captureScreenshot(Integer,String)}.
The forms.captureScreenshot method has the following command format(s):
forms.captureScreenshot( );
forms.captureScreenshot(recid);
Optional the ID of a previously recorded navigation, used for comparison purposes. May be null
.
represents an exception that may be thrown during the execution of a script where the exception should be reported to an end user through the controller.
Constructs the test data of a table cell.
The forms.cell method has the following command format(s):
forms.cell(row, column, expectedValue, operator);
a 1-based index value specifying the row number.
a 1-based index value specifying the column number.
a String specifying the expected value of the property.
a TestOperator enum that defines the type and the match approach of the data.
Adds a table test for specifying exact match or wildcard match for individual cells.
forms.otsHGrid("//forms:otsHGrid[(@name='ASTEVENR_CONF_HGRID_ITEMS_0')]" + .assertCells("MyTableTest", forms.cells(forms.cell(1, 1, "Ticker ",TestOperator.StringExact), forms.cell(1, 2,"Company ", TestOperator.StringExact), forms.cell(2, 1, "ORCL*", TestOperator.StringWildCard), forms.cell(2, 2, "Oracle", TestOperator.StringExact)));
Constructs the list of table cell tests.
Adds a table test for specifying exact match or wildcard match for each cell.
forms.otsHGrid("//forms:otsHGrid[(@name='ASTEVENR_CONF_HGRID_ITEMS_0')]" +
.assertCells("MyTableTest",
web.cells(forms.cell(1, 1, "Ticker ",TestOperator.StringExact),
forms.cell(1, 2,"Company ", TestOperator.StringExact),
forms.cell(2, 1, "ORCL*", TestOperator.StringWildCard),
forms.cell(2, 2, "Oracle", TestOperator.StringExact)));
Identifies an Oracle Forms checkBox object by its path.
The forms.checkBox method has the following command format(s):
forms.checkBox(path);
forms.checkBox(recid, path);
Optional the ID of a previously recorded navigation, used for comparison purposes. May be null
.
a String specifying the path to identify the forms checkBox. For example, //forms:checkBox[(@name='MTL_SYSTEM_ITEMS_INVENTORY_ITEM_FLAG_MIR_0')]
. Must not be null
.
represents an exception that may be thrown during the execution of a script where the exception should be reported to an end user through the controller.
Performs an action on an Oracle Forms checkBox object specified by its recorded ID and path.
forms.checkBox(35, "//forms:checkBox[" + "(@name='JOBS_QF_SHOW_STAGES_0')]") .check(true); forms.checkBox(35, "//forms:checkBox[" + "(@name='JOBS_QF_SHOW_STAGES_0')]") .verifyAttribute("checkbox status", "state", "true", TestOperator.StringExact); if( !forms.checkBox(35, "//forms:checkBox[" + "(@name='JOBS_QF_SHOW_STAGES_0')]") .isSelected())warn("check statement error"); String accessibleName=forms.checkBox(35, "//forms:checkBox[" + "(@name='JOBS_QF_SHOW_STAGES_0')]") .getAccessibleName(); String label=forms.checkBox(35, "//forms:checkBox[" + "(@name='JOBS_QF_SHOW_STAGES_0')]") .getLabel(); //output accessible name and label info("check box's acccessible name: " + accessibleName); info("check box's label: " + label);
Identifies an Oracle Forms choiceBox object by its path.
The forms.choiceBox method has the following command format(s):
forms.choiceBox(path);
forms.choiceBox(recid, path);
Optional the ID of a previously recorded navigation, used for comparison purposes. May be null
.
a String specifying the path to identify the forms choiceBox. For example, //forms:choiceBox
. Must not be null
. Since it is only possible to show one choiceBox in Oracle Forms at runtime, it is not necessary to specify additional conditions in the path to locate the choiceBox object.
represents an exception that may be thrown during the execution of a script where the exception should be reported to an end user through the controller.
Close the running forms. Please refer to forms.close
The forms.close method has the following command format(s):
forms.close( );
forms.close(recid);
the ID of a previously recorded element which is another corresponding element to this, holding all the info recorded.
represents an exception that may be thrown during the execution of a script where the exception should be reported to an end user through the controller.
Identifies an Oracle Forms comboBox object by its path.
The forms.comboBox method has the following command format(s):
forms.comboBox(path);
forms.comboBox(recid, path);
Optional the ID of a previously recorded navigation, used for comparison purposes. May be null
.
a String specifying the path to identify the forms comboBox. For example, //forms:comboBox[(@name='ALL_WIDGETS_LIST508_0')]
. Must not be null
.
represents an exception that may be thrown during the execution of a script where the exception should be reported to an end user through the controller.
Performs an action on an Oracle Forms comboBox object specified by its recorded ID and path.
//get accessible name and count String accessName=forms.comboBox(20, "//forms:comboBox[" + "(@name='ALL_WIDGETS_LIST508_0')]") .getAccessibleName(); int itemCount=forms.comboBox(20, "//forms:comboBox[" + "(@name='ALL_WIDGETS_LIST508_0')]") .getItemCount(); info("accessible Name: " + accessName); info("item count: " + itemCount); forms.comboBox(20, "//forms:comboBox[" + "(@name='ALL_WIDGETS_LIST508_0')]") .setFocus(); forms.comboBox(20, "//forms:comboBox[" + "(@name='ALL_WIDGETS_LIST508_0')]") .setText("text"); String itemValue = forms.comboBox(20, "//forms:comboBox[" + "(@name='ALL_WIDGETS_LIST508_0')]") .getItemValue(""); info(itemValue);
Identifies an Oracle Forms editBox object by its path.
The forms.editBox method has the following command format(s):
forms.editBox(path);
forms.editBox(recid, path);
Optional the ID of a previously recorded navigation, used for comparison purposes. May be null
.
a String specifying the path to identify the forms editBox. For example, //forms:calendar
. Must not be null
. Since it is only possible to show one editBox in Oracle Forms at runtime, it is not necessary to specify additional conditions in the path to locate the editBox object.
represents an exception that may be thrown during the execution of a script where the exception should be reported to an end user through the controller.
Performs an action on an Oracle Forms editBox object specified by its recorded ID and path.
forms.window(65, "//forms:window[(@name='GROUPS_DETAIL')]") .selectMenu("Help|About Oracle Applications..."); forms.editBox(68, "//forms:editBox").clickOk(); String text1 = forms.editBox(68, "//forms:editBox") .getText(); info("editBox text: " + text1);
Identifies an Oracle Forms EditorDialog object by its path.
The forms.editorDialog method has the following command format(s):
forms.editorDialog(path);
forms.editorDialog(recid, path);
Optional the ID of a previously recorded navigation, used for comparison purposes. May be null
.
a String specifying the path to identify the forms editorDialog. For example, //forms:editorDialog
. Must not be null
. Since it is only possible to show one editorDialog in Oracle Forms at runtime, it is not necessary to specify additional conditions in the path to locate the editorDialog object.
represents an exception that may be thrown during the execution of a script where the exception should be reported to an end user through the controller.
Identifies an Oracle Forms FlexWindow object by its path.
The forms.flexWindow method has the following command format(s):
forms.flexWindow(path);
forms.flexWindow(recid, path);
Optional the ID of a previously recorded navigation, used for comparison purposes. May be null
.
a String specifying the path to identify the forms flexWindow. For example, //forms:flexWindow
. Must not be null
. Since it is only possible to show one flexWindow in Oracle Forms at runtime, it is not necessary to specify additional conditions in the path to locate the flexWindow object.
represents an exception that may be thrown during the execution of a script where the exception should be reported to an end user through the controller.
Performs an action on an Oracle Forms FlexWindow object specified by its recorded ID and path.
forms.textField(156, "//forms:textField[" +
"(@name='LINES_ACCOUNTING_FLEXFIELD_0')]")
.openDialog();
forms.flexWindow(159, "//forms:flexWindow")
.setTextAndClickOk("Account Alias", "",
"01-000-2225-0000-000");
Gets the bar count shown in the bottom of the forms client.
The forms.getStatusBarCount method has the following command format(s):
forms.getStatusBarCount( );
represents an exception that may be thrown during the execution of a script where the exception should be reported to an end user through the controller.
Gets the error code shown in the status bar of the forms client.
The forms.getStatusBarErrorCode method has the following command format(s):
forms.getStatusBarErrorCode( );
represents an exception that may be thrown during the execution of a script where the exception should be reported to an end user through the controller.
Gets the item shown in the status bar of forms client.
The forms.getStatusBarItem method has the following command format(s):
forms.getStatusBarItem(barIndex, barItemIndex);
the index of the status bar starting from 0.
the item index of the status bar starting from 0.
represents an exception that may be thrown during the execution of a script where the exception should be reported to an end user through the controller.
Gets the item count shown in the status bar of forms client.
The forms.getStatusBarItemCount method has the following command format(s):
forms.getStatusBarItemCount(index);
represents an exception that may be thrown during the execution of a script where the exception should be reported to an end user through the controller.
Gets the message shown in the status bar of forms client.
The forms.getStatusBarMessage method has the following command format(s):
forms.getStatusBarMessage( );
represents an exception that may be thrown during the execution of a script where the exception should be reported to an end user through the controller.
Gets the record info shown in the status bar of the forms client.
The forms.getStatusBarRecordInfo method has the following command format(s):
forms.getStatusBarRecordInfo( );
represents an exception that may be thrown during the execution of a script where the exception should be reported to an end user through the controller.
Identifies an Oracle Forms helpDialog object by its path.
The forms.helpDialog method has the following command format(s):
forms.helpDialog(path);
forms.helpDialog(recid, path);
Optional the ID of a previously recorded navigation, used for comparison purposes. May be null
.
a String specifying the path to identify the forms helpDialog. For example, //forms:helpDialog
. Must not be null
. Since it is only possible to show one helpDialog in Oracle Forms at runtime, it is not necessary to specify additional conditions in the path to locate the helpDialog object.
represents an exception that may be thrown during the execution of a script where the exception should be reported to an end user through the controller.
Identifies an Oracle Forms HGridApp object by its path.
The forms.hGridApp method has the following command format(s):
forms.hGridApp(path);
forms.hGridApp(recid, path);
Optional the ID of a previously recorded navigation, used for comparison purposes. May be null
.
a String specifying the path to identify the forms HGridApp. For example, //hGridApp[@name='IEU_HGRID_IEU_HGRID_0']
. Must not be null
.
represents an exception that may be thrown during the execution of a script where the exception should be reported to an end user through the controller.
Identifies an Oracle Forms imageItem object by its path.
The forms.imageItem method has the following command format(s):
forms.imageItem(path);
forms.imageItem(recid, path);
Optional the ID of a previously recorded navigation, used for comparison purposes. May be null
.
a String specifying the path to identify the forms imageItem. For example, //forms:imageItem[(@name='NAV_CONTROLS_EXPAND_ALL_0')]
. Must not be null
.
represents an exception that may be thrown during the execution of a script where the exception should be reported to an end user through the controller.
Identifies an Oracle Forms infoBox object by its path.
The forms.infoBox method has the following command format(s):
forms.infoBox(path);
forms.infoBox(recid, path);
Optional the ID of a previously recorded navigation, used for comparison purposes. May be null
.
a String specifying the path to identify the forms infoBox. For example, //forms:infoBox
. Must not be null
. Since it is only possible to show one infoBox in Oracle Forms at runtime, it is not necessary to specify additional conditions in the path to locate the infoBox object.
represents an exception that may be thrown during the execution of a script where the exception should be reported to an end user through the controller.
Identifies an Oracle Forms list object by its path.
The forms.list method has the following command format(s):
forms.list(path);
forms.list(recid, path);
Optional the ID of a previously recorded navigation, used for comparison purposes. May be null
.
a String specifying the path to identify the forms list. For example, //forms:list[(@name='JTF_SORT_COLUMN1_0')]
. Must not be null
.
represents an exception that may be thrown during the execution of a script where the exception should be reported to an end user through the controller.
Performs an action on an Oracle Forms list object specified by its recorded ID and path.
String accessName=forms.list(25, "//forms:list[" + "(@name='GROUPS_SYSTEM_LINKAGE_FUNCTION_0')]") .getAccessibleName(); int itemCount=forms.list(25, "//forms:list[" + "(@name='GROUPS_SYSTEM_LINKAGE_FUNCTION_0')]") .getItemCount(); info("accessible Name: " + accessName); info("item count: " + itemCount); //getItemValue forms.list(25, "//forms:list[" + "(@name='GROUPS_SYSTEM_LINKAGE_FUNCTION_0')]") .selectItem("Usages"); String itemValue=forms.list(25, "//forms:list[" + "(@name='GROUPS_SYSTEM_LINKAGE_FUNCTION_0')]") .getItemValue(); info(itemValue); //isItemInList boolean isItem=forms.list(25, "//forms:list[" + "(@name='GROUPS_SYSTEM_LINKAGE_FUNCTION_0')]") .isItemInList("Usages"); if(!isItem)warn("Item not in list"); //isItemSelected boolean isSelected=forms.list(25, "//forms:list[" + "(@name='GROUPS_SYSTEM_LINKAGE_FUNCTION_0')]") .isItemSelected("Usages"); if(!isSelected)warn("Item not selected");
Identifies an Oracle Forms listOfValues object by its path.
The forms.listOfValues method has the following command format(s):
forms.listOfValues(path);
forms.listOfValues(recid, path);
Optional the ID of a previously recorded navigation, used for comparison purposes. May be null
.
a String specifying the path to identify the forms listOfValues. For example, //forms:listOfValues
. Must not be null
. Since it is only possible to show one listOfValues in Oracle Forms at runtime, it is not necessary to specify additional conditions in the path to locate the listOfValues object.
represents an exception that may be thrown during the execution of a script where the exception should be reported to an end user through the controller.
Performs an action on an Oracle Forms listOfValues object specified by its recorded ID and path.
//get item count int itemcount=forms.listOfValues(20, "//forms:listOfValues") .getItemCount(); info("Item count: " + itemcount); //get text String text = ""; for(int i=0;i<itemcount;i++) { text=forms.listOfValues(21, "//forms:listOfValues") .getText(i); info("Item " + i + "text: " + text); }
Identifies an Oracle Forms logonDialog object by its path.
The forms.logonDialog method has the following command format(s):
forms.logonDialog(path);
forms.logonDialog(recid, path);
Optional the ID of a previously recorded navigation, used for comparison purposes. May be null
.
a String specifying the path to identify the forms logonDialog. For example, //logonDialog
. Must not be null
. Since it is only possible to show one logonDialog in Oracle Forms at runtime, it is not necessary to specify additional conditions in the path to locate the logonDialog object.
represents an exception that may be thrown during the execution of a script where the exception should be reported to an end user through the controller.
Identifies an Oracle Forms otsHGrid object by its path.
The forms.otsHGrid method has the following command format(s):
forms.otsHGrid(path);
forms.otsHGrid(recid, path);
Optional the ID of a previously recorded navigation, used for comparison purposes. May be null
.
a String specifying the path to identify the forms otsHGrid. For example, //forms:otsHGrid[(@name='ASTEVENR_CONF_HGRID_ITEMS_0')]
. Must not be null
.
represents an exception that may be thrown during the execution of a script where the exception should be reported to an end user through the controller.
Identifies an Oracle Forms radioButton object by its path.
The forms.radioButton method has the following command format(s):
forms.radioButton(path);
forms.radioButton(recid, path);
Optional the ID of a previously recorded navigation, used for comparison purposes. May be null
.
a String specifying the path to identify the forms radioButton. For example, //forms:radioButton[(@name='EXPENDITURES_TRANSACTION_STATUS_REJECTED_0')]
. Must not be null
.
represents an exception that may be thrown during the execution of a script where the exception should be reported to an end user through the controller.
Performs an action on an Oracle Forms radioButton object specified by its recorded ID and path.
String radioLabel=forms.radioButton(24,"//forms:radioButton[" + "(@name='JOBS_QF_WHICH_JOBS_MY_UNCOMPLETED_0')]") .getLabel(); boolean isSelected=forms.radioButton(24, "//forms:radioButton[" + "(@name='JOBS_QF_WHICH_JOBS_MY_UNCOMPLETED_0')]") .isSelected(); info("radio label:"+radioLabel+" selected:"+isSelected); if(isSelected)warn("select error!"); forms.radioButton(24, "//forms:radioButton[" + "(@name='JOBS_QF_WHICH_JOBS_MY_UNCOMPLETED_0')]") .select();
Identifies an Oracle Forms responseBox object by its path.
The forms.responseBox method has the following command format(s):
forms.responseBox(path);
forms.responseBox(recid, path);
Optional the ID of a previously recorded navigation, used for comparison purposes. May be null
.
a String specifying the path to identify the forms responseBox. For example, //forms:responseBox
. Must not be null
. Since it is only possible to show one responseBox in Oracle Forms at runtime, it is not necessary to specify additional conditions in the path to locate the responseBox object.
represents an exception that may be thrown during the execution of a script where the exception should be reported to an end user through the controller.
Identifies an Oracle Forms schedulingDataClient object by its path.
The forms.schedulingDataClient method has the following command format(s):
forms.schedulingDataClient(path);
forms.schedulingDataClient(recid, path);
Optional the ID of a previously recorded navigation, used for comparison purposes. May be null
.
a String specifying the path to identify the forms schedulingDataClient. For example, //forms:schedulingDataClient[(@name='GANTT_GANTTBEAN_0')]
. Must not be null
.
represents an exception that may be thrown during the execution of a script where the exception should be reported to an end user through the controller.
Performs an action on an Oracle Forms schedulingDataClient object specified by its recorded ID and path.
forms.schedulingDataClient(32, "//forms:schedulingDataClient[" + "(@name='GANTT_GANTTBEAN_0')]") .clickNext(); forms.schedulingDataClient(33, "//forms:schedulingDataClient[" + "(@name='GANTT_GANTTBEAN_0')]") .clickPrevious(); forms.schedulingDataClient(34, "//forms:schedulingDataClient[" + "(@name='GANTT_GANTTBEAN_0')]") .clickAssigneeCell(3, 1);
Identifies an Oracle Forms spreadTable object by its path.
The forms.spreadTable method has the following command format(s):
forms.spreadTable(path);
forms.spreadTable(recid, path);
Optional the ID of a previously recorded navigation, used for comparison purposes. May be null
.
a String specifying the path to identify the forms spreadTable. For example, //forms:spreadTable[(@name='BLK_INBOX_INBOX_GRID_0')]
. Must not be null
.
represents an exception that may be thrown during the execution of a script where the exception should be reported to an end user through the controller.
Performs an action on an Oracle Forms spreadTable object specified by its recorded ID and path.
forms.spreadTable(66, "//forms:spreadTable[" + "(@name='SR_TASK_GRID_GRID_ITEM_0')]") .selectRows(1, 1); forms.spreadTable(66, "//forms:spreadTable[" + "(@name='SR_TASK_GRID_GRID_ITEM_0')]") .focusCell(1, 1); String cellValue=forms.spreadTable(66, "//forms:spreadTable[" + "(@name='SR_TASK_GRID_GRID_ITEM_0')]") .getCell(1, 2); forms.spreadTable(66, "//forms:spreadTable[" + "(@name='SR_TASK_GRID_GRID_ITEM_0')]") .storeCell("testVar", 1, 2); if(!cellValue.equals("{{testVar}}"))warn("get cell value error"); //test column count and row count forms.spreadTable(66, "//forms:spreadTable[" + "(@name='SR_TASK_GRID_GRID_ITEM_0')]") .verifyAttributes("objectTest1", forms.attributes( forms.attribute("columnCount", "42", TestOperator.StringExact), forms.attribute("rowCount", "2", TestOperator.StringExact))); forms.spreadTable(66, "//forms:spreadTable[" + "(@name='SR_TASK_GRID_GRID_ITEM_0')]") .focusRow(1);
Identifies an Oracle Forms StatusBar object by its recorded ID and path.
The forms.statusBar method has the following command format(s):
forms.statusBar(path);
forms.statusBar(recid, path);
a String specifying the path to identify the forms statusBar. For example, //forms:statusBar
. Must not be null
. Since it is only possible to show one statusBar in Oracle Forms at runtime, it is not necessary to specify additional conditions in the path to locate the Status Bar object.
Optional the ID of a previously recorded navigation, used for comparison purposes. May be null
.
represents an exception that may be thrown during the execution of a script where the exception should be reported to an end user through the controller.
Identifies an Oracle Forms tab object by its path.
The forms.tab method has the following command format(s):
forms.tab(path);
forms.tab(recid, path);
Optional the ID of a previously recorded navigation, used for comparison purposes. May be null
.
a String specifying the path to identify the forms tab. For example, //forms:tab[(@name='ATTRIBUTE_GROUPS_REGIONS')]
. Must not be null
.
represents an exception that may be thrown during the execution of a script where the exception should be reported to an end user through the controller.
Performs an action on an Oracle Forms tab object specified by its recorded ID and path.
forms.tab(485, "//forms:tab[" + "(@name='FLOWDOWN_TAB')]") .select("Terms & Conditions"); String selectedStr=forms.tab(485, "//forms:tab[" + "(@name='FLOWDOWN_TAB')]") .getSelectedTabLabel(); if(!selectedStr.equals("Terms & Conditions")) warn("getSelectedTabLabel() error"); boolean isItem=forms.tab(485, "//forms:tab[" + "(@name='FLOWDOWN_TAB')]") .isItemInList("Terms & Conditions"); if(!isItem) warn("isItemInList(string) error"); boolean isSelected=forms.tab(485, "//forms:tab[" + "(@name='FLOWDOWN_TAB')]") .isItemSelected("Terms & Conditions"); if(!isSelected) warn("isItemSelected(string) error");
Identifies an Oracle Forms tableBox object by its path.
The forms.tableBox method has the following command format(s):
forms.tableBox(path);
forms.tableBox(recid, path);
Optional the ID of a previously recorded navigation, used for comparison purposes. May be null
.
a String specifying the path to identify the forms tableBox. For example, //forms:tableBox
. Must not be null
. Since it is only possible to show one tableBox in Oracle Forms at runtime, it is not necessary to specify additional conditions in the path to locate the tableBox object.
represents an exception that may be thrown during the execution of a script where the exception should be reported to an end user through the controller.
Identifies an Oracle Forms textField object by its path.
The forms.textField method has the following command format(s):
forms.textField(path);
forms.textField(recid, path);
Optional the ID of a previously recorded navigation, used for comparison purposes. May be null
.
a String specifying the path to identify the forms textField. For example, //forms:textField[(@name='NAVIGATOR_TYPE_0')]
. Must not be null
.
represents an exception that may be thrown during the execution of a script where the exception should be reported to an end user through the controller.
Performs an action on an Oracle Forms textField object specified by its recorded ID and path.
forms.textField(248, "//forms:textField[" + "(@name='STUB_APPLICATION_NAME_0')]") .setFocus(); forms.textField(249,"//forms:textField[" + "(@name='STUB_APPLICATION_NAME_0')]") .setText("abc"); forms.textField("//forms:textField[" + "(@name='STUB_APPLICATION_NAME_0')]") .verifyAttributes("test1",forms.attributes( forms.attribute("enabled", "true", TestOperator.StringExact), forms.attribute("text", "Sales", TestOperator.StringExact), forms.attribute("visible", "true", TestOperator.StringExact), forms.attribute("name", "STUB_APPLICATION_NAME_0", TestOperator.StringExact), forms.attribute("showing", "true", TestOperator.StringExact), forms.attribute("prompt", "Application", TestOperator.StringExact), forms.attribute("editable", "true", TestOperator.StringExact)));
Identifies an Oracle Forms tree object by its path.
The forms.tree method has the following command format(s):
forms.tree(path);
forms.tree(recid, path);
Optional the ID of a previously recorded navigation, used for comparison purposes. May be null
.
a String specifying the path to identify the forms tree. For example, //forms:tree[@accessibleName='Navigator']
. Must not be null
.
represents an exception that may be thrown during the execution of a script where the exception should be reported to an end user through the controller.
Performs an action on an Oracle Forms tree object specified by its recorded ID and path.
forms.tree(24, "//forms:tree[(@name='APPTREE_NAV_TREE_NAVIGATOR_0')]") .selectNode("Personal Shortcuts"); forms.list(25, "//forms:list[(@name='APPTREE_VIEW_BY_VIEW_BY_0')]") .setFocus(); forms.tree(26, "//forms:tree[(@name='APPTREE_NAV_TREE_NAVIGATOR_0')]") .expandNode("People By Name"); forms.tree(27, "//forms:tree[(@name='APPTREE_NAV_TREE_NAVIGATOR_0')]") .selectNode("People By Name|A"); forms.tree(28, "//forms:tree[(@name='APPTREE_NAV_TREE_NAVIGATOR_0')]") .expandNode("People By Name|B"); forms.tree(29, "//forms:tree[(@name='APPTREE_NAV_TREE_NAVIGATOR_0')]") .collapseNode("People By Name|B");
Identifies an Oracle Forms treeList object by its path.
The forms.treeList method has the following command format(s):
forms.treeList(path);
forms.treeList(recid, path);
Optional the ID of a previously recorded navigation, used for comparison purposes. May be null
.
a String specifying the path to identify the forms treeList. For example, //forms:treeList[(@name='NAVIGATOR_LIST_0')]
. Must not be null
.
represents an exception that may be thrown during the execution of a script where the exception should be reported to an end user through the controller.
Identifies an Oracle Forms window object by its path.
The forms.window method has the following command format(s):
forms.window(path);
forms.window(recid, path);
Optional the ID of a previously recorded navigation, used for comparison purposes. May be null
.
a String specifying the path to identify the forms window. For example, //forms:window[(@name='NAVIGATOR')]
. Must not be null
.
represents an exception that may be thrown during the execution of a script where the exception should be reported to an end user through the controller.
Performs an action on an Oracle Forms window object specified by its recorded ID and path.
forms.window(24, "//forms:window[(@name='STUB')]") .activate(true); forms.window(25, "//forms:window[(@name='STUB')]") .clickToolBarButton("Save"); forms.statusBar(26, "//forms:statusBar").assertText( "FormsFT AutoValidation: Verify StatusBar text value", "FRM-40401: No changes to save.", MatchOption.Exact); forms.window(27, "//forms:window[(@name='STUB')]") .selectMenu("File|Print..."); boolean isMenu=forms.window(27, "//forms:window[" + "(@name='STUB')]") .isMenuEnabled("File|Print..."); if(!isMenu)warn("isMenuEnabled(string) error"); forms.window(28, "//forms:window[(@name='STUB')]") .close();