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

検索結果件数取得

指定した条件で検索したマスタの検索結果件数を取得します。
リクエストボディに記載した検索条件のみ設定可能です。

HTTPリクエスト

POST /kaiden/v2/api/generic/master/count

リクエストボディ

リクエストボディ情報の説明です。
プロパティ名 論理名 設定 デフォルト値 説明
masterId マスタID string マスタIDを保持するマスタの場合、必須 なし MasterBuilderのマスタIDを指定します。
extensionId マスタ拡張ID string 任意 なし MasterBuilderをカスタマイズして、マスタ拡張IDを設定している場合、指定します。
gadgetClass ガジェットクラス string ガジェットクラスを保持するマスタの場合、必須 なし GadgetBuilderのガジェットクラス「master」を指定します。
gadgetVariation ガジェットバリエーション string ガジェットバリエーションを保持するマスタの場合、必須 なし GadgetBuilderのガジェットバリエーションを指定します。
json JSON object 任意 なし マスタの検索条件をJSON形式で指定します。
json/searchOptions 検索条件設定 object 任意 なし
検索条件設定に記載がない項目を指定した場合、無視されます。
設定した検索条件に合致する項目が検索対象のマスタに存在しない場合、無視されます。
json/searchOptions/
searchCriteriaCompany
検索基準会社 string 任意 ログインユーザの現在の選択組織の会社コード
会社コードを指定します。
会社化特性のマスタの会社コードに一致するか判定します。
json/searchOptions/
searchCriteriaDate
検索基準日 string 任意 現在日付 yyyy/mm/dd形式で指定します。
json/searchOptions/
searchCriteriaUser
検索基準ユーザ string 任意 ログインユーザのユーザコード ユーザコードを指定します。
json/searchOptions/
searchCriteriaLocale
検索基準ロケール string 任意 ログインユーザの使用ロケールのロケールID
ロケールIDを指定します。
国際化特性のマスタのロケールIDに一致するか判定します。
json/searchOptions/
searchWithDisabled
無効データ対象有無 string 任意 true:無効なデータを検索対象に含む
期間化特性のマスタの場合、無効なデータを検索対象に含むかを指定可能です。
true:無効なデータを検索対象に含む
false:無効なデータを検索対象に含まない
json/searchOptions/
searchKeyword
検索キーワード string 任意 なし
指定された語句を部分一致で検索します。
検索対象になる項目はマスタごとに異なりますので、各マスタの一覧検索用SQLを確認してください。
検索キーワードは、検索条件の「searchCriteriaKeyword」として使用されます。
リクエストボディのjsonの設定例
{
    "searchOptions":{
        "searchCriteriaCompany":"comp_sample_01",
        "searchCriteriaDate":"2020/01/01",
        "searchCriteriaUser":"aoyagi",
        "searchCriteriaLocale":"ja",
        "searchWithDisabled":"true",
        "searchKeyword":"XXX"
    }
}

レスポンスデータ

レスポンスデータはJSON情報を返却します。
レスポンスデータ例
{
    "statusCode":"200",
    "error":"false",
    "message":"検索対象データ件数:5件",
    "errorMessage":"XXX",
    "data":"5"
}
解説
プロパティ名 論理名 説明
statusCode 処理ステータス string
200:正常終了
401:エラー終了(認可によりアクセスが拒否)
405:エラー終了(対象機能のAPI利用が不可)
500:エラー終了(401、405以外のエラーが発生)
error 処理結果 boolean
true:エラー終了
false:正常終了
message メッセージ string 処理結果が正常終了の場合、「検索対象データ件数:%件数%件」が設定されます。
errorMessage エラーメッセージ string 処理結果がエラー終了の場合、設定されます。
data 検索結果件数 string