This chapter provides a complete listing and reference for the methods in the OpenScript FormsService Class of Forms Load Module Application Programming Interface (API).
The following section provides an alphabetical listing of the enums in the OpenScript FormsService 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 5-2 List of FormsService Methods
Method | Description |
---|---|
Identifies an Oracle Forms alertDialog object by its handler name. |
|
Initializes the Oracle Forms Application specified by its handler name. |
|
Searchs the status bar contents for the specified text pattern. |
|
Searches the text of selected source type for the specified text pattern. |
|
Identifies an Oracle Forms blockScroller object by its handler name. |
|
Identifies an Oracle Forms Button object by its handler name. |
|
Identifies an Oracle Forms cancelQueryDialog object by its recorded ID and handler name. |
|
Identifies an Oracle Forms canvas object by its recorded ID and handler name. |
|
Identifies an Oracle Forms cfmOLE object by its recorded ID and handler name. |
|
Identifies an Oracle Forms cfmVBX object by its recorded ID and handler name. |
|
Identifies an Oracle Forms CheckBox object by its handler name. |
|
Identifies an Oracle Forms choiceBox object by its handler name. |
|
Identifies an Oracle Forms comboBox object by its recorded ID and handler name. |
|
Connects to an Oracle Forms server. |
|
Disconnects from Oracle Forms Server. |
|
Identifies an Oracle Forms displayErrorDialog object by its recorded ID and handler name. |
|
Identifies an Oracle Forms displayList object by its recorded ID and handler name. |
|
Identifies an Oracle Forms editBox object by its handler name. |
|
Identifies an Oracle Forms editorDialog object by its recorded ID and handler name. |
|
Identifies an Oracle Forms flexWindow object by its handler name. |
|
Identifies an Oracle Forms genericClient object by its handler name. |
|
Returns the string version of contents for the specified ContentSource that was last retrieved for this virtual user. |
|
Gets the contents of the last known status bar text. |
|
Identifies an Oracle Forms helpDialog object by its handler name. |
|
Identifies an Oracle Forms image object by its recorded ID and handler name. |
|
Identifies an Oracle Forms infoBox object by its handler name. |
|
Identifies an Oracle Forms jContainer object by its handler name. |
|
Identifies an Oracle Forms PopList object by its handler name. |
|
Identifies an Oracle Forms List Of Values object by its handler name. |
|
Identifies an Oracle Forms Logon Dialog object by its handler name. |
|
Identifies an Oracle Forms menuParametersDialog object by its recorded ID and handler name. |
|
Identifies an Oracle Forms popupHelp object by its recorded ID and handler name. |
|
Identifies an Oracle Forms promptList object by its handler name. |
|
Identifies an Oracle Forms RadioButton object by its handler name. |
|
Registers a property for any object. |
|
Identifies an Oracle Forms responseBox object by its handler name. |
|
Sends an Oracle Forms Message to the Oracle Forms server. |
|
Sends raw Oracle Forms Messages to the Oracle Forms server. |
|
Sends an Oracle Forms Terminal Message request to the Oracle Forms server. |
|
Parses a value from the source of latest action and store it as a variable. |
|
Identifies an Oracle Forms statusBar object by its recorded ID and handler name. |
|
Identifies an Oracle Forms TabControl object by its handler name. |
|
Identifies an Oracle Forms tableBox object by its recorded ID and handler name. |
|
Creates a reference to a text field object in the Forms applet by handler name. |
|
Identifies an Oracle Forms timer object by its handler name. |
|
Identifies an Oracle Forms Tree object by its handler name. |
|
Identifies an Oracle Forms TreeList object by its handler name. |
|
Unregister a property that was previously registered using |
|
Searchs the status bar contents for the specified text pattern and performs a verify only matching test. |
|
Searches the text of selected source type for the specified text pattern performing a verify only text match. |
|
Identifies an Oracle Forms FormWindow object by its handler name. |
The following sections provide detailed reference information for each method and enum in the FormsService Class of Forms Load Module Application Programming Interface.
Identifies an Oracle Forms alertDialog object by its handler name.
The nca.alertDialog method has the following command format(s):
nca.alertDialog(handlerName);
nca.alertDialog(recid, handlerName);
Optional. The ID of a previously recorded navigation, used for comparison purposes. May be null
.
a String specifying the handler name of the alertDialog. Must not be null
.
if the object is not found.
a new TFormsLTAlertDialog object.
Performs an action on an Oracle Forms alertDialog object specified by its recorded ID and handler name.
nca.window(436, "GROUPS_DETAIL").activate("");
nca.alertDialog(437, "Forms").clickButton(2, "12");
nca.textField(438, "GROUPS_EXPENDITURE_GROUP_0").select(0, 4, 4, "1");
Initializes the Oracle Forms Application specified by its handler name.
The nca.application method has the following command format(s):
nca.application(handlerName);
nca.application(recid, handlerName);
Optional. The ID of a previously recorded navigation, used for comparison purposes. May be null
.
a String specifying the handler name of the Form Application. Must not be null
.
if the object is not found.
a new TFormsLTRunForm object.
Performs an action on an Oracle Forms Application specified by its recorded ID and handler name.
nca.application(161, "Oracle Applications").sendMessage(
"<Message mActionString=\"MSG_UPDATE\" mActionCode=\"2\" " +
"mHandlerClassId=\"1\" mHandlerId=\"1\">\r\n" +
<Property actionString=\"HEARTBEAT\" action=\"517\" " +
"type=\"null\" />\r\n</Message>\r\n", "1");
Searchs the status bar contents for the specified text pattern.
If the test fails, always fail the script unless the status bar text test error recovery setting specifies a different action such as Warn or Ignore. If any part of the status bar text matches textToAssert
, the assertion succeeds.
The nca.assertStatusBarText method has the following command format(s):
nca.assertStatusBarText(testName, textToAssert, matchOption);
nca.assertStatusBarText(recId, testName, textToVerify, matchOption);
Optional the ID of a previously recorded navigation, used for comparison purposes. May be null
.
a String specifying the test name.
a String specifying the Text to match on the page, or not match on the page if TextPresence is set as PassIfPresent.
a MatchOption enum specifying how the text to match should be searched on the page, such as using a regular expression, wildcard, or exact match.
a String specifying the Text to match on the page, or not match on the page if TextPresence is set as PassIfPresent.
on any other failure when attempting to assert the text.
if the assertion fails.
Verifies the specified text matches exactly.
nca.assertStatusBarText(161, "Assert StatusBar Text" +
"text value", "FRM-40400: Transaction complete: " +
"1 records applied and saved.", MatchOption.Exact);
Searches the text of selected source type for the specified text pattern.
If the test fails, always fail the script unless the text matching test error recovery setting specifies a different action such as Warn or Ignore.
If any part of the source text matches textToAssert
, the assertion succeeds.
The nca.assertText method has the following command format(s):
nca.assertText(testName, textToAssert, sourceType, textPresence, matchOption);
a String specifying the test name.
a String specifying the Text to match on the page, or not match on the page if TextPresence is set as PassIfPresent.
a NcaSource enum specifying where to match the text, i.e. in the Object Details, Request and Response, or Status Bar text.
a TestPresence enum specifying either PassIfPresent or FailIfPresent, depending on if you want the test to pass or fail if the text to match is present or not.
a MatchOption enum specifying how the text to match should be searched on the page, such as using a regular expression, wildcard, or exact match.
if the assertion fails.
on any other failure when attempting to assert the text.
Adds Text Matching tests for Statu Bar text.
nca.assertText("myTextMatchingTest", "match this text string",
NcaSource.StatusBarText, TextPresence.PassIfPresent, MatchOption.Exact);
Identifies an Oracle Forms blockScroller object by its handler name.
The nca.blockScroller method has the following command format(s):
nca.blockScroller(handlerName);
nca.blockScroller(recid, handlerName);
Optional the ID of a previously recorded navigation, used for comparison purposes. May be null
.
a String specifying the handler name of the blockScroller. Must not be null
.
if the object is not found.
a new TFormsLTBlockScroller object.
Performs an action on an Oracle Forms blockScroller object specified by its recorded ID and handler name.
nca.textField(571, "PROJECT_OPTIONS_OPTION_NAME_DISP_5") .select(0, 0, 0, ""); nca.textField(572, "PROJECT_OPTIONS_OPTION_NAME_DISP_6") .setFocus("1"); nca.application(573, "Oracle Applications") .sendMessage("<Message mActionString=\"MSG_UPDATE\" mActionCode=\"2\" " + "mHandlerClassId=\"1\" mHandlerId=\"1\">\r\n" + <Property actionString=\"HEARTBEAT\" action=\"517\" " + " type=\"null\" />\r\n</Message>\r\n", "1"); nca.textField(574, "PROJECT_OPTIONS_OPTION_NAME_DISP_6") .select(0, 27, 27, ""); nca.blockScroller(575, "COMPONENT_ID_478").scrollTo(0, 8, "1"); nca.blockScroller(575, "COMPONENT_ID_478").scrollPageUp(0, 1); nca.blockScroller(575, "COMPONENT_ID_478").scrollPageDown(0, 1); nca.textField(576, "PROJECT_OPTIONS_OPTION_NAME_DISP_7") .select(0, 18, 18, ""); nca.textField(577, "PROJECT_OPTIONS_OPTION_NAME_DISP_6") .clearFocus(""); nca.textField(578, "PROJECT_OPTIONS_OPTION_NAME_DISP_6") .select(0, 0, 0, ""); nca.textField(579, "PROJECT_OPTIONS_OPTION_NAME_DISP_7") .setFocus("");
Identifies an Oracle Forms Button object by its handler name.
The nca.button method has the following command format(s):
nca.button(handlerName);
nca.button(recid, handlerName);
Optional the ID of a previously recorded navigation, used for comparison purposes. May be null
.
a String specifying the handler name of the Button. Must not be null
.
if the object is not found.
a new TFormsLTButton object.
Performs an action on an Oracle Forms Button object specified by its recorded ID and handler name.
nca.button(130, "FOLDER_QF_NEW_HEADER_0").setFocus("1"); nca.button(131, "FOLDER_QF_NEW_HEADER_0").click();
Identifies an Oracle Forms cancelQueryDialog object by its recorded ID and handler name.
The nca.cancelQueryDialog method has the following command format(s):
nca.cancelQueryDialog(recid, handlerName);
Optional the ID of a previously recorded navigation, used for comparison purposes. May be null
.
a String specifying the handler name of the cancelQueryDialog. Must not be null
.
if the object is not found.
a new TFormsLTCancelQueryDialog object.
Identifies an Oracle Forms cancelQueryDialog object specified by its recorded ID and handler name.
nca.cancelQueryDialog(169, "cancelQueryDialog");
Identifies an Oracle Forms canvas object by its recorded ID and handler name.
The nca.canvas method has the following command format(s):
nca.canvas(recid, handlerName);
Optional the ID of a previously recorded navigation, used for comparison purposes. May be null
.
a String specifying the handler name of the canvas. Must not be null
.
if the object is not found.
a new TFormsLTCanvas object.
Identifies an Oracle Forms canvas object specified by its recorded ID and handler name.
nca.canvas(169, "canvas");
Identifies an Oracle Forms cfmOLE object by its recorded ID and handler name.
The nca.cfmOLE method has the following command format(s):
nca.cfmOLE(recid, handlerName);
Optional the ID of a previously recorded navigation, used for comparison purposes. May be null
.
a String specifying the handler name of the cfmOLE. Must not be null
.
if the object is not found.
a new TFormsLTCfmOLE object.
Identifies an Oracle Forms cfmOLE object specified by its recorded ID and handler name.
nca.cfmOLE(169, "cfmole");
Identifies an Oracle Forms cfmVBX object by its recorded ID and handler name.
The nca.cfmVBX method has the following command format(s):
nca.cfmVBX(recid, handlerName);
Optional the ID of a previously recorded navigation, used for comparison purposes. May be null
.
a String specifying the handler name of the cfmVBX. Must not be null
.
if the object is not found.
a new TFormsLTCfmVBX object.
Identifies an Oracle Forms cfmVBX object specified by its recorded ID and handler name.
nca.cfmVBX(169, "cfmVBX");
Identifies an Oracle Forms CheckBox object by its handler name.
The nca.checkBox method has the following command format(s):
nca.checkBox(handlerName);
nca.checkBox(recid, handlerName);
Optional the ID of a previously recorded navigation, used for comparison purposes. May be null
.
a String specifying the handler name of the CheckBox. Must not be null
.
if the object is not found.
a new TFormsLTCheckBox object.
Performs an action on an Oracle Forms CheckBox object specified by its recorded ID and handler name.
nca.checkBox(289, "GROUPS_ALLOW_NEGATIVE_TR_0").setFocus(); nca.checkBox(291, "GROUPS_ALLOW_NEGATIVE_TR_0").check(true); nca.checkBox(297, "GROUPS_ALLOW_NEGATIVE_TR_0").clearFocus();
Identifies an Oracle Forms choiceBox object by its handler name.
The nca.choiceBox method has the following command format(s):
nca.choiceBox(handlerName);
nca.choiceBox(recid, handlerName);
Optional the ID of a previously recorded navigation, used for comparison purposes. May be null
.
a String specifying the handler name of the choiceBox. Must not be null
.
if the object is not found.
a new TFormsLTChoiceBoxMessenger object.
Performs an action on an Oracle Forms choiceBox object specified by its recorded ID and handler name.
nca.button(264, "GROUPS_SUBMIT_0").click("1"); nca.button(265, "GROUPS_SUBMIT_0").sendMessage( "<Message mActionString=\"MSG_GET\" mActionCode=\"4\" " + "mHandlerClassId=\"261\" mHandlerId=\"289\">\r\n" + <Property actionString=\"VISIBLERECT\" action=\"155\" " + "type=\"java.awt.Rectangle\" topleftx=\"0.0\" " + toplefty=\"0.0\" width=\"124.0\" height=\"28.0\"/>\r\n" + </Message>\r\n", "3"); nca.textField(266, "GROUPS_OPERATING_UNIT_0").select(0, 17, 17, ""); nca.button(267, "GROUPS_SUBMIT_0").clearFocus(""); nca.textField(268, "GROUPS_OPERATING_UNIT_0").setFocus(""); nca.window(269, "GROUPS_DETAIL").deactivate("11"); String alertMsg=nca.choiceBox(270, "Error").getAlertMessage(); info("alert message:"+alertMsg); nca.choiceBox(270, "Error").clickButton(0); nca.textField(271, "GROUPS_OPERATING_UNIT_0").select(0, 17, 17, "");
Identifies an Oracle Forms comboBox object by its recorded ID and handler name.
The nca.comboBox method has the following command format(s):
nca.comboBox(recid, handlerName);
Optional the ID of a previously recorded navigation, used for comparison purposes. May be null
.
a String specifying the handler name of the comboBox. Must not be null
.
if the object is not found.
a new TFormsLTComboBox object.
Identifies an Oracle Forms comboBox object specified by its recorded ID and handler name.
nca.comboBox(169, "comboBox");
Connects to an Oracle Forms server.
If already connected to an Oracle Forms server, this method quietly returns.
The nca.connect method has the following command format(s):
nca.connect(connMode, formsServerHost, serverPort, formsUrl);
nca.connect(recId, connMode, formsServerHost, serverPort, formsUrl);
Optional the ID of a previously recorded navigation, used for comparison purposes. May be null
.
a ConnectMode enum specifing if the Forms server expects to use Socket or HTTP connection mode.
a String specfying the server host. For ConnectMode.Socket
, specify the host name or IP of the Oracle Forms server to connect to. For ConnectMode.HTTP
, this parameter is ignored and should be null
.
a value specifying the server port. For ConnectMode.Socket
, specify the port number on the Oracle Forms server to connect to. For ConnectMode.HTTP
, this parameter is ignored and should be 0
.
a String specifying the URL. For ConnectMode.HTTP
, specify the Oracle Forms URL to which the Forms applet posts messages. This URL is specified in the Oracle Forms Applet loading web page. The Oracle Forms Recorder automatically records this URL and correlates it appropriately. For ConnectMode.Socket
, this parameter is ignored and should be null
.
on a failure to connect to the Oracle Forms server.
Connects to the specified Oracle Forms server.
nca.connect(90, ConnectMode.HTTP, null, 0, "http://myserver.com:8002
{{formsload.url,/forms/lservlet;jsessionid=" +
8c57166455fa6173d468e0ae4e09966886262ac3b5b3.e38ObheNbx4Ne38Qe0}}");
Disconnects from Oracle Forms Server.
If not connected to the Forms server, this method quietly returns.
IMPORTANT: No matter how Forms statements are programmed, nca.disconnect()
must be the last statement to disconnect from the Forms server. In mulitple iterations if nca.connect()
is called in each iteration, nca.disconnect()
must be called before the end of each iteration.
The nca.disconnect method has the following command format(s):
nca.disconnect( );
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.
Disconnects from Oracle Forms Server.
nca.disconnect();
Identifies an Oracle Forms displayErrorDialog object by its recorded ID and handler name.
The nca.displayErrorDialog method has the following command format(s):
nca.displayErrorDialog(recid, handlerName);
Optional the ID of a previously recorded navigation, used for comparison purposes. May be null
.
a String specifying the handler name of the displayErrorDialog. Must not be null
.
if the object is not found.
a new TFormsLTDisplayErrorDialog object.
Identifies an Oracle Forms displayErrorDialog object specified by its recorded ID and handler name.
nca.comboBox(169, "comboBox");
Identifies an Oracle Forms displayList object by its recorded ID and handler name.
The nca.displayList method has the following command format(s):
nca.displayList(recid, handlerName);
Optional the ID of a previously recorded navigation, used for comparison purposes. May be null
.
a String specifying the handler name of the displayList. Must not be null
.
if the object is not found.
a new TFormsLTDisplayList object.
Identifies an Oracle Forms displayList object specified by its recorded ID and handler name.
nca.displayList(169, "displayList");
Identifies an Oracle Forms editBox object by its handler name.
The nca.editBox method has the following command format(s):
nca.editBox(handlerName);
nca.editBox(recid, handlerName);
Optional the ID of a previously recorded navigation, used for comparison purposes. May be null
.
a String specifying the handler name of the editBox. Must not be null
.
if the object is not found.
a new TFormsLTEditBoxMessenger object.
Performs an action on an Oracle Forms editBox object specified by its recorded ID and handler name.
nca.window(123, "GROUPS_DETAIL").activate("21");
nca.textField(124, "GROUPS_OPERATING_UNIT_0").select(0, 17, 17, "");
nca.window(125, "GROUPS_DETAIL").selectMenu(
"HELP.ABOUT_ORACLE_APPLICATIONS", "1");
nca.window(126, "GROUPS_DETAIL").deactivate("1");
nca.editBox(127, "About Oracle Applications").clickOk("");
nca.textField(128, "GROUPS_OPERATING_UNIT_0").select(0, 17, 17, "");
Identifies an Oracle Forms editorDialog object by its recorded ID and handler name.
The nca.editorDialog method has the following command format(s):
nca.editorDialog(handlerName);
nca.editorDialog(recid, handlerName);
Optional the ID of a previously recorded navigation, used for comparison purposes. May be null
.
a String specifying the handler name of the editorDialog. Must not be null
.
if the object is not found.
a new TFormsLTEditorDialog object.
Performs an action on an Oracle Forms editorDialog object specified by its recorded ID and handler name.
nca.textField(485, "GROUPS_EXPENDITURE_GROUP_0")
.sendMessage("<Message mActionString=\"MSG_GET\" " +
"mActionCode=\"4\" mHandlerClassId=\"257\" mHandlerId=\"272\">\r\n" +
"<Property actionString=\"VISIBLERECT\" action=\"155\" " +
"type=\"java.awt.Rectangle\" topleftx=\"0.0\" toplefty=\"0.0\" "
"width=\"173.0\" height=\"24.0\"/>\r\n</Message>\r\n", "3");
nca.window(486, "GROUPS_DETAIL").selectMenu("EDIT.EDIT_FIELD", "1");
nca.window(487, "GROUPS_DETAIL").deactivate("1");
nca.editorDialog(488, "Editor").setText("ABCD");
nca.textField(489, "GROUPS_EXPENDITURE_GROUP_0").setCursorPosition(4, "");
Identifies an Oracle Forms flexWindow object by its handler name.
The nca.flexWindow method has the following command format(s):
nca.flexWindow(handlerName);
nca.flexWindow(recid, handlerName);
Optional the ID of a previously recorded navigation, used for comparison purposes. May be null
.
a String specifying the handler name of the flexWindow. Must not be null
.
if the object is not found.
a new TFormsLTFlexWindowMessenger object.
Performs an action on an Oracle Forms flexWindow object specified by its recorded ID and handler name.
nca.textField(141, "WORK_ORDER_PARAMETERS_0").setFocus("2"); nca.listOfValues(142, "Reporting Level").displayRows(1, 2, "1"); nca.listOfValues(143, "Reporting Level").selectByIndex(1, "1"); nca.application(144, "Oracle Applications").sendMessage( "<Message mActionString=\"MSG_UPDATE\" mActionCode=\"2\" " + "mHandlerClassId=\"1\" mHandlerId=\"1\">\r\n" + "<Property actionString=\"HEARTBEAT\" action=\"517\" " + "type=\"null\" />\r\n</Message>\r\n","1"); nca.flexWindow(145, "Parameters").clickLOV(1, 0, "122"); nca.listOfValues(146, "Reporting Context").displayRows(1, 11, "1"); nca.listOfValues(147, "Reporting Context").clickCancel("1"); nca.flexWindow(148, "Parameters").focusField(2, 0, "1"); nca.flexWindow(149, "Services Accounting Flex").clickCancel("1"); nca.flexWindow(150, "Parameters").focusField(3, 0, "1"); nca.flexWindow(151, "Services Accounting Flex").clickClear("1");
Identifies an Oracle Forms genericClient object by its handler name.
The nca.genericClient method has the following command format(s):
nca.genericClient(handlerName);
nca.genericClient(recid, handlerName);
Optional the ID of a previously recorded navigation, used for comparison purposes. May be null
.
a String specifying the handler name of the genericClient. Must not be null
.
if the object is not found.
a new TFormsLTGenericClientMessenger object.
Performs an action on an Oracle Forms genericClient object specified by its recorded ID and handler name.
nca.genericClient(96, "COMPONENT_ID_54").sendGenericClientMessage(); nca.genericClient(96, "COMPONENT_ID_54").sendGenericClientMessage("", "1");
Returns the string version of contents for the specified ContentSource that was last retrieved for this virtual user.
The nca.getLastKnownContents method has the following command format(s):
nca.getLastKnownContents(sourceType);
an NcaSource Enum specifying the portion of the contents to return as a String. If null
, assumes NcaSource.ObjectDetails.
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.
String version of the contents last retrieved by the client. Returns null if contents are null.
Gets the specified last known contents.
String details = nca.getLastKnownContents(NcaSource.ObjectDetails); info("Object Details " + details); String reqresp = nca.getLastKnownContents(NcaSource.RequestsAndResponses); info("Requests and Responses " + reqresp); String statusbar = nca.getLastKnownContents(NcaSource.StatusBarText); info("StatusBarText " + statusbar);
Gets the contents of the last known status bar text.
This is useful when user wants to grab the last known value of the status bar within the script.
The nca.getStatusBarText method has the following command format(s):
nca.getStatusBarText( );
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.
String value for the last known text value of the status bar. If the server has never updated the status bar, this method returns an empty string. This method never returns null
.
Gets the contents of the last known status bar text.
String statusBarText1=nca.getStatusBarText();
info("exist status bar text:"+statusBarText1);
Identifies an Oracle Forms helpDialog object by its handler name.
The nca.helpDialog method has the following command format(s):
nca.helpDialog(handlerName);
nca.helpDialog(recid, handlerName);
Optional the ID of a previously recorded navigation, used for comparison purposes. May be null
.
a String specifying the handler name of the helpDialog. Must not be null
.
if the object is not found.
a new TFormsLTHelpDialog object.
Performs an action on an Oracle Forms helpDialog object specified by its recorded ID and handler name.
nca.window(121, "GROUPS_DETAIL").activate("");
nca.textField(122, "GROUPS_OPERATING_UNIT_0").select(0, 17, 17, "");
nca.helpDialog(123, "Keys").clickCancel("1");
Identifies an Oracle Forms image object by its recorded ID and handler name.
The nca.image method has the following command format(s):
nca.image(recid, handlerName);
Optional the ID of a previously recorded navigation, used for comparison purposes. May be null
.
a String specifying the handler name of the image. Must not be null
.
if the object is not found.
a new TFormsLTImage object.
Identifies an Oracle Forms image object specified by its recorded ID and handler name.
nca.image(169, "image");
Identifies an Oracle Forms infoBox object by its handler name.
The nca.infoBox method has the following command format(s):
nca.infoBox(handlerName);
nca.infoBox(recid, handlerName);
Optional the ID of a previously recorded navigation, used for comparison purposes. May be null
.
a String specifying the handler name of the infoBox. Must not be null
.
if the object is not found.
a new TFormsLTInfoBoxMessenger object.
Performs an action on an Oracle Forms infoBox object specified by its recorded ID and handler name.
nca.window(1033, "GROUPS_DETAIL").activate("1");
nca.window(1034, "GROUPS_DETAIL").selectMenu("HELP.RECORD_HISTORY",
"1");
nca.window(1035, "GROUPS_DETAIL").deactivate("1");
nca.infoBox(1036, "About This Record").clickOk();
Identifies an Oracle Forms jContainer object by its handler name.
The nca.jContainer method has the following command format(s):
nca.jContainer(handlerName);
nca.jContainer(recid, handlerName);
Optional the ID of a previously recorded navigation, used for comparison purposes. May be null
.
a String specifying the handler name of the jContainer. Must not be null
.
if the object is not found.
a new TFormsLTJavaContainer object.
Performs an action on an Oracle Forms jContainer object specified by its recorded ID and handler name.
nca.window(9078, "FOLDER_INCIDENT_TRACKING").activate("2"); nca.textField(9079, "CREATE_TASK_PLANNED_END_DATE_UI_0") .select(0, 20, 20, ""); nca.button(9080, "CALENDAR_OK_0").clearFocus(""); nca.textField(9081, "CREATE_TASK_PLANNED_END_DATE_UI_0") .setFocus("1"); nca.window(9082, "Oracle Applications - Main Window") .resize(1364, 768, "1"); nca.textField(9083, "CREATE_TASK_PLANNED_END_DATE_UI_0") .clearFocus(""); nca.jContainer(9084, "SR_TASK_GRID_GRID_ITEM_0") .setFocus(""); nca.jContainer(9085, "SR_TASK_GRID_GRID_ITEM_0") .sendMessage("<Message mActionString=\"MSG_UPDATE\" mActionCode=\"2\" " + "mHandlerClassId=\"271\" mHandlerId=\"496\">\r\n" + "<Property actionString=\"EVENT\" action=\"398\" " + "type=\"oracle.forms.engine.Message\" >\r\n" + "<Message mActionString=\"MSG_UPDATE\" mActionCode=\"2\" " + "mHandlerClassId=\"271\" mHandlerId=\"496\">\r\n" + "<Property actionString=\"EVENTNAME\" action=\"399\" " + "type=\"java.lang.String\" value=\"focusChanged\"/>\r\n" + "<Property actionString=\"EVENT_ARGNAME\" action=\"400\" " + "type=\"java.lang.String\" value=\"currentColumn\"/>\r\n" + "<Property actionString=\"EVENT_ARGVALUE\" action=\"401\" " + "type=\"java.lang.String\" value=\" \"/>\r\n" + "<Property actionString=\"EVENT_ARGNAME\" action=\"400\" " + "type=\"java.lang.String\" value=\"currentRow\"/>\r\n" + "<Property actionString=\"EVENT_ARGVALUE\" action=\"401\" " + "type=\"java.lang.String\" value=\"2\"/>\r\n" + </Message>\r\n</Property>\r\n</Message>\r\n", "12"); nca.timer(9086, "COMPONENT_ID_1216").expired("1"); nca.window(9087, "FOLDER_INCIDENT_TRACKING").deactivate("1");
Identifies an Oracle Forms PopList object by its handler name.
The nca.list method has the following command format(s):
nca.list(handlerName);
nca.list(recid, handlerName);
Optional the ID of a previously recorded navigation, used for comparison purposes. May be null
.
a String specifying the handler name of the PopList. Must not be null
.
if the object is not found.
a new TFormsLTPopListItem object.
Performs an action on an Oracle Forms PopList object specified by its recorded ID and handler name.
nca.list(120, "GROUPS_SYSTEM_LINKAGE_FUNCTION_0") .setFocus(); nca.list(121, "GROUPS_SYSTEM_LINKAGE_FUNCTION_0") .sendMessage("<Message mActionString=\"MSG_UPDATE\" " + "mActionCode=\"2\" mHandlerClassId=\"263\" " + "mHandlerId=\"274\">\r\n<Property actionString=\"MOUSEDOWN\" " + "action=\"180\" type=\"oracle.forms.engine.Message\" >\r\n" + "<Message mActionString=\"MSG_UPDATE\" mActionCode=\"2\" " + "mHandlerClassId=\"263\" mHandlerId=\"274\">\r\n" + "<Property actionString=\"MOUSEDOWN_POS\" action=\"185\" " + "type=\"java.awt.Point\" pointx=\"185.0\" " + "pointy=\"11.0\"/>\r\n" + "<Property actionString=\"MOUSEDOWN_MOD\" action=\"186\" " + "type=\"java.lang.Byte\" value=\"16\"/>\r\n" + "</Message>\r\n</Property>\r\n</Message>\r\n", "1");
Identifies an Oracle Forms List Of Values object by its handler name.
The nca.listOfValues method has the following command format(s):
nca.listOfValues(handlerName);
nca.listOfValues(recid, handlerName);
Optional the ID of a previously recorded navigation, used for comparison purposes. May be null
.
a String specifying the handler name of the List Of Values. Must not be null
.
if the object is not found.
a new TFormsLTListValuesDialog object.
Performs an action on an Oracle Forms List Of Values object specified by its recorded ID and handler name.
nca.listOfValues(133, "Customers").searchByText("cus", "1"); nca.listOfValues(134, "Customers").displayRows(1, 1, "1");
Identifies an Oracle Forms Logon Dialog object by its handler name.
The nca.logon method has the following command format(s):
nca.logon(handlerName);
nca.logon(recid, handlerName);
Optional the ID of a previously recorded navigation, used for comparison purposes. May be null
.
a String specifying the handler name of the Logon Dialog. Must not be null
.
if the object is not found.
a new TFormsLTLogonDialog object.
Performs an action on an Oracle Forms Logon Dialog object specified by its recorded ID and handler name.
nca.logon(133, "Logon").connect("username", "password", "database");
Identifies an Oracle Forms menuParametersDialog object by its recorded ID and handler name.
The nca.menuParametersDialog method has the following command format(s):
nca.menuParametersDialog(recid, handlerName);
Optional the ID of a previously recorded navigation, used for comparison purposes. May be null
.
a String specifying the handler name of the menuParametersDialog. Must not be null
.
if the object is not found.
a new TFormsLTMenuParametersDialog object.
Identifies an Oracle Forms menuParametersDialog object specified by its recorded ID and handler name.
nca.menuParametersDialog(169, "menu");
Identifies an Oracle Forms popupHelp object by its recorded ID and handler name.
The nca.popupHelp method has the following command format(s):
nca.popupHelp(recid, handlerName);
Optional the ID of a previously recorded navigation, used for comparison purposes. May be null
.
a String specifying the handler name of the popupHelp. Must not be null
.
if the object is not found.
a new TFormsLTPopupHelp object.
Identifies an Oracle Forms popupHelp object specified by its recorded ID and handler name.
nca.popupHelp(169, "popupHelp");
Identifies an Oracle Forms promptList object by its handler name.
The nca.promptList method has the following command format(s):
nca.promptList(recid, handlerName);
Optional the ID of a previously recorded navigation, used for comparison purposes. May be null
.
a String specifying the handler name of the tpromptList. Must not be null
.
if the object is not found.
a new TFormsLTPromptList object.
Identifies an Oracle Forms promptList object specified by its recorded ID and handler name.
nca.promptList(172, "promptList");
Identifies an Oracle Forms RadioButton object by its handler name.
The nca.radioButton method has the following command format(s):
nca.radioButton(handlerName);
nca.radioButton(recid, handlerName);
Optional the ID of a previously recorded navigation, used for comparison purposes. May be null
.
a String specifying the handler name of the RadioButton. Must not be null
.
if the object is not found.
a new TFormsLTRadioButton object.
Performs an action on an Oracle Forms RadioButton object specified by its recorded ID and handler name.
nca.radioButton(724, "JOBS_QF_WHICH_JOBS_ALL_MY_JOBS_0").setFocus("1"); nca.radioButton(725, "JOBS_QF_WHICH_JOBS_ALL_MY_JOBS_0") .sendMessage("<Message mActionString=\"MSG_UPDATE\" " + "mActionCode=\"2\" mHandlerClassId=\"267\" " + "mHandlerId=\"375\">\r\n<Property actionString=\"MOUSEUP\" " + "action=\"181\" type=\"oracle.forms.engine.Message\" >\r\n" + "<Message mActionString=\"MSG_UPDATE\" mActionCode=\"2\" " + "mHandlerClassId=\"267\" mHandlerId=\"375\">\r\n" + "<Property actionString=\"MOUSEDOWN_POS\" action=\"185\" " + "type=\"java.awt.Point\" pointx=\"1.0\" pointy=\"8.0\"/>\r\n" + "<Property actionString=\"MOUSEDOWN_MOD\" action=\"186\" " + "type=\"java.lang.Byte\" value=\"16\"/>\r\n" + "</Message>\r\n</Property>\r\n</Message>\r\n", ""); nca.radioButton(726, "JOBS_QF_WHICH_JOBS_ALL_MY_JOBS_0").select(""); nca.radioButton(727, "JOBS_QF_WHICH_JOBS_ALL_MY_JOBS_0").unselect("");
Registers a property for any object.
The property will be sent to the server in subsequent client request(s) in the following cases:
If the server asks the client for a specific property, the client responds with the property using a MSG_GET
type message.
Whenever a client sends a MSG_UPDATE
type message for an object, the client will send any registered properties in the message.
If a property is already registered, this method will overwrite its existing value.
If a property does not exist, this method will add the property.
The nca.registerProperty method has the following command format(s):
nca.registerProperty(name, value, handlerId, options);
a String specifying the name of the property to be registered.
a Property value in its Object form. The type of the object is inferred automatically when the property value is submitted to the server. For example, if a boolean true
value is specified, then the property will be submitted to the server using type "java.lang.boolean".
the specific object for which this property should be registered. The object does NOT have to exist at the time this method is invoked.
a RegisterPropertyOptions enum specifying the scenario in which to register the custom property, such as only when sending a MSG_GET message
, or when sending a MSG_UPDATE
message.
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.
if the name is null
.
Example 1 Sends a WINSYS_REQUIREDVA_LIST property when the application is initialized.
Example 2 Registers a blank custom TITLE property for a window in case the server asks for the title later in the script.
//Example 1 nca.registerProperty("WINSYS_REQUIREDVA_LIST", "true", 1, RegisterPropertyOptions.RegisterForMSG_UPDATE); nca.application("ORACLE_APPLICATIONS").initialize(...); //Example 2 nca.registerProperty("TITLE", "", 6, RegisterPropertyOptions.RegisterForMSG_GET);
Identifies an Oracle Forms responseBox object by its handler name.
The nca.responseBox method has the following command format(s):
nca.responseBox(handlerName);
nca.responseBox(recid, handlerName);
Optional the ID of a previously recorded navigation, used for comparison purposes. May be null
.
a String specifying the handler name of the responseBox. Must not be null
.
if the object is not found.
a new TFormsLTResponseBoxMessenger object.
Performs an action on an Oracle Forms responseBox object specified by its recorded ID and handler name.
nca.window(263, "GROUPS_DETAIL").activate("2"); nca.textField(264, "GROUPS_OPERATING_UNIT_0").select(0, 17, 17, ""); nca.textField(265, "GROUPS_OPERATING_UNIT_0").setFocus("1"); nca.textField(266, "GROUPS_OPERATING_UNIT_0").select(0, 17, 17, ""); nca.window(267, "GROUPS_DETAIL").selectMenu( "PREFERENCES.CHANGE_PASSWORD", "1"); nca.textField(268, "GROUPS_OPERATING_UNIT_0").clearFocus(""); nca.window(269, "GROUPS_DETAIL").deactivate("1"); nca.responseBox(270, "Password Update").validate("F", 0, "sdfas,,", "1"); nca.responseBox(271, "Password Update").validate("F", 1, "sdfas,as,", "1"); nca.responseBox(272, "Password Update").validate("F", 2, "sdfas,as,as", "1"); nca.responseBox(273, "Password Update").validate("O", 2, "sdfas,as,as", ""); nca.responseBox(273, "Password Update").clickOk("", 1);
Sends an Oracle Forms Message to the Oracle Forms server.
The nca.send method has the following command format(s):
nca.send(strMessage);
nca.send(recId, strMessage);
Optionally specify a recorded element ID. Only used for comparison purposes in the results. May be null
.
a String specifying the Oracle Forms Message object in XML format.
on any exception while sending the message to the Oracle Forms server.
Sends the specified Oracle Forms Message.
nca.send(20,
"<Message mActionString=\"MSG_UPDATE\" mActionCode=\"2\" " +
"mHandlerClassId=\"1\" mHandlerId=\"1\">\r\n" +
"<Property actionString=\"INITIAL_VERSION\" action=\"268\" " +
"type=\"java.lang.Integer\" value=\"1012000\"/>\r\n" +
"<Property actionString=\"INITIAL_RESOLUTION\" action=\"263\" " +
"type=\"java.awt.Point\" pointx=\"96.0\" pointy=\"96.0\"/>\r\n" +
"<Property actionString=\"INITIAL_DISP_SIZE\" action=\"264\" " +
"type=\"java.awt.Point\" pointx=\"1364.0\" pointy=\"768.0\"/>\r\n" +
"<Property actionString=\"INITIAL_CMDLINE\" action=\"265\" " +
"type=\"java.lang.String\" value=\"server module=" +
"{{formsload.module_1,/d1/oracle01/EBS/VIS/apps/apps_st/" +
"appl/fnd/12.0.0/forms/US/FNDSCSGN}} fndnam=APPS record=names " +
"config='{{formsload.config_1,VIS}}' " +
"icx_ticket='{{formsload.icx_ticket_11i_3,.jACpSETjvCOkvXLRX3StGA..}}' " +
"resp='ONT/ORDER_MGMT_SUPER_USER' secgrp='STANDARD' " +
"start_func='ONT_OEXOEORD_SUMMARY' other_params=''\"/>\r\n" +
"<Property actionString=\"INITIAL_COLOR_DEPTH\" action=\"266\" " +
"type=\"java.lang.Integer\" value=\"256\"/>\r\n" +
"<Property actionString=\"WINSYS_COLOR_ADD\" action=\"284\" " +
"type=\"java.lang.Integer\" value=\"0\"/>\r\n" +
"<Property actionString=\"WINSYS_COLOR_ADD\" action=\"284\" " +
"type=\"java.lang.Integer\" value=\"255\"/>\r\n" +
"<Property actionString=\"WINSYS_COLOR_ADD\" action=\"284\" " +
"type=\"java.lang.Integer\" value=\"65535\"/>\r\n" +
"<Property actionString=\"WINSYS_COLOR_ADD\" action=\"284\" " +
"type=\"java.lang.Integer\" value=\"4210752\"/>\r\n" +
"<Property actionString=\"WINSYS_COLOR_ADD\" action=\"284\" " +
"type=\"java.lang.Integer\" value=\"8421504\"/>\r\n" +
"<Property actionString=\"WINSYS_COLOR_ADD\" action=\"284\" " +
"type=\"java.lang.Integer\" value=\"65280\"/>\r\n" +
"<Property actionString=\"WINSYS_COLOR_ADD\" action=\"284\" " +
"type=\"java.lang.Integer\" value=\"12632256\"/>\r\n" +
"<Property actionString=\"WINSYS_COLOR_ADD\" action=\"284\" " +
"type=\"java.lang.Integer\" value=\"16711935\"/>\r\n" +
"<Property actionString=\"WINSYS_COLOR_ADD\" action=\"284\" " +
"type=\"java.lang.Integer\" value=\"16762880\"/>\r\n" +
"<Property actionString=\"WINSYS_COLOR_ADD\" action=\"284\" " +
"type=\"java.lang.Integer\" value=\"16756655\"/>\r\n" +
"<Property actionString=\"WINSYS_COLOR_ADD\" action=\"284\" " +
"type=\"java.lang.Integer\" value=\"16711680\"/>\r\n" +
"<Property actionString=\"WINSYS_COLOR_ADD\" action=\"284\" " +
"type=\"java.lang.Integer\" value=\"16777215\"/>\r\n" +
"<Property actionString=\"WINSYS_COLOR_ADD\" action=\"284\" " +
"type=\"java.lang.Integer\" value=\"16776960\"/>\r\n" +
"<Property actionString=\"FONT_NAME\" action=\"383\" " +
"type=\"java.lang.String\" value=\"dialog\"/>\r\n" +
"<Property actionString=\"FONT_SIZE\" action=\"377\" " +
"type=\"java.lang.Integer\" value=\"900\"/>\r\n" +
"<Property actionString=\"FONT_STYLE\" action=\"378\" " +
"type=\"java.lang.Byte\" value=\"0\"/>\r\n" +
"<Property actionString=\"FONT_WEIGHT\" action=\"379\" " +
"type=\"java.lang.Byte\" value=\"0\"/>\r\n" +
"<Property actionString=\"INITIAL_SCALE_INFO\" action=\"267\" " +
"type=\"java.awt.Point\" pointx=\"7.0\" pointy=\"21.0\"/>\r\n" +
"<Property actionString=\"WINSYS_REQUIREDVA_LIST\" action=\"291\" " +
"type=\"java.lang.Boolean\" value=\"true\"/>\r\n" +
"<Property actionString=\"SERVER_USER_PARAMS\" action=\"510\" " +
"type=\"java.lang.String\" value=\"NLS_LANG='AMERICAN_AMERICA' " +
"FORMS_USER_DATE_FORMAT='DD-MON-RRRR' " +
"FORMS_USER_DATETIME_FORMAT='DD-MON-RRRR HH24:MI:SS' " +
"NLS_DATE_LANGUAGE='AMERICAN' NLS_SORT='BINARY' " +
"NLS_NUMERIC_CHARACTERS='.,'\"/>\r\n" +
"<Property actionString=\"DEFAULT_LOCAL_TZ\" action=\"530\" " +
"type=\"java.lang.String\" value=\"Asia/Shanghai\"/>\r\n" +
"</Message>\r\n");
Sends raw Oracle Forms Messages to the Oracle Forms server.
The nca.sendMessages method has the following command format(s):
nca.sendMessages(description, strMessages);
nca.sendMessages(recId, description, strMessages);
Optionally specify a recorded element ID. Only used for comparison purposes in the results. May be null
.
Optional a String specifying a human-readable description explaining what this message does. May be null
.
String containing Oracle Forms Messages in XML format.
on any exception while sending the message to the Oracle Forms server.
Sends the specified Oracle Forms Messages.
nca.sendMessages(20, "Message Description"
"<Message mActionString=\"MSG_UPDATE\" mActionCode=\"2\" " +
"mHandlerClassId=\"1\" mHandlerId=\"1\">\r\n" +
"<Property actionString=\"INITIAL_VERSION\" action=\"268\" " +
"type=\"java.lang.Integer\" value=\"1012000\"/>\r\n" +
"<Property actionString=\"INITIAL_RESOLUTION\" action=\"263\" " +
"type=\"java.awt.Point\" pointx=\"96.0\" pointy=\"96.0\"/>\r\n" +
"<Property actionString=\"INITIAL_DISP_SIZE\" action=\"264\" " +
"type=\"java.awt.Point\" pointx=\"1364.0\" pointy=\"768.0\"/>\r\n" +
"<Property actionString=\"INITIAL_CMDLINE\" action=\"265\" " +
"type=\"java.lang.String\" value=\"server module=" +
"{{formsload.module_1,/d1/oracle01/EBS/VIS/apps/apps_st/" +
"appl/fnd/12.0.0/forms/US/FNDSCSGN}} fndnam=APPS record=names " +
"config='{{formsload.config_1,VIS}}' " +
"icx_ticket='{{formsload.icx_ticket_11i_3,.jACpSETjvCOkvXLRX3StGA..}}' " +
"resp='ONT/ORDER_MGMT_SUPER_USER' secgrp='STANDARD' " +
"start_func='ONT_OEXOEORD_SUMMARY' other_params=''\"/>\r\n" +
"<Property actionString=\"INITIAL_COLOR_DEPTH\" action=\"266\" " +
"type=\"java.lang.Integer\" value=\"256\"/>\r\n" +
"<Property actionString=\"WINSYS_COLOR_ADD\" action=\"284\" " +
"type=\"java.lang.Integer\" value=\"0\"/>\r\n" +
"<Property actionString=\"WINSYS_COLOR_ADD\" action=\"284\" " +
"type=\"java.lang.Integer\" value=\"255\"/>\r\n" +
"<Property actionString=\"WINSYS_COLOR_ADD\" action=\"284\" " +
"type=\"java.lang.Integer\" value=\"65535\"/>\r\n" +
"<Property actionString=\"WINSYS_COLOR_ADD\" action=\"284\" " +
"type=\"java.lang.Integer\" value=\"4210752\"/>\r\n" +
"<Property actionString=\"WINSYS_COLOR_ADD\" action=\"284\" " +
"type=\"java.lang.Integer\" value=\"8421504\"/>\r\n" +
"<Property actionString=\"WINSYS_COLOR_ADD\" action=\"284\" " +
"type=\"java.lang.Integer\" value=\"65280\"/>\r\n" +
"<Property actionString=\"WINSYS_COLOR_ADD\" action=\"284\" " +
"type=\"java.lang.Integer\" value=\"12632256\"/>\r\n" +
"<Property actionString=\"WINSYS_COLOR_ADD\" action=\"284\" " +
"type=\"java.lang.Integer\" value=\"16711935\"/>\r\n" +
"<Property actionString=\"WINSYS_COLOR_ADD\" action=\"284\" " +
"type=\"java.lang.Integer\" value=\"16762880\"/>\r\n" +
"<Property actionString=\"WINSYS_COLOR_ADD\" action=\"284\" " +
"type=\"java.lang.Integer\" value=\"16756655\"/>\r\n" +
"<Property actionString=\"WINSYS_COLOR_ADD\" action=\"284\" " +
"type=\"java.lang.Integer\" value=\"16711680\"/>\r\n" +
"<Property actionString=\"WINSYS_COLOR_ADD\" action=\"284\" " +
"type=\"java.lang.Integer\" value=\"16777215\"/>\r\n" +
"<Property actionString=\"WINSYS_COLOR_ADD\" action=\"284\" " +
"type=\"java.lang.Integer\" value=\"16776960\"/>\r\n" +
"<Property actionString=\"FONT_NAME\" action=\"383\" " +
"type=\"java.lang.String\" value=\"dialog\"/>\r\n" +
"<Property actionString=\"FONT_SIZE\" action=\"377\" " +
"type=\"java.lang.Integer\" value=\"900\"/>\r\n" +
"<Property actionString=\"FONT_STYLE\" action=\"378\" " +
"type=\"java.lang.Byte\" value=\"0\"/>\r\n" +
"<Property actionString=\"FONT_WEIGHT\" action=\"379\" " +
"type=\"java.lang.Byte\" value=\"0\"/>\r\n" +
"<Property actionString=\"INITIAL_SCALE_INFO\" action=\"267\" " +
"type=\"java.awt.Point\" pointx=\"7.0\" pointy=\"21.0\"/>\r\n" +
"<Property actionString=\"WINSYS_REQUIREDVA_LIST\" action=\"291\" " +
"type=\"java.lang.Boolean\" value=\"true\"/>\r\n" +
"<Property actionString=\"SERVER_USER_PARAMS\" action=\"510\" " +
"type=\"java.lang.String\" value=\"NLS_LANG='AMERICAN_AMERICA' " +
"FORMS_USER_DATE_FORMAT='DD-MON-RRRR' " +
"FORMS_USER_DATETIME_FORMAT='DD-MON-RRRR HH24:MI:SS' " +
"NLS_DATE_LANGUAGE='AMERICAN' NLS_SORT='BINARY' " +
"NLS_NUMERIC_CHARACTERS='.,'\"/>\r\n" +
"<Property actionString=\"DEFAULT_LOCAL_TZ\" action=\"530\" " +
"type=\"java.lang.String\" value=\"Asia/Shanghai\"/>\r\n" +
"</Message>\r\n");
Sends an Oracle Forms Terminal Message request to the Oracle Forms server.
The nca.sendTerminal method has the following command format(s):
nca.sendTerminal(responseCode);
nca.sendTerminal(recId, responseCode);
Optionally specify a recorded element ID. Only used for comparison purposes in the results. May be null
.
Specify the type of terminal message to send, i.e. 1
, 2
, or 3
.
on any exception while sending the terminal message to the Oracle Forms server.
Sends an Oracle Forms Terminal Message 1
.
nca.sendTerminal(90, 1);
Parses a value from the source of latest action and store it as a variable.
The nca.solve method has the following command format(s):
nca.solve(name, pattern, errorMessage, isOptional, source, resultIndex, encoding);
a String specifying the Name of the variable to create. Must not be null
.
a String specifying the Regular expression specifying what to extract from the most recent navigation's contents. May contain a transform expression. Must not be null
.
an optional String specifying the error message to display if the pattern cannot be solved. If null
, a meaningful error message is automatically generated.
a boolean specifying if pattern must be solved or not. Set to True if the pattern does not have to be solved. If the pattern cannot be solved, the method quietly returns.
an NcaSource enum specifying which contents to return as a String.
an index value that specifies the 0-based index of the specific result to retrieve if the pattern matches more than one value. If null
, all results will be added into the variables collection.
an EncodeOptions enum specifing the encoding or decoding operation to perform on the variable's value after solving the variable. A null
value is equivalent to EncodeOptions.None
.
if the object is not found.
Parse a value from the specified source using a Regular Expression and store it in a variable. An optional error message returns if the pattern cannot be solved. The pattern is optional and does not have to be solved. Includes a result index value of 0 to specify it should retrieve the first match result and ecoding or decode using the specified option.
nca.solve("varStatusBar0", "FRM-(.+): Transaction complete: (.+) records " +
"applied and saved.", "Text not Found", false,
NcaSource.StatusBarText, 0, EncodeOptions.None);
Identifies an Oracle Forms statusBar object by its recorded ID and handler name.
The nca.statusBar method has the following command format(s):
nca.statusBar(recid, handlerName);
Optional the ID of a previously recorded navigation, used for comparison purposes. May be null
.
a String specifying the handler name of the statusBar. Must not be null
.
if the object is not found.
a new TFormsLTStatusBar object.
Identifies an Oracle Forms statusBar object specified by its recorded ID and handler name.
nca.statusBar(173, "statusBar");
Identifies an Oracle Forms TabControl object by its handler name.
The nca.tab method has the following command format(s):
nca.tab(handlerName);
nca.tab(recid, handlerName);
Optional the ID of a previously recorded navigation, used for comparison purposes. May be null
.
a String specifying the handler name of the TabControl. Must not be null
.
if the object is not found.
a new TFormsLTTabControl object.
Performs an action on an Oracle Forms TabControl object specified by its recorded ID and handler name.
nca.tab(119, "SUMMARY_TABS").setFocus(""); nca.tab(120, "SUMMARY_TABS").selectByIndex(9, "1"); nca.tab(121, "SUMMARY_TABS").clearFocus("");
Identifies an Oracle Forms tableBox object by its recorded ID and handler name.
The nca.tableBox method has the following command format(s):
nca.tableBox(recid, handlerName);
Optional the ID of a previously recorded navigation, used for comparison purposes. May be null
.
a String specifying the handler name of the tableBox. Must not be null
.
if the object is not found.
a new TFormsLTTableBox object.
Identifies an Oracle Forms tableBox object specified by its recorded ID and handler name.
nca.tableBox(171, "tablebox");
Creates a reference to a text field object in the Forms applet by handler name.
The object is not actually found until performing some action against the object.
The nca.textField method has the following command format(s):
nca.textField(handlerName);
nca.textField(recid, handlerName);
Optional the ID of a previously recorded navigation, used for comparison purposes. May be null
.
a String specifying the handler name of the text field. 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.
a new TFormsLTTextField object.
Performs an action on an Oracle Forms text field object specified by its recorded ID and handler name.
nca.window(307, "NAVIGATOR").activate(""); nca.window(308, "NAVIGATOR").setVisible(true, ""); nca.textField(325, "GROUPS_OPERATING_UNIT_0").setFocus(); String text=nca.textField(327, "GROUPS_OPERATING_UNIT_0").getText(); info("text: " + text); nca.textField(327, "GROUPS_OPERATING_UNIT_0").clickButton();
Identifies an Oracle Forms timer object by its handler name.
The nca.timer method has the following command format(s):
nca.timer(handlerName);
nca.timer(recid, handlerName);
Optional the ID of a previously recorded navigation, used for comparison purposes. May be null
.
a String specifying the handler name of the timer. Must not be null
.
if the object is not found.
a new TFormsLTApplicationTimer object.
Performs an action on an Oracle Forms timer object specified by its recorded ID and handler name.
nca.window(9078, "FOLDER_INCIDENT_TRACKING").activate("2");
nca.textField(9079, "CREATE_TASK_PLANNED_END_DATE_UI_0")
.select(0, 20, 20, "");
nca.button(9080, "CALENDAR_OK_0").clearFocus("");
nca.textField(9081, "CREATE_TASK_PLANNED_END_DATE_UI_0")
.setFocus("1");
nca.window(9082, "Oracle Applications - Main Window")
.resize(1364, 768, "1");
nca.textField(9083, "CREATE_TASK_PLANNED_END_DATE_UI_0")
.clearFocus("");
nca.jContainer(9084, "SR_TASK_GRID_GRID_ITEM_0")
.setFocus("");
nca.jContainer(9085, "SR_TASK_GRID_GRID_ITEM_0")
.sendMessage("<Message mActionString=\"MSG_UPDATE\" mActionCode=\"2\" " +
"mHandlerClassId=\"271\" mHandlerId=\"496\">\r\n" +
"<Property actionString=\"EVENT\" action=\"398\" " +
"type=\"oracle.forms.engine.Message\" >\r\n" +
"<Message mActionString=\"MSG_UPDATE\" mActionCode=\"2\" " +
"mHandlerClassId=\"271\" mHandlerId=\"496\">\r\n" +
"<Property actionString=\"EVENTNAME\" action=\"399\" " +
"type=\"java.lang.String\" value=\"focusChanged\"/>\r\n" +
"<Property actionString=\"EVENT_ARGNAME\" action=\"400\" " +
"type=\"java.lang.String\" value=\"currentColumn\"/>\r\n" +
"<Property actionString=\"EVENT_ARGVALUE\" action=\"401\" " +
"type=\"java.lang.String\" value=\" \"/>\r\n" +
"<Property actionString=\"EVENT_ARGNAME\" action=\"400\" " +
"type=\"java.lang.String\" value=\"currentRow\"/>\r\n" +
"<Property actionString=\"EVENT_ARGVALUE\" action=\"401\" " +
"type=\"java.lang.String\" value=\"2\"/>\r\n" +
</Message>\r\n</Property>\r\n</Message>\r\n", "12");
nca.timer(9086, "COMPONENT_ID_1216").expired("1");
nca.window(9087, "FOLDER_INCIDENT_TRACKING").deactivate("1");
Identifies an Oracle Forms Tree object by its handler name.
The nca.tree method has the following command format(s):
nca.tree(handlerName);
nca.tree(recid, handlerName);
Optional the ID of a previously recorded navigation, used for comparison purposes. May be null
.
a String specifying the handler name of the Tree. Must not be null
.
if the object is not found.
a new TFormsLTTreeItem object.
Performs an action on an Oracle Forms Tree object specified by its recorded ID and handler name.
nca.tree(334, "APPTREE_NAV_TREE_NAVIGATOR_0").setFocus(""); nca.tree(335, "APPTREE_NAV_TREE_NAVIGATOR_0").expandNode(1, "1");
Identifies an Oracle Forms TreeList object by its handler name.
The nca.treeList method has the following command format(s):
nca.treeList(handlerName);
nca.treeList(recid, handlerName);
Optional the ID of a previously recorded navigation, used for comparison purposes. May be null
.
a String specifying the handler name of the TreeList. Must not be null
.
if the object is not found.
a new TFormsLTTListItem object.
Performs an action on an Oracle Forms TreeList object specified by its recorded ID and handler name.
nca.treeList(124, "NAVIGATOR_LIST_0").setFocus("1"); nca.treeList(125, "NAVIGATOR_LIST_0").selectByIndex(1);
Unregister a property that was previously registered using registerProperty
.
If the specified property does not exist, this method does not do anything.
The nca.unRegisterProperty method has the following command format(s):
nca.unRegisterProperty(name, handlerId);
a String specifying the name of the property previously registered using registerProperty
.
a value specifying the object for which this property was registered.
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.
if the name is null
.
Unregisters the previously registered property.
nca.unRegisterProperty("TITLE", 6);
Searchs the status bar contents for the specified text pattern and performs a verify only matching test.
If the test fails, report a warning.
This method will never cause a script to fail, regardless of the text matching test error recovery settings. Use nca.assertStatusBarText to make the script fail when the test fails.
When playing back a script in Oracle Load Testing, always use Assertions; failed Verifications are NOT reported in OLT. If any part of the status bar text matches textToVerify
, the verification succeeds.
The nca.verifyStatusBarText method has the following command format(s):
nca.verifyStatusBarText(testName, textToVerify, matchOption);
nca.verifyStatusBarText(recId, testName, textToVerify, matchOption);
Optional the ID of a previously recorded navigation, used for comparison purposes. May be null
.
a String specifying the test name.
a String specifying the Text to match on the page, or not match on the page if TextPresence is set as PassIfPresent.
a MatchOption enum specifying how the text to match should be searched on the page, such as using a regular expression, wildcard, or exact match.
on any failure when attempting to verify the text.
Verifies the specified text matches exactly.
nca.verifyStatusBarText(151, "Verify StatusBar Text" +
"text value", "FRM-40400: Transaction complete: " +
"1 records applied and saved.", MatchOption.Exact);
Searches the text of selected source type for the specified text pattern performing a verify only text match.
If the test fails, report a warning. This method will never cause a script to fail, regardless of the text matching test error recovery settings. Use nca.assertText to make the script fail when the test fails.
When playing back a script in Oracle Load Testing, always use Assertions; failed Verifications are NOT reported in OLT. If any part of the source text matches textToVerify
, the verification succeeds.
The nca.verifyText method has the following command format(s):
nca.verifyText(testName, textToVerify, sourceType, textPresence, matchOption);
a String specifying the test name.
a String specifying the Text to match on the page, or not match on the page if TextPresence is set as PassIfPresent.
a NcaSource enum specifying where to match the text, i.e. in the Object Details, Request and Response, or Status Bar text.
a TestPresence enum specifying either PassIfPresent or FailIfPresent, depending on if you want the test to pass or fail if the text to match is present or not.
a MatchOption enum specifying how the text to match should be searched on the page, such as using a regular expression, wildcard, or exact match.
on any failure when attempting to verify the text.
Adds a Verify only, never fail, Text Matching tests for Statu Bar text.
nca.verifyText("myTextMatchingTest", "match this text string",
NcaSource.StatusBarText, TextPresence.PassIfPresent, MatchOption.Exact);
Identifies an Oracle Forms FormWindow object by its handler name.
The nca.window method has the following command format(s):
nca.window(handlerName);
nca.window(recid, handlerName);
Optional the ID of a previously recorded navigation, used for comparison purposes. May be null
.
a String specifying the handler name of the FormWindow. Must not be null
.
if the object is not found.
a new TFormsLTFormWindow object.
Performs an action on an Oracle Forms FormWindow object specified by its recorded ID and handler name.
nca.window(102, "NAVIGATOR").activate(""); nca.registerProperty("TITLE", "", 102, RegisterPropertyOptions.RegisterForMSG_GET); nca.unRegisterProperty("title", 102); nca.textField(103, "NAVIGATOR_TYPE_0").setFocus("22"); nca.window(105, "NAVIGATOR").resize(586, 451, "22222"); nca.window(106, "FIND_ORDER_NUMBER_0").setCursorPosition(0, ""); nca.window(107, "CONFIGURATOR_PROCESSING").move(288, 192, "");