intra-mart Accel Platform IM-共通マスタ 検索画面仕様書 第9版 2021-04-01

5.2.6. ユーザ検索(パブリックグループ(ツリー))タブ

ユーザ検索(パブリックグループ(ツリー))タブでは、パブリックグループをツリー表示し、選択したパブリックグループ/パブリックグループ・役割に所属するユーザを検索します。

5.2.6.1. 画面構成

ユーザ検索(パブリックグループ(ツリー))タブの画面表示は以下のとおりです。
../../../_images/user_s_public_group_tr.png

【図:ユーザ検索(パブリックグループ(ツリー)) 画面表示】


【表:ユーザ検索(パブリックグループ(ツリー)) 画面項目】
分類 項目 備考
ユーザ絞り込み条件
配下のグループに所属するユーザを含める
選択したパブリックグループの配下のグループに所属するユーザも取得する場合、チェックを入れます。
ユーザ情報の再検索が実行されます。
パブリックグループツリー

該当するパブリックグループ検索をツリー表示します。
役割一覧

選択したパブリックグループから役割検索を実行した結果を表示します。
ユーザ一覧

選択したパブリックグループ/役割からユーザ検索を実行した結果を表示します。

5.2.6.2. 画面イベントと検索処理

ユーザ検索(パブリックグループ(ツリー))タブで発生する画面イベントと検索処理の関連は以下のとおりです。
【表:ユーザ検索(パブリックグループ(ツリー))タブ 画面イベントと検索処理】
イベント 検索処理
画面起動時
起動引数より、パブリックグループ検索を実行します。
パブリックグループ展開時
選択されたパブリックグループより、配下のパブリックグループ検索を実行します。
パブリックグループ押下時
選択されたパブリックグループより、配下のパブリックグループ検索、役割検索、ユーザ検索を実行します。
役割押下時
選択された役割より、ユーザ検索を実行します。
「配下のグループに所属するユーザを含める」押下時
チェックがある場合、選択されたパブリックグループの配下のパブリックグループに所属するユーザを含め検索します。
チェックがない場合、選択されたパブリックグループに所属するユーザのみ検索します。
ユーザ欄マウスホバー時
マウスが重なっているユーザについての詳細情報を取得し、ツールチップに表示します。

5.2.6.3. 起動時のパラメータ

起動時のパラメータ設定により表示や検索条件を変更することができます。
ユーザ検索(パブリックグループ(ツリー))タブで指定可能なパラメータについて列挙します。

5.2.6.3.1. 画面構築基盤用

共通検索画面の外枠をなす画面構築基盤への引数です。
主に画面表示時のタイトルラベルや、検索後、選択決定時のウィンドウの挙動などに関する設定をします。
パラメータの詳細は「画面構築基盤用 」を参照してください。

5.2.6.3.2. 共通パラメータ

検索の基本条件となる引数です。
検索基準日、検索対象ロケール、削除されたデータの取得有無に関する設定をします。
パラメータの詳細は「共通パラメータ 」を参照してください。

5.2.6.3.3. 準共通パラメータ

タブ毎に、取得するテーブルのカラム名を設定します。
パラメータの詳細は「準共通パラメータ 」参照してください。
ユーザ検索(パブリックグループ(ツリー))タブではIMM_USERテーブルのカラムを取得可能です。

5.2.6.3.4. ユーザ検索固有

ユーザ検索時にのみ必要となる引数です。
  • 補足情報の表示
    ユーザ一覧にて、ツールチップにユーザの補足情報を表示するかどうかを設定します。
プロパティ名 必須 初期値 備考
additional_disp Boolean × true
  • true :補足情報表示
  • false:補足情報を表示しない
  • 検索名表示
    補足情報にユーザの検索名を表示するかどうかを設定します。
プロパティ名 必須 初期値 備考
additional_user_search_name Boolean × false
  • true :検索名を表示
  • false:検索名を表示しない
  • 所属表示
    補足情報に主所属している組織のみ表示するかどうかを設定します。
プロパティ名 必須 初期値 備考
additional_dept Boolean × false
  • true :主所属の組織のみ表示
  • false:全ての所属組織を表示

5.2.6.3.5. 暗黙条件

ユーザ検索(パブリックグループ(ツリー))タブで検索を行う際に、ユーザ操作とは別に指定する条件です。
検索結果はこの暗黙条件の範囲で自動的に絞り込まれます。
  • 組織セット表示設定
    会社毎に表示する組織セットを設定します。
    表示する組織セットは会社毎にデフォルト組織セットリストで指定することができ、組織セット名の表示/非表示を選択できます。
    デフォルト組織セットリストには、会社1つにつき1つの組織セットを指定することができます。
    ツールチップ表示に利用します。
プロパティ名 必須 初期値 備考
department_set_disp   Object × -  
type String hide hide、display、allのいずれか
list   Array × -  
配列インデックス   Object × -  
company_cd String -  
department_set_cd String -  
1
2
3
4
5
6
"criteria" : {
    "department_set_disp" : {
        "type" : "hide",
        "list" : [ {"company_cd" : 会社コード, "department_set_cd" : 組織セットコード} , ...
    }
}

  • 組織セット表示設定のタイプ(department_set_disp.type)
    組織セット表示設定のタイプには、hide、display、allのいずれかを指定可能です。これら以外を指定した場合は、規定値である hide が指定されたものとして処理されます。
    タイプ 説明
    hide 組織セット名を非表示にします。 デフォルト組織セットリストには、1つの会社に対して1つの組織セットのみを指定することができます。
    display 組織セット名を表示します。 デフォルト組織セットリストには、1つの会社に対して1つの組織セットのみを指定することができます。
    all すべての組織セット名を表示します。 デフォルト組織セットリストを指定することはできません。指定した場合は無視されます。

コラム

詳しくは「 組織セットの表示について 」を参照してください。

  • パブリックグループ
    パブリックグループ検索時、ユーザ検索時に指定のパブリックグループで絞り込みます。
プロパティ名 必須 初期値 備考
public_group_set   Object × -  
public_group_set_cd String -  
public_group   Object × -  
public_group_cd String -  
compare String × le gt、ge、lt、leのいずれか
1
2
3
4
5
6
7
8
9
"criteria" : {
    "public_group_set" : {
        "public_group_set_cd" : パブリックグループセットコード,
        "public_group" : {
            "public_group_cd" : パブリックグループコード,
            "compare" : "le"
        }
    }
}

  • パブリックグループ役割
    役割検索時、ユーザ検索時に指定の役割で絞り込みます。
プロパティ名 必須 初期値 備考
public_group_set   Object × -  
public_group_set_cd String -  
public_group_role   Object × -  
role_cd String -  
compare String × le gt、ge、eq、lt、leのいずれか
1
2
3
4
5
6
7
8
9
"criteria" : {
    "public_group_set" : {
        "public_group_set_cd" : パブリックグループセットコード,
        "public_group_role" : {
            "role_cd" : 役割コード,
            "compare" : "le"
        }
    }
}

  • パブリックグループ分類項目
    パブリックグループ検索時、ユーザ検索時に指定のパブリック分類項目を持つパブリックグループで絞り込みます。
プロパティ名 必須 初期値 備考
public_group_ctg_item   Array × -  
配列インデックス   Object × -  
category_cd String -  
category_item_cd   Array -  
配列インデックス String -  
1
2
3
4
5
"criteria" : {
    "public_group_ctg_item" :
        [{ "category_cd" : パブリックグループ分類コード,
           "category_item_cd" : [ パブリックグループ分類項目コード, ...]} , ... ]
}

  • ユーザ分類項目
    ユーザ検索時に指定のユーザ分類項目で絞り込みます。
プロパティ名 必須 初期値 備考
user_ctg_item   Array × -  
配列インデックス   Object × -  
category_cd String -  
category_item_cd   Array -  
配列インデックス String -  
1
2
3
4
5
"criteria" : {
    "user_ctg_item" :
        [{ "category_cd" : ユーザ分類コード,
           "category_item_cd" : [ ユーザ分類項目コード, ... ]} , ...]
}

  • ロール
    ユーザ検索時に指定のロールで絞り込みます。
プロパティ名 必須 初期値 備考
role String × -  
1
2
3
"criteria" : {
    role" : ロールID
}

5.2.6.4. システムパラメータ

起動時のパラメータでは指定できない、システム共通のパラメータについて説明します。

5.2.6.4.1. 大量データモード

大量データモードとは、全件検索やあいまい検索などレスポンス悪化を招く検索を制限するためのものです。
具体的には、大量データモードを使用すると以下の制約が発生します。
  • パブリックグループツリー展開は、配下一段ごとに検索します。
  • ユーザ検索時に表示数制限(ユーザ)を超えたデータの取得ができません。

5.2.6.4.1.1. 設定ファイル

  • 設定は、<(展開したwar)/WEB-INF/conf/im-master-config.xml> に定義します。
  • このファイルは、パラメータ名とそれに対する値を定義する汎用的な定義ファイルです。
  • 設定ファイルを変更した場合は、intra-mart Accel Platformを再起動しないと変更が反映されません。
    また、設定ファイルが存在しない場合、intra-martの正常な動作は保証できないので削除しないでください。

5.2.6.4.1.2. 設定パラメータ

以下に大量データモードに関するパラメータについて説明します。
  • 大量データモード設定(パブリックグループ)
    パブリックグループ検索で大量データモードを使用するかどうかの設定です。
要素 <im-master-config>/<large-data-mode>/<public-group>
属性

enabled。下記のいずれか

  • true :大量データモードを使用する場合
  • false:大量データモードを使用しない場合
  • 大量データモード設定(ユーザ)
    ユーザ検索で大量データモードを使用するかどうかの設定です。
要素 <im-master-config>/<large-data-mode>/<user>
属性

enabled。下記のいずれか

  • true :大量データモードを使用する場合
  • false:大量データモードを使用しない場合
  • 大量データモード表示数制限(ユーザ)
    ユーザ検索で大量データモードが設定されている場合、ユーザ情報の最大取得件数の設定です。
要素 <im-master-config>/<large-data-mode>/<user>/<limit>
任意の数値

5.2.6.5. 検索結果の返却

検索結果は、起動時のパラメータ callback_function で指定されたファクションの引数に渡されます。
ユーザ検索(パブリックグループ(ツリー))タブから返却されるオブジェクトは以下の形式です。
type
imm_user
keyFields
user_cd
displayName
ユーザ名
data
デフォルト取得項目(user_cd, user_name, delete_flag)の値
propで指定された項目の値
basic_info
検索時の基本情報(target_date, target_locale, deleted_data)