页面树结构
转至元数据结尾
转至元数据起始

1、功能简介

报表宏是 Smartbi 里面的一项特殊功能,顾名思义,就是基于报表或页面资源的扩展,目的是为了让用户对报表进行自定义的改造。报表宏是 JavaScript 的代码集合体,我们也称之为宏模块。通过报表资源抛出的事件(如报表加载事件、报表刷新事件、参数改变事件、点击事件等)对宏脚本触发执行。

文档目录:

2、使用场景

报表宏用于对系统中,部分灵活分析报表、组合分析、透视分析、电子表格、多维分析报表和页面等报表或页面资源的改造。事实上只要撑握了报表宏的开发(见报表宏快速入门),完全可以让上述提到的报表资源按自己的意愿显示。如:

注意:如果所有同类报表都需要实现某个功能,除了考虑资源包,也可以考虑使用扩展包实现,譬如所有灵活分析都添加一个“指标解释”就可以考虑使用扩展包。

3、报表宏的特点

报表宏具有以下特点:

  •  报表宏以资源(报表资源、页面资源、资源包)为应用载体,类似于 Excel 宏是以 Excel 文件为载体;
  •  报表宏使用 JavaScript 语言开发;
  •  报表宏是按照事件进行触发(如报表加载事件、报表刷新事件、参数改变事件、点击事件等);
  •  在同一载体里面的报表宏可以相互引用。

4、术语及定义

术语

定义

宏代码库

工具宏用来定义一些公共的宏方法,将一些使用频率较高的方法定义为公共的方法,以便更好的重用,消除重复。各个报表资源的宏、宏资源包都可以使用use语法引用这里的方法。

宏资源包

资源包是具有相同特征的一类资源的集合。如来自相同数据源的多个报表资源或多个页面资源的集合。主要用于对多张报表或页面共享同一个宏。

宏控制台查看服务端宏代码的后台日志输出。
服务端模块

表示宏的事件由服务端触发,模块里面的宏代码由服务端进行处理,例如电子表格根据参数值隐藏行列-服务端宏

客户端模块

表示宏的事件由浏览器端触发,模块里面的宏代码由浏览器端进行处理,例如电子表格工具栏上添加按钮

宏模块

指的是宏脚本,即 JavaScript 代码集合。

跳转规则

跳转规则属于一类特殊的报表宏,是指专门实现报表之间关联跳转功能的报表宏,例如:分析流、报表下钻等分析。

 

  • 无标签