Manuel des Scripts Automation Engine > Organisation fonctionnelle > Données d'activation > SYS_ACT_PARENT_NAME

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 aucune tâche supérieure (uniquement pour le type d'activation PRC).

Remarques

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 (par ex. SMITH/DEV).

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é 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 protocole d'activation. S'il n'y a pas de tâche supérieure, cela est indiqué dans le protocole 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 protocole d'activation. Si la tâche a été activée manuellement, le protocole 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 protocole d'activation.

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

 

Rubriques connexes :

Elément de script Description

SYS_ACT_PARENT_NR

Fournit le numéro d'exécution (RunID) de la tâche supérieure.

SYS_ACT_PARENT_TYPE

Retourne le type d'objet de la tâche supérieure.

Eléments de script - Données d'activation

Généralités sur les scripts
Eléments de script - Liste alphabétique

Eléments de script - Répartition fonctionnelle