numtasksforprocessmodelforstatus() Function

Returns the number of tasks with the specified status in process instances of the process model.


numtasksforprocessmodelforstatus( processModelId, status, [includeSubProcessData] )

processModelId: (Integer) The Id number of the process model.

status: (Text) The status of the tasks you want counted.

includeSubProcessData: (Boolean) Controls whether data from sub-processes are included in the count.




The status of each process instance is not considered.

The current user must hold at least viewer rights for the specified process model, in order to execute this function.

Deleted and archived process instances are not counted.

The following (case sensitive) values are available for the status parameter:

  • accepted
  • assigned
  • cancelled
  • completed
  • paused
  • problem ("problem" tasks are attended tasks that are canceled by exception)

If you do not provide a value for the includeSubProcessData parameter, the default value is taken from the current context or set to false if no sub-processes available.

For example, if the function is used on a Web Content with Process Details Channel and the channel's context includes sub-processes, these sub-processes are included by default.


You can copy and paste these examples into the Expression Rule Designer to see how this works.

numtasksforprocessmodelforstatus(processModelId,"completed",true) returns 112

Open in Github Built: Fri, Nov 12, 2021 (02:39:05 PM)

On This Page