Imposta o restituisce il valore associato a un determinato nome della variabile.
Utilizzare questa proprietà per ottenere e impostare i valori per le variabili valide per tutta la sessione. Poiché questa proprietà è composta da un array di valori, è necessario specificare il nome della variabile a cui si è interessati. Se si imposta il valore di una variabile che non esiste, viene creato con il valore assegnato a esso. Se si tenta di ottenere il valore di una variabile che non esiste, viene restituito un valore Variant vuoto (per Visual Basic).
IBM® Rational ClearQuest supporta l'utilizzo delle variabili valide per tutta la sessione per memorizzare le informazioni. Una volta creato, è possibile accedere alle variabili valide per tutta la sessione tramite l'oggetto Session corrente in qualsiasi momento e dalle funzioni o dalle routine secondarie, incluse le routine hook, che dispongono dell'accesso all'oggetto Session. Quando termina la sessione corrente, poiché l'utente si è disconnesso oppure o stato eliminato l'oggetto Session, tutte le variabili associate all'oggetto Session vengono eliminate. Si accede a una variabile valida per tutta la sessione tramite la proprietà NameValue (metodi GetNameValue e SetNameValue per Perl). Inoltre, è possibile utilizzare il metodo HasValue per verificare se esiste una variabile.
Ad esempio, esiste una variabile session _CQ_WEB_SESSION che specifica se una sessione Rational ClearQuest è una sessione Web o una sessione client completa. Se _CQ_WEB_SESSION esiste, allora la sessione è una sessione Web. È possibile eseguire la verifica per questo valore utilizzando il metodo HasValue.
Inoltre, è possibile memorizzare gli oggetti come variabili Session. Ad esempio:
set sessionObj.NameValue "Obj", object
o
set sessionObj.NameValue "CalendarHandle", param.ObjectItem
Nell'esempio precedente, param è il parametro su una funzione hook di script di record e contiene uno strumento di gestione oggetto.
Altrove, è quindi possibile manipolare le proprietà dell'oggetto. Ad esempio:
Dim Calender
'Get the object handle
Set Calender = MySession.NameValue("CalendarHandle")
'Do something with the object ...
VBScript
session.NameValue (variable_name)
session.NameValue variable_name, newValue
Perl
$session->GetNameValue(variable_name);
$session->SetNameValue(variable_name, newValue);
Per Perl, una stringa che specifica il nuovo valore per la variabile.
Per Perl, una stringa che contiene il valore per la variabile.
VBScript
set sessionObj = GetSession
' Get the old value of the session variable "test"
testValue = sessionObj.NameValue("test")
' Set the new value of "test"
sessionObj.NameValue "test",bar
Perl
$sessionObj = $entity->GetSession();
if ($sessionObj->HasValue("test")) {
# Get the old value of the session variable "test"
$testValue = $sessionObj->GetNameValue("test");
# Set the new value of "test"
$sessionObj->SetNameValue("test","bar");