Custom Web Event Recording Configuration Dialog Box

This dialog box enables you to customize the event recording configuration in cases where the predefined Web event configuration levels do not exactly match your recording needs.

You can customize event recording in the following ways:

  • Add or delete objects to which UFT should apply special listening or recording settings.
  • Add or delete events for which UFT should listen.
  • Modify the listening or recording settings for an event.
To access
  1. Select Record > Web Event Recording Configuration. The Web Event Recording Configuration dialog box opens.
  2. Click the Custom Settings button. The Custom Web Event Recording Configuration dialog box opens.
Important information
  • If an object is listed in the Custom Web Event Recording Configuration dialog box, then the settings for that object override the settings for Any Web Object.
  • You cannot delete or add to the list of objects in the Web Objects category, but you can modify the settings for any of these objects.
  • You can add any HTML Tag object in your Web page to the HTML Tag Objects category.
Relevant tasks
See also

User interface elements are described below (unlabeled elements are shown in angle brackets):

UI Elements

Description

<menu options>

File Menu

  • Load Configuration. Enables you to load a custom configuration XML file.
  • Save Configuration As. Enables you to save your custom configuration in an XML file.

Object Menu

  • Add. Enables you to add an HTML tag object to the Objects pane.
  • Delete. Enables you to delete an HTML tag object from the Objects pane.

Event Menu

  • Add. Enables you to add the following events to the Events pane: onchange, ondblclick, onblur, onfocus, onmousedown, onmouseup, onmouseover, onmouseout, onsubmit, onreset, onpropertychange.

    Depending on the selected object, not every event type is available.

  • Delete. Delete the selected events from the Events pane.
<Objects pane>

The list of Web test object classes and HTML tag objects. The top of the hierarchy is Any Web Object.

  • The settings for Any Web Object apply to any object on the Web page, for which there is no specific event recording configuration set. Below this are the Web Objects and HTML Tag Objects categories, each of which contains a list of objects.
  • Only HTML tag objects can be added or deleted to this list.
<Events pane>

The list of events associated with the object.

Event Name

The name of the event to which UFT listens and/or records, depending on the settings you specify.

Listen

The criteria that instructs UFT when to listen to the event. The following criteria are available:

  • Always. Always listens to the event.
  • If Handler. Listens to the event if a handler is attached to it. A handler is code in a Web page, typically a function or routine written in a scripting language, that receives control when the corresponding event occurs.
  • If Behavior. Listens to the event if a DHTML behavior is attached to it. A DHTML behavior encapsulates specific functionality or behavior on a page. When applied to a standard HTML element on a page, a behavior enhances that element's default behavior.
  • If Handler or Behavior. Listens to the event if a handler or behavior is attached to it.
  • Never. Never listens to the event.
Record

The record status for the selected object. The following statuses may be displayed:

  • Enabled. Records the event each time it occurs on an object as long as UFT listens to the event on the selected object, or on another object to which the event bubbles.

    Bubbling is the process whereby, when an event occurs on a child object, the event can travel up the chain of hierarchy within the HTML code until it encounters an event handler to process the event.

  • Disabled. Does not record the specified event and ignores event bubbling where applicable.
  • Enabled on next event. Same as Enabled, except that it records the event only if a subsequent event occurs on the same object.
Reset

Enables you to reset your settings to a pre-configured level. The following levels are available:

  • Basic
  • Medium
  • High

When you choose to reset predefined settings, your custom settings are cleared completely. If you do not want to lose your changes, make sure to save your settings in an event configuration file. For details, see Manage custom Web event recording configurations.