SetHookSeesAllRecords

説明

現在のフックがすべてのレコードを表示するか、現在のユーザーが表示を許可されているレコードのみを表示するかを指定します。

スキーマ開発者がレコードに対するフックの可視性をフックごとに制御できるようにします。Set 関数は、現在実行中のフックのみの期間中の可視性を指定します。

このメソッドを True (1) に設定すると、現在のフックがクエリーの実行時にすべてのレコードを表示することが指定されます。False (0) は、現在のフックが、クエリーの実行時に (セッション中のユーザーの実際のユーザー権限に基づいて) 現在のユーザーが表示を許可されているレコードのみを表示することを意味します。

例えば、フックのデフォルトの動作が、すべてのレコードを表示するわけではないというものである場合は、次の行のようになります。
  • 何の影響も及ぼさない
    $session->SetHookSeesAllRecords(0);
  • フックが必ずすべてのレコードを表示する
    $session->SetHookSeesAllRecords(1);

スキーマ開発者は、HOOKS_SEE_ALL_USERS および HOOKS_SEE_ALL_RECORDS マスター データベースのプロパティを使用することにより、使用中のデータベース内のすべてのフックにデフォルトの可視性を構成できます。バージョン 7.1 (機能レベル 5 および 6) より前のバージョンでは、これらのプロパティのデフォルト値は True (1) です。バージョン 7.1 (機能レベル 7) では、デフォルト値は False (0) です。CLI コマンドについては、CLI のリファレンス ページを参照してください。

注: このメソッドは、バージョン 7.1 で使用可能になります。

構文

VBScript

user_restr = session.SetHookSeesAllRecords set_vis 

Perl

session->SetHookSeesAllRecords(set_vis); 
識別子
説明
session
現在のデータベース アクセス セッションを表す Session オブジェクト。
set_vis
現在のフックがすべてのレコードを表示するか、現在のユーザーが表示を許可されているレコードのみを表示するかを指定する Boolean。True は、現在のフックがレコード クエリーの実行時にすべてのレコードを表示することを指定します。False は、現在のフックが、レコード クエリーの実行時に現在のユーザーが表示を許可されているレコードのみを表示できることを指定します。
戻り値
なし。

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;
}

フィードバック