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

5.2.8. ユーザ検索(ロール)タブ

ユーザ検索(ロール)タブでは、ロールをキーワード検索し、選択したロールを持つユーザを検索します。

5.2.8.1. 画面構成

ユーザ検索(ロール)タブの画面表示は以下のとおりです。
../../../_images/user_s_role.png

【図:ユーザ検索(ロール)タブ 画面表示】

【表:ユーザ検索(ロール)タブ 画面項目】
分類 項目 備考
キーワード検索








カテゴリ
ロールカテゴリをリスト表示します。
キーワード
検索する文字列。
検索対象

検索対象のカラム。
『ロール名』、『ロールID』、『表示名』から選択。
検索方式

検索マッチパターン。
『前方一致』、『完全一致』、『部分一致』から選択。
ロール一覧

キーワードよりロール検索を実行した結果を表示します。
ユーザ一覧

選択したロールよりユーザ検索を実行した結果を表示します。

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

ユーザ検索(ロール)タブで発生する画面イベントと検索処理の関連は以下のとおりです。
【表:ユーザ検索(ロール)タブ 画面イベントと検索処理】
イベント 検索処理
画面起動時 ロールカテゴリを取得します。
検索ボタン押下時 入力されたカテゴリ、キーワード、検索対象、検索方式よりロール検索を実行します。
ロール押下時 選択されたロールよりユーザ検索を実行する。
ユーザ欄マウスホバー時 マウスが重なっているユーザについての詳細情報を取得し、ツールチップに表示します。

5.2.8.3. 起動時のパラメータ

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

5.2.8.3.1. 画面構築基盤用

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

5.2.8.3.2. 共通パラメータ

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

5.2.8.3.3. 準共通パラメータ

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

5.2.8.3.4. ユーザ検索固有

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

5.2.8.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 すべての組織セット名を表示します。 デフォルト組織セットリストを指定することはできません。指定した場合は無視されます。

コラム

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

  • ユーザ分類項目
    ユーザ検索時に指定のユーザ分類項目で絞り込みます。
プロパティ名 必須 初期値 備考
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.8.4. システムパラメータ

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

5.2.8.4.1. 大量データモード

大量データモードとは、全件検索やあいまい検索などレスポンス悪化を招く検索を制限するためのものです。具体的には、大量データモードを使用すると以下の制約が発生します。
  • キーワードの入力が必須です。つまり、全件検索はできません。
  • キーワード検索対象は、「コード」、「名前」、「検索名」のいずれかです。
  • キーワード検索条件は「完全一致」、「前方一致」のどちらか一つしか選択できません。
  • ロール検索時に表示数制限(ロール)を超えたデータの取得ができません。
  • ユーザ検索時に表示数制限(ユーザ)を超えたデータの取得ができません。

5.2.8.4.1.1. 設定ファイル

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

5.2.8.4.1.2. 設定パラメータ

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

enabled。下記のいずれか

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

enabled。下記のいずれか

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

5.2.8.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)