单元格链接概述
介绍单元格链接的 7 种类型、配置入口、参数值的四种取值方式、多链接单元格的菜单行为,以及导出 Excel 时链接的处理。
概述
单元格链接是在单元格上配置的交互动作。报表在查看页中,点击带链接的单元格时执行对应动作,例如钻取到明细报表、打开网页、修改查询条件重新出数、显示图表或向宿主页面发送事件。
一个单元格可以配置多个链接。参数值可以按行求值,同一列数据扩展出的每个单元格点击后传出的是各自所在行的值。
功能入口
设计器 > 选中单元格 > 右侧「单元格属性」面板 > 「链接」页签 > 「添加链接」。
「链接」页签只对普通类型的单元格显示,列表中每个链接显示类型图标和名称,名称可双击修改;行操作图标为编辑和删除。「添加链接」下拉菜单列出全部链接类型。

链接类型
| 类型 | 动作 | 详细说明 |
|---|---|---|
| 「报表链接」 | 钻取到本模板的子报表,或打开另一张报表 | 报表链接与钻取 |
| 「网页链接」 | 打开一个网址,可附带参数 | 其他链接类型 |
| 「更改查询参数」 | 修改当前报表的查询参数并重新查询 | 其他链接类型 |
| 「联动单元格图表」 | 用新参数刷新另一个单元格中的图表 | 其他链接类型 |
| 「显示悬浮图表」 | 点击处弹出悬浮图表 | 其他链接类型 |
| 「执行JavaScript」 | 在浏览器中执行一段脚本 | 其他链接类型 |
| 「发送事件」 | 向嵌入报表的宿主页面发送自定义事件 | 发送事件链接 |
操作步骤
- 选中要点击的单元格,在「单元格属性」面板切换到「链接」页签。
- 点击「添加链接」,从下拉菜单选择链接类型,打开链接设置对话框。
- 填写「链接名称」(必填,默认取类型名称)和该类型的专有设置。
- 需要传值时,在「参数配置」表格中添加参数,逐行设置「参数」名称与「值」。
- 点击「确定」。对话框底部的「使用指南」可打开应用内说明。
- 保存后在预览页点击该单元格验证。
参数配置
「参数配置」表格有两列:「参数」和「值」。每行的值有四种取值方式,通过值左侧的下拉框选择。
| 取值方式 | 说明 | 实际保存的写法 |
|---|---|---|
| 「固定文本」 | 把输入的文字原样作为参数值 | 文本 |
| 「本格的值」 | 当前单元格显示的值 | 表达式 $$value |
| 「取本行字段」 | 取当前行数据集中某个字段的值;字段列表来自当前单元格或其父格绑定的数据集 | 表达式 $$record.字段名,字段名含特殊字符时为 $$record['字段名'] |
| 「表达式」 | 手写表达式,可引用其他单元格,如 A4,双击输入框或点击右侧按钮打开表达式编辑器 |
表达式 |
注意:选错取值方式不会报错,只会传错值。例如把单元格名
A5输入为「固定文本」,目标报表收到的是字面量A5,而不是 A5 的内容。
「报表链接」类型的「参数配置」下方有「读取目标模板参数」按钮,读取目标报表已声明的参数名。参数名在目标报表中不存在时,名称输入框内出现警告图标,提示「目标报表未声明该参数,传过去不会生效」。其他类型使用「添加参数」按钮手工添加。
多个链接
单元格配置了多个链接时,点击单元格弹出菜单,每项显示链接名称,点击菜单项执行对应链接。只配置一个链接时,点击即执行。
打开新的链接前,页面会先关闭已打开的对话框和悬浮图表。
导出
单元格链接依赖报表运行时。导出 Excel 时只还原「网页链接」为 Excel 原生超链接,其余 6 种类型不导出。一个单元格只能挂一个超链接,配置了多个网页链接时取第一个可导出的地址。
注意事项
注意:网页链接的地址只放行
http、https、相对路径、锚点等,javascript:、vbscript:、file:等协议会被拦截,不会打开。
提示:更改查询参数、联动单元格图表等类型使用当前查询表单的值,需要目标参数已在报表中声明,见参数类型、默认值与传参。