メインコンテンツまでスキップ

GetReportDataByConditions

条件を指定してレポートデータを取得

Description

条件を指定してレポートデータを取得する

Method

POST

Request URL Format

/api/v0/applications/:app-id/reports/:report-id/filter

Payload


// 検索条件の指定
"conditions" : [] //検索条件を指定
// "id" : DataReportフィールドのdisplay_id または、 "rpf_id"(/conditions APIで返されるレポートフィールドID) を指定
// "search_value": 検索条件を配列で指定(サンプルを参照) ※アイテム一覧の指定と同様、フィールドタイプごとに指定内容が異なる

// ページネーション
"per_page" : 10 // 1ページたあたりの取得件数 (省略、または、ゼロを指定すると、対象データ全件を返します)※注1
"page" : 1 // ページ数

// ソート順の指定(複数のソートキー指定)
"sort_fields": [
{"id": "Status", "order": "desc"}, // idには、 display_id または rpf_idを指定 
{"id": "Category", "order": "asc"} // order にはソート順を指定 desc : 降順 ask : 昇順 (省略すると昇順となります)
],

// ソート順の指定(単一のソートキー指定)※"sort_fields": []が指定されている場合は、この指定は無視されれます(sort_fieldsが優先される)
"sort_field_id": "No", // display_id または rpf_idを指定
"sort_order": "desc", // asc または descを指定

// 検索結果に作成日、更新日を含める場合は以下を指定します。データソースに指定したデータの作成日、更新日が結果に含まれます。(関連先を結合した場合、関連先アイテムの作成日、更新日は含まれません)
"include_date_at": true,

// 検索結果にデータベース参照(Lookup)先アイテムの値を含める場合、以下を指定します。データベースの参照階層が深いと時間がかかるため、include_lookups_limitで取得階層を指定することを推奨します。
"include_lookups": true, // default false

// 検索結果のデータベース参照(Lookup)先アイテムの取得階層の指定をします。
"include_lookups_limit": 1, // 1以上を指定、かつinclude_lookupsがtrueの時のみ有効。再帰的に同一データベースを参照している場合は同一データベース2回までの取得となります。

// 検索結果にフィールドの参照先ItemのID(d_id, i_id,rev_no) を含める場合、以下を指定します。
"include_item_ref": true, // default false

// 検索結果に選択肢型やステータス、ユーザーに関するID,Valueの値を含める場合、以下を指定します。
"return_id_value_results": true, // default false

// "include_lookups": trueのとき、参照先Itemの数値型データがNumberとして出力する場合は、以下を指定します(defaultでは、数値は文字列("123")で返却される)
"return_number_value": true,

// totalItems(ヒットした件数)のみを返却します。report_resultsにはnullが返却されます。
"return_count_only": true, // default false

// 日付型のフィールドの場合、戻り値をUTC時刻(ISO format)で返す. ただし、HexabaseUIのレポート設定でこの設定がONになっていた場合は、フラグ指定に限らずUTCとなります。この設定はDate型(Datetime型ではない)に対してのみ有効です。
"return_utc_datetime" : true

// totalItemsの検索のタイムアウト時間を秒で指定します。タイムアウトした場合、totalCountは-1が返ります。
"total_count_timeout_sec": 10 // default 60(s)

// data_result_timeout_sec report_results取得時のタイムアウト秒数を指定できます。タイムアウトするとreport_resultsの取得が省略(null)されます。
"data_result_timeout_sec": 20 // default 60(s)

// totalItemsを計算を省略します。totalItemsにはかならず0が返ります。データ量が多い場合は顕著に影響します。検索結果の処理速度改善します。
"omit_total_items": false, // default false


// 取得結果から、"report_fields"部分を省略できます(report_fields情報が不要の際にデータ量を削減できます)
"omit_fields_data" : true,

// 結果をCSV形式取得する場合、"csv"と指定(省略するとJSON形式となる)
"format": "csv"

(注1:per_pageを使用する場合、sort_fields を指定してください。)

Request URL Sample

POST https://api.xxx.com/api/v0/applications/APP_ID/reports/REPORT_ID/conditions

Payload Sample

検索条件に画面IDを利用する場合

id: にフィールドIDを指定します。

{
"conditions":[
{ "id":"CATEGORY", "search_value":["B"] } // CATEGORYカラムのデータ値Bのもののみに絞込み
],
"sort_fields": [
{"id": "Status", "order": "desc"},  // 第1ソートキー
{"id": "Category", "order": "asc"} // 第2ソートキー
],
"per_page" : 10,
"page" : 1
}

レポート用フィールドIDを利用する場合

rpf_id: にレポートフィールドIDを指定します。

{
"conditions":[
{
"rpf_id":"4552a666-508d-419c-ba99-7c9a16b24894", // 特定カラムの値で絞込
"search_value":["B"]
}
],
"sort_field_id": "No", // No カラムでソート
"sort_order": "desc", // 降順
"format": "csv" // CSV形式で出力
// per_pageを省略=全件を出力
}

Response Sample

通常の結果サンプルについては、GetReportData を参照してください。

※ JSON形式は、データレポート取得サンプルと同様
※ format="csv"の場合は、1行目がヘッダ行、2行目以降にデータをカンマ区切りで出力される

"include_lookups": trueを指定した場合

"lookup_items" フィールドに、該当データベース参照(Lookup)先のアイテム情報が展開されます。

Lookup先のItemが再帰的に自分のItemを参照しているようなケースでは、最大で2回まで展開されますが、(無限ループを避けるため)それ以上の呼び出しはされません。

{
"report_fields": [
// (省略) // omit_fields_data : true 指定すると、この"report_fields"を省くことが可能です。
],
"report_results": [
{
"ChildID": "3",
"LookupMySelf": "タスクE", // Lookup type 1
"Status1": "確認",
"Status2": "完了",
"Title": "TaskD",
"Title2": "タスクE",
"created_at": "2020/08/16 11:59:45",
"items": [
{
"d_id": "5f38a11baa395581685afdb4",
"i_id": "5f38a121aa395581685afdc1"
}
],
"lookup_items": {
"LookupMySelf": { // Item values of Lookup type 1
"Assignee": "X",
"Category": "B",
"DueDate": "2015-12-31T15:00:00Z",
"LookupMySelf": "3", // Item values of Lookup type 1 (LookupField in the Lookup Item)
"Status": "完了",
"Title": "タスクE",
"created_at": "2020-08-16T04:06:14Z",
"created_by": "IMPORT",
"d_id": "5f38b0afaa395581685afdf6",
"i_id": "5f38b0b6aa395581685afdff",
"lookup_items": {
"LookupMySelf": { // Item values of Lookup type 1 (Recursive Link... )
"Assignee": "X",
"Category": "B",
"DueDate": "2015-12-31T15:00:00Z",
"LookupMySelf": "4", // Recursive call will be limited by twice for the same datastores in the result
"Title": "タスクE",
"created_at": "2020-08-16T04:06:14Z",
"created_by": "IMPORT",
"d_id": "5f38b0afaa395581685afdf6",
"i_id": "5f38b0b6aa395581685afdff",
"p_id": "5f25956528dc5c55b463bc7b",
"rev_no": "4",
"status_id": "5f38b0afaa39558bfca2963c",
"title": "タスクE",
"updated_at": "2021-01-22T17:10:37Z",
"updated_by": "5f25952c28dc5c55b463bc76"
}
},
"p_id": "5f25956528dc5c55b463bc7b",
"rev_no": "4",
"status_id": "5f38b0afaa39558bfca2963c",
"title": "タスクE",
"updated_at": "2021-01-22T17:10:37Z",
"updated_by": "5f25952c28dc5c55b463bc76"
}
},
"updated_at": "2020/09/30 23:04:30"
}
],
"report_title": "LookupJoin",
"error": "",
"totalItems": 9,
"item_index_from": 0,
"item_index_to": 0
}

"return_id_value_results": true を指定した場合

選択肢型(Select,Radio,Checkbox)、ステータス型、ユーザー型それぞれのフィールドに対する、IDとValueのMap情報を付加します。

{
"report_fields": [
// (省略) // omit_fields_data : true 指定すると、この"report_fields"を省くことが可能です。
],
"report_results": [
{
{
"AssigneeText": "Y",
"Category": "B",
"DueDate": "2016/01/01",
"Lookup1": "",
"Number": 5,
"TextArea": "aあああ",
"Title": "タスクA",
"UserType": "hi__test2",
"i_id": "5f267f1628dc5c6988bc2ff2",
"id_value_results": { // <---- 該当するフィールドに、選択肢型またはステータス、またはユーザー型がある場合、付加されます。
"Category": {
"id": "B",
"value": "B"
},
"UserType": [
{
"id": "6028ed8628dc5c0e38b86c22",
"value": "hi__test2"
}
],
"status1": {
"id": "Assigned",
"value": "Assigned"
}
},
"rev_no": 6,
"status1": "Assigned"
},
{
"AssigneeText": "X",
"Category": "A",
"Checkbox": "22",
"DateOld": "2021/05/26",
"DateTime1": "2021-05-27T18:38:13Z",
"DueDate": "2016/01/22",
"Lookup1": "",
"Number": 11,
"Radio": "B",
"Title": "タスクE",
"UserType": "",
"i_id": "5f267f1628dc5c6988bc2fee",
"id_value_results": { // <---- 該当するフィールドに、選択肢型またはステータス、またはユーザー型がある場合、付加されます
"Category": {
"id": "A",
"value": "A"
},
"Checkbox": [  // <---- Checkboxの場合、複数選択肢に対する配列が返ります
{
"id": "3ce8c186-89a6-455c-8b80-f962333b3eb0",
"value": "22"
}
],
"Radio": {
"id": "OptionB",
"value": "B"
},
"status1": {
"id": "InReview",
"value": "In Review"
}
},
"rev_no": 24,
"status1": "In Review"
},
{
"AssigneeText": "Y2",
"Category": "A",
"DateOld": "2021/05/18",
"DateTime1": "2021-05-26T18:47:51Z",
"DueDate": "2016/01/01",
"Lookup1": "タスクE",
"Number": 45,
"Radio": "A",
"Title": "タスクXXX",
"UserType": "hi-hexabase, hi__test3",
"i_id": "5f267f1628dc5c6988bc2ff1",
"id_value_results": { // <---- 該当するフィールドに、選択肢型またはステータス、またはユーザー型がある場合、付加されます。
"Category": {
"id": "A",
"value": "A"
},
"Radio": {
"id": "OptionA",
"value": "A"
},
"UserType": [  // <---- User型の場合、複数選択肢に対する配列が返ります
{
"id": "5f25952c28dc5c55b463bc76",
"value": "hi-hexabase"
},
{
"id": "5fb20308aa39557714afd53a",
"value": "hi__test3"
}
],
"status1": {
"id": "IN_PROGRESS",
"value": "In Progress"
}
},
}
],
"report_title": "TestReport",
"error": "",
"totalItems": 3,
"item_index_from": 0,
"item_index_to": 2
}

Errors

totalItemsの検索でタイムアウトした場合

{
"report_results": [
...(省略)
],
"report_title": "ReportTitle",
"error": "error totalItems count process timeout. (3 sec elapsed)",
"totalItems": -1,
"item_index_from": 0,
"item_index_to": 4
}