You are here: Reference > Tools, accelerators, and wizards > Harness and Section forms - Client Event Editor

  Harness and Section forms
Help — Client Event Editor

About Harnesses

Use the Client Event Editor to identify a non-auto-generated control that, when a user interface event is performed on it, dynamically submits elements within a work item or flow action form and re-renders the display.

To access the Client Event Editor, in the control's Cell Properties panel, next to the Behavior field. The Behavior field displays for non-auto-generated controls and for auto-generated controls with client events configured prior to V6.3.

In version 6.3 and higher, to configure dynamic behavior for an auto-generated control, selectnext to the Control field in the control's Cell Properties panel. Configure behaviors using the Control Parameters (Behavior) dialog. See Control form — Completing the Control tab.

Unlike the configuration required in releases before V6.2, you do not need to use the Client Event Editor when configuring Refresh When and Visible When conditions based on a property value. As of V6.2, such Apply Conditions happen automatically.

Choosing the Event

Consider the control that is to be used to present the controlling property. This rule may be identified in the Control field of the cell properties panel.

Select a value for the Event field based on the runtime presentation of the property:

Event

Description

OnChange

To associate an event with properties presented as a Text Input, Text Area, or Select List. The event occurs when the contents of the input field changes. The OnChange event is most useful is for selection lists: by using OnChange rather than OnBlur the action can occur immediately.

OnBlur

To associate an event with properties presented as a Text Input, Text Area, or Select List. This event occurs when the input field on the form loses focus; for example, when users press the Tab key or click in another input field. OnBlur is best used for inputs such as text input or text area.

OnClick

To associate an event with action controls such as Link, Icon, or Button, and with properties presented as a check box or set of radio buttons.

Choosing the Action

Select an Action:

For greater design flexibility, such as the ability to refresh sections anywhere on a form, you can use:

— A Refresh When condition on an included section. See Working with the Condition Builder.
— A Refresh Section action in a control such as pxButton, pxLink, or pxIcon. See Control form — Completing the Control tab.

Activity and Transform Data fields

If you selected Refresh This Section for the Action field, the Activity and Data Transform fields appear. You can use either or both options. If used together, the data transform processes first. To find the activity or data transform at runtime, rule resolution uses the rule's Applies To class. Where possible, use a data transform rather than an activity to effect the refresh process.

Click  Save   to exit the Client Event Editor.

Up About Harnesses