Substitution using BPMN Explorer

This section guides you through using the interface on the BPMN explorer to perform user substitution. For more information about user substitution, see Working with BPMN User Substitution.

Prerequisite - Enabling user substitution

Run the database script <BPS_HOME>/dbscripts/bps/bpmn/create/activiti.<DB_Name>.create.substitute.sql against your BPMN engine's database to add the Substitution related table.

Open the activiti.xml file found in the <BPS_HOME>/repository/conf/ directory and uncomment the following configuration.

<bean id="userSubstitutionConfiguration">
    <property name="enabled" value="true"></property>
    <property name="enableTransitivity" value="false"></property>
    <property name="activationInterval" value="60"></property>
</bean>

Adding a substitute

Login to the BPMN explorer and select the Substitutions tab.
Click on Add Substitute and fill in the following fields.
You can now see the substitution record you just added listed under the My Substitutions Information section. The Substituted Assignees section lists the substitution records where you (the logged in user) is a substitute for another user.
- To deactivate the substitution, click the Deactivate button next to Substitution Status.This will deactivate the substitution regardless of the time period.
- To update the existing substitution, click on the Update button.

Updating a substitute

Login to the BPMN Explorer and select the Substitutions tab.
The existing substitute and substitution details will appear under the My Substitutions Information section.
Click on the Update button to update this substitution record.
Change the details you wish to change and click Update.

Deactivating a substitute

Login to the BPMN Explorer and select the Substitutions tab.
The existing substitute and substitution details will appear under the My Substitutions Information section.
Click on the Deactivate button. This will deactivate the substitution regardless of the specified time period.
The substitution status will change to "Inactive". You can re-activate this substitution by clicking on the Activate button again.

Substitute Admin view

Login to the BPMN Explorer and select the Substitutions tab.
Click on the Go to Substitutions Admin View button. You will see all substitution records of all users (i.e, not just the currently logged in user) listed under the Substituted Assignees section.
- Click on the relevant row to update an existing substitution record.
- Click on Deactivate for the relevant substitution to deactivate it.
- Click on the Add Substitute button to add a new substitution for any user.
Note: This button and view is only visible when the user has substitution permissions.

Try it out

To try out this sample scenario, you can use the UserTaskCreatorProcess.bar sample. The sample requests a username for the assignee and will create a user task that is assigned to a given user. To deploy the sample and run through the sample scenario, see User Substitution.