超级链接传参

1. 概述

1.1 传参原理

超级链接设置参数一般是为了实现动态钻取其他报表、联动组件或图表等效果。

参数在超级链接中是起到一个钥匙的作用，而目标模板的参数就相当于是一个房门的门牌号。

因此在定义超级链接时，定义的参数名就相当于这个房间的钥匙，只有钥匙配对了门牌号，才能打开房门拿到想拿的东西。

所以我们在设置超级链接时，设置的参数名一定要和目标模板的参数名一致，才能将参数传递到目标模板，查看到对应的内容。

注：继承报表的参数功能暂不支持 value() 函数。

1.2 功能入口

除了 超级链接-邮件 不支持配置参数，其他类型的超链都可以设置参数，配置参数的位置如下图所示：

2. 超链参数配置项

2.1 参数传递方式

有两种参数传递的方式，它们的区别如下：

• GET：效率高，但不安全，传递的参数会显示在 URL 后面，且长度不能超过 1K 。

• POST：参数个数及值的长度没有限制，且参数不会显示在 URL 后面，安全但效率低。

2.2 展示参数界面

• 勾选：如果目标模板有参数界面，此时超链到此模板时，参数界面会显示出来。

• 不勾选：如果目标模板有参数界面，此时超链到此模板时，参数界面不显示，直接将数据展示出来。

2.3 添加参数

参数区域右上角有5个按钮，其作用分别如下：

• 插入：新增一个参数，用户需要手动写参数名和值。
  

• 删除：选中参数，点击该按钮即可删除该参数。

• 上移：选中参数，点击该按钮参数位置上移。
  

• 下移：选中参数，点击该按钮参数位置下移。

• 模板参数：只有网络报表类型的超链有该按钮，如果已经设置好了目标模板，点击该按钮会将目标模板的参数添加进来，但是只有参数名没有值。

图表的超链添加参数时，其值可以是分类、系列这样的图表内置指标，典型应用参见文档：词云实现点击关键字进行百度搜索

2.4 继承报表的参数

若当前模板有参数的名称跟目标模板相同，此时可以直接勾选超级链接设置界面左下角的「继承报表参数功能」，不需要在这个界面重新定义。

注：只有网络报表和网页链接这两种超链的界面有该设置项，其他类信息超链不支持。

举个例子演示下，比如“主模板”设置超链链接到“目标模板”，其中主模板已经设置了一个模板参数 test，目标模板中单元格中也设置了参数 test。

此时想要将主模板中这个参数传递给目标模板，只需要勾选「继承报表参数功能」即可，无需再次定义。

最终传参效果如下图，如果不勾选「继承报表参数功能」，是传不过去的。

注：继承报表的参数功能暂不支持 value() 函数。

3. 超链传参示例

超链传参的简单示例可参见文档：超级链接到有参数的模板