intra-mart Accel Kaiden! ReportBuilder 設定ガイド 第10版 2024-04-01

検索

指定した条件で検索したレポートの検索結果を取得します。

HTTPリクエスト

POST /kaiden/v2/api/generic/report/search

リクエストボディ

リクエストボディ情報の説明です。
プロパティ名 論理名 設定 デフォルト値 説明
reportId レポートID string 必須 なし ReportBuilderのレポートIDを指定します。
queryId クエリーID string 任意 なし
各レポートに保存されるクエリーIDを指定します。
指定した場合、「json」の値は無視します。
json JSON object 任意 なし レポートの検索条件をJSON形式で指定します。
json/selectionList 表示項目設定 array<string> 任意 ReportBuilderの一覧設定 ReportBuilderの一覧設定の項目名(reportBuilderSettings / List / item @ name)が指定可能です。
json/searchOptions 検索条件設定 object 任意 なし
「”項目名”:”検索条件”,”項目名”:”検索条件”…」の形式で指定します。
項目名には、ReportBuilderの一覧設定の項目名(reportBuilderSettings / List / item @ name)が指定可能です。
json/sortKey ソート項目設定 array<object> 任意 ReportBuilderの一覧設定に指定したソート順
「{“項目名”:”ソート方法”},{“項目名”:”ソート方法”}…」の形式で指定します。
項目名には、ReportBuilderの一覧設定の項目名(reportBuilderSettings / List / item @ name)が指定可能です。
ソート方法には、「asc」、「desc」が指定可能です。
json/paging ページング情報設定 object 任意 各項目を参照してください。
ページング情報設定が未設定、または未設定項目がある場合、各項目のデフォルト値を設定します。
ページング情報設定のいずれかの項目に「0」を指定した場合、全件取得します。
json/paging/pageNo ページNo number 任意 1 取得するページNoを指定します。(1始まり)
json/paging/pageSize 最大件数 number 任意 50 1ページ当たりの最大件数を指定します。
リクエストボディのjsonの設定例
{
    "selectionList":[
        "companyCd",
        "id",
        "name"
    ]
    "searchOptions":{
        "companyCd":"xxx",
        "id":"XXX"
    },
    "sortKey":[
        {"companyCd":"asc"},
        {"id":"desc"}
    ],
    "paging":{
        "pageNo":1,
        "pageSize":50
    }
}

レスポンスデータ

レスポンスデータはJSON情報を返却します。
レスポンスデータ例
{
    "statusCode":"200",
    "error":"false",
    "message":"XXX",
    "errorMessage":"XXX",
    "pageInfo":{
        "pageNo":"1",
        "totalPageNo":"3"
    },
    "data":[
        {"companyCd":"xxx", "id":"XXX", "name":"XXX"},
        {"companyCd":"www", "id":"WWW", "name":"WWW"}
    ]
}
解説
プロパティ名 論理名 説明
statusCode 処理ステータス string
200:正常終了(検索結果あり)
204:正常終了(検索結果なし)
401:エラー終了(認可によりアクセスが拒否)
500:エラー終了(認可以外のエラーが発生)
error 処理結果 boolean
true:エラー終了
false:正常終了
message メッセージ string 処理結果が正常終了で、検索結果が0件の場合、設定されます。
errorMessage エラーメッセージ string 処理結果がエラー終了の場合、設定されます。
pageInfo ページ情報 object ページ情報
pageInfo/pageNo ページNo string 返却対象の検索結果のページNo
pageInfo/totalPageNo 合計ページ数 string 検索結果の合計ページ数
data 検索結果 array<object> リクエストボディの表示項目設定に従い、検索結果が「{“項目名”:”値”,”項目名”:”値”…},」の形式で設定されます。