API后端获取下钻参数

更新时间:2020-02-10

有关图表如何配置下钻功能,详见图表的下钻设置

下钻参数在哪里看

对于下钻弹出的图表,最重要的就是如何知道下钻的参数有哪些?其实,在下钻弹出图表的右侧控制面板中「数据」下,单击「调试」,就能看到上层图表传递给本下钻图表的下钻参数。例如,一个饼图点击下钻弹出一个折线图:

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"
      }
    },
    ...
  ]
}

本页内容