Column Sort | ||
| ||
Users can sort the columns by clicking on the header text link or the
toolbar button. opens a dialog box allowing the user to
choose up to 3 columns for sorting. Only columns defined with the Sortable=true
setting can be selected. In addition, columns with the sortType=other
setting defined cannot be used for multiple column sorting. See Designing Your Own Page Views
for details.
When the page displays the first time, the initial sorting is done based on the URL parameter sortColumnName and sortDirection. If you do not pass this URL parameter, the first column (the freeze pane column) is used for sorting the structure. You can pass up to 3 column names with the sortColumnName parameter and 3 directions with the sortDirection parameter. In addition, you can pass sortColumnName=none so that no initial sorting is done.
When the user opens the Sort by dialog box (by clicking in the page toolbar), the 1st, 2nd, and 3rd column name
fields are populated based on the values passed to the sortColumnName
and sortDirection URL parameters. If less than 3 values
are passed, only the values passed show populated in the dialog box and
the remaining fields are blank.
If the user creates a custom table based on the system table for the structure browser page, the sorting options selected by the user determine the default values for the Sort by dialog box.
If the sortColumnName is used for sorting, the subsequent node expansion uses the specific sort column name to sort the child objects for that page.
If the user clicks on one of the other column headers to sort, the system updates the page level sortColumnName setting to the new column. Subsequent expands will use this new sortColumnName to sort the objects. If the user clicks on any column header for sorting while the structure is already expanded to multiple levels, the sorting is done within the individual levels and redisplays the sorted structure with all the nodes as expanded before sorting.
For pages that include columns with the type program or programHTMLOutput with complex logic, the sort process may take a while. You can set the Sortable setting on the column to false if needed.