|
PREP_PROCESS_AGENTGROUP |
Datensequenzen |
PREP_PROCESS_DOCU |
|
Script-Funktion: Ermittelt mit Filtereinstellungen den Zeitstempel, Benutzer und Text von Aufgaben-Kommentaren und stellt das Ergebnis als interne Auflistung (Datensequenz) für die weitere Verarbeitung zur Verfügung.
PREP_PROCESS_COMMENTS([RunID], [Text], [User])
|
Syntax |
Beschreibung/Format |
|---|---|
|
RunID |
Laufende Nummer (RunID) der Aufgabe dessen Kommentare ausgelesen werden soll. Geben Sie keine RunID an, so werden die Kommentare jener Aufgabe ausgelesen, welche die Script-Anweisung aufruft. |
|
Text |
Filter für einen Ausdruck im Kommentartext Die Wildcardzeichen "*" und "?" können verwendet werden. "*" steht dabei für beliebige, "?" für genau ein Zeichen. |
|
Benutzer |
Filter für den Namen eines Benutzer-Objektes Die Wildcardzeichen "*" und "?" können verwendet werden. "*" steht dabei für beliebige, "?" für genau ein Zeichen. Wenn Sie nur nach dem Benutzer filtern wollen, ist das erste Komma auch zu setzen. Beispiel: :SET &HND# = PREP_PROCESS_COMMENTS(,,"SMITH/AE") |
|
Rückgabewert |
|---|
|
Referenz auf die Datensequenz von Kommentaren |
Die Script-Funktion liest die Kommentare einer Aufgabe aus. Dabei kann das Ergebnis mit den Parametern Text und Benutzer eingeschränkt werden.
Bei den Filterangaben wird die Groß- und Kleinschreibung berücksichtigt!
Beachten Sie, dass ein Leerstring "" als Filterangabe genauso wirkt wie "*", d.h. alle Werte werden zurückgeliefert.
Der Rückgabewert der Script-Funktion ist die Referenz auf eine Datensequenz. Sie wird den Script-Anweisungen :PROCESS und :ENDPROCESS als Startparameter übergeben. In Kombination mit der Script-Funktion GET_PROCESS_LINE kann nun auf jeden Kommentareintrag der Aufgabe zugegriffen werden.
Enthält der Kommentar die gesuchten Werte nicht, führt das zu keiner Fehlermeldung. Die Bearbeitung der Datensequenz, definiert zwischen :PROCESS und :ENDPROCESS, wird einfach nicht durchlaufen.
Der Script-Variablen, die die Datensequenz-Referenz enthält, kann kein neuer Wert zugewiesen werden. Erst wenn Sie die Datensequenz mit der Script-Anweisung :CLOSE_PROCESS explizit verwerfen, kann die Variable erneut verwendet werden.
Gegeben sind die folgenden Kommentare:
Das erste Beispiel ermittelt alle Kommentare und gibt den Benutzer sowie den Text mit :PRINT aus.
:SET &HND# = PREP_PROCESS_COMMENTS()
:PROCESS &HND#
: SET &USER# = GET_PROCESS_LINE(&HND#,2)
: SET &TEXT# = GET_PROCESS_LINE(&HND#,3)
: PRINT "&USER#: &TEXT#"
:ENDPROCESS
:CLOSE_PROCESS &HND#
Im zweiten Beispiel werden nur die Einträge von Hrn. Meier gelesen und samt Zeitstempel ausgegeben.
:SET &HND# = PREP_PROCESS_COMMENTS(,,"SMITH/AE")
:PROCESS &HND#
: SET &TIME# = GET_PROCESS_LINE(&HND#,1)
: SET &TEXT# = GET_PROCESS_LINE(&HND#,3)
: PRINT "&TIME#: &TEXT#"
:ENDPROCESS
:CLOSE_PROCESS &HND#
Im dritten Beispiel wird die Script-Funktion aus einer anderen Aufgabe aufgerufen. Die RunID wurde daher angegeben. Als Ergebnis werden alle Kommentartexte geliefert, die das Wort "Datei" enthalten.
:SET &RunID = GET_UC_OBJECT_NR(MM.RETRIEVE.FILES)
:SET &HND# = PREP_PROCESS_COMMENTS(&RunID,"*file*")
:PROCESS &HND#
: SET &TEXT# = GET_PROCESS_LINE(&HND#,3)
: PRINT "Comment: &TEXT#"
:ENDPROCESS
:CLOSE_PROCESS &HND#
Siehe auch:
| Script-Sprachmittel | Beschreibung |
|---|---|
|
Fügt einer Aufgabe einen Kommentar hinzu. |
|
|
Verwirft eine Datensequenz innerhalb eines Scripts. |
|
|
Definition einer Schleife zur zeilenweisen Bearbeitung einer Datensequenz, wie beispielsweise den Inhalt einer sequentiellen Datei oder das textmäßige Ergebnis eines Kommandos. |
|
|
Ermittelt den aktuellen Zeileninhalt einer Datensequenz. |
Script-Sprachmittel - Datensequenzen
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 |