GET_PARENT_NAME

Verwenden Sie die Script-Funktion GET_PARENT_NAME, um den Verarbeiter 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 Verarbeitern und Aktivierern finden Sie unter Übergeordnete Aufgaben (Parent).

Tipp:Verwenden Sie SYS_ACT_PARENT_NAME, um den Objektnamen des Verarbeiters 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
  Ruft den Namen des Aktivierers oder Verarbeiters ab

• RunID
  (Optional) RunID der Aufgabe, die von der Parent-Aufgabe aktiviert wurde
  Format: Script-Literal oder Script-Variable
  Hinweis:Wenn Sie keine RunID angeben, gibt die Script-Funktion die Parent-Aufgabe der Aufgabe zurück, die das Script enthält.

• ACT oder PRC
  (Optional) Gibt den Typ der Aktivierung an
  Zulässige Werte:

  • ACT
    Aktivierer
    Parent-Aufgabe, die die angegebene Child-Aufgabe aktiviert, oder Benutzer, der die Aufgabe manuell aktiviert
  • PRC
    Verarbeiter (Standard)
    Anderes Mittel, die Aufgabe zu aktivieren
  Hinweis: Wenn kein Aktivierungstyp angegeben wird, ermittelt die Script-Funktion den Verarbeiter (Standard).

Rückgabewerte

Die Script-Funktion hat die folgenden Rückgabewerte:

• Name des Aktivierers oder Verarbeiters
• Name des Benutzers
  Aufgabe wurde manuell aktiviert
  Format: NAME/ABTEILUNG
• *SCRIPT
  Die Aufgabe wurde über eine CallAPI aktiviert
• Leerer Wert
  Es ist keine Parent-Aufgabe vorhanden
  

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 "Die Aufgabe wurde aktiviert von &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 Die Aufgabe wurde aktiviert von 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 Die Aufgabe wurde aktiviert von SMITH/DEV

Siehe auch: