주어진 변수 이름과 연관된 값을 설정하거나 리턴합니다.
이 특성을 사용하여 세션 전체에 적용되는 변수에 대한 값을 가져오거나 설정합니다. 이 특성은 값의 배열로 구성되기 때문에 관심 있는 변수의 이름을 지정해야 합니다. 존재하지 않는 변수의 값을 설정한 경우, 해당 변수에 지정된 값을 사용하여 작성됩니다. 존재하지 않는 변수의 값을 가져오려고 시도하면 빈 Variant가 리턴됩니다(Visual Basic의 경우).
IBM Rational ClearQuest는 정보 저장을 위해 세션 전체 변수 사용을 지원합니다. 작성된 뒤에는, 언제라도 현재 Session 오브젝트을 통하거나 Session 오브젝트에 액세스 권한이 있는 후크 루틴을 포함한 함수 또는 서브루틴에서 세션 전체 변수에 액세스할 수 있습니다. 사용자라 로그아웃했거나 Session 오브젝트를 삭제하여 현재 세션이 종료되면 해당 Session 오브젝트와 연관된 모든 변수가 삭제됩니다. 세션 전체 변수는 NameValue 특성(Perl의 경우 GetNameValue 및 SetNameValue 메소드)를 통해 액세스됩니다. 또한 HasValue 메소드를 사용하여 변수의 존재 여부를 확인할 수 있습니다.
예를 들어 Rational® ClearQuest® 세션에 웹 세션 또는 전체 클라이언트 세션인 경우 지정되는 _CQ_WEB_SESSION 세션 변수가 있습니다. _CQ_WEB_SESSION이 있는 경우 세션은 웹 세션입니다. HasValue 메소드를 사용하여 이 값을 확인할 수 있습니다.
오브젝트를 세션 변수로 저장할 수도 있습니다. 예를 들어, 다음과 같습니다.
set sessionObj.NameValue "Obj", object
set sessionObj.NameValue "CalendarHandle", param.ObjectItem
위 예제에서 param은 레코드 스크립트 후크에 대한 매개변수이고 오브젝트 핸들을 포함합니다.
그런 다음 프로젝트의 특성을 조작할 수 있습니다. 예를 들어, 다음과 같습니다.
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);
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");