Automation Engine Script Guide > Ordered by Function > Activation Data > SYS_ACT_TOP_NAME

SYS_ACT_TOP_NAME

Script Function: Supplies the name of the top workflow

Syntax

SYS_ACT_TOP_NAME()

Return codes
Name of the top workflow " " - The task was not activated by a workflow.

Example

In the following example, the return codes of the two script functions are compared in order to determine whether the task was activated without a workflow, within a workflow, or within the framework of several nested workflows. The corresponding message will then be sent to a user.

:SET &TNAME# = SYS_ACT_TOP_NAME()
:SET &PNAME# = SYS_ACT_PARENT_NAME()

:IF &TNAME# = &PNAME#
:   IF &TNAME# = " "
:      SEND_MSG ADMIN,AE,"Task does not run in a workflow."
:   ELSE
:      SEND_MSG ADMIN,AE,"Task runs in a workflow &TNAME#. No superordinate workflows."
:   ENDIF
:ELSE
:   SEND_MSG ADMIN,AE,"Name of the top workflow: &TNAME#."
:ENDIF