GET_PARENT_NAME

Verwenden Sie die Script-Funktion GET_PARENT_NAME, um den Prozessor oder Aktivierer einer Aufgabe abzurufen, auch wenn die Aufgabe über eine CallAPI aktiviert wurde. Die Aufgabe kann jede Art von ausführbarem Objekt sein. Weitere Informationen zu Prozessoren und Aktivierern finden Sie unter Übergeordnete Aufgaben (Parent).

Tipp: Verwenden Sie SYS_ACT_PARENT_NAME, um den Objektnamen des Prozessors oder Aktivierers der aktuellen Aufgabe (der Aufgabe, die die Script-Funktion enthält) abzurufen. Weitere Informationen finden Sie unter SYS_ACT_PARENT_NAME.

Syntax

GET_PARENT_NAME(RunID[, ACT|PRC])

GET_PARENT_NAME([ACT|PRC])

Parameter

• GET_PARENT_NAME
  Ermittelt den Namen des Aktivierers oder Prozessors

• RunID
  (Optional) RunID der von der Parent-Aufgaben aktivierten Aufgabe
  Format: Script-Literal oder Script-Variable
  Hinweis: Wenn keine RunID angegeben wird, gibt die Script-Funktion den übergeordneten Teil der Aufgabe zurück, den das Script enthält.

• ACT oder PRC
  (Optional) Gibt die Art der Aktivierung an
  Erlaubte Werte:

  • ACT
    Aktivierer
    Parent-Aufgabe, die die Child-Aufgabe aktiviert, oder Benutzer, der die Aufgabe manuell aktiviert
  • PRC
    Prozessor (Standard)
    Andere Möglichkeiten, die Aufgabe zu aktivieren
  Hinweis: Wenn kein Aktivierungstyp angegeben wird, ermittelt die Script-Funktion den Processor (Standard).

Rückgabewerte

Die Script-Funktion hat die folgenden Rückgabewerte:

• Name des Aktivierers oder Prozessors
• Name des Benutzers
  Aufgabe wurde manuell aktiviert
  Format: NAME/DEPARTMENT
• *SCRIPT
  Die Aufgabe wurde über eine CallAPI aktiviert
• Leerer Wert
  Es existiert keine Parent-Aufgabe
  

Beispiel

Das folgende Script ruft die RunID einer Aufgabe namens MAWI.END.PROCESSING ab und verwendet sie, um Informationen über den Aktivierer der Aufgabe zurückzugeben.

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

Wenn die Aufgabe durch einen Parent-Workflow namens JOBP.MM.PROCESSING aktiviert wurde, würde die Ausgabe im Aktivierungsreport wie folgt aussehen:

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

Wenn ein Benutzer namens Smith aus der DEV-Abteilung die Aufgabe manuell ausführen würde, würde die Ausgabe den folgenden Benutzernamen anzeigen:

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

Siehe auch: