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 来解析:
JavaScript
1{
2 "drillDowns": [
3 { // 第一层下钻
4 "item": { // 点击区域的信息
5 "name": "Android",
6 "value": 40,
7 "url": "http://www.baidu.com"
8 }
9 },
10 { // 第二层下钻
11 "item": {
12 "name":
13 "访问量",
14 "value":17480134,
15 "rate":23.34,
16 "rate_level": "green"
17 }
18 },
19 ...
20 ]
21}
