Harness form
Completing the Display Options tab

Field

Description

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.
  
  

This 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.

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 (such as leaving a required field blank) are reported against properties on the current form. You can display them in one of two ways:

• As image with tooltip — The error image ( ) next to the field and the error message text in a Tooltip. Default. See Skin form — Components tab — Controls — Text inputs.
• As full error text — The error message text above the input the field. See Skin form — Components tab — General — Errors.

Keep visible Leave cleared in most cases. Check this 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.

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

Select if you want 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.

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.

Field

Description

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.