Automation Engine Script-Leitfaden > Funktionelle Gliederung > Aktivierungsdaten > SYS_ACT_PARENT_NAME

SYS_ACT_PARENT_NAME

Script-Funktion: Liefert den Namen der übergeordneten Aufgabe.

Syntax

SYS_ACT_PARENT_NAME([Activation type])

Syntax

Beschreibung/Format

Aktivierungsart

Erlaubte Werte:

ACT = Activator
PRC = Processor (Standardwert)


Rückgabewert

Name der übergeordneten Aufgabe
"*SCRIPT" - Die Aufgabe wurde über ein CallAPI aktiviert.
" " - Es existiert keine übergeordnete Aufgabe (nur bei Aktivierungstyp PRC).

Anmerkungen

Die Script-Funktion ermittelt den Namen der übergeordneten Aufgabe (Parent). Bei einer manuellen Aktivierung ist dies der Name des Benutzer-Objektes (z.B. MEIER/DEV).

Geben Sie keinen Aktivierungstyp an, ermittelt die Script-Funktion den Processor.

Damit die RunID einer Gruppe ermittelt werden kann, muss bei der Aufgabe, welche die Script-Funktion verwendet, "Zur Laufzeit generieren" (Registerkarte Attribute) aktiviert sein. Sonst kann der Objekttyp nur bei Jobs im Post-Script festgestellt werden.

Beispiele

Im ersten Beispiel wird geprüft, ob die Aufgabe in einer Gruppe, einem Workflow oder einem Schedule läuft. Ist dies der Fall, wird der Name der Aufgabe in das Aktivierungsprotokoll geschrieben. Gibt es keine übergeordnete Aufgabe, wird darauf mit einem Eintrag im Aktivierungsprotokoll hingewiesen.

:SET &NAME# = SYS_ACT_PARENT_NAME()
:
IF &NAME# NE " "
:   
PRINT "Name of parent: &NAME#."
:
ELSE
:  
 PRINT "No parent"
:
ENDIF

Das zweite Beispiel ermittelt den Activator der Aufgabe. Im Aktivierungsprotokoll wird dessen Name ausgegeben. Wurde die Aufgabe manuell aktiviert, enthält das Aktivierungsprotokoll Namen und Abteilung des jeweiligen Benutzers.

:SET &NAME# = SYS_ACT_PARENT_NAME(ACT)
:
PRINT "Task was activated by &NAME#."

Im dritten Beispiel wird auf dieselbe Weise wie im zweiten der Activator einer Aufgabe ermittelt. Bei einer Aktivierung über die CallAPI wird beispielsweise eine solche Zeile im Aktivierungsprotokoll ausgegeben:

2004-01-27 13:19:36 - U0020408 Task was activated by *SCRIPT.

 

Siehe auch:

Script-Sprachmittel Beschreibung

SYS_ACT_PARENT_NR

Liefert die laufende Nummer (RunID) der übergeordneten Aufgabe.

SYS_ACT_PARENT_TYPE

Liefert den Objekttyp der übergeordneten Aufgabe.

Script-Sprachmittel - Aktivierungsdaten

Allgemeines zum Script
Script-Sprachmittel - Alphabetische Auflistung

Script-Sprachmittel -Funktionelle Gliederung

 


Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support

Copyright © 2016 Automic Software GmbH