API后端获取联动参数

更新时间:2020-02-10

有关图表如何配置联动功能,详见图表的联动设置

联动参数在哪里看

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

1、点击饼图的某一区域,触发联动

2、然后点击折线图,右侧控制面板中单击「调试」,如下图:

图片

3、在「调试」窗口中就能看到dependence字段即联动参数,如下图:

图片

图表 API 后端获取联动参数

如果图表被某个上级图表设置为了联动的下级图表,当上级图表触发联动时,Sugar BI在请求下级图表的数据 API 中会额外附加上一些联动的具体信息,这些信息和过滤条件一样放在 API 请求的 body 中(Sugar BI统一使用的 POST 方式来请求您绑定的 API)。例如,如果上级图表是一个饼图,点击每个扇形区域时,我们在拉取下级图表的数据 API 时会加上dependence参数用来描述用户到底是点击了哪一区域。

dependence参数的格式如下:

{
  "dependence": {
    "item": {
      "subsys": "北京总部",
      "module": "市场部",
      "business": "第一小分队",
      "name": "张三",
      "value": 6672389,
      "url": "http://www.baidu.com"
    },
    "fireKey": "name"
  }
}
  • 联动参数是一个对象,由 item 和 fireKey 组成。
  • item 是一个对象,里面有触发联动相关的信息,比如触发联动的表格某行的数据。
  • fireKey 是一个字符串,在某种图表可以触发多种联动的情况下用来区分触发的是哪一种联动,一般用不到。

本页内容