API后端获取下钻参数
更新时间:2021-12-13
有关图表如何配置下钻功能,详见图表的下钻设置。
下钻参数在哪里看
对于下钻弹出的图表,最重要的就是如何知道下钻的参数有哪些?其实,在下钻弹出图表的右侧控制面板中「数据」下,单击「调试」,就能看到上层图表传递给本下钻图表的下钻参数。例如,一个饼图点击下钻弹出一个折线图:
1、点击饼图的某一区域
2、在弹出的折线图中,右侧控制面板中单击「调试」,如下图:
3、在「调试」窗口中就能看到drillDowns
字段即下钻参数,如下图:
图表 API 后端获取下钻参数
在绑定了图表的下钻功能之后,Sugar BI在请求下钻弹出图表的数据 API 时会额外附加上一些下钻的具体信息,这些信息和过滤条件一样放在 API 请求的 body 中(Sugar BI统一使用的 POST 方式来请求您绑定的 API)。例如,一个饼图有三个扇形区域,点击每个扇形区域时,我们在拉取弹出图表的数据 API 时会加上drillDowns
参数用来描述用户到底是点击了哪一区域。
drillDowns
参数的格式如下, 由于Sugar BI支持多层下钻,因此drillDowns
参数是个数组,数组的每项分别表示每级下钻的信息,在后端需要使用 json_decode 来解析:
{
"drillDowns": [
{ // 第一层下钻
"item": { // 点击区域的信息
"name": "Android",
"value": 40,
"url": "http://www.baidu.com"
}
},
{ // 第二层下钻
"item": {
"name":
"访问量",
"value":17480134,
"rate":23.34,
"rate_level": "green"
}
},
...
]
}