intra-mart Accel Platform IM-共通マスタ スマートフォン 検索画面仕様書 第5版 2018-04-01

5.2.2. ユーザ検索(組織)タブ

ユーザ検索(組織)タブでは、組織を階層で表示し、選択した組織/組織・役職に所属するユーザを検索します。

5.2.2.1. 画面構成

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

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

分類 項目 備考
階層一覧   該当する組織を一覧表示する。
追加条件   選択した組織から役職検索を実行した結果を表示する。
検索結果一覧   選択した組織/役職からユーザ検索を実行した結果を表示する。

【表:ユーザ検索(組織)タブ 画面項目】

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

ユーザ検索(組織)タブで発生する画面イベントと検索処理の関連は以下のとおりです。
イベント 検索処理
画面起動時 起動引数より、組織検索を実行する。
組織(会社)展開時 選択された組織(会社)より、配下の組織検索を実行する。
組織(会社)押下時 選択された組織(会社)より、配下の組織検索、役職検索、ユーザ検索を実行する。
役職選択時 選択された役職より、ユーザ検索を実行する。

【ユーザ検索(組織)タブ 画面イベントと検索処理】

5.2.2.2.1. 画面イベント「組織押下時」の補足

組織を押下すると、配下の組織検索、役職検索、ユーザ検索が実行されますが、選択した組織が会社であった場合、「暗黙条件:組織表示設定」により動作が異なります。
  • 組織表示設定がhideの場合
    会社を押下すると、特定の組織セットに紐付く役職、ユーザを検索します。
    このとき、組織セットの特定方法は、以下の優先順位に従い決定します。
    1. 暗黙条件:組織 で指定した組織セット
    2. 組織セット表示設定のlistで指定した組織セット
    3. デフォルト組織セット
  • 組織表示設定がdisplay、allの場合
    会社を押下しても役職、ユーザを検索は行いません。
    配下組織の展開結果に表示された組織セットを選択すると、役職検索、ユーザ検索を実行します。

5.2.2.2.2. 組織検索に関する補足(認可)

ユーザ検索、組織検索では、ログインユーザごとに認可による会社の絞り込みが行われます。
検索結果には、ログインユーザが参照できる会社に所属しているユーザ、組織が表示されます。

コラム

暗黙条件にログインユーザが認可されていない会社が指定されている場合、それを除いて検索します。

5.2.2.3. 起動時のパラメータ

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

5.2.2.3.1. 画面構築基盤用

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

5.2.2.3.2. 共通パラメータ

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

5.2.2.3.3. 準共通パラメータ

タブ毎に、取得するテーブルのカラム名を設定します。
パラメータの詳細は「準共通パラメータ 」参照してください。

コラム

ユーザ検索(組織)タブでは IMM_USER テーブルのカラムを取得可能です。

5.2.2.3.4. ユーザ検索固有

ユーザ検索時にのみ必要となる引数です。
  • 主所属による絞り込み
    検索対象を、主所属組織が設定されたユーザのみとするかを設定します。
プロパティ名 必須 初期値 備考
department_main_only Boolean × true
true : 主所属のみを表示
false: 主所属以外も含めて表示

5.2.2.3.5. 暗黙条件

ユーザ検索(組織)タブで検索を行う際に、ユーザ操作とは別に指定する条件です。
検索結果はこの暗黙条件の範囲で自動的に絞り込まれます。
  • 組織セット表示設定
    会社毎に表示する組織セットを設定します。
    表示する組織セットは会社毎にデフォルト組織セットリストで指定することができ、組織セット名の表示/非表示を選択できます。
    認可設定で許可された会社のみ有効です。
プロパティ名 必須 初期値 備考
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" : 組織セットコード} , ... ]
    }
}

  • 会社
    組織検索時、ユーザ検索時に指定の会社で絞り込みます。
    ただし、組織リストまたは組織を設定している場合、会社は利用されません。
    認可設定で許可された会社のみ有効です。
プロパティ名 必須 初期値 備考
company   Array × -  
配列インデックス   Object × -  
company_cd String -  
1
2
3
"criteria" : {
    "company" : [ { "company_cd" : 会社コード } , { "company_cd" :  会社コード } , ... ]
}

  • 組織リスト
    組織検索時、役職検索時、ユーザ検索時に指定の会社と組織の組み合わせで絞り込みます。
    ただし、1つの会社に複数の組織を指定することはできません。
    認可設定で許可された会社のみ有効です。
プロパティ名 必須 初期値 備考
department_set_list   Array × -  
配列インデックス   Object × -  
company_cd String -  
department_set_cd String -  
department   Object × -  
department_cd String -  
compare String × le gt、ge、lt、leのいずれか
post   Object × -  
post_cd String -  
compare String × le gt、ge、eq、lt、leのいずれか
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
"criteria" : {
    "department_set_list" : [ {
        "company_cd" : 会社コード,
        "department_set_cd" : 組織セットコード,
        "department" : {
            "department_cd" : 組織コード,
            "compare" : "le"
        },
        "post" : {
            "post_cd" : 役職コード,
            "compare" : "le"
        }
    }, ...]
}

  • 組織
    組織検索時、ユーザ検索時に指定の組織で絞り込みます。
    ただし、組織リストが指定されている場合は、組織リスト指定が優先されます。
    認可設定で許可された会社のみ有効です。
プロパティ名 必須 初期値 備考
department_set   Object × -  
company_cd String -  
department_set_cd String -  
department   Object × -  
department_cd String -  
compare String × le gt、ge、lt、leのいずれか
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
"criteria" : {
    "department_set" : {
        "company_cd" : 会社コード,
        "department_set_cd" : 組織セットコード,
        "department" : {
            "department_cd" : 組織コード,
            "compare" : "le"
        }
    }
}

  • 組織役職
    役職検索時、ユーザ検索時に指定の役職で絞り込みます。
    ただし、組織リストが指定されている場合は、組織リスト指定が優先されます。
    認可設定で許可された会社のみ有効です。
プロパティ名 必須 初期値 備考
department_set   Object × -  
company_cd String -  
department_set_cd String -  
department   Object × -  
department_cd String -  
compare String × le gt、ge、lt、leのいずれか
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
"criteria" : {
    "department_set" : {
        "company_cd" : 会社コード,
        "department_set_cd" : 組織セットコード,
        "post" : {
            "post_cd" : 役職コード,
            "compare" : "le"
        }
    }
}

  • 組織分類項目
    組織検索時、ユーザ検索時に指定の組織分類項目を持つ組織で絞り込みます。
    認可設定で許可された会社のみ有効です。
プロパティ名 必須 初期値 備考
dept_ctg_item   Array × -  
配列インデックス   Object × -  
company_cd String -  
category_cd String -  
category_item_cd   Array -  
配列インデックス String -  
1
2
3
4
5
6
"criteria" : {
    "dept_ctg_item" :
    [ { "company_cd" : 会社コード,
        "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.2.4. システムパラメータ

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

5.2.2.4.1. 大量データモード

大量データモードとは、全件検索やあいまい検索などレスポンス悪化を招く検索を制限するためのものです。
具体的には、大量データモードを使用すると以下の制約が発生します。
  • 組織階層の移動ごとに検索します。
  • ユーザ検索時に表示数制限(ユーザ)を超えたデータの取得ができません。

5.2.2.4.1.1. 設定ファイル

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

5.2.2.4.1.2. 設定パラメータ

以下に大量データモードに関するパラメータについて説明します。
  • 大量データモード設定
    ユーザ検索(組織)タブで大量データモードを使用するかどうかの設定です。
設定ファイル <(展開したwar)/WEB-INF/plugin/ jp.co.intra_mart.im_master.app.search.tabs.user.department.tree_with_list.smartphone_8.0.0 /plugin.xml >
要素 <plugin>/<extension>/<search>/<content>
属性

large_data_mode。下記のいずれか

  • true : 大量データモードを使用する場合
  • false:大量データモードを使用しない場合

  • 大量データモード表示数制限(ユーザ)
    ユーザ検索で大量データモードが設定されている場合、ユーザ情報の最大取得件数の設定です。
設定ファイル <(展開したwar)/WEB-INF/conf/im-master-config.xml>
要素 <im-master-config>/<sp-large-data-mode>/<user>/<limit>
任意の数値

5.2.2.5. 検索結果の返却

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