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

5.3.3. 組織検索(キーワード)タブ

組織検索(キーワード)タブでは、組織をキーワードで検索します。

5.3.3.1. 画面構成

組織検索(キーワード)タブの画面表示は以下の通りです。
../../../_images/department_s_kw.png

【図:組織検索(キーワード)タブ 画面表示】

【表:組織検索(キーワード)タブ 画面項目】
分類 項目 備考
キーワード検索






キーワード
検索する文字列。
検索対象

検索対象のカラム。
『名前』(組織名)、『コード』(組織コード)、『検索名』(組織検索名)から選択。
検索方式

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



組織一覧のページングを行う。
1ページの表示件数については、システムパラメータで変更可能です。
組織一覧

キーワードより組織検索を実行した結果を表示します。

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

組織検索(キーワード)タブで発生する画面イベントと検索処理の関連は以下の通りです。
【表:組織検索(キーワード)タブ 画面イベントと検索処理】
イベント 検索処理
画面起動時
特になし
検索ボタン押下時
入力されたキーワード、検索対象、検索方式より組織検索を実行します。
ページングボタン押下
検索条件を引き継ぎ、組織検索を実行します。
<ボタン :前のページ
<<ボタン :先頭のページ
>ボタン :次のページ
>>ボタン :最後のページ

5.3.3.2.1. 組織検索に関する補足(暗黙条件)

組織検索では、キーワードより組織検索を行いますが、「暗黙条件:組織表示設定」により検索動作が異なります。
  • 組織表示設定がhideの場合
    デフォルトのセット=会社のため、デフォルトのセット以外の組織セットを表示させたい場合、会社の検索はできません。
    デフォルトのセット以外の組織セットは検索できません。
    デフォルトのセット以外の組織セットを検索したい場合は、組織表示設定をallまたはdisplayとしてください。
  • 組織表示設定がdisplay、allの場合
    組織セットの検索が可能です。組織一覧には組織セット名が表示されます。

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

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

5.3.3.3. 起動時のパラメータ

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

5.3.3.3.1. 画面構築基盤用

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

5.3.3.3.2. 共通パラメータ

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

5.3.3.3.3. 準共通パラメータ

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

5.3.3.3.4. 暗黙条件

組織検索(キーワード)タブで検索を行う際に、ユーザ操作とは別に指定する条件です。
検索結果はこの暗黙条件の範囲で自動的に絞り込まれます。
  • 組織セット表示設定
    会社毎に表示する組織セットを設定します。
    表示する組織セットは会社毎にデフォルト組織セットリストで指定することができ、組織セット名の表示/非表示を選択できます。
    デフォルト組織セットリストには、会社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、eq、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、eq、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"
        }
    }
}

  • 組織分類項目
    組織検索時に指定の組織分類項目を持つ組織で絞り込みます。
    認可設定で許可された会社のみ有効です。
プロパティ名 必須 初期値 備考
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" : [ 組織分類項目コード, ...]},.. ]
}

5.3.3.4. システムパラメータ

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

5.3.3.4.1. 大量データモード

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

5.3.3.4.1.1. 設定ファイル

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

5.3.3.4.1.2. 設定パラメータ

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

enabled。下記のいずれか

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

5.3.3.4.2. 1ページ表示件数

組織一覧では、ページングが行われます。
1ページの表示件数は設定ファイルで設定されています。

5.3.3.4.2.1. 設定ファイル

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

5.3.3.4.2.2. 設定パラメータ

以下に大量データモードに関するパラメータについて説明します。
  • 1ページ表示件数(組織一覧)
    組織一覧にて1ページに表示する件数を設定します。
要素 <im-master-config>/<large-data-mode>/<department>/<length>
任意の数値

5.3.3.5. 検索結果の返却

検索結果は、起動時のパラメータ callback_function で指定されたファクションの引数に渡されます。
組織検索(キーワード)タブから返却されるオブジェクトは以下のような形式です。
  • 返却データが会社の場合
type
imm_company
keyFields
company_cd
displayName
組織名(内包構造に従って組織名を連結)
data
デフォルト取得項目(company_cd, department_set_cd, department_cd , department_name, delete_flag)の値
propで指定された項目)
basic_info
検索時の基本情報(target_date, target_locale, deleted_data)
inclusion
内包構造の組織名
  • 返却データが組織の場合
type
imm_department
keyFields
company_cd, department_set_cd, deparment_cd
displayName
組織名(内包構造に従って組織名を連結)
data
デフォルト取得項目(company_cd, department_set_cd, department_cd , department_name, delete_flag)の値
propで指定された項目)
basic_info
検索時の基本情報(target_date, target_locale, deleted_data)
inclusion
内包構造の組織名