現在のフックがすべてのレコードを表示するか、現在のユーザーが表示を許可されているレコードのみを表示するかを指定します。
スキーマ開発者がレコードに対するフックの可視性をフックごとに制御できるようにします。Set 関数は、現在実行中のフックのみの期間中の可視性を指定します。
このメソッドを True (1) に設定すると、現在のフックがクエリーの実行時にすべてのレコードを表示することが指定されます。False (0) は、現在のフックが、クエリーの実行時に (セッション中のユーザーの実際のユーザー権限に基づいて) 現在のユーザーが表示を許可されているレコードのみを表示することを意味します。
$session->SetHookSeesAllRecords(0);
$session->SetHookSeesAllRecords(1);
スキーマ開発者は、HOOKS_SEE_ALL_USERS および HOOKS_SEE_ALL_RECORDS マスター データベースのプロパティを使用することにより、使用中のデータベース内のすべてのフックにデフォルトの可視性を構成できます。機能レベル 5 および 6 では、 これらのプロパティのデフォルト値は True (1) です。機能レベル 7 では、デフォルト値は False (0) です。CLI コマンドについては、「Rational ClearQuest コマンド リファレンス」を参照してください。
VBScript
user_restr = session.SetHookSeesAllRecords set_vis
Perl
session->SetHookSeesAllRecords(set_vis);
VBScript
sub project_ChoiceList(fieldname, choices)
' fieldname As String
' choices As Object
' record type name is Defect
' field name is project
set session = GetSession
dim curHookSeesAllRecords
' Store current session "Context"
curHookSeesAllRecords = session.GetHookSeesAllRecords()
' set session context to "User Context"
session.SetHookSeesAllRecords(0)
set querydef = session.BuildQuery("project")
querydef.BuildField("name")
set resultset = session.BuildResultSet(querydef)
resultset.Execute
status =resultset.MoveNext
Do While status = AD_SUCCESS
choices.AddItem resultSetObj.GetColumnValue(1)
Loop
' revert to original session "Context"
session.SetHookSeesAllRecords( curHookSeesAllRecords )
End Sub
Perl
sub project_ChoiceList
{
my($fieldname) = @_;
my @choices;
# $fieldname as string scalar
# @choices as string array
# record type name is Defect
# field name is Project
my $session = $entity->GetSession();
my ($curHookSessAllRecords);
# store current "Context"
$curHookSessAllRecords=$session->GetHookSeesAllRecords();
# set to "User Context"
$session->SetHookSeesAllRecords(0);
my ($queryDefObj, $resultSetObj);
$queryDefObj = $session->BuildQuery("Project");
# have the query return the desired
# field of the user object(s)
$queryDefObj->BuildField("Name");
$resultSetObj = $session->BuildResultSet($queryDefObj);
# run it
$resultSetObj->Execute();
# add each value in the returned column to the choicelist
while
($resultSetObj->MoveNext() == $CQPerlExt::CQ_SUCCESS) {
push(@choices,$resultSetObj->GetColumnValue(1));
}
# revert to original session "Context"
$session->SetHookSeesAllRecords($curHookSessAllRecords);
return @choices;
}