Catégories :

Fonctions système (Informations système)

SYSTEM$GET_PREDECESSOR_RETURN_VALUE

Récupère la valeur de retour pour la tâche prédécesseur dans un graphique de tâches. La valeur de retour est définie explicitement par le prédécesseur en appelant la fonction SYSTEM$SET_RETURN_VALUE.

Syntaxe

SYSTEM$GET_PREDECESSOR_RETURN_VALUE('<task_name>')
Copy

Arguments

'task_name'

Identificateur de la tâche prédécesseur qui définit la valeur de retour à récupérer.

  • Si la tâche a plusieurs tâches prédécesseurs qui sont activées, cet argument est requis.

  • Si la tâche n’a qu’une seule tâche prédécesseur qui est activée, l’argument est facultatif. Si cet argument est omis, la fonction récupère la valeur de retour pour la seule tâche prédécesseur activée.

  • Si le nom de la tâche du prédécesseur immédiat ne correspond pas au nom de la tâche demandée, mais qu’un prédécesseur ancêtre correspond au nom de la tâche, la valeur de retour de l’ancêtre correspondant est renvoyée.

  • L’argument de nom de la tâche ne doit pas inclure le nom de la base de données ou le nom du schéma. Toutes les tâches d’un graphique doivent se trouver dans le même schéma, de sorte qu’il ne devrait pas être nécessaire de référencer une tâche dans un schéma différent. Par exemple, vous devez utiliser MYTASK comme entrée de cette fonction, au lieu de MYDATABASE.MYSCHEMA.MYTASK.

Notes sur l’utilisation

  • Les noms des tâches sont sensibles à la casse.

  • Lorsqu’un nom de tâche est spécifié, il doit correspondre à un prédécesseur activé, sinon l’appel échouera.

Exemples

Voir des exemples complets pour cette fonction dans SYSTEM$SET_RETURN_VALUE.