GET_PARENT_NR

La fonction de script GET_PARENT_NR vous permet d'extraire le RunID du processeur ou de l'activateur d'une tâche. Cette fonction de script renvoie l'ID de session si la tâche est activée manuellement par un utilisateur. Cette tâche peut être n'importe quel type d'objet exécutable. Pour plus d'informations sur les processeurs et les activateurs, voir Tâches de niveau supérieur (parents).

Conseil : Utilisez SYS_ACT_PARENT_NR pour extraire le RunIDdu processeur ou de l'activateur de la tâche active (tâche contenant la fonction de script). Pour plus d'informations, voir SYS_ACT_PARENT_NR.

Syntaxe

GET_PARENT_NR(RunID[, ACT|PRC])

GET_PARENT_NR([ACT|PRC])

Paramètres

• GET_PARENT_NR
  Extrait le RunID de l'activateur ou du processeur, ou l'ID de session si la tâche est activée par un utilisateur

• RunID
  (Optionnel) RunID de la tâche activée
  Format : littéral de script ou variable de script
  Remarque : Si vous ne spécifiez pas de RunID, cette fonction de script renvoie le parent de la tâche qui contient le script.

• ACT ou PRC
  (Optionnel) Spécifie le type d'activation
  Valeurs autorisées :

  • ACT
    Activateur
    Tâche parent qui active la tâche enfant spécifiée ou utilisateur qui active la tâche manuellement
  • PRC
    Processeur (défaut)
    Autres moyens d'activation de la tâche
  Remarque : Si vous ne spécifiez pas de type d'activation, la fonction de script extrait le processeur (par défaut).

Codes retour

Cette fonction de script a les codes retour suivants :

• RunID de l'activateur ou du processeur
• ID de session
  (ACT uniquement) La tâche a été activée manuellement par un utilisateur
  Pour plus d'informations, voir Dernière session dans Utilisateurs (USER).
• Valeur non renseignée
  Tâche parent inexistante

Exemple

Le script suivant extrait et utilise le RunID d'une tâche pour renvoyer des informations sur l'activateur de la tâche.

:SET &RunID# = GET_UC_OBJECT_NR(MAWI.END.PROCESSING)
:SET &RET# = GET_PARENT_NR(&RunID#, ACT)
:PRINT "The task was activated by &RET#"

Si la tâche a été activée par une tâche parent, telle qu'un workflow, le rapport d'activation se présente ainsi :

2018-11-06 15:26:01 - U00020408 The task was activated by 0001004059

Si un utilisateur a exécuté la tâche manuellement, c'est l'ID de session de l'utilisateur qui s'affiche :

2018-11-06 15:26:01 - U00020408 The task was activated by 0001000081

Voir aussi :