View
A view describes how the items of a specific type are presented in the worklist: visible attributes and column order, sort order, filter conditions, and many more visualization properties.
The attribute supportedItemTypes defines which item types are included in the list, and the item types defines which connections are initiated to retrieve the items when the user selects the list view.
In addition, a view can contain filters, active by default or offered to the end user for selection. See child element AllowedFilters.
Column details are defined in the child element DisplayAttributes.
Views can contain custom actions which can be applied to the selected items. See child element Actions.
When a specific list view is created for an item type, it will be automatically added to the sub view selection dropdown once the user receives items of that type. It can be also navigated directly from the item using the View all <view name> function.
It is also possible have a default view to a UWL iView instance using the iView property sap_uwl_viewname.
The user can personalize many characteristics of the view definition in the personalization page.
Attributes
Attributes |
Description |
name |
Specifies the name of the view to be referenced from the navigation nodes, or with the iView property sap_uwl_viewname to set this view for a custom UWL iView instance. |
width |
Specify the width of the table. See HTML table tag. Usually a percentage of the available space. Example: width="98%". |
supportedItemTypes |
Specifies the item types that can be displayed in this view in a comma separated list. Example: supportedItemTypes="uwl.task.approval, uwl.task.coll.approval". |
columnOrder |
This specifies the order of the display attributes for the columns of the view in a comma separated list. Example: columnOrder="subject, dueDate, priority, creatorId, createdDate, attachmentCount". Other attributes will not be visible in the list view, but the user can personalize the view and add any display attributes into their view. |
sortby |
Specifies the display attributes to sort by, up to a max of three attributes can be specified in a comma separated list. The direction of the sort can also be indicated by using a ":" after the attribute and then using descend or ascend. Example: sortby="priority:descend, dueDate:ascend, createdDate:descend" |
selectionMode |
Specifies the row selection mode. Allowed values are NONE, SINGLESELECT, MULTISELECT. |
tableDesign |
Specifies the table design. Allowed values are ALTERNATING, STANDARD (the default), TRANSPARENT. |
visibleRowCount |
The maximum number of rows to display in the view. More items are accessible through paging. |
defaultHeaderName |
Not used. |
headerVisible |
Obsolete. Specifies if the view header is displayed. There is no header with the standard Tab layout regardless of the setting of this flag. |
tableNavigationFooterVisible |
Specifies if the view page navigation is displayed or not (Yes or No). |
tableNavigationHeaderVisible |
Specifies if the search input box is displayed inside the header (yes or no). This is no longer used for page navigation. The page navigation cannot be added to the header. |
tableNavigationType |
Specifies the navigation style. Allowed values are ● STANDARD - Unified rendering table view navigation ● CUSTOMNAV - Content Management style (default) ● POWERNAV - Obsolete. Do not use. ● BRIEFNAV - Obsolete. Do not use. |
actionRef |
Obsolete. Do not use. Use child tag Actions instead. |
refresh |
Number of seconds to have the view return to the server to see if any items need updating. Example: refresh="300" |
dueDateSevere |
Due date will be displayed in red from within the specified number of milliseconds before the date. Default is 1 day. |
dueDateWarning |
Due date will be displayed in yellow from within the specified number of milliseconds before the date. Default is 3 days. |
emphasizedItems |
Bold the items which are: ● new (for example: tasks) ● unread (for example: notifications) ● none – no bolding |
displayOnlyDefinedAttributes |
Obsolete, do not use.. |
actionPosition |
Flag to indicate where the view actions should be displayed in the view: ● top - just below the table view header ● bottom - just above the footer ● both |
dynamicCreationAllowed |
No suppresses that the view is automatically added to the sub view selection dropdown once the user receives item of that type. The default is yes. |
referenceBundle |
Child Tags: Descriptions, DisplayAttributes, AllowedFilters, Actions
AllowedFilters
The filters for the view are specified as compound expressions (see below). In the UI, the filters are offered to the user in a filter dropdown.
The compound expression with the defaultViewFilter set is active in the view by default. If none of the filters is marked as default filter, the UWL UI adds a blank entry to the filter dropdown that allows to display all items in the view (means no filter is active).
Example for three filters (not used in the general UWL, but for a specific collaboration task list reusing the UWL iView):
<View ... dynamicCreatingAllowed="no"> ... <CompoundExpression referenceBundle="filter_display_all" > <Expression name="itemType" comparator="StartsWith" value="uwl" /> </CompoundExpression> <CompoundExpression referenceBundle="filter_completed" > <Expression name="itemType" comparator="Equals" value="uwl.completedtask.coll" /> </CompoundExpression> <CompoundExpression referenceBundle="filter_uncompleted" defaultViewFilter="yes"> <Expression name="itemType" comparator="NotEquals" value="uwl.completedtask.coll" /> </CompoundExpression> </AllowedFilters> </View> |