GET_PARENT_NAME

La fonction de script GET_PARENT_NAME vous permet d'extraire le processeur ou l'activateur d'une tâche, même si celle-ci a été activée par une CallAPI. 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_NAME pour extraire le nom d'objet du 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_NAME.

Syntaxe

GET_PARENT_NAME(RunID[, ACT|PRC])

GET_PARENT_NAME([ACT|PRC])

Paramètres

• GET_PARENT_NAME
  Extrait le nom de l'activateur ou du processeur

• RunID
  (Optionnel) RunID de la tâche activée par la tâche parent
  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 :

• Nom de l'activateur ou du processeur
• Nom de l'utilisateur
  La tâche a été activée manuellement
  Format : NOM/DÉPARTEMENT
• *SCRIPT
  La tâche a été activée via une CallAPI
• Valeur non renseignée
  Tâche parent inexistante
  

Exemple

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

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

Si la tâche a été activée par un workflow parent nommé JOBP.MM.PROCESSING, le rapport d'activation se présente ainsi :

2018-11-06 15:26:01 - U00020408 The task was activated by JOBP.MM.PROCESSING

Si un utilisateur dénommé Smith du département DEV a exécuté la tâche manuellement, la sortie affiche le nom de cet utilisateur :

2018-11-06 15:26:01 - U00020408 The task was activated by SMITH/DEV

Voir aussi :