Contents

List of Tables

Title and Copyright Information

Preface

• Audience
• Documentation Accessibility
• Related Documents
• Conventions

Part I Introduction

1 Introduction

• 1.1 About the OpenScript Scripting API

2 OpenScript Scripting Basics

• 2.1 About Oracle OpenScript
• 2.2 Starting the OpenScript Workbench
• 2.3 Overview of the OpenScript Main Window (Workbench)
  • 2.3.1 Tester Perspective
  • 2.3.2 Developer Perspective
  • 2.3.3 Script View
    • 2.3.3.1 Tree View
    • 2.3.3.2 Java Code
    • 2.3.3.3 Assets
  • 2.3.4 Problems View
  • 2.3.5 Error Log View
  • 2.3.6 Data Table View
  • 2.3.7 Object Details View
  • 2.3.8 Script Variables View
  • 2.3.9 Treeview Breakpoint View
  • 2.3.10 Debug View
  • 2.3.11 Declaration View
  • 2.3.12 Variables and Breakpoints Views
• 2.4 Creating a Script Project
  • 2.4.1 Recording Scripts
• 2.5 Creating Functional Test Scripts
  • 2.5.1 Creating a Web Functional Test Script Project
  • 2.5.2 Recording a Functional Test Scripts
  • 2.5.3 Opening and Closing a Browser
  • 2.5.4 Navigating Web Pages in Functional Test Scripts
  • 2.5.5 About Object Identification Paths
• 2.6 Creating a Load Test Script
  • 2.6.1 Creating a Load Test Script Project
  • 2.6.2 Recording a Load Test Script
  • 2.6.3 Setting the User Agent and Language Type
  • 2.6.4 Navigating Web Pages in Load Test Scripts
• 2.7 Modifying Scripts
  • 2.7.1 Adding Step Groups to a Script
  • 2.7.2 Adding a Delay to a Script
  • 2.7.3 Adding a Log Message to a Script
  • 2.7.4 Encrypting and Decrypting Data
  • 2.7.5 Setting the Password Encryption
  • 2.7.6 Running a Child Script from Within a Script
  • 2.7.7 Calling a Function from a Child Script from Within a Script
  • 2.7.8 Adding a Function to a Script
    • 2.7.8.1 Adding Functions that Use Lists
    • 2.7.8.2 Adding Functions that Use Maps
    • 2.7.8.3 Adding Functions that use Enumerated Lists
    • 2.7.8.4 Inputting Values from a File
  • 2.7.9 Using a Script as a Dedicated Function Library
    • 2.7.9.1 About Function Libraries
    • 2.7.9.2 Creating a Dedicated Function Library Script
    • 2.7.9.3 Calling Functions from a Function Library Script
  • 2.7.10 Converting a Script to a Dedicated Function Library
  • 2.7.11 Adding Script Assets
  • 2.7.12 Adding a Synchronization Point to a Script
  • 2.7.13 Setting and Evaluating Script Variables
    • 2.7.13.1 Variables with Scope
  • 2.7.14 Adding Comments to Script Results
  • 2.7.15 Adding Error Recovery to a Script
    • 2.7.15.1 Script Types
    • 2.7.15.2 Constants
    • 2.7.15.3 Actions
  • 2.7.16 Verifying Script Actions
    • 2.7.16.1 Adding an Error Recovery Action
    • 2.7.16.2 Adding a Has Error Control Statement
    • 2.7.16.3 Adding a Result Object Message
    • 2.7.16.4 Actions That Can Be Verified
  • 2.7.17 Chaining Multiple Scripts
    • 2.7.17.1 Setting the Browser Preferences
    • 2.7.17.2 Recording Scripts
    • 2.7.17.3 Creating a Shell Script
  • 2.7.18 Aborting and Resuming a Script Programmatically
• 2.8 Using Script Databanks
  • 2.8.1 Configuring Databanks
  • 2.8.2 Creating or Editing Databank Files
  • 2.8.3 Getting Databank Records
    • 2.8.3.1 Getting Databank Records Using the API
      • 2.8.3.1.1 Databank API Usage Notes
      • 2.8.3.1.2 Loading a Databank
      • 2.8.3.1.3 Getting a Record Count
      • 2.8.3.1.4 Getting a Specific Record
      • 2.8.3.1.5 Getting the First Record
      • 2.8.3.1.6 Getting the Last Record
  • 2.8.4 Playing Back Scripts With Iterations
    • 2.8.4.1 Notes and Limitations
    • 2.8.4.2 Using Very Large Databanks
• 2.9 Using Data Tables
  • 2.9.1 Enabling the Data Table Service
  • 2.9.2 Setting the First Row Policy
  • 2.9.3 Importing Data from a Spreadsheet File
  • 2.9.4 Exporting Data to a Spreadsheet File
  • 2.9.5 Changing Data During Script Playback
    • 2.9.5.1 Getting and Setting Cell Values
      • 2.9.5.1.1 Getting Data by Row and Column Value
      • 2.9.5.1.2 Getting Data by Sheet, Row, and Column Value
      • 2.9.5.1.3 Setting Data by Row and Column Value
      • 2.9.5.1.4 Setting Data by Sheet, Row, and Column Value
    • 2.9.5.2 Adding and Deleting Rows and Columns
      • 2.9.5.2.1 Adding Columns
      • 2.9.5.2.2 Deleting Columns
      • 2.9.5.2.3 Adding Rows
      • 2.9.5.2.4 Deleting Rows
    • 2.9.5.3 Adding and Deleting Worksheets
      • 2.9.5.3.1 Adding Worksheets
      • 2.9.5.3.2 Deleting Worksheets
    • 2.9.5.4 Getting Worksheet, Row, and Column Counts
      • 2.9.5.4.1 Getting Worksheet Counts
      • 2.9.5.4.2 Getting Row Counts
      • 2.9.5.4.3 Getting Column Counts
    • 2.9.5.5 Getting the Current Sheet and Row
      • 2.9.5.5.1 Getting the Current Sheet
      • 2.9.5.5.2 Getting the Current Row
    • 2.9.5.6 Setting Next and Previous Rows
      • 2.9.5.6.1 Setting the Next Row
      • 2.9.5.6.2 Setting the Previous Row
    • 2.9.5.7 Importing and Exporting Documents and Sheets
      • 2.9.5.7.1 Importing an Excel Spreadsheet Document
      • 2.9.5.7.2 Importing Worksheets
      • 2.9.5.7.3 Exporting an Excel Spreadsheet Document
      • 2.9.5.7.4 Exporting Worksheets
    • 2.9.5.8 Using Data Tables with Parent and Child Scripts
      • 2.9.5.8.1 Accessing the Parent Data Table from a Child Script
      • 2.9.5.8.2 Accessing the Top-Most Data Table in Chain of Parent Scripts
• 2.10 Using the Shared Data Service
  • 2.10.1 Basic Scenarios
  • 2.10.2 Enabling the Shared Data Service
  • 2.10.3 Setting the Connection Parameters
  • 2.10.4 Creating a Shared Data Queue
  • 2.10.5 Inserting Data into a Shared Data Queue
  • 2.10.6 Getting Data from a Shared Data Queue
  • 2.10.7 Clearing a Shared Data Queue
  • 2.10.8 Destroying a Shared Queue
  • 2.10.9 Creating a Shared Data Hash Map
  • 2.10.10 Inserting Data into a Shared Data Hash Map
  • 2.10.11 Getting Data from a Shared Data Hash Map
  • 2.10.12 Clearing a Shared Data Hash Map
  • 2.10.13 Destroying a Shared Data Hash Map
• 2.11 Using The Utilities API
  • 2.11.1 Working with Text Files
  • 2.11.2 Working with CSV Files
  • 2.11.3 Working with XML Files
  • 2.11.4 Getting Values from a Database
    • 2.11.4.1 Adding a SQL Query Test
    • 2.11.4.2 Calling a Database Procedure Statement
  • 2.11.5 Using the XPath Generator
• 2.12 Debugging Scripts
  • 2.12.1 Adding Views to the Tester Perspective
  • 2.12.2 Adding Breakpoints to a Script
  • 2.12.3 Adding a Java Exception Breakpoint
  • 2.12.4 Pausing and Resuming Script Playback in Debug Mode
  • 2.12.5 Inspecting and Changing Script Variable Values
• 2.13 Enabling Debug Logging

Part II Load Testing Modules API Reference

3 Adobe Flex (AMF) Load Module

• 3.1 AmfService API Reference
  • 3.1.1 Alphabetical Command Listing
• amf.assertText
• amf.post
• amf.solve
• amf.solveXpath
• amf.verifyText

4 Oracle EBS/Forms Load Module

• 4.1 FormsService ENUM Reference
  • 4.1.1 Alphabetical Enum Listing
• 4.2 FormsService API Reference
  • 4.2.1 Alphabetical Command Listing
• nca.alertDialog
• nca.application
• nca.assertStatusBarText
• nca.assertText
• nca.blockScroller
• nca.button
• nca.cancelQueryDialog
• nca.canvas
• nca.cfmOLE
• nca.cfmVBX
• nca.checkBox
• nca.choiceBox
• nca.comboBox
• nca.connect
• nca.disconnect
• nca.displayErrorDialog
• nca.displayList
• nca.editBox
• nca.editorDialog
• nca.flexWindow
• nca.genericClient
• nca.getLastKnownContents
• nca.getStatusBarText
• nca.helpDialog
• nca.image
• nca.infoBox
• nca.jContainer
• nca.list
• nca.listOfValues
• nca.logon
• nca.menuParametersDialog
• NcaSource
• nca.popupHelp
• nca.promptList
• nca.radioButton
• nca.registerProperty
• nca.responseBox
• nca.send
• nca.sendMessages
• nca.sendTerminal
• nca.solve
• nca.statusBar
• nca.tab
• nca.tableBox
• nca.textField
• nca.timer
• nca.tree
• nca.treeList
• nca.unRegisterProperty
• nca.verifyStatusBarText
• nca.verifyText
• nca.window

5 Oracle Fusion/ADF Load Module

• 5.1 AdfLoadService ENUM Reference
  • 5.1.1 Alphabetical Enum Listing
• 5.2 AdfLoadService API Reference
  • 5.2.1 Alphabetical Command Listing
• adfload.getAdfVariable
• adfload.solveGroupAdf
• VariableType

6 Oracle Hyperion Load Module

• 6.1 HyperionLoadService API Reference
  • 6.1.1 Alphabetical Command Listing
• hyperion.getAtSignEncoder
• hyperion.getBNToCRLFEncoder
• hyperion.getBNToLFEncoder
• hyperion.getCRLFSEncoder
• hyperion.getStarEncoder

7 Siebel Load Module

• 7.1 SiebelService API Reference
  • 7.1.1 Alphabetical Command Listing
• siebel.getSettings
• siebel.solve

8 Web/HTTP Load Module

• 8.1 HTTPService ENUM Reference
  • 8.1.1 Alphabetical Enum Listing
• 8.2 HTTPService API Reference
  • 8.2.1 Alphabetical Command Listing
• http.addAuthentication
• http.addCookie
• http.addGlobalAssertText
• http.addGlobalVerifyText
• http.addValidator
• http.assertResponseTime
• http.assertText
• http.assertTitle
• http.assertXPath
• http.beginConcurrent
• http.clearCookies
• http.element
• EncodeOptions
• http.endConcurrent
• http.form
• http.frame
• http.get
• http.getBrowser
• http.getHtmlContent
• http.getLastBrowserResponse
• http.getLastResponseContents
• http.getResponseHeaders
• http.getSettings
• http.getValidatorList
• http.header
• http.headers
• http.javaScriptPath
• http.link
• http.loadKeystore
• http.multipartPost
• http.navigate
• http.param
• http.post
• http.postdata
• http.querystring
• http.removeCookie
• http.removeGlobalTextValidator
• http.removeValidator
• http.setAcceptLanguage
• http.setUserAgent
• http.solve
• http.solveCookieHeader
• http.solveGroupJavaScript
• http.solveHeader
• http.solveRedirectNavs
• http.solveRefererHeader
• http.solveXPath
• Source
• http.text
• http.urlEncode
• http.validate
• http.verifyResponseTime
• http.verifyText
• http.verifyTitle
• http.verifyXPath
• http.window
• http.xmlPost

Part III Functional Testing Modules API Reference

9 Applet Module

• 9.1 AppletService API Reference
  • 9.1.1 Alphabetical Command Listing
• applet.appWindow
• applet.button
• applet.checkBox
• applet.comboBox
• applet.dcmLayoutEditor
• applet.dialog
• applet.dtree
• applet.expansionTree
• applet.grid
• applet.infiniteScrollBar
• applet.javaObject
• applet.radioButton
• applet.scrollBar
• applet.tab
• applet.textField
• applet.timeBrowser
• applet.timeline
• applet.toolBar
• applet.treeBrowser

10 Adobe Flex Functional Module

• 10.1 FlexFTService API Reference
  • 10.1.1 Alphabetical Command Listing
• flexFT.accordion
• flexFT.alert
• flexFT.application
• flexFT.areaChart
• flexFT.areaSeries
• flexFT.barChart
• flexFT.barSeries
• flexFT.box
• flexFT.bubbleSeries
• flexFT.button
• flexFT.buttonBar
• flexFT.cartesianChart
• flexFT.checkbox
• flexFT.colorPicker
• flexFT.columnChart
• flexFT.columnSeries
• flexFT.combobox
• flexFT.dataGrid
• flexFT.dateChooser
• flexFT.dateField
• flexFT.dividedBox
• flexFT.lineChart
• flexFT.lineSeries
• flexFT.linkBar
• flexFT.list
• flexFT.menu
• flexFT.menubar
• flexFT.numericStepper
• flexFT.panel
• flexFT.pieChart
• flexFT.pieSeries
• flexFT.plotSeries
• flexFT.popupButton
• flexFT.progressBar
• flexFT.radioButton
• flexFT.scrollbar
• flexFT.slider
• flexFT.toggleButtonBar
• flexFT.tree

11 Functional Test Module

• 11.1 FunctionalTestService API Reference
  • 11.1.1 Alphabetical Command Listing
• ft.drag
• ft.dragAndDrop
• ft.getScreenCapture
• ft.keyDown
• ft.keyUp
• ft.mouseClick
• ft.mouseDown
• ft.mouseUp
• ft.typeCharacters
• ft.typeKeyCode
• ft.typeKeys

12 Oracle EBS/Forms Functional Module

• 12.1 FormsService API Reference
  • 12.1.1 Alphabetical Command Listing
• forms.alertDialog
• forms.appletAdapter
• forms.attribute
• forms.attributes
• forms.blockScroller
• forms.button
• forms.calendar
• forms.captureScreenshot
• forms.cell
• forms.cells
• forms.checkBox
• forms.choiceBox
• forms.close
• forms.comboBox
• forms.editBox
• forms.editorDialog
• forms.flexWindow
• forms.getAllObjects
• forms.getStatusBarCount
• forms.getStatusBarErrorCode
• forms.getStatusBarItem
• forms.getStatusBarItemCount
• forms.getStatusBarMessage
• forms.getStatusBarRecordInfo
• forms.helpDialog
• forms.hGridApp
• forms.imageItem
• forms.infoBox
• forms.list
• forms.listOfValues
• forms.logonDialog
• forms.otsHGrid
• forms.radioButton
• forms.responseBox
• forms.schedulingDataClient
• forms.spreadTable
• forms.statusBar
• forms.tab
• forms.tableBox
• forms.textField
• forms.tree
• forms.treeList
• forms.window

13 Oracle Fusion/ADF Functional Module

• 13.1 ADFService API Reference
  • 13.1.1 Alphabetical Command Listing
• adf.calendar
• adf.carousel
• adf.commandButton
• adf.commandImageLink
• adf.commandLink
• adf.commandMenuItem
• adf.commandNavigationItem
• adf.commandToolbarButton
• adf.dialog
• adf.gauge
• adf.goButton
• adf.goImageLink
• adf.goLink
• adf.goMenuItem
• adf.graph
• adf.inputColor
• adf.inputComboboxListOfValues
• adf.inputDate
• adf.inputFile
• adf.inputListOfValues
• adf.inputNumberSlider
• adf.inputNumberSpinbox
• adf.inputRangeSlider
• adf.inputText
• adf.menu
• adf.message
• adf.messages
• adf.navigationPane
• adf.noteWindow
• adf.outputFormatted
• adf.outputLabel
• adf.outputText
• adf.page
• adf.panelAccordion
• adf.panelBox
• adf.panelHeader
• adf.panelLabelAndMessage
• adf.panelList
• adf.panelSplitter
• adf.panelTabbed
• adf.panelWindow
• adf.pivotTable
• adf.progressIndicator
• adf.query
• adf.quickQuery
• adf.region
• adf.resetButton
• adf.richTextEditor
• adf.selectBooleanCheckbox
• adf.selectBooleanRadio
• adf.selectManyCheckbox
• adf.selectManyChoice
• adf.selectManyListbox
• adf.selectManyShuttle
• adf.selectOneChoice
• adf.selectOneListbox
• adf.selectOneRadio
• adf.selectOrderShuttle
• adf.showDetail
• adf.showDetailHeader
• adf.table
• adf.toolbar
• adf.train
• adf.trainButtonBar
• adf.tree
• adf.treeTable
• adf.waitForPageLoaded

14 Oracle JD Edwards EnterpriseOne Functional Module

• 14.1 EnterpriseOneService API Reference
  • 14.1.1 Alphabetical Command Listing
• eone.grid

15 Siebel Functional Module

• 15.1 SiebelFTService API Reference
  • 15.1.1 Alphabetical Command Listing
• siebelFT.applet
• siebelFT.application
• siebelFT.attribute
• siebelFT.attributes
• siebelFT.button
• siebelFT.calculator
• siebelFT.calendar
• siebelFT.cell
• siebelFT.cells
• siebelFT.currency
• siebelFT.element
• siebelFT.exists
• siebelFT.list
• siebelFT.menu
• siebelFT.pageTabs
• siebelFT.pdq
• siebelFT.richText
• siebelFT.screen
• siebelFT.screenViews
• siebelFT.text
• siebelFT.textArea
• siebelFT.threadbar
• siebelFT.toolbar
• siebelFT.tree

16 Webdom Module

• 16.1 WebDomService API Reference
  • 16.1.1 Alphabetical Command Listing
• web.accButton
• web.accCheckBox
• web.accComboBox
• web.accElement
• web.accListBox
• web.accMenu
• web.accRadioButton
• web.accTextBox
• web.addGlobalAssertText
• web.addGlobalVerifyText
• web.alertDialog
• web.assertErrors
• web.assertText
• web.attribute
• web.attributes
• web.button
• web.cell
• web.cells
• web.checkBox
• web.clearAllCache
• web.clearAllPersistentCookies
• web.clearCache
• web.clearPersistentCookies
• web.clearSessionCookies
• web.confirmDialog
• web.customElement
• web.dialog
• web.document
• web.element
• web.exists
• web.getFocusedWindow
• web.image
• web.link
• web.loginDialog
• web.notificationBar
• web.object
• web.promptDialog
• web.radioButton
• web.removeGlobalTextValidator
• web.selectBox
• web.solve
• web.table
• web.textArea
• web.textBox
• web.verifyText
• web.waitForObject
• web.window
• web.xmlDocument

Part IV Utility Modules API Reference

17 Block Scenario Module

• 17.1 BlockScenariosService API Reference
  • 17.1.1 Alphabetical Command Listing
• blockScenarios.run

18 Browser Module

• 18.1 BrowserService API Reference
  • 18.1.1 Alphabetical Command Listing
• browser.clearBrowser
• browser.close
• browser.closeAllBrowsers
• browser.getBrowser
• browser.getBrowserProcessID
• browser.getFirefoxUtility
• browser.getSettings
• browser.launch
• browser.setBrowserType

19 DataTable Utility Module

• 19.1 DataTableService ENUM Reference
  • 19.1.1 Alphabetical Enum Listing
• 19.2 DataTableService API Reference
  • 19.2.1 Alphabetical Command Listing
• datatable.addColumn
• datatable.addSheet
• datatable.changeSheet
• datatable.debugDump
• datatable.deleteColumn
• datatable.deleteRow
• datatable.deleteSheet
• ExportMode
• datatable.exportSheet
• datatable.exportSheets
• datatable.exportToExcel
• datatable.getColumn
• datatable.getColumnCount
• datatable.getColumnIndex
• datatable.getCurrentRow
• datatable.getCurrentSheet
• datatable.getGlobalDatatable
• datatable.getParentDatatable
• datatable.getRowCount
• datatable.getSheet
• datatable.getSheetCount
• datatable.getValue
• datatable.importAllSheets
• datatable.importExcel
• datatable.importSheet
• datatable.importSheets
• datatable.insertRow
• datatable.isFirstRowAsColumnHeader
• datatable.setCurrentRow
• datatable.setCurrentSheet
• datatable.setNextRow
• datatable.setPreviousRow
• datatable.setValue
• datatable.updateColumn
• datatable.useFirstRowAsColumnHeader

20 SharedData Module

• 20.1 SharedDataService API Reference
  • 20.1.1 Alphabetical Command Listing
• sharedData.clearMap
• sharedData.clearQueue
• sharedData.createMap
• sharedData.createQueue
• sharedData.destroyMap
• sharedData.destroyQueue
• sharedData.getFromMap
• sharedData.getKeysOfMap
• sharedData.getLengthOfQueue
• sharedData.offerFirst
• sharedData.offerLast
• sharedData.peekFirst
• sharedData.peekLast
• sharedData.pollFirst
• sharedData.pollLast
• sharedData.putToMap
• sharedData.removeFromMap
• sharedData.setConnectionParameters
• sharedData.waitFor

21 Utilities Module

• 21.1 UtilitiesService API Reference
  • 21.1.1 Alphabetical Command Listing
• utilities.getFileService
• utilities.getSQLService
• utilities.loadCSV
• utilities.loadXML
• utilities.loadXMLContent
• utilities.parameters
• utilities.saveCSV

22 Web Services Module

• 22.1 WSService ENUM Reference
  • 22.1.1 Alphabetical Enum Listing
• 22.2 WSService API Reference
  • 22.2.1 Alphabetical Command Listing
• ws.addSecurityAttachments
• ws.attachment
• AttachmentMechanism
• ws.attachments
• ws.post
• ws.security
• ws.solveXpath

Index