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

5.2.1. ユーザ検索(キーワード)タブ

ユーザ検索(キーワード)タブでは、キーワード検索、またはあかさたな検索によりユーザ情報を検索します。

5.2.1.1. 画面構成

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

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


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




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

検索対象のカラム。
『名前』(ユーザ名)、『コード』(ユーザコード)、『フリガナ』(ユーザ検索名)から選択。
検索方式

検索マッチパターン。
『前方一致』、『完全一致』、『部分一致』から選択。
あかさたな検索




選択した行の文字がユーザ検索名に前方一致するものを検索。
設定ファイルにより、表示名、検索値を規定。
頭文字

選択した文字がユーザ検索名に前方一致するものを検索。
設定ファイルにより、表示名、検索値を規定。
ユーザ一覧

キーワード検索を実行した結果を表示。

5.2.1.1.1. 設定ファイル

あかさたな検索の表示名と検索値は、設定ファイルにて定義されています。
設定ファイルは、%PUBLIC_STORAGE%/im_master/search/ に配置されており、検索画面の表示ロケールに従い、国際化された設定ファイルを読み込みます。
設定ファイルが存在しない場合は、何も表示されません。
intra-martインストール時のあかさたな検索の表示文字および検索値は以下の通りです。

【表:頭文字検索の検索条件】
表示文字 検索値 表示文字 検索値 表示文字 検索値 表示文字 検索値 表示文字 検索値
あ|ア い|イ う|ウ え|エ お|オ
か|が|カ|ガ き|ぎ|キ|ギ く|ぐ|ク|グ け|げ|ケ|ゲ こ|ご|コ|ゴ
さ|ざ|サ|ザ し|じ|シ|ジ す|ず|ス|ズ せ|ぜ|セ|ゼ そ|ぞ|ソ|ゾ
た|だ|タ|ダ ち|ぢ|チ|ヂ つ|づ|ツ|ヅ て|で|テ|デ と|ど|ト|ド
な|ナ に|ニ ぬ|ヌ ね|ネ の|ノ
は|ば|ぱ|ハ|バ|パ ひ|び|ぴ|ヒ|ビ|ピ ふ|ぶ|ぷ|フ|ブ|プ へ|べ|ぺ|ヘ|ベ|ペ ほ|ぼ|ぽ|ホ|ボ|ポ
ま|マ み|ミ む|ム め|メ も|モ
や|ヤ ゆ|ユ よ|ヨ
ら|ラ り|リ る|ル れ|レ ろ|ロ
わ|ワ を|ヲ ん|ン

【表:行検索の検索条件】
表示文字 前方一致検索で使用される検索値
あ|ア い|イ う|ウ え|エ お|オ
か|が|カ|ガ き|ぎ|キ|ギ く|ぐ|ク|グ け|げ|ケ|ゲ こ|ご|コ|ゴ
さ|ざ|サ|ザ し|じ|シ|ジ す|ず|ス|ズ せ|ぜ|セ|ゼ そ|ぞ|ソ|ゾ
た|だ|タ|ダ ち|ぢ|チ|ヂ つ|づ|ツ|ヅ て|で|テ|デ と|ど|ト|ド
な|ナ に|ニ ぬ|ヌ ね|ネ の|ノ
は|ば|ぱ|ハ| バ|パ ひ|び|ぴ|ヒ| ビ|ピ ふ|ぶ|ぷ|フ| ブ|プ へ|べ|ぺ|ヘ| ベ|ペ ほ|ぼ|ぽ|ホ| ボ|ポ
ま|マ み|ミ む|ム め|メ も|モ
や|ヤ ゆ|ユ よ|ヨ
ら|ラ り|リ る|ル れ|レ ろ|ロ
わ|ワ を|ヲ ん|ン

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

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

5.2.1.2.1. ユーザ検索に関する補足(認可)

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

5.2.1.3. 起動パラメータ

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

5.2.1.3.1. 画面構築基盤用

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

5.2.1.3.2. 共通パラメータ

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

5.2.1.3.3. 準共通パラメータ

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

5.2.1.3.4. ユーザ検索固有

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

  • 検索名表示
    補足情報にユーザの検索名を表示するかどうかを設定します。
プロパティ名 必須 初期値 備考
additional_user_search_name Boolean × false
  • true :検索名を表示
  • false:検索名を表示しない

  • 所属表示
    補足情報に主所属している組織のみ表示するかどうかを設定します。
プロパティ名 必須 初期値 備考
additional_dept Boolean × false
  • true :主所属の組織のみ表示
  • false:全ての所属組織を表示

5.2.1.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
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"
        }
    }
}

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

  • パブリックグループ
    ユーザ検索時に指定のパブリックグループで絞り込みます。
プロパティ名 必須 初期値 備考
public_group_set   Object × -  
public_group_set_cd String -  
public_group   Object × -  
public_group_cd String -  
compare String × le gt、ge、eq、lt、leのいずれか
1
2
3
4
5
6
7
8
9
"criteria" : {
    "public_group_set" : {
        "public_group_set_cd" : パブリックグループセットコード,
        "public_group" : {
            "public_group_cd" : パブリックグループコード,
            "compare" : "le"
        }
    }
}

  • パブリックックグループ役割
    ユーザ検索時に指定の役割で絞り込みます。
プロパティ名 必須 初期値 備考
public_group_set   Object × -  
public_group_set_cd String -  
public_group_role   Object × -  
role_cd String -  
compare String × le gt、ge、eq、lt、leのいずれか
1
2
3
4
5
6
7
8
9
"criteria" : {
    "public_group_set" : {
        "public_group_set_cd" : パブリックグループセットコード,
        "public_group_role" : {
            "role_cd" :役割コード,
            "compare" : "le"
        }
    }
}

  • パブリックグループ分類項目
    ユーザ検索時に指定のパブリック分類項目を持つパブリックグループで絞り込みます。
プロパティ名 必須 初期値 備考
public_group_ctg_item   Array × -  
配列インデックス   Object × -  
category_cd String -  
category_item_cd   Array -  
配列インデックス String -  
1
2
3
4
5
"criteria" : {
    "public_group_ctg_item" :
        [ { "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.1.4. システムパラメータ

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

5.2.1.4.1. 大量データモード

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

5.2.1.4.1.1. 設定ファイル

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

5.2.1.4.1.2. 設定パラメータ

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

enabled。下記のいずれか

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

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

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

5.2.1.5.1. あいまい検索

あいまい検索とは、ユーザ検索においてアルファベットの大文字・小文字/ひらがな・カタカナ/半角・全角を区別せずに検索できるようにするためのものです。
あいまい検索を使用する際は、以下の制限事項が発生します。
  • ユーザ検索のパフォーマンスが劣化する可能性があります。
  • アルファベット、ひらがな、カタカナを複合させた場合、意図した結果が表示されない場合があります。

詳細は「 制限事項 」-「 IM-共通マスタ 」を参照してください。

5.2.1.5.1.1. 設定パラメータ

ユーザ検索であいまい検索を使用するかどうかの設定です。