Harness and Section forms
Adding a tab

Field

Description

Choose a format to control what appears above the layout (known as a header or subheader), and the appearance of both the header or subheader if any, and aspects of the body.

A tab must have a header. Do not choose No Format, Hidden or Hidden (Sub).

This choice primarily affects styles and appearance. Information in or below a subheader (including Hidden Sub) present information that is right-indented from information in a header.

Enter text to appear in the header or subheader. This text may include directives or JSP tags, such as <p:r > or <pega:lookup >.

If you plan to localize the application using this rule so the application can support users in various languages or locales, choose the text carefully and limit the length to no more than 64 characters. When practical, choose a caption already included in a language pack, to simplify later localization. A field value rule with this text as the final key part is needed for each locale. See About the Localization wizard.

This field is not visible if the Header field contains No Format, Hidden, or Hidden (Sub).

If the Header field contains Custom, identify the Stream Name (second key part) of an HTML rule that defines the content of the header.

Select to create a SmartLayout grid containing fixed-width, fixed-height column pairs. Each column pair is designed to hold one label and one field, typically for a Single Value property value.

Select a template:

• Single — A single column pair.
• Double — One column pair, a spacer column and a second column pair.
• Triple — Three column pairs with two spacer columns.

The width and other style characteristics of these SmartLayout templates depend on the portal skin rule in use. For ensure consistent results when building harness, section, or flow action rules for work object forms, set the Skin preference (in the Run Process area of the General Preferences group) to the skin that application users are expected to use. You can change template widths, heights, cell padding, and other characteristics of the templates using the Branding wizard. See About the Branding wizard.

By design, you cannot change the height or width of SmartLayout template-based cells through rule form updates. However, Process Commander records the template cell height and widths in styles for the <TD> HTML element. If at runtime a cell contains an object that is explicitly larger than these values, browsers do expand the table cell to attempt to display the entire object, overriding the fixed size restriction. The resulting display may vary somewhat by browser version.

Optional. To control visibility of this tab header, enter or select one of the following:

• Leave blank to always present the tab header.
• A when condition rule. Click the pencil icon () to review or create the when condition rule.
• Expression evaluated once — Enter an expression that returns true or false. This expression can involve multiple properties, function calls, and other syntax as supported by the <pega:when > JSP tag.

This checkbox appears only if the Visible When field contains a simple Java comparison of a property and a value, or a combination of such comparisons using parentheses and the && and || operators, such as:

(.Width >= "20") && (.Length >= "40)

Select to cause dynamic execution of the condition each time the value of a property mentioned in the condition changes. (Mark the fields containing such properties as a Client Event.) Leave cleared to cause the condition to execute only once, upon initial presentation of the form.

Field

Description

Select Tabbed.

Optional. If the Header Type is Tabbed, this field provides the ability to reference a family of custom styles for headers. Enter a single letter or a few letters that designate a collection of styles for this header.

For example, type A in this field to use styles named .A_standardheader* rather than the normal .standardheader* styles. Define the prefixed styles in your workform_zzzzz.css text file (created by the Branding wizard) or in another text file that you identify on the Scripts and Styles tab of the Harness form.

Select to postpone, at runtime, the loading of the contents of this tab from the server until the user clicks to make the body visible.

Select if you want to start a new row of tabs.