SYS_ACT_TOP_NR

Use the SYS_ACT_TOP_NR script function to retrieve the RunID of the topmost Workflow. The task that contains the script function can be a child of the top Workflow, or can be nested at any level within the Workflow.

Note: If an object starts from the Postconditions tab, the Workflow is not a direct parent but only the activator of the script. In this case, this script function returns the properties of the activator.

Syntax

SYS_ACT_TOP_NR()

Return Codes

The script function has the following return codes:

RunID of the top Workflow
Empty value
Task was not activated by a Workflow

Example

The following script in a task retrieves the RunID of the parent task, and of the top Workflow. The script compares the retrieved values to determine whether the parent task is the top Workflow. A conditional block in the script sends the user a message with the appropriate information.

:SET &TNR# = SYS_ACT_TOP_NR()
:SET &PNR# = SYS_ACT_PARENT_NR()

:IF &TNR#    = &PNR#
:   IF &TNR# = " "
:      SEND_MSG ADMIN,AE,"Task does not run in a Workflow."
:   ELSE
:      SEND_MSG ADMIN,AE,"Task runs in the Workflow with RunID &TNR#. The Workflow is the top Workflow."
:   ENDIF
:ELSE
:   SEND_MSG ADMIN,AE,"Task runs in a nested Workflow. The RunID of the top workflow is &TNR#."
:ENDIF