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
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 "foo" fooValue = sessionObj.NameValue("foo") ' Set the new value of "foo" sessionObj.NameValue "foo",bar
Perl
$sessionObj = $entity->GetSession(); if ($sessionObj->HasValue("foo")) { # Get the old value of the session variable "foo" $fooValue = $sessionObj->GetNameValue("foo"); # Set the new value of "foo" $sessionObj->SetNameValue("foo","bar");