SYS_ACT_PARENT_NAME

Fonction de script : Indique le nom de la tâche supérieure.

Syntaxe

SYS_ACT_PARENT_NAME ([Activation type])

Syntaxe	Description / format
Type d'activation	Valeurs autorisées : ACT : activateur PRC : processeur (valeur par défaut)

Code retour
Nom de la tâche supérieure. "*SCRIPT" : la tâche a été activée via un CallAPI. " " : Il n'existe pas de tâche supérieure (uniquement pour le type d'activation PRC).

Cette fonction de script fournit le nom d'une tâche supérieure (parent). En cas d'activation manuelle, il s'agit du nom de l'objet Utilisateur (SMITH/DEV, par exemple).

Si le type d'activation n'est pas indiqué, cette fonction de script fournit le processeur.

Pour récupérer le nom d'un groupe, l'option "Générer à l'exécution" (onglet Attributs) doit être activée dans la tâche qui utilise la fonction de script. Sinon, le nom ne peut être récupéré que pour les jobs en post-traitement.

Exemples

Le premier exemple vérifie si la tâche est exécutée dans un groupe, un Workflow ou un Schedule. Dans ce cas, le nom de la tâche est écrit dans le rapport d'activation. S'il n'y a pas de tâche supérieure, cela est indiqué dans le rapport d'activation.

:SET &NAME# = SYS_ACT_PARENT_NAME()
:IF &NAME# NE " "
:   PRINT "Name of parent: &NAME#."
:ELSE
:   PRINT "No parent"
:ENDIF

Le deuxième exemple détermine l'activateur de la tâche. Son nom est affiché dans le rapport d'activation. Si la tâche a été activée manuellement, le rapport d'activation contient le nom et le département de cet utilisateur.

:SET &NAME# = SYS_ACT_PARENT_NAME(ACT)
:PRINT "Task was activated by &NAME#."

Le troisième exemple récupère aussi l'activateur d'une tâche. Si l'activation est réalisée par un CallAPI, la ligne suivante peut être affichée dans le rapport d'activation.

2004-01-27 13:19:36 - U0020408 Task was activated by *SCRIPT.

Voir aussi :