Overview

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 task management features. For configuration details, see Configuring Access Roles for Task Management.

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 `expiryTime` field is defined within the process definition. To set up an `expiryTime` function, follow these steps Go to FLOWX Designer > Processes > Definitions. Select a process and click the ”⋮” button, then choose Settings. Inside the General tab, you can edit the Expiry time field.
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 about your process by enabling the Use process in task management button at the node level. This allows the Task Manager plugin to send updates about the process.

To set up Task Management 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 butto

Some actions may be restricted based on user roles and access rights.

To set up Task Management 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 Management plugin setup

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

In the task management tab, paste the application URL where the process is loaded, following this format:

{baseURL}/processes/instance

Example:

You can also use a defined generic parameter as a 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: Process Engine Setup

Getting Started

Platform overview

Building blocks

FlowX.AI Designer

Platform deep dive

API reference

Activities

Task Details

Process status updates

Swimlanes and Stages Updates

Swimlanes Updates

Stages Updates

Using the plugin

Task Assignment and Reassignment

Managing On-Hold Projects

Adding Comments

Viewing the Application

Bulk updates

​Activities

​Task Details

​Process status updates

​Swimlanes and Stages Updates

​Swimlanes Updates

​Stages Updates

​Using the plugin

​Task Assignment and Reassignment

​Managing On-Hold Projects

​Adding Comments

​Viewing the Application

​Bulk updates

Activities

Task Details

Process status updates

Swimlanes and Stages Updates

Swimlanes Updates

Stages Updates

Using the plugin

Task Assignment and Reassignment

Managing On-Hold Projects

Adding Comments

Viewing the Application

Bulk updates