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: