交互事件

智能数据洞察支持对仪表盘上的图表设置交互事件，在绑定图表中字段后，点击图表中对应字段的值，可向父页面传递该行的值，可利用此数据进行其他需要的操作。

• 使用场景：在某平台嵌入了仪表盘，想要获取仪表盘中的数据填充进该平台其他功能中以进行后续操作；
• 交互事件为仪表盘级别，同一图表支持在不同仪表盘上设置不同的交互事件；
• 交互事件在仪表盘编辑页面设置完成后，需要保存仪表盘并返回到仪表盘查看页面才会生效；
• 本功能仅私有化部署支持，如有需要，请提前联系智能数据洞察工作人员进行开通功能。

第一步：进入仪表盘编辑页面，选中需要设置事件的图表，点击图表右上角的选项按钮，点击交互事件

第二步：选择绑定字段，输入事件名称，当前事件类型默认为向父页面发送消息

第三步：点击下方 + 号可添加更多事件，输入完成后，点击确认即可创建事件

• 保存仪表盘后回到仪表盘查看页面，设置的事件才会生效

第四步：保存仪表盘后，退出编辑页面回到仪表盘查看页面，点击事件绑定字段的值即可向父页面传递数据

传递的数据格式如下：

{
  "version": 0,
  "event": "测试事件",
  "payload": {
    "row": \[
      {
        "triggered": false,
        "name": "省/自治区",
        "displayName": "省/自治区",
        "rawValue": "浙江",
        "displayValue": "浙江"
      },
      {
        "triggered": true,
        "name": "城市",
        "displayName": "城市",
        "rawValue": "丽水",
        "displayValue": "丽水"
      },
      {
        "triggered": false,
        "name": "利润",
        "displayName": "利润",
        "rawValue": "0.6000000238418579",
        "displayValue": "0.60"
      }
    \]
  }
}

3.1 支持的图表类型

3.1.1 表格/明细表

点击图表或明细表的交互事件绑定字段后，会传递该行的所有数据。

传递的数据格式为：

{
  "version": 0,
  "event": "测试事件",
  "payload": {
    "row": \[
      {
        "triggered": false,
        "name": "省/自治区",
        "displayName": "省/自治区",
        "rawValue": "浙江",
        "displayValue": "浙江"
      },
      {
        "triggered": true,
        "name": "城市",
        "displayName": "城市",
        "rawValue": "丽水",
        "displayValue": "丽水"
      },
      {
        "triggered": false,
        "name": "利润",
        "displayName": "利润",
        "rawValue": "0.6000000238418579",
        "displayValue": "0.60"
      }
    \]
  }
}

3.1.2 透视表

点击透视表交互事件的绑定字段后：

• 如点击维度字段，会传递集联维度值
• 如点击指标字段，会传递该指标以及该指标对应的行列维度值

传递的数据格式为：

{
  "version": 0,
  "event": "测试事件-利润",
  "payload": {
    "row": \[
      {
        "triggered": false,
        "name": "城市",
        "displayName": "城市",
        "rawValue": "上海",
        "displayValue": "上海"
      },
      {
        "triggered": false,
        "name": "省/自治区",
        "displayName": "省/自治区",
        "rawValue": "上海",
        "displayValue": "上海"
      },
      {
        "triggered": true,
        "name": "利润",
        "displayName": "利润",
        "rawValue": "0.800000011920929",
        "displayValue": "0.8000"
      },
      {
        "triggered": false,
        "name": "邮寄方式",
        "displayName": "邮寄方式",
        "rawValue": "二级",
        "displayValue": "二级"
      }
    \]
  }
}

3.1.3 直方图

由于直方图只有一个维度字段，因此设置交互事件时不用选择绑定字段，点击直方图对应的柱体或折线图的标记点均可触发交互事件。

传递的数据格式为：

{
  "version": 0,
  "event": "测试事件-利润",
  "payload": {
    "row": \[
      {
        "name": "利润",
        "displayName": "利润",
        "rawValue": "0.0000-0.0800",
        "displayValue": "0.0000-0.0800"
      },
      {
        "name": "value",
        "displayName": "value",
        "rawValue": "7221",
        "displayValue": "7221"
      },
      {
        "name": "ratio",
        "displayName": "ratio",
        "rawValue": 0.7363858861921273,
        "displayValue": "73.6386%"
      }
    \]
  }
}

3.1.4 其他图表

• 交互事件功能已支持大部分图表类型，如果在编辑页面发现无交互事件选项，则表明暂未支持该图表类型；
• 除上述图表类型外，其余图表点击对应的标记点或区域后，传递的数据均为：维度值和指标值，数据格式可参考上述图表传递的数据格式。

3.2 取消交互事件

进入仪表盘的编辑页面，已设置交互事件的图表，再次点击右上角展开的下拉框会额外增加一条“取消交互事件”的选项，点击取消交互事件即可。