Creating user interfaces for a BPD

Create customized user interfaces that a user sees for the process instance in Process Portal.

About this task

IBM® Business Process Manager provides a user interface for your instances in Process Portal. You can either use the provided interface or you can create your own user interface and make it the default user interface for all users. Optionally, you can also create your own user interface that is customized for instance owners.
Attention: A process instance user interface must be implemented as a client-side human service. You cannot implement it as a heritage human service.
These are the process instance user interfaces that you can create:
  • The Default user interface that overrides the user interface that is provided by IBM BPM. Any user that has permission to see the process instance in Process Portal will see this interface. You can create a client-side human service and specify it as the user interface. If you do not specify a client-side human service here, the user interface that is provided by IBM BPM is used.
  • The Instance Owners user interface is an optional user interface that you can create for the team that is specified in the Instance owner team field in the Overview page. You can create a client-side human service and specify it as the user interface for the instance owners.

Procedure

To create a process instance user interface, first create a client-side human service, then create your customized interface by modifying the generated service and adding a coach.

  1. Open the BPD for which you want to create the user interface.
  2. Switch to the Views page.
  3. Under Details UI, select the interface that you want to create (Default or Instance Owners).
  4. Select a client-side human service, or create a new one. IBM BPM provides a template in the Dashboards toolkit, called Instance Details UI Services Template. You can copy this template and modify it to create your custom UI. The template contains the following coaches:
    • View Instance Details coach, which contains the following coach controls:
      Default Instance Details Template
      displays the instance details in Process Portal
      Data section
      displays the values of the variables that are passed into the client-side human service.
    • Show error, which returns an error if the instance is not found.
    For more information, see Instance Details UI Service template.
  5. Map the process variables to the client-side human service variables. To automatically map input properties with process variables, click the auto-map icon Auto-map input properties with process variables.
  6. Open the client-side human service, and click Run Run to test the client-side human service and the coach.
    Note: If you copied the template in step 4, remove the defensive logic that shows an error when the instance ID is null.
  7. To test the interaction between the user interface and the process:
    1. Open the BPD and click Run Process Run Process in the toolbar.
    2. Switch to the Inspector when prompted.
    3. In the Inspector, select the process instance and click the Runs the Details UI for the selected BPD Instance in the toolbar.
    Process Portal opens in your default browser showing the process instance user interface. You can view the user interface, enter data, and interact with the process.
Parent topic: Creating a business process definition (BPD)