Flow functions

From the current task, these functions allow you to :

  • test if a task is in progress (at the process document level / whatever the connected user is).
  • test if a task is overdue (for the logged-in user)
  • recover the duration of the current task (how long the task has been running).

ISCURRENT / ESTENCOURS

Since Process17.0.0

Description

This function returns @TRUE if a task is in progress for the process document regardless of the logged-in user. It returns @FALSE if the task is not active (other tasks in progress, process document completed, process document canceled).

Syntax

1

@ISCURRENT(iResource; taskName)

The function contains the following arguments :

Parameter Description Mandatory Comment
iResource Object corresponding to the resource. Yes iResource
taskName System name of the task. Yes

return value

The ISCURRENT function returns @TRUE if the specified task is in progress, otherwise it returns @FALSE.

Examples

Example 1 : display the fragment if the current step is “Human Resources Validation”.

1

@ISCURRENT(iResource; "HRValidation")

Example 2 : display the fragment if the current step is different from “Human Resources Validation”.

1

@NOT( @ISCURRENT(iResource; "HRValidation") )

ISLATE / ESTENRETARD

Since Process17.0.0

Description

This function checks whether the current stage is overdue.

Syntax

1

@ISLATE(iResource)

The function contains the following arguments :

Parameter Description Mandatory Comment
iResource Object corresponding to the resource. Yes iResource

return value

The function ISLATE returns @TRUE if the active task is late, otherwise it returns @FALSE.

Examples

Example 1 : indicate if a task is overdue in a virtual column

1

@IF(@ISLATE(iResource);"Late";"")

DURATION / DUREE

Since Process17.0.0

Description

This function returns the duration of the delay if a task is in progress and late for the process document.

Syntax

1

@DURATION(iResource; "unit")

La syntaxe de la fonction contient les arguments suivants :

The function contains the following arguments :

Parameter Description Mandatory Comment
iResource Object corresponding to the resource. Yes iResource
unit Time unit No default value: “DAY”.

return value

The function DURATION returns an integer value.

Note

The DURATION function does not handle parallel tasks .

Examples

Example 1 : display the number of days overdue in a virtual column

1

@DURATION(iResource; "DAY")