Fonction de script : retourne le numéro d'exécution (RunID) de la tâche supérieure.
SYS_ACT_PARENT_NR ([Activation type])
Syntaxe |
Description / format |
---|---|
Type d'activation |
Valeurs autorisées : |
Codes retour |
---|
RunID de la tâche supérieure. |
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.
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 |
---|---|
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