文档首页 / 单元格链接概述

单元格链接概述

介绍单元格链接的 7 种类型、配置入口、参数值的四种取值方式、多链接单元格的菜单行为,以及导出 Excel 时链接的处理。

概述

单元格链接是在单元格上配置的交互动作。报表在查看页中,点击带链接的单元格时执行对应动作,例如钻取到明细报表、打开网页、修改查询条件重新出数、显示图表或向宿主页面发送事件。

一个单元格可以配置多个链接。参数值可以按行求值,同一列数据扩展出的每个单元格点击后传出的是各自所在行的值。

功能入口

设计器 > 选中单元格 > 右侧「单元格属性」面板 > 「链接」页签 > 「添加链接」。

「链接」页签只对普通类型的单元格显示,列表中每个链接显示类型图标和名称,名称可双击修改;行操作图标为编辑和删除。「添加链接」下拉菜单列出全部链接类型。

单元格属性「链接」页签:添加链接

链接类型

类型 动作 详细说明
「报表链接」 钻取到本模板的子报表,或打开另一张报表 报表链接与钻取
「网页链接」 打开一个网址,可附带参数 其他链接类型
「更改查询参数」 修改当前报表的查询参数并重新查询 其他链接类型
「联动单元格图表」 用新参数刷新另一个单元格中的图表 其他链接类型
「显示悬浮图表」 点击处弹出悬浮图表 其他链接类型
「执行JavaScript」 在浏览器中执行一段脚本 其他链接类型
「发送事件」 向嵌入报表的宿主页面发送自定义事件 发送事件链接

操作步骤

  1. 选中要点击的单元格,在「单元格属性」面板切换到「链接」页签。
  2. 点击「添加链接」,从下拉菜单选择链接类型,打开链接设置对话框。
  3. 填写「链接名称」(必填,默认取类型名称)和该类型的专有设置。
  4. 需要传值时,在「参数配置」表格中添加参数,逐行设置「参数」名称与「值」。
  5. 点击「确定」。对话框底部的「使用指南」可打开应用内说明。
  6. 保存后在预览页点击该单元格验证。

参数配置

「参数配置」表格有两列:「参数」和「值」。每行的值有四种取值方式,通过值左侧的下拉框选择。

取值方式 说明 实际保存的写法
「固定文本」 把输入的文字原样作为参数值 文本
「本格的值」 当前单元格显示的值 表达式 $$value
「取本行字段」 取当前行数据集中某个字段的值;字段列表来自当前单元格或其父格绑定的数据集 表达式 $$record.字段名,字段名含特殊字符时为 $$record['字段名']
「表达式」 手写表达式,可引用其他单元格,如 A4,双击输入框或点击右侧按钮打开表达式编辑器 表达式

注意:选错取值方式不会报错,只会传错值。例如把单元格名 A5 输入为「固定文本」,目标报表收到的是字面量 A5,而不是 A5 的内容。

「报表链接」类型的「参数配置」下方有「读取目标模板参数」按钮,读取目标报表已声明的参数名。参数名在目标报表中不存在时,名称输入框内出现警告图标,提示「目标报表未声明该参数,传过去不会生效」。其他类型使用「添加参数」按钮手工添加。

多个链接

单元格配置了多个链接时,点击单元格弹出菜单,每项显示链接名称,点击菜单项执行对应链接。只配置一个链接时,点击即执行。

打开新的链接前,页面会先关闭已打开的对话框和悬浮图表。

导出

单元格链接依赖报表运行时。导出 Excel 时只还原「网页链接」为 Excel 原生超链接,其余 6 种类型不导出。一个单元格只能挂一个超链接,配置了多个网页链接时取第一个可导出的地址。

注意事项

注意:网页链接的地址只放行 http、https、相对路径、锚点等,javascript:、vbscript:、file: 等协议会被拦截,不会打开。

提示:更改查询参数、联动单元格图表等类型使用当前查询表单的值,需要目标参数已在报表中声明,见参数类型、默认值与传参。

相关文档

联系我们

请填写您的信息,我们将在 1 个工作日内与您联系。