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

SYS_ACT_PARENT_NR

Fonction de script : retourne le numéro d'exécution (RunID) de la tâche supérieure.

Syntaxe

SYS_ACT_PARENT_NR ([Activation type])

Syntaxe

Description / format

Type d'activation

Valeurs autorisées :

ACT : activateur
PRC : processeur (valeur par défaut)


Codes retour

RunID de la tâche supérieure.
ID de session en cas d'activation manuelle (uniquement pour le type d'activation ACT)
" " : il n'existe aucune tâche supérieure (uniquement pour le type d'activation PRC).

Remarques

Cette fonction de script fournit le numéro d'exécution (RunID) de la tâche supérieure (parent). En cas d'activation manuelle, il s'agit de l'ID de session de l'utilisateur.

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 numéro d'exécution (RunID) 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é par une ligne dans le protocole d'activation.

:SET &NR# = SYS_ACT_PARENT_NR()
:
IF &NR#  = " "
:   
PRINT "No parent"
:
ELSE
:   
PRINT "RunID of parent is &NR#."
:
ENDIF

Le deuxième exemple détermine l'activateur de la tâche. Si elle a été activée par une tâche, son numéro d'exécution (RunID) est affiché dans le protocole d'activation. Dans le cas d'une activation manuelle, le protocole d'activation contient le RunID de la session utilisateur correspondante.

:SET &NR# = SYS_ACT_PARENT_NR(ACT)
:
PRINT "RunID of parent is &NR#."

 

Rubriques connexes :

Elément de script Description

SYS_ACT_PARENT_NAME

Indique le nom 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