5.2.4. ユーザ検索(会社組織(ツリー))タブ¶
ユーザ検索(会社組織(ツリー))タブでは、組織をツリーで表示し、選択した組織/組織・役職に所属するユーザを検索します。
項目
5.2.4.1. 画面構成¶
ユーザ検索(会社組織(ツリー))タブの画面表示は以下のとおりです。
【図:ユーザ検索(会社組織(ツリー))タブ 画面項目】 分類 項目 備考 ユーザ絞り込み条件 配下の組織に所属するユーザを含める 選択した組織の配下の組織に所属するユーザも取得する場合、チェックを入れます。ユーザ情報の再検索が実行されます。 主所属のみ表示 選択した組織に主所属するユーザの未表示させる場合、チェックを入れます。ユーザ情報の再検索が実行されます。 組織ツリー 該当する組織をツリー表示します。 役職一覧 選択した組織から役職検索を実行した結果を表示します。 ユーザ一覧 選択した組織/役職からユーザ検索を実行した結果を表示します。
5.2.4.2. 画面イベントと検索処理¶
ユーザ検索(会社組織(ツリー))タブで発生する画面イベントと検索処理の関連は以下のとおりです。
【表:ユーザ検索(会社組織(ツリー))タブ 画面イベントと検索処理】 イベント 検索処理 画面起動時 起動引数より、組織検索を実行します。 組織(会社)展開時 選択された組織(会社)より、配下の組織検索を実行します。 組織(会社)押下時 選択された組織(会社)より、配下の組織検索、役職検索、ユーザ検索を実行します。 役職押下時 選択された役職より、ユーザ検索を実行します。 「配下の組織に所属するユーザを含める」押下時 チェックがある場合、選択された組織の配下の組織に所属するユーザを含め検索します。チェックがない場合、選択された組織に所属するユーザのみ検索します。 「主所属のみ表示」押下時 チェックがある場合、選択された組織に主所属するユーザを検索します。チェックがない場合、選択された組織に所属する全ユーザを検索します。 ユーザ欄マウスホバー時 マウスが重なっているユーザについての詳細情報を取得し、ツールチップに表示します。
5.2.4.2.1. 画面イベント「組織押下時」の補足¶
組織を押下すると、配下の組織検索、役職検索、ユーザ検索が実行されますが、選択した組織が会社であった場合、「暗黙条件:組織表示設定」により動作が異なります。
組織表示設定がhideの場合会社を押下すると、特定の組織セットに紐付く役職、ユーザを検索します。このとき、組織セットの特定方法は、以下の優先順位に従い決定します。
暗黙条件:組織 で指定した組織セット 組織セット表示設定のlistで指定した組織セット デフォルト組織セット 組織表示設定がdisplay、allの場合会社を押下しても役職、ユーザを検索は行いません。配下組織の展開結果に表示された組織セットを選択すると、役職検索、ユーザ検索を実行します。
5.2.4.2.2. 組織検索に関する補足(認可)¶
ユーザ検索、組織検索では、ログインユーザごとに認可による会社の絞り込みが行われます。検索結果には、ログインユーザが参照できる会社に所属しているユーザ、組織が表示されます。暗黙条件にログインユーザが認可されていない会社が指定されている場合、それを除いて検索します。
5.2.4.3. 起動時のパラメータ¶
起動時のパラメータ設定により表示や検索条件を変更できます。ユーザ検索(会社組織(ツリー))タブで指定可能なパラメータについて列挙します。
5.2.4.3.1. 画面構築基盤用¶
共通検索画面の外枠をなす画面構築基盤への引数です。主に画面表示時のタイトルラベルや、検索後、選択決定時のウィンドウの挙動などに関する設定をします。パラメータの詳細は「画面構築基盤用 」を参照してください。
5.2.4.3.3. 準共通パラメータ¶
タブ毎に、取得するテーブルのカラム名を設定します。パラメータの詳細は「準共通パラメータ 」参照してください。ユーザ検索(会社組織(ツリー))タブではIMM_USERテーブルのカラムを取得可能です。
5.2.4.3.4. ユーザ検索固有¶
ユーザ検索時にのみ必要となる引数です。
補足情報の表示ユーザ一覧にて、ツールチップにユーザの補足情報を表示するかどうかを設定します。
プロパティ名 型 必須 初期値 備考 additional_disp Boolean × true
- true :補足情報表示
- false:補足情報を表示しない
検索名表示補足情報にユーザの検索名を表示するかどうかを設定します。
プロパティ名 型 必須 初期値 備考 additional_user_search_name Boolean × false
- true :検索名を表示
- false:検索名を表示しない
所属表示補足情報に主所属している組織のみ表示するかどうかを設定します。
プロパティ名 型 必須 初期値 備考 additional_dept Boolean × false
- true :主所属の組織のみ表示
- false:全ての所属組織を表示
5.2.4.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 すべての組織セット名を表示します。 デフォルト組織セットリストを指定することはできません。指定した場合は無視されます。 コラム
詳しくは「 組織セットの表示について 」を参照してください。
会社組織検索時、ユーザ検索時に指定の会社で絞り込みます。ただし、組織リストまたは組織を設定している場合、会社は利用されません。認可設定で許可された会社のみ有効です。
プロパティ名 型 必須 初期値 備考 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 ○ - post Object × - post_cd String ○ - compare String × le gt、ge、eq、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.4.4. システムパラメータ¶
起動時のパラメータでは指定できない、システム共通のパラメータについて説明します。
5.2.4.4.1. 大量データモード¶
大量データモードとは、全件検索やあいまい検索などレスポンス悪化を招く検索を制限するためのものです。具体的には、大量データモードを使用すると以下の制約が発生します。
組織ツリー展開は、配下一段ごとに検索します。 ユーザ検索時に表示数制限(ユーザ)を超えたデータの取得ができません。
5.2.4.4.1.1. 設定ファイル¶
設定は、<(展開したwar)/WEB-INF/conf/im-master-config.xml> に定義します。 このファイルは、パラメータ名とそれに対する値を定義する汎用的な定義ファイルです。 設定ファイルを変更した場合は、intra-mart Accel Platformを再起動しないと変更が反映されません。また、設定ファイルが存在しない場合、intra-martの正常な動作は保証できないので削除しないでください。
5.2.4.4.1.2. 設定パラメータ¶
以下に大量データモードに関するパラメータについて説明します。
大量データモード設定(組織)組織検索で大量データモードを使用するかどうかの設定です。
要素 <im-master-config>/<large-data-mode>/<department> 属性 enabled。下記のいずれか
- true :大量データモードを使用する場合
- false:大量データモードを使用しない場合
大量データモード設定(ユーザ)ユーザ検索で大量データモードを使用するかどうかの設定です。
要素 <im-master-config>/<large-data-mode>/<user> 属性 enabled。下記のいずれか
- true :大量データモードを使用する場合
- false:大量データモードを使用しない場合
大量データモード表示数制限(ユーザ)ユーザ検索で大量データモードが設定されている場合、ユーザ情報の最大取得件数の設定です。
要素 <im-master-config>/<large-data-mode>/<user>/<limit> 値 任意の数値
5.2.4.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)