Harness form
Completing the Display Options tab

  1. About 
  2. New 
  3. Design 
  4. Display Options 
  5. Scripts and Styles 
  1. Pages & Classes 
  2. Advanced 
  3. History 
  4. More... 

Optional. Complete the Display Options tab to control the presentation of form-level and field-level error messages. You can customize the fonts, colors and image used in field-level messages in the Skin rule. See Skin form — Components tab — General — Errors.

You can also use this tab to configure optional logging of each use at runtime of this rule.

Error Display

Field

Description

Form-level errors

Form-level errors are reported against properties not present on the current form. By default, the messages appear in a standard form-error message section. You can display the error messages in one of three ways:

  • Default — In a standard error section at both the top and bottom of the user form.
  • Top of harness — In a standard error section at the top of the form.
  • In configurable section — In a custom section that you create and place on the harness.

Always show – Select this check box so that a form-level error message appears in the standard form-error section even when a field-level error occurs. This enables you to see both-field level and form-level errors.
Custom Error Section

SmartPromptThis field appears only when you select Displayed in Configurable Section in the Form-level errors field. To add the section do the following:

  1. Press the down arrow to select a section that will display the error message.
  2. Open the section. On the section's Design tab, type the message text in one or more label fields on the layout, and save the rule.
  3. Include the section on the harness where you want the message to appear.
  4. Open the section's Properties panel.
  5. In the Visible When field, select hasMessages from @baseclass and click OK.
  6. Save the harness.

For an example, see PDN article How to create a custom error section in user forms.

Caution: If you select this option, the standard form-level error section will not appear. Therefore, make sure that you add the custom section to the harness layout. Otherwise, no messages will appear. Optionally, you can use the Displayed in Configurable Section option, add the section specified here to the layout, and change the option to Default or Top of harness — both the custom and standard form-level error section will appear.

Field-level errors

Field-level errors (such as leaving a required field blank) are reported against properties on the current form. You can display them in one of two ways:

Keep visible – Leave cleared in most cases. Select this check box to cause the entire runtime work item to scroll vertically as a single unit, except for the button bar and form error area which remain visible at the top.

Presentation

Show container icons

Select this check box to display container (header) icons to the user.

Enforce CSS minimum width

Select this check box to enforce the Minimum Screen Width set in the skin. This determines the smallest width to which a user can compress the screen width before text is truncated and horizontal and vertical scroll bars appear. The minimum value provides consistent alignment by preventing columns and text from wrapping.

When the Enforce CSS minimum width check box is selected, the Minimum Screen Width setting, located in the Skin form — Components tab — Controls — Smart layouts, applies to all harnesses, regardless of whether the harness contains a Smart layout.

Additional

Enable auditing

Select to enable auditing of the user forms produced by this harness. Additional fields display.

Enable this feature only if such detailed auditing is needed in your application. Auditing increases the database workload of your application and can produce large volumes of log data.

Complete these optional fields to record each time a user requests the user form based on this harness. Each time the form appears, your application can add an instance of the Log-DataAccessAudit class, to support later compliance auditing, reporting, and analysis. The added instance identifies the date, time, Operator ID, harness, Customer party (if any) and work item ID.

Logging occurs upon initial display of the form; it does not require that the user update any fields. You can create list view rules and summary rules to report on Log-DataAccessAudit instances, or export the data for analysis.

Note: On the Security tab of the Flow Action form, you can provide a similar logging capability for flow actions.

Mobile

This section will appear only if the Pega-Mobile RuleSet is part of your application.

Field

Description

Supplemental Toolbar Navigation Rule

SmartPrompt Optional. Enter the name of a navigation rule to render as a supplemental toolbar navigation menu. The nodes specified in this rule appear in the toolbar navigation menu in addition to the nodes defined in the Toolbar Navigation Rule field of the mobile portal rule.

To display the toolbar navigation menu, rule resolution checks:

  • the required Toolbar Navigation Rule field of the mobile portal rule.
  • the Supplemental Toolbar Navigation Rule field on the Display Options tab of the Harness rule form.

Be careful to reference a navigation rule of type Mobile. If you reference a Standard type navigation rule, a validation error will appear when you save the harness.

Up About Harnesses