Business processes
Overview
The Business Processes page lets administrators connect the portal to a Camunda BPM engine and manage how business processes are presented to users on Hub. The page is organized into four tabs: Configuration, Processes customization, Monitoring, and Custom processes.
Configuration
Sets up the connection to Camunda and refreshes the list of business processes available from it. Once a process is selected here, it can be triggered automatically from the Process for Request Object field.
Fields:
- Server — URL of the Camunda server (e.g. https://camundadev.org.com).
- Login — username used to authenticate with Camunda.
- Password — password used to authenticate with Camunda (masked).
- Enabled — toggle that turns the Camunda integration on or off.
- Business process for Request Object — dropdown selecting which business process runs automatically after a request object created.
Actions:
- Cancel — discards unsaved changes.
- Save — saves the current configuration.
- Clear — clears the form fields.
- Update business processes list — re-fetches the list of available business processes from Camunda.
Processes customization
Controls how individual business processes behave and appear to end users. On this tab an administrator can:
- link a form template to a business process so it displays at process start;
- limit a business process to a single run;
- allow a process to be started from the list, from a dedicated button, or both (a maximum of 3 processes can have a start button).
Each process row includes:
- Name — process name.
- Form template — the form shown when the process starts.
- Run once? — toggle limiting the process to a single start.
- Show as button — toggle exposing a dedicated start button for the process which is available on the object or request view page.
- Show in list — toggle including the process in the general process list.
Monitoring
Displays active and completed business processes and lets an administrator manually suspend any process from the list.
Table columns:
- Started at — date and time the process instance started.
- Last updated at — date and time of the most recent update.
- Object — the object the process was run against.
- Business process — name of the process definition.
- Invoker — user who started the process.
- Current stage — current step or status of the process (e.g. Report Certified).
- Status — process instance status (e.g. Completed).
Custom processes
Allows adding a third-party process as a link, so it appears alongside native processes in the list available to users or as a button.
Fields (per custom process entry):
- Name — display name of the custom process.
- URL — link the user is redirected to (e.g. a Jira or Power BI URL).
- System tag — the source system the link points to (e.g. Power BI). the list of available sources configure on the Report systems page
- Categories — one or more categories the process is tagged with, for filtering.
Actions:
- Add new — adds a new custom process entry.
- Remove (×) — removes a custom process entry.
- Save — saves all custom process entries.
Admins can create and manage dynamic request forms and run or monitor business processes through the Admin Panel. Business processes are built with .bpmn schemas and use the Camunda engine. They can be initiated for objects or request objects and monitored in the Configuration tab.
Please, note: In order for business processes to be available to run on the object or request view pages, the administrator must add the relevant processes to the list of available ones on the Events & Processes tab of the object type editing page.