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

5.6.1. 役職検索タブ

役職検索タブでは、会社/組織セットをツリーで表示し、選択した組織セットに紐づく役職を検索します。

5.6.1.1. 画面構成

役職検索タブの画面表示は以下のとおりです。
../../../_images/post_search.png

【図:役職検索タブ 画面表示】

分類 項目 備考
階層一覧   該当する組織セットを階層表示する。
検索結果一覧   選択した組織セットから役職検索を実行した結果を表示する。

【表:役職検索タブ 画面項目】

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

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

【表:役職検索タブ 画面イベントと検索処理】

5.6.1.2.1. 画面イベント「会社押下時」の補足

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

5.6.1.2.2. 組織検索、役職検索に関する補足(認可)

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

コラム

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

5.6.1.3. 起動時のパラメータ

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

5.6.1.3.1. 画面構築基盤用

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

5.6.1.3.2. 共通パラメータ

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

5.6.1.3.3. 準共通パラメータ

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

コラム

役職検索タブでは IMM_COMPANY_POST テーブルのカラムを取得可能です。

5.6.1.3.4. 暗黙条件

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

5.6.1.4. システムパラメータ

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

5.6.1.4.1. 大量データモード

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

5.6.1.4.1.1. 設定ファイル

  • 大量データモードの有効/無効は、検索画面タブの plugin.xml で定義します。
  • 設定ファイルを変更した場合は、intra-mart Accel Platform を再起動しないと変更が反映されません。
    また、設定ファイルが存在しない場合、intra-mart の正常な動作は保証できないので削除しないでください。

5.6.1.4.1.2. 設定パラメータ

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

large_data_mode。下記のいずれか

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

5.6.1.5. 検索結果の返却

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