Queries on business-process and task-related objects

Use the query interface of the service API to retrieve stored information about business processes and tasks.

Predefined database views are provided for you to query the object properties. For process templates, the query function has the following syntax: process templates.
ProcessTemplateData[] queryProcessTemplates 
                       (java.lang.String whereClause,
                        java.lang.String orderByClause,
                        java.lang.Integer threshold,
                        java.util.TimeZone timezone);
For task templates, the query function has the following syntax:
TaskTemplate[] queryTaskTemplates 
                (java.lang.String whereClause,
                 java.lang.String orderByClause,
                 java.lang.Integer threshold,
                 java.util.TimeZone timezone);
For the other business-process and task-related objects, the query function has the following syntax:
QueryResultSet query (java.lang.String selectClause,
                      java.lang.String whereClause,
                      java.lang.String orderByClause,
                      java.lang.Integer skipTuples
                      java.lang.Integer threshold,
                      java.util.TimeZone timezone);

The query is made up of:

For example, a list of work items IDs accessible to the caller of the function is retrieved by:
QueryResultSet result = process.query("WORK_ITEM.WIID",
                                       null, null, null, null, null);

The query function returns objects according to the caller's authorization. The query result set contains the properties of only those objects that the caller is authorized to see.

The query interface also contains a queryAll method. You can use this method to retrieve all of the relevant data about an object, for example, for monitoring purposes. The caller of the queryAll method must have one of the following Java 2 Platform, Enterprise Edition (J2EE) roles: BPESystemAdministrator, BPESystemMonitor, TaskSystemAdministrator, or TaskSystemMonitor. Authorization checking using the corresponding work item of the object is not applied.

For more information on the Business Process Choreographer APIs, see the Javadoc in the com.ibm.bpe.api package for process-related methods and in the com.ibm.task.api package for task-related methods.


Terms of use | | Broken links

Last updated: Mon Mar 27 18:04:05 2006

(c) Copyright IBM Corporation 2005.
This information center is powered by Eclipse technology (http://www.eclipse.org)