NameValue

Description

Establece o devuelve el valor asociado a un nombre de variable determinado.

Utilice esta propiedad para obtener y establecer los valores para las variables globales de sesión. Puesto que esta propiedad consta de una matriz de valores, debe especificar el nombre de la variable en la que está interesado. Si establece el valor de una variable que no existe, se crea con el valor especificado que se le ha asignado. Si intenta obtener el valor de una variable que no existe, se devuelve un valor Variant vacío (para Visual Basic).

IBM Rational ClearQuest admite la utilización de variables globales de sesión para almacenar información. Una vez creadas, puede acceder a estas variables a través del objeto Session actual en cualquier momento y desde funciones o subrutinas, incluidas rutinas de enganche, que tengan acceso al objeto Session. Cuando finaliza la sesión actual, debido a que el usuario ha finalizado la sesión o a que se ha suprimido el objeto Session, se suprimen todas las variables asociadas al objeto Session. Se accede a una variable global de sesión a través de la propiedad NameValue (métodos GetNameValue y SetNameValue para Perl). Además, se puede utilizar el método HasValue para comprobar si existe una variable.

Por ejemplo, existe una variable de sesión _CQ_WEB_SESSION que especifica si una sesión de Rational ClearQuest es una sesión web o una sesión de cliente completa. Si _CQ_WEB_SESSION existe, significa que se trata de una sesión web. Puede comprobar este valor utilizando el método HasValue.

También puede almacenar objetos como variables de sesión. Por ejemplo:

set sessionObj.NameValue "Obj", object

o

set sessionObj.NameValue "CalendarHandle", param.ObjectItem

En el ejemplo anterior, param es el parámetro de un enganche de script de registro y contiene un descriptor de contexto del objeto.

A continuación, en otra parte puede manipular las propiedades del objeto. Por ejemplo:

Dim Calender

'Obtener el descriptor de contexto del objeto

Set Calender = MySession.NameValue("CalendarHandle")

'Do something with the object ...

Sintaxis

VBScript

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

Perl

$session->GetNameValue(variable_name);
$session->SetNameValue(variable_name, newValue); 
Identificador
Description
session
El objeto Session que representa la sesión de acceso a la base de datos actual.
variable_name
Un valor String que contiene el nombre de la variable a obtener o establecer.
newValue
Para Visual Basic, un valor Variant que especifica el nuevo valor para la variable.

Para Perl, un valor String que especifica el nuevo valor para la variable.

Valor de retorno
Para Visual Basic, una referencia a una valor Variant que contiene el valor de la variable.

Para Perl, un valor String que contiene el valor de la variable.

Ejemplo

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

Comentarios