intra-mart Accel Kaiden! MasterBuilder 設定ガイド 第14版 2024-08-31

汎用検索

指定した条件で検索したマスタの検索結果を取得します。
検索条件を自由に設定可能です。

HTTPリクエスト

POST /kaiden/v2/api/generic/master/genericSearch

リクエストボディ

リクエストボディ情報の説明です。
プロパティ名 論理名 設定 デフォルト値 説明
masterId マスタID string マスタIDを保持するマスタの場合、必須 なし MasterBuilderのマスタIDを指定します。
extensionId マスタ拡張ID string 任意 なし MasterBuilderをカスタマイズして、マスタ拡張IDを設定している場合、指定します。
gadgetClass ガジェットクラス string ガジェットクラスを保持するマスタの場合、必須 なし GadgetBuilderのガジェットクラス「master」を指定します。
gadgetVariation ガジェットバリエーション string ガジェットバリエーションを保持するマスタの場合、必須 なし GadgetBuilderのガジェットバリエーションを指定します。
json JSON object 任意 なし マスタの検索条件をJSON形式で指定します。
json/genericOptions 検索条件設定 object 任意 なし
「”項目名”:{“検索条件式”:”検索条件”},”項目名”:{“検索条件式”:”検索条件”},…」の形式で指定します。
項目名には、MasterBuilderの項目設定の項目名(genericMasterSettings / items / item @ name)が指定可能です。
ただし、マスタを保持するテーブルのカラム名とマッピングできない項目名は無視されます。
ヘッダと明細に分かれている構成のマスタの明細の項目をソート順に指定する場合、「”detail.項目名”:{“検索条件式”:”配列”}」と指定してください。
検索条件式の詳細は「汎用検索、汎用検索件数共通リクエストボディ」を参照ください。
json/sortKey ソート項目設定 array<object> 任意
検索対象のマスタの主キーの昇順
「{“項目名”:”ソート方法”},{“項目名”:”ソート方法”}…」の形式で指定します。
項目名には、MasterBuilderの項目設定の項目名(genericMasterSettings / items / item @ name)が指定可能です。
ヘッダと明細に分かれている構成のマスタの明細の項目をソート順に指定する場合、「{“detail.%項目名%”:”ソート方法”}」と指定してください。
ソート方法には、「asc」、「desc」が指定可能です。
json/paging ページング情報設定 object 任意 各項目を参照してください。
ページング情報設定が未設定、または未設定項目がある場合、各項目のデフォルト値を設定します。
ページング情報設定のいずれかの項目に「0」を指定した場合、全件取得します。
json/paging/pageNo ページNo string 任意 1 取得するページNoを指定します。(1始まり)
json/paging/pageSize 最大件数 string 任意 20 1ページ当たりの最大件数を指定します。
リクエストボディのjsonの設定例
{
    "genericOptions":{
        "field1":{"eq":"XXX"},
        "detail.field2":{"in":["XXX", "XXX"]}
    },
    "sortKey":[
        {"field1":"asc"},
        {"detail.field2":"desc"}
    ],
    "paging":{
        "pageNo":"1",
        "pageSize":"20"
    }
}

レスポンスデータ

レスポンスデータはJSON情報を返却します。
レスポンスデータ例
{
    "statusCode":"200",
    "error":"false",
    "message":"XXX",
    "errorMessage":"XXX",
    "pageInfo":{
        "pageNo":"1",
        "totalPageNo":"3"
    },
    "data":[
        {"companyCd":"xxx", "id":"XXX", "detail":{"companyCd":"xxx"}},
        {"companyCd":"xxx", "id":"YYY", "detail":{"companyCd":"xxx"}}
    ]
}
解説
プロパティ名 論理名 説明
statusCode 処理ステータス string
200:正常終了(検索結果あり)
204:正常終了(検索結果なし)
401:エラー終了(認可によりアクセスが拒否)
405:エラー終了(対象機能のAPI利用が不可)
500:エラー終了(401、405以外のエラーが発生)
error 処理結果 boolean
true:エラー終了
false:正常終了
message メッセージ string 処理結果が正常終了で、検索結果が0件の場合、設定されます。
errorMessage エラーメッセージ string 処理結果がエラー終了の場合、設定されます。
pageInfo ページ情報 object ページ情報
pageInfo/pageNo ページNo string 返却対象の検索結果のページNo
pageInfo/totalPageNo 合計ページ数 string 検索結果の合計ページ数
data 検索結果 array<object>
検索結果が「{“項目名”:”値”,”項目名”:”値”…},」の形式で設定されます。
MasterBuilderの基本設定のサービスクラス(genericMasterSettings / service)に紐づくEntityに定義したフィールドが、検索結果の項目に設定されます。
ヘッダと明細に分かれている構成のマスタの明細データは、「”detail”:{“項目名”:”値”,”項目名”:”値”…},」の形式で設定されます。