You are viewing the documentation for Blueriq 14. Documentation for other versions is available in our documentation directory.
For presenting lists at runtime, Blueriq provides different containers in studio:
In spite of slightly different parameters in studio, they have the same layout at runtime.
At runtime a list is rendered as shown in the following screenshot:
The list has several features:
- Paging
- Sorting
- Filtering
- Persistency Settings
Paging
Paging is used to break up a list in multiple pages. The page size can be configured in Studio. In the example above the page size is set to 5. The buttons below the list can be used to navigate to other pages.
Sorting
Clicking on a column will sort the list descending or ascending based on the values in that column. Depending on the data type (within the column) the sorting is done alphabetically, on number or on date. To remove the sorting, the column header should be clicked a few times, until the arrow disappears. The states are: none - ascending - descending - none.
A second column can be clicked for sorting within the sorted results. If a sorted column has multiple rows with the same value, then the second column will sort within those values. The most left column is always the primary sorting parameter.
Paging does not influence the sorting result, all values in the list are sorted.
Filtering
Boolean Filtering a boolean value can be done by selecting whether to show rows of the list with value | |
Value list Filtering a column which is bound by a value list resembles the functionality that is available in many table-oriented applications, such as Microsoft Excel. Unknown values can be included and excluded from the filter by using the "Show Unknown" checkbox, which is by default selected. This means that by default, all rows of the list where the value is unknown, are also shown. | |
String To filter a string column of a list, you simply type (part of) the string that you are looking for. By default, unknown values are also shown. To disable this, deselect the checkbox labeled "Show Unknown". | |
Number Filtering a number (integer, numeric, percentage or currency) provides three options. By default, the "Show Unknown" checkbox is selected. This means that by default, all rows of the list where the value is unknown, are shown. | |
Date(time) Date an datetime filtering strongly resembles number filtering. Filtering a date also provides three options. By default, the "Show Unknown" checkbox is selected. This means that by default, all rows of the list where the value is unknown, are shown. Datetime filtering works the same as date filtering, with the addition of a timestamp HH:mm. |
If the presentation style simple_filtering is added on any of these containers (AQ_WorkList, AQ_CaseList of AQ_Aggregate_List), at runtime the Show All and Show Unknown checkboxes will disapper.
Persistency Settings
The list preferences, such as paging, sorting and search tags set by the user, are persisted during a browser session. If a user starts a task from a task list and returns after finishing the task, the list preferences are preserved.