Configuring Human Task Coordination

Enabling human task coordination

For the human task coordination to function properly, you need to enable task coordination at both the Task Parent and Task Processor. In WSO2 BPS, you can enable this feature in both Task Parent (B4P module) and Task Processor using the following configuration options. The following steps address human task processor configuration.

1. Navigate to the <PRODUCT_HOME>/repository/conf/ directory in your local machine and open the humantask.xml configuration file.

2. Set the TaskCoordinationEnabled entry to true.

   <HumanTaskCoordination>
   	<TaskCoordinationEnabled>true</TaskCoordinationEnabled>
   </HumanTaskCoordination>

Use the following steps to enable HumanTask Coordination in the B4P module (Task Parent).

1. Navigate to the <PRODUCT_HOME>/repository/conf/ directory in your local machine and open the b4p-coordination-config.xml file. 

2. Set the TaskCoordinationEnabled entry to true.

   <HumanTaskCoordinationConfiguration>
   	<TaskCoordinationEnabled>true</TaskCoordinationEnabled>
   </HumanTaskCoordinationConfiguration>

Creating a predefined user for authentication

Coordination Protocol Services and Registration service are implemented as WSO2 Carbon admin services. In order to access these services, a user needs to be authenticated to the system. In WSO2 BPS task coordination, these service are authenticated using a user created in BPS and configured within the config files.

Use the following instructions to create a role and a user.

Step 1: Create a role

1. Start the BPS server If it is not started already.
2. Go to the Configuration menu in the management console and navigate to Users and Roles > Role.
3. Click "Add New Role".
4. Enter a name for the role (e.g.: htcoordinatorRole) and click Next.

5. Select the following permissions for the newly created role.

   These are minimum permission requirements.

   • All Permissions \ Admin Permissions \ Login
   • All Permissions \ Admin Permissions \ Manage \ HumanTask \ View Task List
6. Click Finish.

Step 2: Create a user for the above created role

1. Go to Configuration menu in the management console and navigate to Users and Roles > Users.
2. Click "Add New User".
3. Enter relevant values in the username and password fields.
4. Click Next.
5. Select the rolename defined above for the role
6. Click Finish.

Step 3: Configure the above created user in b4p-coordination-config.xml

1. Navigate to the <PRODUCT_HOME>/repository/conf/ directory in your local machine and open the b4p-coordination-config.xml file.

2. Set the username and password in the TaskProtocolHandlerAuthentication entry as follows.

   <TaskProtocolHandlerAuthentication>
   	<Username>htcoor</Username>
   	<Password>htcooradmin</Password>
   </TaskProtocolHandlerAuthentication>

Step 4: Configure the above created user in humantask.xml

1. Navigate to the <PRODUCT_HOME>/repository/conf/ directory and open the humantask.xml configuration file

2. Set the username and password in the RegistrationServiceAuthentication entry as follows. 
   

   <RegistrationServiceAuthentication>
   	<Username>htcoor</Username>
   	<Password>htcooradmin</Password>
   </RegistrationServiceAuthentication>