Build it yourself

This section describes how to enable a human task to create group work items. It covers how to:

Enable group work items

Since we want to determine the users for our business process by the groups they belong to, we first have to enable WebSphere to search users by groups. This can be enabled via the administrative console.

    To start the administrative console on WebSphere Process Server, perform the following steps.

  1. In a Web browser, open the URL http://yourhost:yourport/admin.
  2. Note: Replace yourhost with your server's internet address and yourport with the port of your server's HTTP transport, for example http://localhost:9060/admin.

  3. Log in as a userid with administrative privileges.
  4. On the navigation pane, expand the Servers section.
  5. Click on the Application servers link.
  6. Click on the name of the application server for which you want to enable group work items. In this case the server is server1.
  7. In the Business Integration section, expand the Business Process Choreographer item and select Human Task Manager.
  8. The configuration page opens.

  9. Scroll to the People Resolution section at the bottom of the page.
  10. Check the Enable group work items checkbox.
  11. Click on Apply.
  12. Now you have to persist the changes you made.

  13. Scroll to the top of the page and click the save link.
  14. The new settings will become active after the next server restart.

Import the prepared project

A project has been prepared, which serves as the basis to build this sample. To import the prepared project interchange file delivered with this sample, perform the following steps:

  1. Download the GWISamplePrepare.zip file, and save it to a temporary directory.
  2. In WebSphere Integration Developer, click File > Import. The Import window opens.
  3. Select Other > Project Interchange.
  4. Click Next. The Import Project Interchange Contents window opens.
  5. Click Browse next to the From zip file field.
  6. Browse to the temporary directory and select the zip file you downloaded in step 1.
  7. Click Open.
  8. Select your workspace directory as your Project location root.
  9. Click Select All.
  10. Click Finish.
  11. Wait until the automatic build process has finished.

Open the human task editor

    In this sample business process we defined two staff activities which are executed in parallel. The same users are eligible for these activities, but different mechanisms are used to determine the eligible users. This is just for demonstrating the difference between these two mechanisms. In a production scenario, you rather would pick the appropriate mechanism, depending on the number of users existing in the group, and then use this mechanism for both activities.

  1. In the business process editor select the Group Work Item Task.
  2. Select the Properties tab.
  3. Click on Details.
  4. Click on Open.
  5. The human task editor opens.

    If you did not use the preparation file delivered with this sample you need to create a new human task first and set the input and output parameters of the interface. If a human task had not been defined before, a New button instead of the Open button would be displayed.

Check the staff verb plugin provider setting

  1. Switch to the human task editor.
  2. Click the icon to display the properties.
  3. In the Properties view, select the Details section.
  4. In the field People directory (JNDI name) select bpe/staff/samplevmmconfiguration from the list box.
  5. On the toolbar, click the Save button .

Use the staff verb "Group"

  1. Switch to the human task editor.
  2. Select the role you want to create group work items for. In this case it is Potential Owners.
  3. Go to the Properties view.
  4. Select Group from the list box next to People assignment criteria.
  5. In the GroupID field enter cn=sellers,o=defaultWIMFileBasedRealm which is the full qualified name of the group.
  6. On the toolbar, click the Save button .