Troubleshooting

Script Recorder update caused an error

If an error is encountered during automatic update, perform the following steps to resolve the issue.
  1. Open the Windows Control Panel
  2. Click 'Add/Remove Programs'
  3. Uninstall the Script Recorder
A dialog will ask the user to roll back to the previous version or completely remove the application. Select the option to rollback to the previous version.

During playback, script encounters an UnknownObjectException

Occasionally, during playback, a script may not be able to find a certain element that was identified by the script recorder. In order to resolve this issue, navigate to the page where the error occurred in the script recorder, and in the Menu, click "View" and then "Element HTML". A window should show directly below your script. Move the cursor directly over the element you want to identify to see the HTML for that element. With this tool, you will be able to quickly determine other attributes to identify that element.

For help on how to identify elements, refer to the "How To" section and the "Examples" section.

Further help can be found in the Watir User's Guide at http://wtr.rubyforge.org/watir_user_guide.html

Script doesn't play when clicking play button

If a script doesn't play back in the script recorder, perform the following steps to determine the problem.
  1. Check the Run-time Output tab right after clicking the play button. If there are any errors here, the script will need to be corrected to resolve the issue.
  2. Check that ruby is installed. Open a command prompt and type in ruby.exe and Enter. If there is an error such as 'command not found' or something similar, then the prerequisites were not installed. Click this link to install the needed files.

Script recorder does not record user actions

If the recorder doesn't seem to record any actions, perform the following steps to determine the issue
  1. Check that the record button is depressed. The script will not update if this button is inactive.
  2. Load a webpage, wait for the status bar at the bottom to say 'Document Complete. Ready for user interaction' to appear before proceeding with navigation. If this resolves the issue, refer to Recording a script for instructions on how to record a script.
  3. Try using the ElementHTML feature of the script recorder to determine what type of element you are trying to interact with. This can be found in the View menu at the top of the script recorder. If nothing shows up in this textbox when you hover your cursor over the page, it is most likely something on the page causing the page to not fully load all the elements in the DOM and therefore the script recorder cannot start recording your actions.
  4. If the above steps do not resolve the issue, try reinstalling the script recorder.

Popup window does not appear

During playback, if the script is supposed to cause a new window to appear but it does not, it may be that the popup blocker in Internet Explorer is interfering with the script playback.

To disable the PopUp Blocker perform the following steps:
  1. Open Internet Explorer
  2. Click 'Tools' in the Menu
  3. Click 'Pop-Up Blocker
  4. Click 'Turn off Popup Blocker'

WIN32OLERuntimeError when trying to access a frame

This is a bug that is known in Watir. If you feel that this is the case with your script, find the URL of the frame you are trying to access and use a goto statement to goto that frame directly and continue scripting from there.

For help on using the goto statement, refer to this page

An AutoComplete dialog causes my script to pause

By default, Internet Explorer prompts the user to ask if they want to save Passwords, Usernames, or Search Queries. If an AutoComplete dialog comes up during playback, the script will pause here until the dialog is clicked away.

To resolve this, do one of the following:
  1. Disable this by clicking the check box that tells Internet Explorer to never remember this information
  2. Click 'No' when the prompt shows up so that IE will not save this information