/api/dataSets/:id/dataLoads dataset data. データセットデータをロードします。 リソース情報Request ParametersリクエストパラメーターParametersパラメーター | Detail詳細 | Example例 |
|---|
id (path parameter) | フェッチするデータセットのID。 IDは、ID of the data set to fetch. You can find the ID in the response to /api/dataSets.へのレスポンスで見つけることができます。 | 123 | | joinPoints | データのロードに使用される結合ポイントの定義。 使用可能な結合タイプ: - LEFT_OUTER_JOIN
- INNER_JOIN
- CROSS_JOIN
| joinPoints={"joins"=[
{"joinedDataSetId":"198", "primaryAttribute": "L_ID", "joinedAttribute":"L_ID_JOINED", "alias":"th", "joinType": "INNER_JOIN"}
]} | filter
(query parameter)
| ( Optional) Filter used to load data.オプション) データを読み込む際に使用するフィルター。 プレフィックス（PT）は、joinに同じ名前のカラムが含まれる場合に使用できます。 フィルター操作の種類一覧は こちら. conditionType (オプション) は、条件間の条件演算子を定義するために使用される。利用可能な値： 文字列の一部を検索する：データセット値で選択された文字列を検索するには、'%'ワイルドカードを使用します。例："value": "%al%" 複数のフィルタを結合したり、同じパラメータに2つのフィルタを適用したりするために、属性ドリルダウンは配列にすることができます。 「ドリルダウン」の外側の "conditionType "属性はドリルダウン配列のメンバー間の条件を定義し、内側の "conditionType "属性はドリルダウンの属性間の条件を定義します | {
"drilldown": {
"UID": {
"op":"IN",
"values":["1","2","4","10"]
},
"L_COUNTRY_OR_AREA": {
"op": "EQ",
"value": "Slovakia"
},
"L_TYPE": {
"op": "IN",
"values": [ "Type 1", "Type 2", "Type 3" ]
},
"PT.L_DATE": {
"op": "NOT_NULL"
},
"conditionType":"OR"
}
}
Example of a between filter:
{"drilldown":[{"L_ID":{"op":"GT","value":"10"}},{"L_ID":{"op":"LT","value":"20"}}]}
| offset (query parameter) | (Optional) Specifies the page offset if pagination is necessary.オプション)ページ分割が必要な場合のページオフセットを指定します。 | 2 | size (query parameter) | (Optional) Specifies the number of entries on each page if pagination is necessary. | 15 |
オプション) ページネーションが必要な場合に、各ページの項目数を指定します。 | 15 | order (query parameter) | (オプション) リストアップされたデータのソート順を指定します | M_INDICATOR asc |
レスポンス構造| Code Block |
|---|
| {
"dataSet" : { ... },
"data" : [ { "UID" : 123456, "L_ATTRIBUTE" : "value", "M_INDICATOR" : 11.99 }, { "UID" : 123457, "L_ATTRIBUTE" : "value2", "M_INDICATOR" : 22.08 } ],
} "offset" : 0,
"size" : 2
} |
JSONレスポンスには2つのページネーション要素 (offsetとsize) が含まれますが、主な2つの要素はデータセットに関する詳細情報を含むdataSet (JSON response contains 2 elements dataSet that contains detailed information about data set (see GET Data Set Detail) and data which contains array of data rows in following strcutureを参照）と、次の構造のデータ行の配列を含むdataです: | Name名 | Description説明 |
|---|
| UID | Unique ID of data row. | | L_* | Attribute values contained in the data row. | | M_* | Indicator values contained in the data row. |
結合データセット| Note |
|---|
BellaDati 2.9.19から利用可能です。 |
結合データセットでは、プレフィックスは重複した属性またはインジケータのソースデータセットを示します。 例: DATASETCODE_L_ATTRIBUTE サンプルリクエスト/レスポンスcurl使用: | Code Block |
|---|
curl -H "Authorization: OAuth realm=\"https://service.belladati.com/\", oauth_consumer_key=\"myConsumer\", oauth_token=\"mh7an9dkrg59\", oauth_timestamp=\"135131231\", oauth_nonce=\"randomString\"" https://service.belladati.com/api/dataSets/123/data
|
JSONフォーマットの応答JSON形式のレスポンス: | Code Block |
|---|
| {
"dataSet" : {
"id" : 123,
"name" : "My test data set",
"code" : "DATASET_CODE",
"localization" : {
"de" : "Deutsch Name"
},
"description" : "This is a sample data set.",
"owner" : "John Smith",
"lastChange" : "Tue, 22 May 2012 17:16:31 GMT",
"attributesdata" : [
{
"id { "UID" : "123.FO8j1HfdDz",
"name123456, "L_ATTRIBUTE" : "Cityvalue",
"code" : "L_CITY",
"type" : "String"
}
],
"indicators" : [
{
"id" : "123.8RnLDOwZnY",
"name"M_INDICATOR" : 11.99 },
{ "UID" : 123457, "L_ATTRIBUTE" : "Countvalue2",
"type" : "DATA"M_INDICATOR",
"code" : "M_COUNT"
},
{
"id" : "123.Jiq7Cuyai1": 22.08 }
],
"nameoffset" : "Calculated indicator"0,
"typesize" : "FORMULA_INDICATOR"2,
"formulaparameters" : "M_COUNT * 1000"[
},
{
"id" : "123.MrrmQgYyyo",
"name" param1": "Indicator groupvalue1",
"type" : "INDICATOR_GROUP"
}
],
"reports" : [
{
"id" : 7497,
"nameparam2" : "My Report",
"description" : "This is a sample report.",
"owner" : "John Smith",
value2"
"lastChange" : "Mon, 16 Apr 2012 10:17:26 GMT"
}
]
},
"data" : [
{ "UID" : 123456, "L_ATTRIBUTE" : "value", "M_INDICATOR" : 11.99 },
{ "UID" : 123457, "L_ATTRIBUTE" : "value2", "M_INDICATOR" : 22.08 }
]
} |
|