Format tab on the List View form

Complete this optional tab to identify HTML styles for the fields on the display, headers and footers, how user interface click events are processed, and other aspects of the presentation.

View Style

Style Name - Identify a cascading style sheet (CSS) file that is contained in a text file rule. Enter the File Type key part, a slash character, and the File Name key part, for example css/ourreportstyles.

In most situations, leave this field blank, using it only for unusual reports. As a best practice, define report styles for an entire application using a Skin rule. This approach assures uniform presentation of list view output. If you leave this blank, default styles apply, but vary depending on the Type field of the user's portal rule and any skin rule that the portal rule references. For additional information on styles, see:

Styles referenced here affect only the presentation of this individual list view report. You can override the styles for all list view and summary view reports at the portal level, through a skin rule that references report styles you have defined in your application.

Row Format

Use this optional array to define styles applied to specific rows of this display.

For each row, the system evaluates all the conditions (in the order you enter them) and applies the style in the first row that evaluates to true. If none is true, no style is applied.

Field Description
Evaluate Expression Optional. Enter the name of a when condition rule or a boolean Java expression.

The when condition rule can evaluate property values in the row. For example, you can apply a special style to those rows of a list view report that contain your own Operator ID in a certain column.

Apply this style when true Optional. Identify a style for a table row if the expression is true. This becomes the value of the CLASS=" " attribute for the <TR> table row element. Choose a style defined in the style sheet identified in the Style Name field.

Alternate Row Styles

Optionally, you can identify styles to be applied to alternate rows of report output.

Field Description
Odd Row Optional. Identify the name of a style for the first, third, and other odd-numbered rows of the output.
Even Row Optional. Identify the name of a style for the second, fourth, and other even-numbered rows of the output.

Events Handling

Complete these optional fields to allow users to select a row and operate on in using mouse clicks. The system response can be an activity, started on the Pega Platform server, or a JavaScript function, executing in a client browser session.

If you implement this capability, make sure the Applies To class of the list view report is an external class, make sure the Key of a Row field (on the Content tab) correctly identifies a property in the external class that uniquely identifies a row.

When the parameter param.glimpseMode is set to the literal value " scripts ", the system responds to click events by calling the script identified in the call script function field. Otherwise, it responds by calling the activity.

Field Description
Single click event
  • call Activity - Optional. Identify an activity to run upon single click after a row is selected.
  • call script function - Optional. Identify a script function to run upon single click after a row is selected.
Double-click event
  • call Activity - Optional. Identify an activity to run upon double-click after a row is selected. This capability is not available when the Embedded option (on the Display Fields tab) is selected.
  • call script function - Optional. Identify a script to run upon double-click after a row is selected.
call script function Optional. This field appears only when the Enable Selection of Rows option is selected on the Selectable tab. Identify a callback JavaScript function with the signature:
(nRow, strClass, strInsName, strInsKey, strCategoryProp, strCategoryValue, lvRowItem, options)

where:

  • nRow — index of the row, starting 1. If the Select All open is selected then this is set to -1.
  • strClasspxObjClass value of the record.
  • strInsName — value of pxInsName
  • strInsKey — value of pzInsKey
  • strCategoryProp — category property (if categorization is enabled)
  • strCategoryValue — category value (if categorization is enabled)
  • lvRowItem — structure describing a single row, with these fields:

    getRowIndex

    GetPageIndex

    getPageCount

    getKey

  • Options.selected is true or false.

Your application can call the pega.ui.LVUtils.getSelectedRows() PublicAPI function to return an array of list view rows that the user selected.

Custom tool tip message Optional. Enter Tooltip text to appear for a row.
Return properties to clients? Reserved. Do not use.
Target Frame Optional. Identify the HTML frame in the display for the output of the event. The default frame is DETAILS.
On load event call script function Optional. Identify a script to run when this view is first displayed. This capability is not available when the Embedded option (on the Display Fields tab) is selected.
Fragment for script functions Optional. Identify an HTML Fragment rule that contains the functions identified above, or that references a static file containing the script functions.

The standard HTML fragment rule ListViewSelectorScript contains JavaScript functions that you can use here. To review documentation on these functions, click the Show JS Doc button to access this display.

SmartInfo Settings (for hover)

Optionally, you can define a source for HTML code to be rendered in a pop-up window or displayed as an embedded <DIV> when users hold the mouse pointer over a row (hover) or when they click a row expand arrow ( Row Expand Arrow ) at the beginning of the row. For example, this capability can allow users to review details about a work item on a worklist, without requiring the users to open the work item.

SmartInfo pop-ups are designed for read-only presentation. Do not attempt to include input fields or other controls.

Field Description
Header Enter text to appear in the header of the pop-up window. Alternatively, if this list view report is to be localized, identify a field value rule to contain the header text.
Content Identify the name of an activity that computes the HTML text to be rendered. This activity must meet the following conditions:
  • The Applies To key part of the activity matches the Applies To key part of the list view rule, or is a parent class of this list rule.
  • On the Security tab, the May Start? check box is selected.
  • The activity accepts a parameter named keyHandle.
  • The activity assembles and returns text or an HTML stream that meets certain restrictions listed here.

For an example, review the standard activity Assign-.getWorkItemSmartInfo, which can be used to supplement worklist displays. It assembles an HTML stream by evaluating a section named Work-.WorkItemSmartInfo. (Although the standard activity is a Final rule, you can copy and override the section, to include fields in your application as appropriate, or copy the standard activity with a new name.

The activity can return HTML code that is a partial document that contains:

  • No <HTML> or </HTML> elements
  • No input fields
  • No <TEXTAREA > elements
  • No JavaScript code or calls

Additionally, when rendered by the client browser as a pop-up, the window must be modest in size.

To aid users, include in the Description field a notification that this capability is available. For example:

Hold mouse pointer over any row to see details...

For an example activity that meets these criteria, see the Pega Community article How to enable a SmartInfo details display on report rows.

Embedded? Select to have the SmartInfo content embedded in the report to display when you click the expand arrow at the beginning of the row.
Field Optional. Select one field — from those appearing in the Display fields tab — to activate the SmartInfo display — to cause the SmartInfo display to appear only when the mouse pointer is held over a value in that field.

If blank, the SmartInfo display is activated when the mouse pointer is held over any field in the row and does not move for at least 700 milliseconds. The workstation sends a request to the server to run the Content activity specified in the previous field, and the resulting HTML output appears in a pop-up window.

This field appears only when the Embedded? option is not selected.

Right-click SmartInfo Settings

Optionally, you can define a source for HTML code to be rendered in a pop-up window or displayed as an embedded <DIV> when users right-click a row. For example, this capability can allow users to review details about a work item on a worklist, without requiring the users to open the work item.

This feature works similarly to the SmartInfo Settings feature, but is started at run time by a right-click rather than by hovering the mouse pointer. Your application can provide either or both SmartInfo capabilities.

SmartInfo pop-ups are designed for read-only presentation. Do not attempt to include input fields or other controls.

Field Description
Header Optional. Enter text to appear in the header of the pop-up window. Alternatively, if this list view report is to be localized, identify a field value rule to contain the header text.
Content Optional. Identify the name of an activity that computes the HTML text to be rendered. This field functions similarly to the Content field in SmartInfo Settings .
Field Optional. Select one field — from those appearing in the Display fields tab — to activate the SmartInfo display — to cause the SmartInfo display to appear only from a right-click operation over a value in that field. If blank, the SmartInfo display is activated from a right-click in any field in the row.

The workstation sends a request to the server to run the Content activity specified in the previous field, and the resulting HTML output appears in a pop-up window.

Header and Footer

You can add a header and footer to reports. For an example, see the Pega Community article How to add a header or footer to a report.

Field Description
Header Optional. Select a section that specifies the content of the report display header.
Footer Optional. Select a section that specifies the content of the report display footer.

Events Handling

Complete these optional fields to allow users to select a row and operate on in using mouse clicks. The system response can be an activity, started on the Pega Platform server, or a JavaScript function, executing in a client browser session.

If you implement this capability, make sure the Applies To class of the list view report is an external class, make sure the Key of a Row field (on the Content tab) correctly identifies a property in the external class that uniquely identifies a row.

When the parameter param.glimpseMode is set to the literal value " scripts ", the system responds to click events by calling the script identified in the call script function field. Otherwise, it responds by calling the activity.

Field Description
Single click event - call Activity Optional. Identify an activity to run upon single click after a row is selected.
call script function Optional. Identify a script function to run upon single click after a row is selected.
Double-click event - call Activity Optional. Identify an activity to run upon double-click after a row is selected. This capability is not available when the Embedded option (on the Display Fields tab) is selected.
call script Function Optional. Identify a script to run upon double-click after a row is selected.
call script function Optional. This field appears only when the Enable Selection of Rows option is selected on the Selectable tab. Identify a callback JavaScript function with the signature:
(nRow, strClass, strInsName, strInsKey, strCategoryProp, strCategoryValue, lvRowItem, options)

where:

  • nRow — index of the row, starting 1. If the Select All open is selected then this is set to -1.
  • strClasspxObjClass value of the record.
  • strInsName — value of pxInsName
  • strInsKey — value of pzInsKey
  • strCategoryProp — category property (if categorization is enabled)
  • strCategoryValue — category value (if categorization is enabled)
  • lvRowItem — structure describing a single row, with these fields:

    getRowIndex

    getPageIndex

    getPageCount

    getKey

  • Options.selected is true or false.

Your application can call the pega.ui.LVUtils.getSelectedRows() PublicAPI function to return an array of list view rows that the user selected.

Custom tool tip message Optional. Enter Tooltip text to appear for a row.
Return properties to clients? Reserved. Do not use.
Target Frame Optional. Identify the HTML frame in the display for the output of the event. The default frame is DETAILS.
On load event call script function Optional. Identify a script to run when this view is first displayed. This capability is not available when the Embedded option (on the Display Fields tab) is selected.
Fragment for script functions Optional. Identify an HTML Fragment rule that contains the functions identified above, or that references a static file containing the script functions.

The standard HTML fragment rule ListViewSelectorScript contains JavaScript functions that you can use here. To review documentation on these functions, click the Show JS Doc button to access this display. Then click the List View Script link in the Packages area.