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 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:

Choosing the Action

Select an Action:

• Refresh This Section — When the event is performed on the property, the system submits the elements to the server in a single section. The Pega 7 Platform uses AJAX technology to communicate between the browser client and the server. The section is then redrawn dynamically, based on the value of this controlling property. The updated form may contain different values supplied by an activity or a data transform.

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.

• Post Value — Posts the property value to the clipboard and refreshes the cell's contents. Post Value is triggered by OnChange or OnBlur of the field and prior to any other event (such as a click action) initiated from a control, or from the calculation of expressions. For example: a pxButton control refreshes another section using an activity that requires three updated properties before the control can update the target section. When the user clicks the button, the properties are posted to the clipboard and are synchronized with the activity.The properties are already on the clipboard, in most cases, when the button is clicked.

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.

• Data Transform — Optional. Enter the Name key part of a data transform that may affect the content of the section to be redrawn. Click  Params  to display the parameters specified on the Data Transform form's Parameters tab. Enter the values you want to pass to this data transform. See About Data Transforms.
• Activity — Optional. Enter the Activity Name of an activity that performs only computations and does not send HTML or XML code to the workstation. Click  Params  to display the parameters listed on the Activity rule form's Parameters tab. Enter the values you want to pass to this activity.

Click  Save   to exit the Client Event Editor.

About Harnesses

Open topic with navigation