With Business Process Choreographer you can separate the logic of your business processes and human tasks from the staff resolution. Staff queries are resolved using a plug-in that is specific to the directory service. Some examples of using the staff service are described here:
For detailed information on the staff resolution plug-ins, refer to the Process Choreographer: Staff Resolution Architecture, the Process Choreographer: Programming Model for Staff Resolution, and the Process Choreographer: Staff Resolution Parameter Reference White papers in WebSphere Business Process Choreographer
You can use WebSphere Integration Developer to define staff queries for the staff support service. Staff queries are templates that define how to retrieve the list of users authorized for a certain work item. You can use the abstract query templates (staff verbs) when you model business processes and human tasks. These staff verbs are transformed during deployment into a set of queries that can be run on a staff repository.
Before the staff query verbs in the process editor and the parameterized verbs in the process models can be run as queries on a specific staff repository, they must be translated into executable queries using an XSL transformation. The result of a transformation (mapping) can be run by staff resolution plug-ins that provide access to specific directories, such as Lightweight Directory Access Protocol (LDAP) or the user registry. At run time, the plug-in runs the query by invoking the staff repository APIs and by creating the list of authorized user IDs for the corresponding work item.
During process or task deployment, the staff support service is invoked to deploy the staff query. The staff service retrieves the staff plug-in provider configuration with the corresponding Java Naming and Directory Interface (JNDI) name. The JNDI name is set in WebSphere Integration Developer, the default is the user registry. The staff support service then converts the parameterized staff query verb into a query run by a specific staff resolution plug-in defined in the configuration for the Extensible Stylesheet Language transformation (XSLT) verb mapping file and the staff resolution plug-in. All of the staff query verbs belonging to a process template must use the same provider configuration.
<verb> <id>Manager of Employee by user ID</id> <name>Manager of Employee by user ID</name> <parameter id="EmployeeUserID"> %wf:process.starter% </parameter> </verb>
The staff support service accepts queries in an abstract form that is independent of the directory infrastructure used. Both the process editor and the task editor have a set of predefined staff query verbs that can be used when you model processes and tasks. These verbs are contained in the VerbSet.xml file. This file is installed with WebSphere Integration Developer.
The individual staff resolution plug-ins and the XSLT mapping files do not support all of the verbs. The Manager of Employee verb, for example, is not available if you use the user registry or the system plug-in. You can modify the set of staff query verbs. Make your changes to a copy of the file. Ensure that the copied file has a different file name.
The following predefined set of verbs is available. For information on the parameters that you can use with each of the verbs, see Predefined staff verbs and their parameters.
User [username='%wf:process.starter%']This verb is useful for testing processes. This verb is supported by the system, user registry, and LDAP plug-ins. You might need to customize the default mapping XSLT file to match the LDAP schema of your organization.
Use the e-mail verb set in WebSphere Integration Developer is used for e-mail notifications for task escalations. These e-mail verbs are transformed during modeling and deployment into a set of queries that can be run on a staff repository. E-mail verbs are defined for the most common staff verbs supported by the LDAP plug-in. The following e-mail verbs are available:
For the other LDAP staff verbs, the user identifiers retrieved by the staff verbs are used as input to the Email Address for Users by User ID verb.
Before the e-mail verbs can be run as queries on a specific staff repository, they must be translated into executable queries using an XSL transformation. The result of a transformation (mapping) can be run by the LDAP staff resolution plug-in. At run time, the query returns a set of e-mail addresses, for example, user1@mycomp.com, user2@mycomp.com, and so on.
<sur:staffQueries> <staff:userID name="%wf:process.starter%"> <staff:userID name="%wf:process.administrators%"> </sur:staffQueries>
<sur:staffQueries> <staff:everybody> </sur:staffQueries>
<sur:staffQueries> <staff:nobody> </sur:staffQueries>
The following XML snippet explicitly retrieves the WebSphere user ID smith:
<staff:staffQueries> <staff:userID name="smith"> </staff:staffQueries>
Using this plug-in, staff queries can refer to users and groups that are known to the WebSphere Process Server user registry. This plug-in does not require any configuration parameters, comes preinstalled and is ready for use.
The following XML snippet retrieves the user IDs of all the members of the Administrators group:
<sur:staffQueries> <sur:usersOfGroup groupName="Administrators"/> </sur:staffQueries>
This XML snippet is an example of the transformation output.
If you want to use the LDAP plug-in, you probably need to create a customized version of the LDAP XSL transformation to match the LDAP schema of your organization. The standard XSLT provided for LDAP is located:
Make your changes to a copy that has a different file name. When you have made your changes:
<sldap:staffQueries> <sldap:search baseDN="ou=mydivision, o=mycompany, c=us" filter="cn=*" searchScope="onelevelScope" recursive="no"> <sldap:attribute name="uid" objectclass="person" usage="simple"/> </sldap:search> </sldap:staffQueries>
Last updated: Mon Mar 27 18:01:21 2006
(c) Copyright IBM Corporation 2005.
This information center is powered by Eclipse technology (http://www.eclipse.org)