Exploring BPMN Artifacts

The 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 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
If you configured the BPMN Explorer for a tenant account, you access it at: https://<HOST_IP>/t/<TENANT_DOMAIN>/jaggeryapps/bpmn-explorer/

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")
  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.
  4. View the ID of your tenant.
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/

The BPMN Explorer has the following features and functionalities.

Exploring BPMN Artifacts - View statistics for the deployed processes
Exploring BPMN Artifacts - View and take action on tasks
Exploring BPMN Artifacts - View and start processes
Exploring BPMN Artifacts - Monitor process activity
Exploring BPMN Artifacts - 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.

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

Now that you understand how to create, deploy and explore BPMN artifacts, next take a look at:

BPMN Tutorials for information on trying out end to end use cases.
BPMN Samples for information on how to run samples that are shipped with WSO2 EI.