Creating browser scripts

To create a script for a website displayed in a desktop browser, record the actions you take to navigate the target website.

Before beginning the script:

  • If the Recorder must use a proxy server to reach the Internet, configure the appropriate proxy settings.

  • If a website requires a certificate, use the Certificate Manager to import the certificate.

  • To record an IPv6 script, you must record the script from an IPv6-capable system with IPv6 support from your ISP. You will not be able to record the script if you cannot reach the IPv6 address from your local machine. After recording an IPv6 script, while the default is IPv4, you can select to play back the script in IPv6 mode. For more information, see Trial playback of scripts.

If you usually use the same settings when you record scripts, you can specify default selections in the Global Preferences screen. These defaults will be applied when you begin recording, so it is not necessary to change the settings individually each time.

To record the script:

Click REC to start recording.

Select Desktop Browser.
Select desktop browser to record

Optional: Click Customize to open the Customize Profile window, where you can change the device name, user agent, and/or headers.

Use this window to save the custom profile or to load an existing profile. You can also apply a custom profile after you have recorded the script. For more information, see Using custom profiles.

By default, the Recorder captures each keystroke, creating Type actions. To capture the value in a field instead of individual keystrokes, select FormFill to create FormFill actions wherever possible.

When you select FormFill, for some keys that you type (Tab, Enter, and Ctrl or Alt combinations), Type actions will appear. You can toggle between Keystrokes and FormFill at any time while recording the script.

If using the target website includes entering sensitive data such as a password or personal information, enable FormFill, then encrypt the field values after you have recorded the script.

The HTTP Capture option creates static requests for any objects generated through a particular plugin on the page, for example Flash or Silverlight. The option is OFF by default because when Enable Flash Playback or Enable Silverlight Playback is selected in the playback settings, HTTP Capture is redundant.

To capture the actions of scrolling the page, make sure Scroll Capture On is selected. By default, this option is Off.
Scroll capture on

For more information, see Scroll script action.

In the URL field, replace about:blank with the website URL. Press Enter or click the Go To icon to begin recording.

Navigate the website in the Recorder window as if you were using a browser.
As you navigate, your actions are added to the timeline; for example, clicking a link adds a Click action and a Wait action. Clicking-and-dragging, for example to re-center a map, is recorded as a Click.

As the actions are added to the timeline, they are separated into steps. A step is a set of actions that have been grouped together for convenience. The default steps roughly correspond to a webpage view, but are not limited to being a page view.

As you navigate through web pages, the URL field changes to display the address of the current page.

When you have recorded all of the actions, click STOP .

The Recorder displays the Profile tab. Other script settings tabs are also available. For details, see Modifying script settings.

After you stop recording, you can play back, save, and edit the script.

It is recommended that you add a test at the end of the script whenever possible to make sure it ends correctly. Add a Validate action and enter a string that appears on the last page that the script visits.

Flash objects

If the script includes interactions with Flash objects, see Recording and playing back Flash for more information.

HTTP authentication

During the recording of a script, if the agent encounters an HTTP authentication request and prompts you for the username and password, these credentials are inserted in the step.

You can also add this information manually to the step after you finish recording:

  1. Click the step name in the timeline.
    Select the step name
  2. If necessary, click the small right-pointing arrow  next to the step name below the timeline to display the HTTP Authentication fields.
    HTTP authentication fields
  3. Enter the Username and Password for basic or digest HTTP authentication. For NT LAN Manager (NTLM), also enter the Machine Name and the Domain Name.

The information is saved automatically.