Back Forward List View form
Completing the Display Fields tab

  1. About 
  2. New 
  3. Display Fields 
  4. Content 
  5. Selectable 
  6. Organize 
  1. Format 
  2. Parameters 
  3. Pages & Classes 
  4. Join 
  5. HTML 
  6. History 
  7. More... 

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 runtime by interacting with the list view display are temporary and do not alter the list view rule.

Category

Field

Description

Category

SmartPromptOptional. To assign a category to this report, select from the SmartPrompt list.

This list shows field value rules with Rule-Obj-Report- as the first key part and pyCategory as the second key part. You can create additional field value rules in your application to define more categories.

Embedded?

Select if the output display of this list view is to appear within the runtime presentation of another rule, such as a section or flow action. See Harness and Section forms — Adding a List View display

The Customize View and Customize Criteria capabilities are not available for embedded list views.

Height

Optional. If you selected Embedded List View, enter a vertical size of the initial display, and select px or % to indicate the units.

Header Settings

Field

Description

Hide Column Header

Optional. Select to suppress column headers in the report display.

Enable adding/removing columns?

Optional. Select to allow the user to add or remove columns in the list view display. See Interacting with List view displays.

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 runtime, the header remains visible and fixed. This field is not visible when you select Hide Column Header.

Enable filtering?

Optional. Select to allow the user to filter the data in the list view display. See Interacting with List view displays.

Enable Sorting?

Optional. Select to allow the user to sort the list view display by any column at runtime, by clicking the column header. This field is not visible 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 good performance, specify only Single Value properties that correspond to optimized (exposed) columns in a database table here, rather than properties in the Storage Stream (BLOB) column. See PDN 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 is to be frequently executed in a production setting, consider optimizing all listed properties to improve performance.

Field

Description

Field

SmartPromptEnter 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 superclass of that class.

Field Label

Enter heading text for this column.

NoteIf your application is to support 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. Clickmagnifying glass to review or create the field value rule supporting localization. The pencil icon appears only after you select the Localize? check box on the HTML tab. See About the Localization wizard and Rules Inspector tool — Localizing forms and reports with the Field Value Inspector.

Field Width

Optional. To control the display width of this column, enter a number and a measurement here. This becomes the WIDTH=" " value in the final HTML.

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 appears at runtime, the browser determines the resulting display appearance.

Cell Style

SmartPromptOptional. You can identify a CSS style, one present on the style sheet identified on the Format tab, for this column. At runtime, this value becomes the CLASS = "zzz" value in the <TD> element for the cells in this column.

For example, enter tdRightStyle to right-justify a value.

Format

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

SmartPromptOptional. If this display can be exported to Excel, select a format to use for the export. Ordinarily, select one of the following, as appropriate to the type of the value:

Export_Integer Export_Date
Export_Decimal Export_Time
Export_DateTime  

These five controls accept parameters. Click to the right of the Export Control value to enter parameters for the control.

Optional

SmartPromptIf checked, the field does not appear in the initial list view display, but is available for users to add or remove at runtime by clicking the Add/remove link in the filter button dialog.

Up About List View rules