NameValue

Descrizione

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

oppure

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 ...

Sintassi

VBScript

session.NameValue (variable_name)
session.NameValue variable_name, newValue 

Perl

$session->GetNameValue(variable_name);
$session->SetNameValue(variable_name, newValue); 
Identificativo
Descrizione
session
L'oggetto Session che rappresenta la sessione di accesso al database corrente.
variable_name
Una stringa che contiene il nome della variabile da ottenere o impostare.
newValue
Per Visual Basic, un valore Variant che specifica il nuovo valore per la variabile.

Per Perl, una stringa che specifica il nuovo valore per la variabile.

Valore di ritorno
Per Visual Basic, un riferimento a un valore Variant che contiene il valore per la variabile.

Per Perl, una stringa che contiene il valore per la variabile.

Esempio

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"); 

Feedback