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/
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
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.
Claimable tasks
Select a task and click Claim Task to claim it if it is not assigned to a user.
Completed tasks
This tab displays the list of the completed BPMN task instances.
Click on a task to view more information such as task description, assignee, status etc. about it.
Processes
Use the PROCESSES tab to start the deployed BPMN processes and view their process diagrams.
Click the Process Definition ID of a process to view the process diagram of it.
VacationRequestProcess
shown above: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.
Also, you can perform an advanced filtering search for a Process Instance ID.
Reports
Click Generate Report in the REPORTS tab to generate statistical reports of the actions you performed on BPMN processes.
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
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.
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>
.- 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"
)
- Add your tenant domain as the value of the
- 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. - 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. - Log in to the BPMN Explorer via the following URL and tenant's credentials:
https://<HOST_IP>/t/<TENANT_DOMAIN>/jaggeryapps/bpmn-explorer/