You are here: Reference > Tools, accelerators, and wizards > Client Event Editor

Harness and Section forms: Help — Client Event Editor

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 Cell Properties panel for the control select the gear icon next to the Behavior field. For client events configured before PRPC Version 6.3, the Behavior field displays for both auto-generated controls and controls that are not auto-generated.

To configure dynamic behavior for an auto-generated control, select the gear icon that is next to the Control field in the Cell Properties panel for the control. Configure behaviors using the Control Parameters (Behavior) dialog. See Control form — Completing the Control tab.

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 run time, 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.