场景报表

1 集成说明
2 访问规范
3 请求参数
3.1 通过明文方式访问
3.2 通过密文方式访问(推荐使用)
4 前端事件
5 工具栏
6 整合示例
7 常见问题

场景报表是一种能够把智能报表、跨设备表单、第三方页面等整合到一起的一种报表类型，适合作为主页、大屏显示等。

1 集成说明

请参考智能报表集成说明。

2 访问规范

智能报表页面URL规范：

Method：GET 
URL(格式1)：{http}://{ip}:{port}{/lczServer}/hrServlet?请求参数
URL(格式2)：{http}://{ip}:{port}{/lczServer}/hrServlet?opt=sceneView&请求参数

组成说明
{http} 网络协议名称，支持http或https两种协议
{ip} 乐创者服务部署所在的 Internet 主机名，支持ip地址或域名
{port} 乐创者服务部署所在Web应用服务器的访问端口。如果是80或443端口，可缺省
{lczServer} 乐创者服务应用名，乐创者服务部署时的应用上下文根目录(Web Context-root)，可根据业务需要调整为其他名称。当乐创者服务代码发布在“ROOT”目录下时，内容为空即可。

3 请求参数

支持明文和密文两种传参方式。

注意：
参数值包含中文或特殊字符时需URL编码。
javascript代码示例：url += ‘&variants=’ + encodeURIComponent(‘年份=2019;月份=1’)
java代码示例：url += “&variants=” + java.net.URLEncoder.encode(“年份=2019;月份=1”, “UTF-8”)

3.1 通过明文方式访问

必选参数

参数名	类型	说明
targetVolume	string	报表模板文件所属应用内部名称。
fileName	string	报表模板文件内部名称。
authId	string	可使用登录乐创者服务成功后返回的authId或匿名authId。非匿名方式访问:&authId=xxxxxxxxxxxx 如果系统配置中开启了‘允许匿名登录’，则可通过匿名方式直接查看报表。匿名方式访问:&authId=anonymous_admin

可选参数

参数名	类型	默认值	说明
variants	string		拼接格式：&variants=参数1=参数值1;@参数1=参数显示值1;参数2={year()};…参数n=参数值n; 注意： 1、参数值使用”{“、”}”括起来的代表支持脚本解析，如:年份={year()}。 2、通过variants传入的同名报表参数将默认不在参数页面显示，如需要显示则需要通过displayVarNames传入要显示的参数名。
fileAlias	string	缺省使用报表模板文件的显示名称作为标题。	显示在浏览器或窗体上的标题内容，允许通过传参进行个性化显示。
displayVarNames	string		在参数区域显示的报表参数名称。如果通过variants传递了参数或变量的默认值，某些参数需求在参数页面中显示出来的，则通过本参数指定。值格式：参数1,参数2,…参数n
showParamPanel	boolean	true	是否显示参数面板

3.2 通过密文方式访问(推荐使用)

通过密文方式情况，安全性比较高，可以有效的防止用户恶意访问报表或随意篡改传参值。

参数说明

参数名	类型	默认值	说明
v	string		加密后的请求参数串。注意：v的参数值，需要通过privilege_type参数传入解密处理的认证类，缺省为：default。
privilege_type	string	缺省使用乐创者门户中指定的认证类型	【可选】传入第三方认证的认证类型。
validateVariants	string		【可选】传入第三方认证相关参数。可传递多个参数，格式如下： &validateVariants=认证参数1=参数值;认证参数2={year()};…认证参数n=参数值