Display Fields tab on the List View form
Information on this tab identifies the content of data rows and aspects of the report layout. Fields on the report display
Single Value
properties, identified by a property reference.
Changes made at run time by interacting with the list view display are temporary and do not alter the list view rule.
Category
| Field | Description |
|---|---|
| Category |
Optional. To assign a category to this report, select from the SmartPrompt list.
This list shows field value rules with
|
| Embedded? |
Select if the output display of this list view is to appear within the run time presentation of another rule, such as a section or flow action.
The Customize View and Customize Criteria capabilities are not available for embedded list views. |
| Height |
Optional. If you selected Embedded List View , specify a vertical size of the initial display, and select px or % to indicate the units. |
Header Settings
| Field | Description |
|---|---|
| Enable adding/removing columns | Optional. Select to allow the user to add or remove columns in the list view display. |
| Enable filtering | Optional. Select to allow the user to filter the data in the list view display. |
| Hide column header | Optional. Select to suppress column headers in the report display. |
| Fixed header? | Optional. Select to indicate that the header area is to be excluded from the scrollable area. When a user scrolls the rows at run time, the header remains visible and fixed. This field is not available when you select Hide Column Header . |
| Enable sorting? | Optional. Select to allow the user to sort the list view display by any column at run time, by clicking the column header. This field is not available when you select Hide Column Header . |
Show These Fields
Identify the properties to appear in the report and the presentation of each. The order of rows in the Fields array determines the order of columns, left to right, in the resulting HTML table.
As a best practice for optimal performance, specify only
Single Value
properties that correspond to optimized (exposed) columns in a database table, rather than
properties in the Storage Stream (BLOB) column. See the
Pega Community
article
How
to detect and remedy the performance impact of Obj-List methods and list view
reports.
If this list view rule presents properties that are not optimized and will run frequently in a production setting, consider optimizing all listed properties to improve performance.
| Field | Description | ||||||
|---|---|---|---|---|---|---|---|
| Field | Specify a property reference for a single, text value source for the data in a column of an HTML table. In most cases, enter a period and select a property in the class corresponding to the Applies To key part, or a super class of that class. | ||||||
| Field label |
Specify the header text for this column.
If your application supports users in multiple locales, choose a noun or noun phrase for the caption of 64 characters or less, and select the
Localize?
check box on the
HTML
tab. When practical, choose a caption already included in a language pack, to simplify localization. Click the
Open
icon
|
||||||
| Field width |
Optional. To control the display width of this column, specify a number and a measurement. This becomes the
WIDTH=" "
value in the HTML output.
Type % as the measurement for percentages of overall table width, or another HTML measurement term such as px for pixels or pt for points. For example, enter 25% for a column that is to be one quarter of the width of the table. If you leave this field blank or specify widths that cannot be achieved when the table displays at run time, the browser determines the display appearance. |
||||||
| Cell style |
Optional. You can identify a CSS style, from the style sheet identified on the
Format
tab, for this column. At run time, this value becomes the
CLASS = "zzz"
value in the
<TD>
element for the cells in this column.
For example, enter
|
||||||
| Format |
Optional. Select a format for the presentation of the field on the list view display. Leave blank to use the format associated with the property.
Many controls accept parameters. Click the icon to the right of the Control value to enter parameters for the control. |
||||||
| Export format |
Optional. If this display can be exported to Excel, select a format to use for the export. In most cases, select one of the following formats, as appropriate to the type of the value:
These five controls accept parameters. Click the gear icon to the right of the Export Control value to enter parameters for the control. |
||||||
| Optional | If checked, the field does not appear in the initial list view display, but is available for users to add or remove at run time by clicking the Add/remove link in the filter button dialog. |
to review or create the field value rule that supports localization. The pencil icon appears only after you select the
Localize?
check box on the
HTML
tab. See