주어진 변수 이름과 연관된 값을 설정하거나 리턴합니다.
이 특성을 사용하여 세션 전체에 적용되는 변수에 대한 값을 가져오거나 설정합니다. 이 특성은 값의 배열로 구성되기 때문에 관심 있는 변수의 이름을 지정해야 합니다. 존재하지 않는 변수의 값을 설정한 경우, 해당 변수에 지정된 값을 사용하여 작성됩니다. 존재하지 않는 변수의 값을 가져오려고 시도하면 빈 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);
Perl의 경우 변수에 대한 새 값을 지정하는 문자열입니다.
Perl의 경우 변수에 대한 값이 포함된 문자열을 리턴합니다.
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");