| Oracle® Application Testing Suite OpenScript User's Guide Version 9.10 for Microsoft Windows (32-Bit) Part Number E15488-03 |
|
|
View PDF |
| Oracle® Application Testing Suite OpenScript User's Guide Version 9.10 for Microsoft Windows (32-Bit) Part Number E15488-03 |
|
|
View PDF |
This chapter provides instructions on configuring and using the OpenScript Web Functional Test Module, which tests Web-based applications by accessing objects through the Document Object Model (DOM) of the Web browser.
The OpenScript Web Functional Test Module is an application module that supports functional testing of Web-based applications that uses the Web Document Object Model (DOM). OpenScript provides a flexible and easy-to-use scripting interface for both Technical Testers and Non-Technical Testers. The OpenScript Functional Test Module enables script creation from both the code view and GUI view scripting interfaces.
The Functional Test Module extends the OpenScript platform with Document Object Model (DOM) recording and playback capabilities. The DOM recorder automatically captures Web page objects, actions, and navigations and records them as tree view nodes (with the underlying code in the Code View) in the script. The Functional Test Module also provides additional GUI script modification options. Web Functional Test Scripts differ from HTTP Scripts. Even though both are used to test web applications, HTTP scripts automate the underlying HTTP network protocol, whereas Web Functional Test scripts automate the browser UI.
The Web Functional Test Module is an extension module to the Oracle OpenScript platform that extends the platform with Web Functional Test recording and playback capabilities. The Web Functional Test Module is fully integrated with the OpenScript platform including the Results view, Details view, Properties view, Console/Problems views, Preferences, Step Groups, Script Manager, and Workspace Manager.
The Web Functional Test recorder displays commands in the Tree View in easy-to-understand commands. By default, script commands are grouped into Steps Groups by the Web page on which they were performed. Each Step Group contains one or more script commands corresponding to recorded actions that were performed on the page. The default name for the Step Group is the Web page Title (as specified in the "Title" tag).
OpenScript shows the results of Web Functional Test script playback in the Results view. The Results view shows results for each script command (including duration and summary for failures). The Results Report compiles the same information into an HTML Results Report. Results can be exported from the OpenScript GUI in standard format (CSV / HTML). Results are also generated for unattended playback through the command line.
The Web Functional Test Module API includes a "Web" class that provides additional programming functionality.
The Web Functional Test Module provides the following functionality:
Records Document Object Model objects and actions for playback automation. The objects and actions can be generated by a Web browser (i.e. IE or Firefox).
Plays back functional testing scripts to validate proper functionality. Playback runs interactively in the OpenScript user interface. Playback runs interactively in the OpenScript user interface and is also supported in Oracle Test Manager.
Provides full script code view integration to support script generation for the Web Functional Test Module. The Web Functional Test Module includes an additional API to support Web Functional Test protocol code scripting.
Allows users to parameterize user inputs to Functional Test scripts and drive those inputs from an external data file (Databank).
Allows users to insert test cases for validation of objects and actions.
Provides additional options/settings that are specific to Functional Test scripts within the Functional Test categories in the preferences interface.
Reports playback results for Functional Test scripts in the Results and Console views.
The Web Functional Test Module records Document Object Model objects and actions in a Web browser for playback automation. The Recorder creates functional and regression test scripts for automating GUI applications in a browser.
OpenScript records standard Web DOM objects (links, images, forms, form elements, etc.) and events (click, mousedown, focus, etc.) for playback. Web DOM objects are identified by one or more attribute as configured through the Web Functional Test Record Preferences under Object Identification. Object Identification attributes can later be modified by users through the Preferences global settings for new scripts or for already recorded commands in the tree view or code view. All Web DOM objects, events and attributes should be supported. Recording can be configured through Internet Explorer or Firefox. You can set the browser type in the Preferences.
The Web Functional Test Module provides a record toolbar button that lets you initiate the Web DOM recorder and capture Web page actions to the script view. The record toolbar includes start and stop recording toolbar buttons. OpenScript recorders also open a floating toolbar that can be used while recording without having to switch between the browser and OpenScript.
Before recording Web Functional Test scripts, set Web record preferences.
Start OpenScript.
Select OpenScript Preferences from the View menu.
Expand the OpenScript node and the Record category.
Select Web Functional Test.
Click the General tab and set the general recording preferences as follows:
Browser: Specify the browser options that will be used during Web Functional test recording.
Always launch a new browser when recording a different script: When selected, a new browser opens each time a new script is recorded.
Miscellaneous: Specifies the miscellaneous record settings.
Capture Screen Shots: When selected, screen images are captured during recording.
Capture HTML: When selected, page source HTML is captured during recording.
Capture URLs: When selected, the page URL will be captured.
Capture Frames: When selected, the HTML frames on the page will be captured.
Ignore Auto Page: When selected, server-side auto pages are ignored during recording.
Action Cache Interval(s): Specifies how often to cache page actions during recording. The following cases are determined by this setting:
If while recording, the text on the same Web page element is changed within the Action Cache Interval time setting, the previously recorded value will be replaced by the changed value. In the Java code, the setText action will be replaced with the changed value.
If while recording, a browser window closes within the Action Cache Interval after a user performs an action on a web page (for example, a button click) the window close event will not be recorded, as the window close event is considered to be caused by the previously performed action.
Record "waitForPage actions: When selected, the script recorder generates "wait for page" actions for test steps that generate a page transition in the browser. When cleared, the script recorder generates a "capture page" action for test steps that generate a page transition in the browser. For Web functional test scripts, the "wait for page" action is the normal record option. See the Siebel Functional test record preferences for additional information.
Click the Object Identification tab and use Add or Edit to customize the object identification elements or attributes.
Click OK when finished.
The Web Functional Module uses object identification to specify attributes used to identify Web objects. The Web Functional Test Module includes predefined path attributes for common Web objects. Object paths are specified in XPath format. For example, for web objects, the object identification path appears as follows in Java code commands:
/web:window[@index='0'] /web:document[@index='0'] /web:form[@index='0'] /web:input_text[@id='ticker' or @name='ticker' or @index='0']
You can set the default object attributes in the Web Functional Test Module Record Preferences. You can also edit object attributes in recorded scripts in the tree view or the code view.
In addition to the predefined object identification, you can add an Object Library to the script to record paths into a library file. Object Library files may be shared and reused across other scripts. The Object Library files provide a more convenient "short name" for objects to provide for more convenient programming.
The Web Functional Test Module includes object identifiers that specify how the recorder identifies Browser objects. You can add object identifiers or edit the existing object identifiers in the Record preferences.
To add or edit an object identifier:
Select the OpenScript Preferences from the View menu.
Expand the Record node and select Web Functional Test.
Click the Object Identification tab.
Click Add or select an existing object identifier and click Edit.
The Object Element dialog box lets you define an object identifier for a Web Functional Test recorder. The object identifier specifies how the OpenScript Web Functional Test recorder module identifies web objects in the Document Object Model on a Web page.
Name: Specify the name of the object identifier.
Attributes: Shows the attributes defined for the object identifier. The attributes can consist of an object attributes group and specific object element attributes.
Add: Opens a dialog box for specifying a new Web object identifier.
Edit: opens a dialog box for editing the selected Web object identifier.
Delete: Deletes the selected Web object identifier.
Up: Moves the selected Web object identifier up in the priority order.
Down: Moves the selected Web object identifier down in the priority order.
For each object element, you specify a name (typically a Web object attribute), an operator, a value and a value type. As you add object elements, OpenScript builds the object identifier using logical OR between each object identifier element. Click Edit to change between logical OR and AND.
If adding a new object identifier, click Add and specify the path segments for the object identifier.
The Path Segment dialog box lets you define a segment of an object identifier for a Web Functional Test recorder. The object identifier specifies how the OpenScript Web Functional Test recorder module identifies web objects in the Document Object Model on a Web page.
Attribute: When selected, specify the name, operator, value, and value type for the object identifier.
Name: Specify the name of the Web object attribute to use to identify the object.
Operator: Specify the logical operator to use to identify the object value.
Value: Specify the value of the Web object attribute to use to identify the object.
Value Type: Specify the value type to use to identify the object. The value type can be a string, a number, or by variable reference. Set the Value type to match the specified value.
String: The value in the Value field will be matched as a text string to identify the Web object.
Number: The value in the Value field will be matched as a numeric value to identify the Web object.
Reference: The value in the Value field will be matched as a variable name to identify the Web object.
Group: when selected the Web object identifier can be specified as a string representing a logical group of Names, Operators, and Values.
If editing an existing segment, click Edit and specify the path attributes for the object identifier.
The Path Attribute dialog box lets you edit an element of an object identifier.
Name: Specify the name of the Web object attribute to use to identify the object.
Operator: Specify the logical operator to use to identify the object value.
Value: Specify the value of the Web object attribute to use to identify the object.
Value Type: Specify the value type to use to identify the object. The value type can be a string, a number, or by variable reference. Set the Value type to match the specified value.
String: The value in the Value field will be matched as a text string to identify the Web object.
Number: The value in the Value field will be matched as a numeric value to identify the Web object.
Reference: The value in the Value field will be matched as a variable name to identify the Web object.
And/Or: specifies logical OR or AND between object elements. This option does not appear if the object element being edited is the last object element in the object identifier group.
If editing an existing path, click Edit and specify the path attributes for the object identifier.
The Path Attribute Group dialog box lets you edit an object identifier group as a string value.
Group: A text string of the object identifier group. The object identifier group syntax follows the @name operator value/type format. Values by reference are enclosed in double curly braces {{}}. String values are enclosed in single quotation marks. Numeric values are not enclosed. Logical OR or AND are used between object elements. Parenthesis are used for logical grouping of multiple object elements. Object identifiers can use the wildcard characters * (asterisk) for multiple characters and ? (question mark) for single characters. For example, @text="Login*". The following are examples of object identifier group syntax:
@index={{index}} or @title='title' or @number=5
@text={{text}} or @href={{href}} or @index={{index}}
(@id={{id}} or @name={{name}} or @index={{index}}) and multiple mod {{multiple}}
Click OK when finished adding or editing segments or attributes. The object identifier is added to the record preferences.
If you have the browser open when adding or editing object identifiers, close and restart the browser.
The following table lists the attributes available for Web Document Object Model objects.
| Element | Attributes |
|---|---|
| Common attributes for all web DOM elements | tag, id, index, title, style, class, html, _adftrueval, rn, un, ot |
| web:window | index, title |
| web:document | index, url |
| web:a | disabled, text, href |
| web:button | type, name, value, disabled, text |
| web:input_button | type, name, value, disabled, text |
| web:input_file | type, name, value, index, disabled, size |
| web:input_hidden | type, name, value, index, disabled |
| web:input_image | type, name, disabled, alt, align, border, height, hspace, src, lowsrc |
| web:input_submit | type, name, value, disabled, text |
| web:input_text | type, name, value, defaultValue, disabled, maxlength, readOnly, size |
| web:input_check | type, name, value, disabled, checked, defaultChecked, readOnly, size |
| web:input_radio | type, name, value, disabled, checked, defaultChecked, readOnly, size |
| web:img | alt, height, longdesc, name, src, width |
| web:option | value, text, optionIndex(index in the select), defaultSelected, selected |
| web:select | name, disabled, value, selectedIndex |
| web:textarea | name, disabled, value, defaultValue, readonly, cols, rows |
To record Web Functional Test scripts:
Start OpenScript.
Set the Web Functional Test Recording preferences.
Select New from the File menu.
Expand the Functional Testing group.
Select Web.
Click Next.
Select the Repository and Workspace.
Enter a script name.
Click Finish. A new Script tree is created in the Script View.
Select Record from the Script menu. The browser automatically opens when you start recording.
Load the web page where you want to start recording into the browser.
Navigate the web site to record page objects, actions, and navigations. The page objects, actions, and navigations will be added to the Run node of the script tree.
When finished navigating pages, close the browser.
Select Stop from the Script menu or click the Stop button on the OpenScript toolbar.
Expand the Run node of the script to view the page objects, actions, and navigation nodes in the script tree.
You can customize the script using the menu options or the Code View for specific testing requirements.
Note:
Do not close the script editor view or script project while recording or playing back scripts. Doing so could result in unpredictable behavior in the OpenScript application.OpenScript plays back recorded Web actions/commands which consist of an event plus an object identified by its attributes (for example: click link(text="Home")). The actions used for playback will either be those that are recorded or are specified manually in the Java Code view. Playback can be configured through Internet Explorer or Firefox. Unattended playback is supported through Oracle Test Manager or third-party tools using OpenScript's command line interface. Web Functional Test scripts do not play in Oracle Load Testing.
The Web Functional Test Module provides playback and iterate toolbar buttons that allows users to start the script playback for either a single playback through the script or multiple iterations using data from a databank file. Playback results for Web Functional scripts can be viewed in the Results and Console views.
To set Web Functional Test Playback preferences:
Start OpenScript.
Select OpenScript Preferences from the View menu.
Expand the OpenScript node and the Playback category.
Select Web Functional Test.
Expand the Object Timeout group and set the preferences as follows:
Timeout(S): Specifies the maximum number of seconds OpenScript should wait for an object to appear before considering the object not found. This is the default timeout when waiting for an object to appear before invoking an action against it. This is also the default timeout when waiting for an object to appear before continuing the script.
You can override individual object wait timeouts in waitForPage() or object.waitFor() by editing their "timeout" properties. Action timeouts cannot be overridden.
Expand the Miscellaneous group and set the preferences as follows:
Capture HTML: When selected, the page HTML will be captured.
Capture ScreenShot: When selected, the a screen image of the page will be captured.
Expand the Agent Port group and set the preferences as follows:
Port: Specifies the port number to use to communicate with the agent machine.
Expand the Capture Screenshot Interval group and set the preferences as follows:
Delay time for capture screenshot: Specifies the amount of time to wait before capturing a screenshot of the page.
Click OK when finished.
To play back Web Functional scripts:
Start OpenScript.
Open the Web Functional script to play back.
Select Playback from the Script menu or click the toolbar button.
You can view the progress of the script playback in the Console View. You can review the results of script playback in the Results View.
To play back Web Functional scripts with iterations:
Start OpenScript.
Open the Web Functional script to play back.
Select Iterate from the Script menu or click the toolbar button.
Set the iteration count.
Select which databank file to use, if necessary.
Set the starting record and data usage.
Click OK.
You can view the progress of the script playback in the Console View. You can review the results of script playback in the Results View.
Once a script has been created/recorded, you can make modifications to customize the script for your specific testing needs.
To add a Browser Navigation to a Script:
Record a Web Functional Test script.
Select the script node where you want to add the navigation.
Select the Script menu and then select Other from the Add sub menu.
Expand the Web Actions node.
Expand the Browser node and select Navigate.
Click OK.
Enter the object identification path for the browser. You can use the Capture or Select buttons to capture or select an object path.
Enter the URL.
Click OK. The navigate node is added to the script tree.
In the Java Code view, the web.window(objectId).navigate method will be added to the script code:
web.window(1, "/web:window[@index='0']").navigate("http://testserver2/fmstocks");
The Browser web actions includes additional options for browser navigation such as Back, Forward, Close, Refresh, Wait for Page, etc. Additional browser actions have corresponding Java code methods:
web.window(1, "/web:window[@index='0']").waitForPage("http://testserver2/fmstocks/", "Stocks", true, null)
web.window("/web:window[@index='0']").close();
web.window("/web:window[@index='0']").back();
web.window("/web:window[@index='0']").forward();
web.window("/web:window[@index='0']").refresh();
web.window("/web:window[@index='0']").capturePage();
web.window("/web:window[@index='0']").solve("MyVariable", "(.+?)", true, 1);
web.window("/web:window[@index='0']").storeResponseTime("MyRespTime");
web.window("/web:window[@index='0']").waitFor(10);
web.window("/web:window[@index='0']").storeAttribute("MyAttribVar", "MyAttribute");
The Web Functional Test Module includes actions for Browser objects that can be added to a script.
To add Web actions on Browser objects to a script:
Record a Web Functional Test script.
Select the script node where you want to add the action.
Select the Script menu and then select Other from the Add sub menu.
Expand the Web Actions node.
Expand an action node and select the action.
Click OK.
Enter the object identification path for the object. You can use the Capture or Select menu options to capture or select an object path.
Click OK. The action node is added to the script tree.
In the Java Code view, a web.object(objectId).action() method will be added to the script code:
web.button("/web:window[@index='0']
/web:document[@index='0']
/web:form[@index='0'
or @id='loginform'
or @name='loginform']
/web:input_submit[@name='LoginButton'
or @value='Login'
or @index='0']").click()
The Web Actions node includes actions for objects such as buttons, check boxes, dialogs, images, links, tables, etc. Other object actions have corresponding Java code methods:
web.link("/web:window[@index='0']
/web:document[@index='0']
/web:a[@text='Open a new account.'
or @href='http://testserver2/fmstocks/_NewAccount.asp'
or @index='0']").click()
or
web.select("/web:window[@index='0']
/web:document[@index='0']
/web:form[@index='0']
/web:select[(@id='namespace'
or @name='namespace'
or @index='0')
and multiple mod 'False']").selectOptionByText("[select product]");
web.clearSessionCookies();
web.clearAllPersistentCookies();
web.clearPersistentCookies("domain");
web.clearCache("domain");
To add Object Libraries to a script:
Open or create a Web Functional Test script project.
Select the Script menu and then select Script Properties.
Select the Test Assets category and select Object Libraries.
Click Add.
Specify the library file and alias:
If you have already created an Object library file, select the file in a repository or file path.
Note:
As of OpenScript Version 9.10, scripts can be stored anywhere in the file system. However, any scripts you plan to run, along with any associated assets, in the Oracle Load Testing application must be stored in a repository/workspace that can be accessed by the Oracle Load Testing Controller.If you have not created a library file, enter a file name, and click OK. A new file will be created. When you record a Web Functional Test script, the browser actions will be automatically added to the object library file.
Click OK. The Object Library file is added as a script test asset under the Object Libraries tree. Script test assets are referenced in the assets.xml file located in the script directory of the repository or file path.
Click OK.
Record a Web Functional Test script to use the object library.
The object identification paths for browser objects will be automatically added to the object library file during recording. You can open and edit the object library file using the Object Library Editor. Select Script Properties from the Script menu, select the Object Library Test Asset in the tree and click Open. The Object Library editor view opens in the Workbench with the objects and details included in the selected Object Library. You can add objects to and delete objects from the Object list. You edit the object attributes in the object string or in the tree hierarchy of the Details section. The tree hierarchy lets you move attributes up or down in the priority order.
Save the script when finished.
You can use Server Response Tests to report an error and/or abort the script if a Web page does not return back to the client within a specified time range.
To add a Server Response Test to a script:
Record a Web Functional Test script.
Expand the Run node.
Select the script node where you want to add the Server Response test.
Select the Script menu and then select Other from the Add sub menu.
Expand the Web Actions group.
Expand the Test group.
Select Server Response Test and click OK.
Enter the window path.
Enter a name for the test.
Enter the minimum and maximum time values.
Set the Stop Iteration on Failure option.
Click OK to add the Server Response node to the script tree.
In the Java Code view, the Server Response Test consists of the code executed in the web.window(objectId).verifyResponseTime() or web.window(objectId).assertResponseTime()method:
web.window("/web:window[@index='0']").verifyResponseTime("MyserverResp", 10.0, 20.0);
or
web.window("/web:window[@index='0']").assertResponseTime("MyserverResp2", 10.0, 50.0)
In the above code examples, verify means "do not stop on failure" and assert means "stop on failure".
To add a Text Matching Test to a Script:
Open or create a Web Functional Test script project.
Select the script node where you want to add the Text Matching Test.
Select the Script menu and then select Other from the Add sub menu.
Expand the Web Actions node.
Expand the Tests node and select Text Matching Test.
Click OK.
Select the Look in location:
All Browsers: When selected, the Text Matching Test looks for the text to match in all open browsers.
Specified Browser: When selected, the Text Matching Test looks for the text to match by the browser ID specified in the Path.
Specified Document: When selected, the Text Matching Test looks for the text to match in the document specified by the object ID in the Path.
If you selected Specified Browser or Specified Document, enter the object identification path for the browser, document, or frame in the Path.
Enter a name for the test.
Enter the text string or Regular Expression to match or click the Substitute Variable icon to select a databank or script variable to find in the source.
Note:
The pound (#) character and double brace ({{ and }}) character sequences need to be escaped with a preceding pound (#) character if used in the Text Matching Test as a literal string (not a string specifying an OpenScript databank or script variable). For example, the pound character should be doubled (##) and double braces should be preceded by a pound character (#{{ and #}}).Select the source location that will be searched for the matching text:
HTML Display Contents: Search the browser rendered text of the page.
Raw HTML: Search HTML source of the page.
Select the Pass when setting.
Selected text is present: The test case passes if the Text to Match string is found in the selected source.
Selected text is absent: The test case passes if the Text to Match string is not found in the selected source.
Select the Match type.
Exact: Matches the Text to Match string exactly.
Regular Expression: Matches using the Regular Expression specified in Text to Match.
Wildcard: Matches using the wildcard characters specified in Text to Match.
Set the Verify only, never fail option.
Click OK. The Text Matching Test node is added to the script tree.
In the Java Code view, the web.assertText or web.document(specifiedDoc).assertText method will be added to the script code if the Verify only, never fail option is not selected:
web.assertText("MyTextMatchTest", "Home", TextPresence.PassIfPresent, MatchOption.Exact)
web.document("Main").assertText("MyTextMatchTest2", "Home", TextPresence.PassIfPresent, MatchOption.RegEx);
In the Java Code view, the web.verifyText or web.document(specifiedDoc).verifyText method will be added to the script code if the Verify only, never fail option is selected:
web.verifyText("MyTextMatchTest", "Home", TextPresence.PassIfPresent, MatchOption.Exact)
web.document("Main").verifyText("MyTextMatchTest2", "Home", TextPresence.PassIfPresent, MatchOption.RegEx);
The Web Functional Test Module includes an object test case for Browser objects that can be added to a script.
To add an object test to a script:
Record a Web Functional Test script.
Select the script node where you want to add the object test.
Select the Script menu and then select Other from the Add sub menu.
Expand the Web Actions node.
Expand the Tests node and select Object Test.
Click OK.
Enter the object identification path for the object. You can use the Capture or Select menu options to capture or select an object path.
Substitute Variable: Opens a dialog box for selecting the variable to use for the object ID.
Capture Object: Opens a capture object dialog box and starts the capture mode. Navigate to the object to capture and use options in the capture dialog box to capture the object path.
Edit Object Path: Opens a dialog box for editing the currently selected object path.
View Object Path: Opens a dialog box for editing the currently selected object path.
Select from Object Library: Opens a dialog box for selecting an object from a saved library.
Save to Object Library: Opens a dialog box for saving the current object to a library.
Enter a test name.
Select an Attribute/Value pair and specify the test details.
Attributes: Shows the attributes of the selected object. Select an attribute and specify the test details.
Attribute: Shows the name of the attribute. When selected, the attribute is included in the object test. When cleared, the attribute is not included in the object test.
Value: Shows either the recorded value or the test criteria for the attribute depending upon which Display option is selected.
Enable All: Enables all properties for inclusion in the test criteria.
Disable All: Disables all properties for exclusion from the test criteria.
Add Row: Adds a new row to the table.
Display: Selects which values appear in the properties list.
Test: When selected, the Value list shows the test criteria defined for each attribute.
Recorded Values: When selected, the Value list shows the recorded value for each attribute.
Test Details: Specifies the test criteria for the selected attribute.
Recorded Value: Shows the recorded value of the attribute.
Enable: When selected, the attribute is included in the object test. When cleared, the attribute is not included in the object test.
Value Type: Specifies the data type to use as the test criteria for the attribute. The available options in the Operator list depend upon the selected value type to test: String, Boolean, Date, or Numeric.
Operator: Specifies the operator to use for the playback test criteria. The list of operators changes depending upon the selected Value Type.
The following options are available for String values:
Exact: The test passes if the text or attribute value matches exactly the current value of the text string during playback of the script.
Wildcard: The test passes if the text or attribute value matches the current value of the Like operator pattern during playback of the script.
Regular Expression: The test passes if the text or attribute value matches the current value of the Regular Expression pattern during playback of the script.
The following options are available for Numeric and Date values:
[Relational Operators]: Lists the relational operators. Select the type of comparison to use during playback of the script. If you select the Range operator, the Object Test adds a field for specifying the range. Specify the from-to range.
The following option is available for Boolean values:
Exact: The test passes if the text or attribute value matches the True or False value specified in the Value field during playback of the script.
Value: Specifies the value to use for the test criteria for the attribute.
[Substitute Variable]: Opens a window for selecting a databank variable to substitute as the value to use for the test criteria for the attribute.
Specify the test details for each Attribute/Value pair as required for the test.
Click OK. The object test node is added to the script tree.
In the Java Code view, a web.element(objectId).verifyAttributes method will be added to the script code:
web.element(15, "/web:window[@index='0']
/web:document[@index='0']
/web:form[@index='0'
or @id='loginform'
or @name='loginform']
/web:input_password[@name='password' or @index='0']").verifyAttributes(
"MyObjectTest", web.attributes(web.attribute("index", "0", TestOperator.StringExact),
web.attribute("tag", "INPUT", TestOperator.StringExact),
web.attribute("name", "password", TestOperator.StringExact),
web.attribute("value", "ta", TestOperator.StringExact),
web.attribute("type", "password", TestOperator.StringExact),
web.attribute("checked", "False", TestOperator.StringExact),
web.attribute("disabled", "False", TestOperator.StringExact)));
The Web Functional Test Module includes a table test case for HTML tables that can be added to a script.
To add a table test to a script:
Record a Web Functional Test script.
Select the script node where you want to add the table test.
Select the Script menu and then select Other from the Add sub menu.
Expand the Web Actions node.
Expand the Tests node and select Table Test.
Click OK.
Enter the object identification path for the table. You can use the Capture or Select menu options to capture or select an object path.
Substitute Variable: Opens a dialog box for selecting the variable to use for the object ID.
Capture Object: Opens a capture object dialog box and starts the capture mode. Navigate to the object to capture and use options in the capture dialog box to capture the object path.
Edit Object Path: Opens a dialog box for editing the currently selected object path.
View Object Path: Opens a dialog box for editing the currently selected object path.
Select from Object Library: Opens a dialog box for selecting an object from a saved library.
Save to Object Library: Opens a dialog box for saving the current object to a library.
Enter a test name.
Select a row and column cell and specify the test details.
Test Details: Specifies the test to perform for each value. Select a value in the row and column list to set the details for that specific value.
Row: Shows the row number of the selected table value.
Column: Shows the column number of the selected table value.
Enable: When selected, the table value is included in the comparison test.
Recorded value: Shows the selected attribute's recorded value.
Value Type: Specifies the data type of the selected value: String, Numeric, Date, or Boolean.
Operator: Specifies how to compare the value. The Operator options change depending upon the selected value type. For relational operators, if you select the Range operator, a field is added for specifying the numeric or date range. Specify the from-to range.
Value: Specifies the value to test.
[Substitute Variable] - opens a dialog box for selecting the variable to use as the value to test.
Specify the test details for each table cell as required for the test.
Click OK. The table test node is added to the script tree.
In the Java Code view, a web.table(objectId).verifyCells method will be added to the script code:
web.table(24, "/web:window[@index='0']
/web:document[@index='0']
/web:table[@index='6']").verifyCells("MyTableTest",
web.cells(web.cell(1, 1, "Ticker ", TestOperator.StringExact),
web.cell(1, 2, "Company ", TestOperator.StringExact),
web.cell(2, 1, "ORCL ", TestOperator.StringExact),
web.cell(2, 2, "Oracle Corporation ", TestOperator.StringExact)))
You can use the Wait for Page browser option to cause the script playback to wait until a page is returned by the server before continuing playback.
To add a Wait for Page command to a script:
Record a Web Functional Test script.
Expand the Run node.
Select the script node where you want to add the Wait for Page node.
Select the Script menu and then select Other from the Add sub menu.
Expand the Web Actions group.
Expand the Browser group.
Select Wait For Page and click OK.
Enter the document ID in XPath format.
Select or clear the Wait for any page option.
If you clear the Wait for any page option, specify the URL and Match option.
Set the Timeout value.
Click OK to add the Server Response node to the script tree.
In the Java Code view, a web.window(objectId).waitForPage() method will be added to the script code:
web.window(6, "/web:window[@index='0']").waitForPage("http://testserver2/fmstocks/home.asp", null, null)
To inspect a Web object path:
Record a Web Functional Test script.
Select the Script menu and then select Inspect Path. OpenScript opens the capture mode. This dialog box lets you capture the object path for an object on a Web page.
Path: Shows the Object Identification path of the object highlighted with the mouse cursor.
The following options are available on the pulldown menu after you press F10 to capture an object path:
Capture Object: Opens a capture object dialog box and starts the capture mode. Navigate to the object to capture and use options in the capture dialog box to capture the object path.
View Object Path: Opens a dialog box for viewing the currently selected object path.
Save to Object Library: Opens a dialog box for specifying the Object Library in which to save the object path.
Position: Shows the x, y coordinates for the entire screen. The upper left coordinate of entire screen is {0,0}. This position coordinate is used with Functional tests that include object types, such as Flash, where screen positions are required to perform mouse actions on the object. The position coordinates are used with the functional test methods, ft.mouseClick(), ft.mouseDown(), and ft.mouseUp().
Offset: Shows the x, y coordinates relative to the currently highlighted object. The upper left coordinate of highlighted object is {0,0}. This offset coordinate is used with Web Functional tests that include object types, such as Flash, where screen positions are required to perform a mouse click on the object. The position coordinates are used with the Web functional test method, web.element().mouseClick().
Navigate to the Web object and place the mouse cursor on the object.
Press F10 to capture the path.
Highlight the path with the mouse cursor and press the Ctrl+C keys to copy the path to the clipboard.
Click OK when finished.
To set script properties:
Record a Web Functional Test script.
Select the Script menu and then select Script Properties.
Select the properties category.
Specify the properties for the category.
Click OK when finished.
To substitute a databank variable for a query string parameter in a script:
Record a Web Functional test script that has text string parameters.
Expand the Run node.
Expand the node containing text parameters.
Right-click a text parameter node and select Properties from the shortcut menu.
If you have already configured the script with one or more databanks, select the click the [Substitute Variable] icon and select the databank field to substitute for the text parameter from the desired databank file and click Finish.
If you have not already configured the script with a databank, select Add new databank and click Next.
Click the Browse button and select the databank file to use.
Select the column (field name) to substitute for the text parameter and click Finish.
In the Tree View, the databank variable appears in place of the recorded value as {{db.databankFileName.field,recordedValue}}.
In the Java Code view, the databank variable appears as {{db.databankFileName.field,recordedValue}} in the web.text(objectId).setText method:
web.text(1, "/web:window[@index='0']
/web:document[@index='0']
/web:form[@index='0']
/web:input_text[@id='ticker'
or @name='ticker'
or @index='0']").setText("{{db.fmstocks_data.ticker,orcl}}")
To edit an object library:
Create a Web Functional Test script project.
Add an Object Library to the script and record the Web application under test.
Select the Load Object Library node in the script tree and then select Open Object Library from the right-click shortcut menu.
If necessary, click the Object Library tab.
Select an object in the Objects list.
Edit the object attributes in the Details section.
You can add objects to and delete objects from the Object list. You edit the object attributes in the object string or in the tree hierarchy of the Details section. The tree hierarchy lets you move attributes up or down in the priority order.
You can click the libraryName.properties tab to view or edit the object/object attribute text strings in the object library file source.
Select Save from the File menu or click the Save toolbar button to save changes to the object library file.
The Web Functional Module includes a script Application Programming Interface (API) specific to Web DOM functional testing. The Web Functional Test Module recorder creates the Java code that corresponds to the Tree View and displays the Web Functional Test commands in the Java Code view using easy-to-understand function names. The Java Code view commands correspond to the Tree View and you can edit your scripts in either view.
You can use the Web Functional Test API to enhance recorded scripts with additional testing functionality. Commands that are specific to the Web Functional Testing Module are part of the "web" class. Additional functional test methods are available in the "ft" class. You can also leverage other commands from other enabled classes (services) or general Java commands in your scripts.
Some examples of the Web Testing Module API include:
Adding control statements
Adding think time
Launching and closing the Browser
Navigating to a URL
Performing actions on Web objects (click, double click, etc.)
Setting text fields
Waiting for a page to load
Many API methods can be added using the Web Functional Test Module Tree View. Additional methods can be added using the Java Code view.
|
 Copyright © 2009, 2010, Oracle and/or its affiliates. All rights reserved. Legal Notices |
|