Case-specific configurations for Task List

Draft comment:
This topic is shared by BAW, CP4BA. Last updated on 2025-03-13 12:15

You can use the following configuration options and event handlers for case task customization in the solution task layout.

Configuration properties

Under Behavior, set or modify the following configuration properties in the Task List.

Table 1. Task List configuration properties used for case customization
Configuration property	Description	Data type
Filter by app	The case solution acronym, based on which you filter the list to show only tasks for that case solution.	`String`
Set tasks per page	Specifies the number of tasks that are shown per page.	`Integer`
Show view instance	Enables opening a task instance.	`Boolean`
Enable batch modify	Enables modification of multiple selected tasks at once.	`Boolean`

For more configuration information, see Task List.

Events

JavaScript customizations added to the Task List event handlers ensure a consistent behavior of the actions triggered from the overflow menu of the listed case tasks, such as Open task, Modify task, Open workflow, View process diagram, Modify workflow.

On load: Activated when the task list page loads. The default OnLoad script adds two case-specific prebuilt saved searches to the view. You can customize the default script to create custom saved searches according to users' requirements. For more information, see Solution task layouts.

On task launched: Activated when a task is launched from the task list. For example:

var data = {	
      name: "showURL",	
      displayName: task.displayName+":"+task.tkiid,	
      replaceExistingWindow: false,	
      clearBreadcrumb: false,	
      systemID: task.systemID, 	
      tid: task.tkiid,	
      caseAction: "openWorkItem",	
      taskName: task.displayName 
};
parent.parent.postMessage(JSON.stringify(data), "*");

On instance launched: Activated when a process instance is launched from the task list. For example:

var instanceDisplayName = instance.name ? instance.name : (instance.processInstanceName ? instance.processInstanceName : null);
var instancePiid = instance.piid ? instance.piid : (instance['PROCESS_INSTANCE.PIID'] ? instance['PROCESS_INSTANCE.PIID'] : null);
var data = {	
      name: "showURL",	
      displayName: instanceDisplayName,	
      replaceExistingWindow: false,	
      clearBreadcrumb: false,	
      systemID: instance.systemID,	
      piid: instancePiid,	
      caseAction: "openWorkflow"	    				
};
parent.parent.postMessage(JSON.stringify(data), "*");

On process diagram launched: Activated when a process diagram is launched from the task list. For example:

var systemID = null;
var data = {	
      name: "showURL",
      displayName: processDiagram.processName,	
      replaceExistingWindow: false,	
      clearBreadcrumb: false,	
      systemID: systemID,	
      piid: processDiagram.piid,	
      caseAction: "viewProcessDiagram"	    				
};
parent.parent.postMessage(JSON.stringify(data), "*");