Task Management

Select the Processes to Display

A list box in the article extras displays all of the currently deployed process models in the workflow engine.

Select the processes whose tasks you'd like to appear on your article. You can use Ctrl-Click or Shift-Click to select more than one. If you don't select any none will appear.

Process Variables Filter

When building filters the variable names and values should be entered in lowercase, the ANDs and ORs in UPPERCASE

You can further restrict the tasks shown by the template so that it will only show tasks for process instances that have variables with certain values. For example, you could select the "case management" process, and then write an expression to only show cases of a certain type.

Note that this filter is used to restrict the instances shown for the processes selected above, you must select processes before applying a filter.

Filter expressions have the format variablename='value'. The name of the variable should not be in quotes, the value always will be.

The filter also lets you construct more complex expressions using ANDs or ORs with named variables and values.

This expression would only return tasks for processes that have a type of complaint or a type of feedback:

This expression would only return complaints that also have an escalated status:

Task/Process Filter

Once the template has been set up to only show tasks for the process instances you want, you can also build filters that will appear in the Task/Process drop-down filter on the article.

Simple Filters

Start by building some simple filters. This example shows Task Management set up to work with Case Management. Each filter will display one case type:

Each item in the list has a display value and an expression:

Which has generated the following drop-down options:

Remember, you can use any process variable to construct a filter! We've seen great examples using locations, postcodes and case statuses.

More Complex Expressions

You can also build filters using AND or OR expressions. In this example a single item in the drop-down would display a variety of waste-related tasks:

Creating Multiple Filters at Once

To make adding multiple items easier, press the "Add multiple" button. This lets you enter the name of a single process variable, then a comma separated list of possible values:

Which will automatically generate the following list of items:

You can then edit each item individually to tidy up the display values.

Useful Case Management Filters

These are some common filters you can use with Case Management processes.

Groups and Users

In the article extras, select the user groups that can be managed by the template. Only tasks assigned to or claimable by users in the chosen groups will be returned. The groups and users automatically populate the Assignee drop-down filter on the article. The list also includes the current user ("you").

For example, this article has been set up to manage two groups:

Those groups and the users in them appear as filters:

The groups appear first and a list of users second. Groups display the group description, followed by the name. Users are listed by their profile display name and account username.

Selecting a group or a user from the assignee filter will only display tasks already assigned to those users. This is a change in behaviour from previous versions of Task Management (prior to October 2024) where you would see all tasks a user may be able to work on, even via other group memberships.

Created and Due Date Filters

The options in these two filters are set in the article extras. Pick a date or SLA to filter the task table.

Custom Column Filters

You can add any number of extra custom columns to the table to use as filters for your tasks. There are two types of column, drop-down and text box, which determines the type of filter they provide.

Custom Drop-down

This column and filter creates a custom drop-down list.

To create this column, in the article extras, pick "Add a custom column". Then choose "Dropdown".

• Display label is the label that appears above the column
• Query field is the name of the process variable (it is case sensitive) that holds the values you'd like to filter on
• Type is either dropdown or fixed text (so, dropdown in this case)
• Options type lets you enter fixed values that will appear in the drop-down, or lists all of the end points found in the TaskSearch.getConfig end point (see Configuration below)

Custom Text Box

This column filter works like a search, rather than picking options from a drop-down.

To create this column, in the article extras, pick "Add a custom column". Then choose "Text box".

• Display label is the label that appears above the column
• Query field is the name of the process variable (it is case sensitive) that holds the values you'd like to search for
• Type is either dropdown or text box (so, text box in this case)

Additional Configuration

The custom drop-down column can generate its options from an end point rather than having fixed values entered into the article extras. The names of the end points you'd like to use need to be added into the Task Management configuration, so they can be selected in the article extras. The end points themselves need to return a single array of values that will appear in the drop-down on the template.

The configuration end point has the namespace config.[environment].TaskSearch.getConfig.

The end point should list the namespaces of other end points which will generate options for your drop-downs. For example, this configuration end point lists two end points:

function(params, credentials) {
    return {
        optionsEndpoints: [{
                name: "Initiator",
                endpoint: "test.alex.initiatorOptions"
            },
            {
                name: "Location",
                endpoint: "test.tim.locationOptions"
            }
        ]
    };
}

It provides these options in the article extras:

The initiatorOptions end point returns:

{
    "result": ["anonymous", "citizen1", "sarah"],
}

Which appears in the drop-down as: