Task management
The Task management plugin is a powerful plugin that enables back-officers and supervisors to efficiently track and assign tasks within a company. It provides a business-oriented view of a process defined using FlowX Designer and allows for seamless interactions at the assignment level.
Activities
Within the Task Manager section, particularly under All Tasks, you’ll find the Activities tab, featuring:
- Title: The task’s title.
- Stage: The specific stages during process execution.
- Assignee: The person responsible for the process.
- Status: The current process status (details in Process status updates).
- Priority: Allows task prioritization.
- Last Updated: Timestamp for the latest updates.
- Search: A search function to find process keys stored in the process.
Task Details
The Task Details tab within Task Manager provides key process information, including:
- Priority: Enables task prioritization.
- Status: The current process status.
- Stage: Specific stages during process execution.
- Comments: User comments.
- History: Information such as task creation, creator, and status changes.
Please note that specific roles must be defined in a process to utilize all the task management features. For configuration details, see Configuring Access Roles for Task Manager.
Process status updates
Task Manager displays various statuses based on process state:
Status | Definition |
---|---|
Created | This status is visible only if there is an issue with the process creation. If the process is error-free in its configuration, you will see the Started status instead. |
Started | Indicates that the process is in progress and running. |
Finished | The process has reached an end node and completed its execution. |
Failed | Displayed when a CronJob is enabled in the FlowX Engine. For example, if a CronJob is triggered but not completed on time, tasks move to the FAILED status. |
Expired | Displayed when
|
Aborted | This status is available for processes that also contain subprocesses. When a subprocess is running (and the token is moved backward to redo a series of previous actions) - the subprocess will be aborted. |
Dismissed | Available for processes that contain subprocesses. It is displayed when a user stops a subprocess. |
On hold | Freezes the process, blocking further actions. A superuser can trigger this status for clarification or unfreeze. |
Terminated | A request is sent via Kafka to terminate a process instance, ending all active tokens in the current process or subprocesses. |
Swimlanes and Stages Updates
Task Manager also tracks swimlane and stage changes:
Swimlanes Updates
Status | Definition |
---|---|
Swimlane Enter | Marks token entering a new swimlane. |
Swimlane Exit | Indicates token exiting a swimlane. |
Stages Updates
Status | Definition |
---|---|
Stage Enter | Marks token entering a new stage. |
Stage Exit | Indicates token exiting a stage. |
Using the plugin
The Task Manager plugin offers a range of features tailored to different roles, including:
- Assigning and Unassigning Tasks
- Managing On-Hold Projects
- Adding Comments
- Viewing the application URL
- Bulk Updates (via Kafka)
You can configure Task Manager to send information/tasks about your process by enabling the Use process in task management button in the Process Settings menu. This allows the Task Manager plugin to send updates about the process.
To set up Task Manager to send updates on your process, follow these steps:
- In FlowX Designer, open the desired process definition.
- Select the Settings tab from the left sidebar menu.
- Enable the Use process in task management toggle button.
Some actions may be restricted based on user roles and access rights.
To set up Task Manager to send extra updates on your process using only some specific areas of your process:
- In FlowX Designer, open your process definition.
- Click the Edit button.
- Select a node for Task Manager to trigger updates upon reaching.
- Enable the Update task management? switch.
You can configure this action for multiple nodes.
For detailed configuration steps, refer to the next section:
Task Assignment and Reassignment
Consider this scenario: you’re the HR manager overseeing the onboarding process for new employees. In order to streamline this operation, you’ve opted to leverage a task manager plugin. This process consists of two key phases: the Initiation Stage and the Account Setup Stage, each requiring a designated team member.
The Initiation Stage has successfully concluded, marking the transition to the Account Setup Stage. At this juncture, it’s essential to reassign the task, originally assigned to John Doe, to Jane Doe, a valuable member of the backoffice team.
Managing On-Hold Projects
As a project manager overseeing various ongoing projects, you may need to temporarily pause one due to unforeseen circumstances. To manage this, you use the “On Hold” status.
Adding Comments
When handling on-hold projects, document the reasons, inform the team, and plan for resumption. This pause helps address issues and ensures a smoother project flow upon resuming. Never forget to add comments:
Viewing the Application
Property used to point to the application url where the flowx process is loaded.
Process settings level
In the Process Definitions settings, navigate to the Task Management tab and locate the Application URL field. Here, paste the application URL where the process is loaded, following this format:
{baseURL}/processes/instance
Example:
You can also use a predefined generic parameter as the URL: ${genericParameter}
.
Bulk updates
Send bulk update requests via Kafka (using Process Engine) to perform multiple operations at once. Use the Kafka topic:
KAFKA_TOPIC_PROCESS_OPERATIONS_BULK_IN
(defined in Process Engine) to send operations from “KAFKA_TOPIC_PROCESS_OPERATIONS_IN” as an array, allowing multiple operations at once. More details here.
Example of a bulk request:
{
"operations": [
{
"operationType": "HOLD",
"taskId": "some task id",
"processInstanceUuid": "d3aabfd8-d041-4c62-892f-22d17923b223", // the id of the process instance
"swimlaneName": "Default", //name of the swimlane
"owner": null,
"author": "john.doe@flowx.ai",
"requestID": "1234567891"
},
{
"operationType": "HOLD",
"taskId": "some task id",
"processInstanceUuid": "d3aabfd8-d041-4c62-892f-22d17923b223",
"swimlaneName": "Default", //name of the swimlane
"owner": null,
"author": "jonh.doe@flowx.ai",
"requestID": "1234567890"
}
]
}
For more information on bulk updates configuration, see Process Engine Setup:
Was this page helpful?