Back Forward Harness form
Completing the HTML tab

About Harness rules

Each time you save a harness rule, Process Commander generates source HTML from your entries on the other tabs of this form. Complete the fields on this tab to control how the HTML is generated.

You can review but not directly alter the HTML text on this tab.

Field

Description

Enable Client Side Validation?

Select to cause Process Commander to immediately validate the format of user input to dates, integers, and other fields within the browser window when focus leaves the form field, before a user submits the form. C-1197 SP6

This feature can affect input of dates, times, text areas, and selected other properties, in sections of the work object form other than the Take Action section. This feature depends on the HTML Property rule associated with the property. See client-side format validation.

A similar checkbox appears on the HTML tab of the Flow Action form. It controls the client-side validation for the form presented by that flow action rule. GROVS 5/2006

NoteThis feature is effective only for Harness forms that use the SmartFrames version of the Layout tab and use only JSP tags, no directives. R-20008 off in std

TipSelect when users are to enter dates, times, integers, or text through typing rather than through selection. Workstation-level validation can detect and mark invalid input earlier, and may consume less network traffic and bandwidth. Do not select if the work object form presented by this harness rule contains only checkboxes, selection lists, combo boxes, and other input widgets that do not require typing.

Advanced featureStandard client-side validation scripts are in the text file rule named webwb.CSValid.js; to allow for localization, the corresponding error messages are in the HTML fragment rule named CSValid. You can add custom client-side validation scripts or error messages on an application-wide by overriding the HTML fragment rule named UserWorkForm, which is included in the fragment WorkFormStandard, which in turn is included in the HTML code for every work object form. R-20339

Enable Expression Calculation?

Select to enable automatic recomputation and redisplay of all target properties of a Declare Expression rules that appear on the work object form, and automatic evaluation of constraints rules associated with properties on this form, immediately after the user touches an input field. C-2337 This feature is sometimes known as "calculated values".

You can select this box if the work object form defined by this rule:

  • Displays one or more properties computed by Declare Expressions rules using forward chaining, or one or more properties involved in constraints rules
  • Allows users to input a property value that affects the computed property (directly through forward chaining) or the constraints

Computation occurs (and the system updates the display) as user focus leaves the input field for a property. See More about Declare Expression rules.

For example, the form may contain a total that sums values entered into an array.

This field controls all areas of the runtime work object form except the Take Action area. A similar but separate checkbox appears on the HTML tab of the Flow Action form; that field controls automatic expression calculation in the Take Action area when the user selects the corresponding flow action.

Portlet compliant?

C-1105 Select to generate portlet-compliant HTML that can be displayed by a portal server. Portlet-compliant HTML meets the requirements of Java Specification Request 168, which defines the portlet standard.

A portlet-compliant harness form can be sent to an external portal server through Service Portlet rules and displayed in a portlet window. A harness is considered portlet-compliant only when its section rules are also portlet-compliant.

The standard harness Work-.SimpleConfirm provides an example of portlet-compliant form.

Localize?

Select to indicate that at runtime, presentation of this harness rule will be localized based on field value rules in a language-specific RuleSet.

For each locale, you must add field value rules in such a RuleSet to support presentation of this section. Typically, use the Localization wizard and the Rules Inspector tool to identify, create, and maintain these field value rules. See:

This checkbox is available only when Generate For is set to JSP. C-2112 R-18899

Advanced featureWhen Localize? is selected, the generated HTML calls the PublicAPI Java function getLocalizedTextForString() at runtime to convert text in the pyCaption, pyButtonLabel, pyActionLabel, pyActionPrompt and other properties to a locale-specific value.

Accessibility

SmartPrompt This checkbox always appears "grayed-out" and is not available for selection. This field is active on other user interface rule forms (Flow Action, Paragraph, HTML Property and Section) to indicate that you have designed and implemented your own HTML rules that meet your accessibility requirements.

NoteHarness forms always auto-generate HTML code and are considered accessible by the system. These rules are included in the calculation of accessibility levels displayed in the Preflight Accessibility Report. See Using the Application Preflight tool.PROJ-901 5.4

Browser Support

SmartPromptIndicate which browser types can correctly process the HTML code from this rule. Because the code from harness rules is generated by Process Commander, the generated code includes only those tags that can be displayed across browser types and the value of this field is set to IE 6+, Firefox 2+ and Safari 3+6.1.

For harness rules last saved in a V5.3 or earlier system, the value of this field is IE6+ only.

The Browser Compatibility Report in the Preflight tool evaluates this field when determining what fractions of the rules in your application provide cross-browser support.PROJ-282 5.4

Old If your application includes auto-generated harness rules that you created in a version prior to V5.4 that include only sections and properties where the value of this field is set to IE 6+, Firefox 2+ and Safari 3+6.1, open and resave such section rules in V5.4 to have this field correctly reflect the setting. MAYED S4/24/08 SR-16854

Client RunTime Version

Select to control which JavaScript files are included in the generated harness. In most cases, accept the default value. PROJ-1343 add+ KAVOJ 1/7/09

  • 05-04+ — To reduce the runtime workstation memory requirements from this harness form, do not include three JavaScript files: DynamicSelect, SmartPrompt, and PRWBSScripts.js) in generated HTML code for this harness rule. Either these three are not needed by any HTML property, section, or other parts of the form, or the generated HTML code for the HTML property, section, or other parts of the form incorporates one or more of these three scripts directly.
  • 05-03 — This harness rule does not meet the above criteria for 05-04+ setting.

Tip Choosing the 05-04+ setting when possible improves performance by reducing the quantity of JavaScript code required on the client workstation at runtime, potentially reducing the amount of workstation memory required by the browser. GROVS 1/21/08

If your application includes custom versions of the standard HTML Property rules DynamicSelect, SmartPromptforClass, SmartPromptForDataClass, or other SmartPromptzzz rules, select 05-03.

Advanced featureSelecting 05-04+ excludes the legacy scripts file prscripts.js from the generated HTML code. Choose 05-03 if your harness rule references custom HTML property rules that use scripts in the prscripts.js file.

Advanced featureWhen entering HTML source code directly into the HTML tab of a HTML Property rule (or similar form), you can minimize the size of the resulting HTML document with the <pega:onlyonce > and <pega:static > tags.

Frame Source

Advanced featureOptional. Enter an HTML <FRAMESET > element if you want to present the harness as a set of frames.

HTML Source

Read-only. At runtime, Process Commander uses stream processing to evaluate the directives in this source HTML (which reference properties and other rules such as HTML fragment rules, HTML rules, HTML property rules, and section rules) in the context of current clipboard contents and static files.

Process Commander then returns the resulting HTML to the browser on the client workstation.

Definitions active property, open authoring
Related topics JavaServer Pages tags
Directives
How stream processing works
Source HTML tags

Up About Harness rules