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.
Syntax
PREP_PROCESS_COMMENTS ([RUN#] [,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. |
|
User |
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 |
|---|
|
Verweis 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 der Verweis auf eine Datensequenz. Diese 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.
Beispiele
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#
Das zweite Beispiel liest nur die Einträge von Herrn Smith und druckt sie inklusive des Zeitstempels aus.
: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#
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: