+

Search Tips   |   Advanced Search


Understand the default filter set for tasks

A task filter set is a named set of individual task filters that are available for selection in the Show list of the Task List portlet. After install the product, you initially see only the default task filter set, which contains the filters All Tasks, Claimed Tasks, and Tasks Not Claimed.

Task List filter sets, and the filters contained in a filter set, are defined as custom properties of the Portal Configuration Service, WP Config Service, resource environment provider. The values of these configuration properties are expressed as data retrieval queries on the attributes of business process objects (process templates, task templates, processes, and tasks).

The example shows how these queries are expressed using the where clause.

Initially, the configuration mode of the Task List portlet lists only Default Filter Set for selection. This filter set and the task filters contained in the set are defined in the IBM WAS resource environment provider for the Portal Configuration Service: From the Administrative Console, click Resources > Resource Environment > Resource Environment Providers > WP Config Service > Custom Properties and find the properties of the default task filter set, which have names qualified as processintegration.filterset.default. 

processintegration.filterset.default.allTasks=((WORK_ITEM.REASON=WORK_ITEM.REASON.REASON_POTENTIAL_OWNER


AND TASK.STATE=TASK.STATE.STATE_READY)OR(WORK_ITEM.REASON=WORK_ITEM.REASON.REASON_OWNER AND TASK.STATE=TASK.STATE.STATE_CLAIMED)) processintegration.filterset.default.claimedTasks=WORK_ITEM.REASON=WORK_ITEM.REASON.REASON_OWNER AND TASK.STATE=TASK.STATE.STATE_CLAIMED processintegration.filterset.default.unclaimedTasks=WORK_ITEM.REASON=WORK_ITEM.REASON.REASON_POTENTIAL_OWNER AND TASK.STATE=TASK.STATE.STATE_READY processintegration.filterset.default.order=allTasks,unclaimedTasks,claimedTasks

Each configuration property qualified as processintegration.filterset. indicates that the property defines a task filter contained in the named task filter set.

For example, the property processintegration.filterset.default.allTasks defines the task filter criteria for the task filter with the identifier allTasks contained in the task filter set default. The value for each property defines the task filter criteria in a data retrieval query using the where clause. Each query is evaluated and processed to return the tasks defined by the task filter when the user works with the Task List.

For more information about queries using the where clause, refer to the WebSphere Process Server Information Center topics that explain developing EJB client applications, specifically queries on business process and task-related objects.


Sorting

The configuration property processintegration.filterset.filterset_name.order is reserved for task filter sets. Do not use this property to define task filters.

For example, the property processintegration.filterset.default.order specifies the order in which the task filters of the default task filter set appear in the Show selection list of the Task List portlet: namely, allTasks, unclaimedTasks, claimedTasks.

If this property is not explicitly specified for a task filter set, the corresponding filters are sorted according to their identifiers: for example, allTasks, claimedTasks, unclaimedTasks.


Multilingual support

In general, the Task List portlet does not display the property identifiers of the task filter sets and the task filters but their corresponding titles, translated in the language specified in the user's browser. The titles for the default task filter set and the corresponding task filters are defined in an internal resource bundle within the configuration property processintegration.filtersetresourcebundle and cannot be changed:

If you create additional filters, you can specify titles for custom task filter set and the custom task filters, including titles for different locales, by referencing the corresponding Java™ resource bundle specified in the property processintegration.filtersetresourcebundle of the Portal Configuration Service.


Parent topic:

Creating custom filters for tasks


Next topic:

Creating new filters for tasks