GET_PUBLISHED_VALUE

Verwenden Sie die Script-Funktion GET_PUBLISHED_VALUE, um den Wert einer Objektvariablen oder einer PromptSet-Variablen aus einer Aufgabe abzurufen.

Kombinieren Sie GET_PUBLISHED_VALUE mit :SET, um die folgenden Werte zu lesen:

• Objektvariable
• PromptSet-Variable
• Einzelnes Element in einem PromptSet-Array

Kombinieren Sie GET_PUBLISHED_VALUE mit :FILL, um ein vollständiges PromptSet-Array zu lesen.

Mehr Informationen:

• Seite "Variablen"
• PromptSets (PRPT)
• :SET
• :FILL
• Arrays

Syntax

GET_PUBLISHED_VALUE (RunID, Variablenname)

Parameter

• GET_PUBLISHED_VALUE
  Ruft einen Wert aus einer Aufgabe ab

• RunID
  RunID der Aufgabe
  Format: Script-Literal oder Script-Variable

• Variablenname
  Name der abzurufenden Objektvariablen oder der PromptSet-Variablen ohne das vorangestellte kaufmännische Und-Zeichen (&)
  Format:AE Name
  Hinweis:Sie können Arrays aus PromptSet-Elementen für Checklisten und Kontrollkästchen abrufen. Fügen Sie beim Abrufen eines Arrays leere eckige Klammern ([]) am Ende des Variablennamens ein.

Beispiele

Im folgenden Beispiel wird ein Objekt aktiviert und die Objektvariable &VARIABLE1# in der aktivierten Aufgabe gelesen.

:SET &RUNID# = ACTIVATE_UC_OBJECT(&OBJ#,WAIT)
:SET &VAR# = GET_PUBLISHED_VALUE(&RUNID#,VARIABLE1#)
:PRINT "&&VARIABLE1# = &VAR#"

Das folgende Beispiel liest die PromptSet-Variable &CHECKLIST1# aus, die als Array definiert wurde. Das Script ruft nur den Wert des ersten Array-Elements ab.

:SET &RUNID# = ACTIVATE_UC_OBJECT(&OBJ#,WAIT)
:SET &VAR# = GET_PUBLISHED_VALUE(&RUNID#,"CHECKLIST1#[1]")
:PRINT "&&CHECKLIST1#[1] = &VAR#" 

Im folgenden Beispiel wird das vollständige PromptSet-Array aus der aktivierten Aufgabe abgerufen. Das Script gibt die PromptSet-Werte im Aktivierungsreport aus. Übersteigt das PromptSet-Array die Größe des Script-Arrays, werden nur die Elemente gespeichert, für die Platz ist.

:DEFINE &ARRAY#, string, 10
:SET &RUNID# = ACTIVATE_UC_OBJECT(&OBJ#,WAIT)
:FILL &ARRAY#[] = GET_PUBLISHED_VALUE(&RUNID#,"CHECKLIST1#[]")
:SET &LEN# = LENGTH(&ARRAY#[])
:SET &VAR# = 1

:WHILE &VAR# LE &LEN#
:PRINT "&&ARRAY#[&VAR#] = &ARRAY#[&VAR#]"
:SET &VAR# = &VAR# + 1
:ENDWHILE

Siehe auch: