IBM® WebSphere Lombardi Edition V7.2 (hereafter called Lombardi) includes an internal security provider that you can use to create and maintain Lombardi users and groups. You can use the internal Lombardi security provider in conjunction with an external LDAP security provider, such as OpenLDAP that is registered with the Lombardi embedded application server. When you use the internal Lombardi security, users and groups from both providers are available for selection throughout Lombardi; for instance, while binding users to participant groups during process development.
This article describes the following steps to associate Lombardi attributes with users defined in an OpenLDAP server 2.4 and uses the association for a dynamic routing scenario.
- Define Lombardi attributes.
- Associate attributes to users defined in LDAP server.
- Associate users defined in LDAP server to groups defined in Lombardi.
- Use a dynamic routing scenario using these associations.
This article assumes that an OpenLDAP server is installed and configured with Lombardi.
Defining Lombardi attributes
This section describes the steps to define user attributes in Lombardi.
User attribute definitions
A user attribute definition is an attribute (parameter) that you can configure on user definitions in Lombardi. For example, if you need to route a process task to the manager of a user, you need know the manager of every user. Through the creation of a user attribute, a user can be associated to his or her manager. You can create a user attribute definition from within the Data category of the Library as shown in Figure 1.
Figure 1. Define the user attribute
When created, a dialog appears asking for a name for this attribute as depicted in Figure 2.
Figure 2. Define the attribute
The definition parameters for a user attribute looks as follows in Figure 3.
Figure 3. Attribute details (seeenlarged Figure 3)
For this use case, an attribute called "Reporting Manager" has been created.
Associating attributes to users defined in LDAP server
This section describes the steps to assign value to an attribute and associate the attribute to the user.
Bulk user attribute assignment
You can set up attributes associated with users in this area. Log into the Lombardi Process Admin Console. Click on the User Management option, and under that, Bulk User Attribute Assignment.
Under this option in the Select an Attribute section, all the attributes defined are listed. For user "user" (from the LDAP server), user "Jeni" (from the LDAP server) is associated as a Reporting Manager as shown in Figure 4.
Figure 4. User attribute assignment (seeenlarged Figure 4)
Associating users defined in LDAP server to groups defined in Lombardi
This section describes the configuration of groups in Lombardi.
Lombardi manages its own model of users and groups. User administration is performed through the Process Admin Console in the User Management section. Here, groups are defined out of users from the LDAP server and the internal security provider. These groups are later used as participant groups.
Group management is performed in the Process Admin Console under User Management > Group Management.
In Figure 5, a group called "TSO" has been defined with two users, "user" and "tso1". They are defined in OpenLDAP and the Lombardi internal repository, respectively.
Figure 5. Group management (seeenlarged Figure 5)
Similarly, another group called "TCGroup" has been defined with two users from OpenLDAP, as shown in Figure 6.
Figure 6. Group management (seeenlarged Figure 6)
A dynamic routing use case using these associations
Now you will define a Business Process Definition (BPD) and implement a routing scenario using the attribute definition ReportingManager. Figure 7 shows a snap shot of the process in question. There are two activities, Call Customer and TC approve. They are housed in the participant groups TSO (Telesales officer) and TC Group (Team Coordinator), respectively.
Figure 7. Business Process Definition (seeenlarged Figure 7)
Under the variable section of the Business Process Definition, the following variables are defined in a private scope as shown in Figure 8. Of interest is the complex variable TSODetails of type TSO, which contains variables, name, and reportingTo.
Figure 8. BPD variables
The activity Call Customer has been implemented as a human service as shown in Figure 9. Also, the logic as represented in Listing 1 to extract the user attribute and assign it to a variable is implemented here. This variable value is later used in the routing logic of the next activity in the Business Process Definition.
Figure 9. Implementation of Call Customer activity
Listing 1. Fetch the user attribute and assign it to a variable
tw.local.userName=tw.system.user_loginName; var user=tw.system.org.findUserByName(tw.local.userName); tw.local.TSOreportingTo= user.getAttributes().get("ReportingManager");
In Listing 1, the Lombardi system APIs are used to fetch the attribute for
the logged in user. The
returns the defined attribute value for the corresponding user. The user
object is obtained by invoking the method
findUserByName(), which takes username as an
Subsequently, for the activity TC approve, under the Property tab in the Routing section, Assign To is selected to List of Users and is bound to the reportingTo variable as shown in Figure 10. Thus, when the work item is routed from Call Customer to the next activity, the manager of the corresponding user who initiated the request gets the work item.
Figure 10. Routing definition (seeenlarged Figure 10)
In the above scenario, user "user", who belongs to the TSO participant group, takes action on the activity Call Customer. After completion, the task is routed to activity TC approve and assigned dynamically to user "Jeni", who belongs to the TC participant group. User "Jeni" is also the manager for user "user". The routing logic is configured in the routing section of the Properties tab.
This article showed how to use a user defined in an external repository, such as LDAP, with attributes defined in WebSphere Lombardi. The article also listed an API for retrieving attributes and showcased a dynamic routing scenario based on the attribute.
The author would like to thank Harsha Bushana for his efforts in reviewing the article.
- WebSphere Lombardi V7.2 Information Center
- WebSphere_Lombardi_Edition V7.2.0 Runtime Environment Installation and Configuration Guide for Windows (pdf file)
- WebSphere_Lombardi_Edition V7.2.0 Authoring Environment User Guide (pdf file)