This site contains the documentation that is relevant to older WSO2 product versions and offerings.
For the latest WSO2 documentation, visit https://wso2.com/documentation/.

Using the BPMN Explorer

Owned by Former user (Deleted)
Apr 05, 2018
4 min read

BPMN Explorer enables users to interact with deployed BPMN applications. It's a Jaggery-based, lightweight web application that you can customize and deploy in a web server.

You access the BPMN Explorer at: https:/<HOST_IP>:9445/bpmn-explorer/login. If you configured the BPMN Explorer for a tenant account, you access it at: https://<HOST_IP>/t/<TENANT_DOMAIN>/jaggeryapps/bpmn-explorer/

If you want to log in to the BPMN Explorer as a user residing in a secondary user store, provide the username in the following format: <DOMAIN>/<USER>. E.g., foo/user1

The BPMN Explorer has the following features and functionalities.

  • Dashboard - View statistics for the deployed processes
  • Tasks - View and take action on tasks
  • Processes - View and start processes
  • Monitoring - Monitor process activity
  • Reports - Generate reports for processes

Dashboard

Use the DASHBOARD tab to view statistics, such as the process instance count, and the status of process and task instances.

view dashboard

Tasks

Use the TASKS tab to view and take action on your BPMN tasks and to claim tasks you want to work on.

My tasks

This tab displays the task instances that are assigned to the user who is logged in. Click on a task to select it.

list of tasks

 Click the Start button and complete, reject, transfer or reassign it accordingly. 
add process details
Claimable tasks
This tab displays the list of tasks that can be claimed by the user who is logged in.

list of claimable tasks

Select a task and click Claim Task to claim it if it is not assigned to a user.

claim a task

Completed tasks

This tab displays the list of the completed BPMN task instances.

completed tasks list

Click on a task to view more information such as task description, assignee, status etc. about it.

view details of a completed task

Processes

Use the PROCESSES tab to start the deployed BPMN processes and view their process diagrams.

list of deployed BPMN processes

Click the Process Definition ID of a process to view the process diagram of it.

view process diagram

Click the Start button, fill in the required details, and click Start to start it. For example, you can start the process named VacationRequestProcess shown above:

fill details to start a process

The process will stop after the specified number of days. 

Monitoring

Use the MONITORING tab to view the activity of specific process instances using the Process Instance ID.

monitoring a process instance

Also, you can perform an advanced filtering search for a Process Instance ID.

advanced filtering

Reports

Click Generate Report in the REPORTS tab to generate statistical reports of the actions you performed on BPMN processes.

generate report

You can generate the following reports for a single process or for all processes.

  • Process Instance Count
  • Average Time Duration Of Completed Processes
  • Task Durations Of Completed Process
  • User Vs Number Of Tasks Completed
  • User Vs Average Time Taken to Complete Tasks
  • Task Instance Count Variation Over Time
  • Process Instance Count Variation Over Time
  • User Performance Of Tasks Instances Over Time

view generated report

Configuring BPMN Explorer for a tenant account

If you are running WSO2 Enterprise Integrator in a multi-tenanted environment, follow these steps to configure the BPMN explorer for a tenant account.

  1. Make a copy of the <EI_HOME>/wso2/business-process/repository/deployment/server/jaggeryapps/bpmn-explorer/ directory anywhere on your computer. You will make your configuration changes in this new directory.

    The rest of these instructions refer to the new directory as <EXPLORER_CONFIG_TEMP>.

  2. Update the <EXPLORER_CONFIG_TEMP>/config/config.json configuration file as follows: 
    • Add your tenant domain as the value of the bpsTenantDomain parameter. (E.g., "bpsTenantDomain": "wso2.bps.com")

    • Add your tenant ID as the value of the bpsTenantId parameter. (E.g., "bpsTenantId" : "1")

       Follow the steps below to find your tenant ID.
        1. Log in to the Management Console of the Business Process profile using the following URL and admin/admin credentials: https://<HOST_IP>:9445/carbon/
        2. Click Configure, and then click View Tenants in the Multitenancy menu.
        3. Click the corresponding Edit link of the tenant.
          view the tenant list
        4. View the ID of your tenant.
          view your tenant ID
  3. Compress the <EXPLORER_CONFIG_TEMP> directory into a ZIP file, and then copy that ZIP file to the <EI_HOME>/wso2/business-process/repository/deployment/server/jaggeryapps/ directory. You may now delete the <EXPLORER_CONFIG_TEMP> directory.
  4. Copy the <EI_HOME>/wso2/business-process/repository/deployment/server/webapps/bpmn.war file to the <EI_HOME>/wso2/business-process/repository/tenants/<TENANT_ID>/webapps/ directory.
  5. Log in to the BPMN Explorer via the following URL and tenant's credentials: https://<HOST_IP>/t/<TENANT_DOMAIN>/jaggeryapps/bpmn-explorer/