Search fields

Task filters enable users to search tasks that meet one or more of the configured criteria. These filters can be configured by an admin.

Configuring task search fields

Via UI

• Go to the Admin menu

• Go to the Tasks menu

• Select the case to configure serach fields for

The configured task search fields will only be available for the selected case.

On the Search fields tab, search fields can be added, edited or removed.

Task search field configuration

When adding or editing a search field, the available options are similar to the case search fields. More information on case search fields can be found here.

For task list filters the following path prefixes are available:

• doc:

• case:

Via IDE

Task search fields can be autodeployed by creating json files on the classpath following this pattern: classpath*:**/*.task-search-field.json. The name of the file does not matter, but it is advised to keep it in line with the object title.

You can find an example of the JSON below:

my-case.task-search-field.json

{
  "changesetId": "my-case.TaskListSearchColumns.1721390529320",
  "collection": [
    {
      "ownerId": "my-case",
      "searchFields": [
        {
          "key": "caseAssignee",
          "title": "Case assignee",
          "path": "case:assigneeFullName",
          "dataType": "TEXT",
          "fieldType": "SINGLE",
          "matchType": "LIKE"
        },
        {
          "key": "createdBy",
          "title": "Case created by",
          "path": "case:createdBy",
          "dataType": "TEXT",
          "fieldType": "SINGLE",
          "matchType": "LIKE"
        }
      ]
    }
  ]
}

More information on the available fields and values can be found here.

Using task search fields

Since task filters are configured on a case, they will only be available when the user selects a case from the dropdown. For 'All cases', the additional filters will not be available.

With these filters, a user can filter on data from the document or case the task relates to.

Task search field

Just like the case search filters, these filters will behave differently depending on how the admin configured the fields.

Note

The current search criteria can be shared with another user by copying the url from the address bar. The same filter criteria will be applied, but results may vary depending on access control for the other user.

Import and export

The configuration task search fields is included in the case definition import and export by default.