Show all
C-1990 GROVS To reduce the size and complexity of work object
forms, you can hide, show, or alter parts of the runtime presentation of
harness, section, and flow action forms based on user input.
Additionally, you can cause sections to repaint based on user
interactions. GRP-224
For example, if a user selects 3 in a field labeled Children, the work
object form can quickly change to present three input fields, to collect
the name or other information about each child. Similarly, if a user
checks a box labeled Earthquake Coverage?, fields appropriate and
specific to that situation can appear.
The field to which an event is linked is known as the
controlling field. Other fields that may become visible or hidden
are known as the controlled fields. In the first example, the
Children field contains the controlling field and the Child Name fields
are controlled.
Internally, user interactions trigger the JavaScript events
OnBlur
, OnChange
, and OnClick
that
then execute built-in JavaScript functions to change or refresh the
form.
Prerequisites
Dynamic form actions require the following: SR-6018 KHATV
9/27/06 GARFJ
- A harness, section, or flow action rule saved in Version 5 or
later that uses the SmartFrames layout and uses only JSP tags, not
directives. Section rules referenced with the rule also must use
only JSP tags. KHATV 10/3/06
- The control rule associated with the property (through
the Property form or through the Harness, Section, or Flow Action
form) must include the JavaScript code in the control rule
named ClientValidation. Several standard control
rules meet this requirement.
- A visible property presented on the runtime form in read-write
mode.
- An event associated with a controlling property.
- A test condition associated with one or more controlled
properties.
1. Establish the
controlling field with the Client Event Editor
Use the Client Event Editor to associate an event with the value
that the user enters into an input field for a property.
C-2526
1. Consider the control rule that is to be used to present
the controlling property. This rule may be identified in the
Control field of the panel. Click the Preview
toolbar button () to see an approximate runtime presentation.
2. Click the magnifying glass icon () on the Behavior field
to start the Client Event editor in a new window.
3. Complete the Client Event Editor form. See Help — Client Event Editor.
2. For each
controlled element, enter a Condition
At runtime, a controlled element is visible or hidden dynamically,
based on the results of the Run on Client test. The
following controlled elements are supported:
- Fields in a cell
- A layout
- An included section
- A container in a Harness rule
To establish a controlled element:
1. On the Field, Layout, Section Include or Container panel, choose
Other Condition
for the Visible When
field.
2. In the Condition field, enter one or more
simple test conditions for the property value in the controlling
field. Provide a comparison of the property with a constant value
using one of the operators ==, !=, >, >=, <, <=. Unless
the Type of the property is Integer
,
TrueFalse
, or Decimal
, place a pair of
double quotation characters around the string constant. You can use
parentheses and the && and || operators to group multiple
conditions.
For example, these are valid: 5/23/06 double quotes may not be
necessary per GROVS
.pyAddress2 != ""
.Color ==
"blue"
.Limit
>= 32 || .Limit <= 20
.GoldCard = true
&& .StateCode!="VA"
.RetiredDate >=
"20071010"
(.pyAddress2 !=""
|| .pyEmailAddress!="") &&
.pyStateCode!=""
See Constants in
expressions — Constants for information on entering
constants.
3. Select the Run on Client? box.
Notes
This feature does not require that the Enable Client Side
Validation? box be selected on the HTML tab of the Harness or Flow Action form.
When you select Refresh This Section
as the
Action, at runtime Process Commander uses AJAX
technology to communicate between the browser client and the
server.
About Flow Action rules
About Harness rules
About Section rules