SYS_ACT_PARENT_TYPE

Fonction de script : Renvoie le type d'objet de la tâche supérieure.

Syntaxe

SYS_ACT_PARENT_TYP[E] ([Activation type])

Syntaxe

Description / format

Activation type

Valeurs autorisées :

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


Codes retour

Type d'objet de la tâche supérieure.
"USER" : dans le cas d'une activation manuelle (uniquement pour le type d'activation ACT)
"API" : dans le cas d'une activation via CallAPI (uniquement pour le type d'activation ACT).
" " : Il n'existe pas de tâche supérieure (uniquement pour le type d'activation PRC).

Cette fonction de script extrait le type d'objet de la tâche supérieure (parent), voir Tâches de niveau supérieur (parents). En cas d'activation manuelle, il s'agit de "USER". 

Si vous n'indiquez pas de type d'activation, la fonction de script récupère 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 type d'objet 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é par une ligne dans le rapport d'activation.

:SET &TYPE# = SYS_ACT_PARENT_TYPE()
:
IF &TYPE#  = " "
:   
PRINT "No parent"
:
ELSE
:   
PRINT "Object type of parent is &TYPE#."
:
ENDIF

Le deuxième exemple détermine l'activateur de la tâche. Si elle a été activée par une tâche, son type d'objet est affiché dans le rapport d'activation. Si elle a été activée manuellement, le rapport d'activation contient l'entrée "La tâche a été activée par utilisateur".

:SET &TYPE# = SYS_ACT_PARENT_TYPE(ACT)
:
PRINT "Task was activated by &TYPE#."

Le troisième exemple détermine également 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-28 11:19:26 - U0020408 Task was activated by API.

Voir aussi :