SortingTable

Use to create a table whose contents can be sorted by column header.Child components determine the content of this table. Create one child component per column (defined by the columns property). Columns are typically contained within a FieldLoop.

This component respects the align, valign, and width properties of the children components when rendering the table cells.

Properties include:

• emptyMessage– Specifies the String or message key to display in the table when the table has no rows. If you omit this property, Waveset displays a generic message.

• pageButtonAlign– Determines position of buttons relative to page content. Valid values include left, right, bottom, and center. The default value is right.

• sortEnable– Enables column sorting when set to true. (Boolean)

• sortURL– Identifies the URL that Waveset posts to when column sorting is selected. If column sorting is not set, Waveset uses the _postURL of the HtmlPage. (String)

• sortURLParams– Specifies the parameters that get passed along with the sortURL. (String)

• sortColumn– Specifies the number of the column that we are currently sorting by. The default is to set this value to the first column. (Integer)

• sortOrder– Specifies the sort order. Values includes asc (for ascending) or desc (for descending). Default value is asc. (String)

• linkEnable– Indicates if this table is to be generated with the first column as links. (Boolean)

• linkURL– Specifies the URL that Waveset links to when generating links. If not specified, defaults to the post URL of the containing HtmlPage. (String)

• linkURLArguments– Indicates the arguments to include in the link URL.

• linkColumn– Specifies the column number that will be used for the generated links as specified by the linkURL attribute. (Integer)

• linkParameter– Specifies the name of the post data parameter that will have the value of the link row id. The default value is id.

• selectEnable– Indicates whether a column of checkboxes is displayed along a MultiSelect table’s left margin. When set to true, Waveset displays a column of checkboxes. (Boolean)

• columns– Lists table column headers. (List of strings)

• pageSize– Specifies that the table should display at most _pageSize entries simultaneously. If more than _pageSize entries exist, then interface elements allow paging through the results. If _pageSize is less than 1 (the default setting), then all entries are displayed at once. (Integer)

• useSavedPage– If set to true and if the value of pageSize exceeds 0, then the sorting table saves the current sorting table page on the HTTP session in the <fieldName>_currentPage attribute. The _useSavedPage property indicates whether the current page should be retrieved from the HTTP session and displayed. By making the value of this property the result of an XPRESS expression, the form or view can control when the current page is recalled after when returning back to the JSP containing the SortingTable component. (Boolean)

• If you use multiple sorting tables in a form, you must enable the useSavedPage property for each table. Each field in the form must have a unique name.

For example, if the SortingTable component displays the results of a query containing editable items, to ensure that Waveset displays the results page that contains the edited item after the user has edited an item in the result table, enter a value that exceeds 0.