A UWL View describes the way that workitems are presented in the worklist. By customizing a UWL View, you can change column order, sort order, filter conditions, and many more visualization properties.
The attribute supportedItemTypes defines which item types are relevant to the View.
In addition, a view can contain filters.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 view is assigned to an ItemType, it will be automatically added to the sub view selection dropdown once the user receives items of that type.
It is also possible to have a default view per 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 |
Description |
---|---|
name |
Specifies the name of the view to be referenced from the navigation nodes. Use 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
|
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:
|
displayOnlyDefinedAttributes |
Obsolete, do not use.. |
actionPosition |
Flag to indicate where the view actions should be displayed in the view:
|
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 |
Display name of the view to display in the table view header, or within the sub view dropdown. Alternatively, the descriptions can be added in multiple languages within the child tag descriptions . |
queryRange | Determines the time range to retrieve workitems. Items, older than the range specified, will not be retrieved. Allowed values are: LastWeek, LastMonth, Last_3_Months, LastYear. |
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"> ... <AllowedFilters> <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>