User Task

User task represents a general activity to be processed by a participant (or a group of users), or an automated process. A user task is the most frequently used type of task in a workflow.

Many of the configuration settings for the user task apply to other types of tasks. Use the setting discussed here as a reference for configuring similar properties for other types of tasks.

A user task can be configured through the following tabs:

General tab

The General tab allows you to configure general information about the task.

From the General tab, set up the following fields:

Field

Required

Description

Name

Yes

The task name, whose length MUST BE less than or equal to 80 Unicode characters, and MUST be unique within the scope of the whole workflow definition.

Description

No

Hold a human-readable description or comment.

Input Parameters tab

You can specify the parameters that can be used for a task. Parameters include data fields and attachments. You can use the parameter values to help you perform the task.

From the Input Parameters tab, set up the following fields:

Field

Required

Description

Input parameters

No

A JSON fragment of key-value pairs containing the mapping values from input or output of another task during the execution.

In SimWorkflow, certain parameter name prefixes are reserved for specific purposes. Understanding these prefixes and syntax conventions is crucial for effective workflow design. Here's a breakdown of the reserved prefixes and syntax rules:

Reserved prefixes:

JSONPath expression syntax:

JSONata expression syntax:

Referencing workflow inputs:

Referencing task inputs and outputs:

Referencing task attachments:

Referencing workflow definition variables:

Examples of acceptable expressions:

Task Processor tab

To execute a user task within SimWorkflow, you have two primary options: using the SimWorkflow API task endpoint or leveraging a SimWorkflow page as a task processor. Here's a breakdown of each approach:

SimWorkflow API task endpoint:

SimWorkflow Page as a task processor:

Additionally, SimWorkflow Pages offer the flexibility to create powerful applications by combining workflow definitions and pages. For example, you can build applications like an issue tracking system using SimWorkflow's workflow definitions and pages. As a starting point, your SimWorkflow account already includes a simple Issue Management workflow definition, allowing you to kickstart your application development process.

From the Task Processor tab, set up the following fields:

Field

Required

Description

Select a page for task processor

No

Use a SimWorkflow page as a task processor.

Routing tab

In the Routing tab, you configure how the task handles the incoming routes and how it processes the outgoing routes.

From the Routing tab, set up the following fields:

Field

Required

Description

Collector task

No

If you used parallel routing earlier, at some point, you must have a collector task to combine the parallel routes into one place. If the current task is the collector task, check the Collector task option. Otherwise, leave it unchecked.

Take the first route that evaluates to true

Yes

As soon as one condition becomes true, the route is taken.

Take all routes

Start all routes in parallel.