Harness rules
|
Use these steps to add an accordion control to a harness rule or section rule. An accordion control presents one layout from several, with other layouts represented only by the header. Expanding one layout causes the currently expanded layout to collapse. Proj-1012 5.4SP2
1. Adding and deleting an Accordion control
Click the down-arrow ( ) at the right end of the Layout control group () and select the accordion control (). Alternatively, click the Layout control group itself to pop-out the Layout control group window. Click and drag the control on to the work area. When the pointer changes shape to indicate that you can drop the layout, release the mouse button.
Alternatively, you can select an existing accordion and click the Insert Row Above () or Insert Row Below () button to add a new accordion control above or below the selected one.
To delete an accordion control, select the control and click the Delete Row button (). Do not use the Delete Cell button for this action.
2. Complete the Container panel — Top fields
Click the magnifying glass icon () to open the Layout panel. Complete the top fields, General tab, and Advanced tab.
Your updates to this panel can update the rule form immediately or upon clicking Apply, depending on the Property Panel settings in your Edit preferences. See Setting your preferences. If the panel is pinned(), the wireframe on the rule form changes immediately to reflect your inputs. If the panel is not pinned(), click Apply to apply your inputs.
Field |
Description |
Header |
Select |
Title |
Optional. Enter literal text, a reference directive, reference JSP tag, Lookup directive, or JSP tag to derive the text to appear in the left title area of a header. For example, enter {.pyLabel} or equivalently <pega:reference name=".pyLabel" /> to use the value of a property named pyLabel as a title. If your application is to support users in multiple locales, choose a noun or noun phrase for the caption. When practical, choose a caption already included in a language pack, to simplify later localization. Select the Localize? box on the HTML tab. Limit title text to no more than 64 characters, even after JSP or directive tags are expanded. B-16750 See About the Localization wizard. |
Visible When |
Optional. Identify the When Name key part of a when condition rule to control visibility of the container. At runtime, the system uses the Applies To key part of the harness rule to locate the when rule. The when rule is executed only once, when the harness rule is first presented. Don't confuse Expanded When with Visible When. When collapsed but visible, the clickable header appears. When not visible, nothing appears. |
3. Complete the Container panel — General tab
Complete the General tab.
Field |
Description |
Using Page |
Optional. Identify the name of a clipboard page on which
the properties referenced in this expansion area are to be
found. By convention, the page containing the work object is
named If you leave this field blank, Process Commander assumes that properties referenced in this expansion area are found on the primary page of the activity that displays the harness form. If, at runtime, no page with this name is found, all HTML output from this row is suppressed — both the top-level header and the included sections. |
Layout |
Choose the format to be used to present this header:
|
Image |
Optional. If you choose For example, enter image/3dball.gif in this field for the 3dball image. This bar contains the 3dball.gif image: |
Defer Load? |
If you choose Select this box to instruct Process Commander to transmit the details for this header to the browser on the user workstation only when a user clicks a plus sign or tab to view the expanded details of this header. By default, the setting is selected. R-14332
04-01SP4 Deferred loading technique can speed up the
initial harness form display, by reducing the amount of HTML
text sent to and processed by the user's browser. Fields that
do not interest most users are not transmitted unless the
browser client sends an explicit request later.
(This checkbox is only meaningful when the
Layout is |
New Layout |
Select if you chose |
Read Only? |
Select to cause all parts of the horizontal header area and all parts of the section rules referenced in this container to appear in read-only mode (and with read-only styles) always, or based on a when condition rule, even when the form is in read-write mode. Complete the next field to modify the effect of this checkbox. PROJ-283 |
Read Only Condition |
This field appears only when you select the Read Only? checkbox. PROJ-283 Optional. Identify the When Name key part of a when condition rule that at runtime determines whether the content of this contain appears in read-only mode (with read-only styles) or in the mode of the enclosing layout. Leave blank to present the content in read-only mode always, regardless of the mode of the form. You can override this result with Read Only settings and conditions for specific elements inside the container. MARTT 2/28/07 verbal The system evaluates this condition once, when it renders the work object form. You can implement dynamic, client-side condition tests for cells within the layout inside the container, but not for the entire container. |
4. Complete the Container panel — Advanced tab
Field |
Description |
With Style |
Optional. Identify the name of a CSS style for the container. Click the pencil icon () to review the text file rule that contains the style. The SmartPrompt list shows styles in the CSS style sheet that begin with the word container. You are not limited to these styles. |
Expanded When |
Optional. If you choose Don't confuse Expanded When with Visible When. When collapsed but visible, the clickable header appears. When not visible, nothing appears. |
Retrieval Activity |
C-2077 Optional. If Defer Load? is selected, you can specify an activity to be run when the container expanded by a click the plus label (). This activity can compute property values and other aspects of the expanded container. |
Use Windows drag operations to stretch or adjust the width of the table and of columns in the table.
The table initially contains three columns and three rows. Usually,
the top row holds labels, the second row holds fields (property
values), and the final row contains the Add Row control (). When the section appears
at runtime, the second row is repeated for each existing Page
List
or Page Group
page.
Use these seven cell controls to add or delete columns:
Control |
Description |
Delete the selected row, container, layout, or repeating group. | |
Insert a new column before (to the left of) the selected column. | |
Insert a new column after (to the right of) the selected column. | |
Delete the selected column. | |
Merge the selected cells in a single row or column into one cell. | |
Unmerge — Undo the immediately previous merge. | |
Delete the contents of a single cell (not a row or column). |
To reorder rows or columns within a repeating layout, you can select and drag a single row or column using the dots above or to the left of the table; these act as handles.
DISPUTED To duplicate rows or columns within a repeating layout:
Ctrl
key.Ctrl
key to drop a duplicate row or
column.