本文档重点阐述第三方系统中如何整合数智大屏(弹性布局)发布页面。
注意:【弹性大屏V7.1.0版本新增】
1 集成说明
1.1 通过浏览器直接打开
包括以下几种方式:
1)、在新开页面中打开
2)、从当前页面跳转到跨设备表单页面
直接通过请求的URL串打开跨设备表单即可。
1.2 将跨设备表单页面作为业务系统页面的一部分
当把跨设备表单页面作为子模块内容集成到业务系统的某个页面中,作为该页面的一部分(常见的业务系统左边是菜单,点击菜单项时,右边显示整合内容)时,需要通过iframe标签方式加载。
<iframe src="跨设备表单访问URL" style="width:100%;height:600px;border:0px;" border="0" frameborder="0" ></iframe>2 访问规范
2.1 通过公开身份的方式访问
Request Method:GET
Request URL:{http}://{ip}:{port}/{lczServer}/lczMatrix/index.html?请求参数=xxxxxxx#/gridPublish/{releaseId}2.2 通过乐创者用户凭证的方式访问
Request Method:GET
Request URL(7.5.0及之前版本):{http}://{ip}:{port}/{lczServer}/lczMatrix/index.html?authId={authId}&请求参数=xxxxxxx#/gridPublish/{releaseId}
Request URL(7.5.1及之后版本):{http}://{ip}:{port}/{lczServer}/lczMatrix/index.html?lczticket={lczticket}&请求参数=xxxxxxx#/gridPublish/{releaseId}2.3 通过指定认证的方式访问
Request Method:GET
Request URL:{http}://{ip}:{port}/{lczServer}/lczMatrix/index.html?privilege_type=xxxx&请求参数=xxxxxxx#/gridPublish/{releaseId}2.4 通过跳转方式访问
在集成到第三方系统时,某些系统不支持路由地址中注入参数(即智能将参数追加到路由地址后面),可通过本方式进行跳转处理。
Request Method:GET
Request URL:{http}://{ip}:{port}/{lczServer}/matrix/gridPublish/{releaseId}?privilege_type=xxxx&请求参数=xxxxxxx组成说明
{http} 网络协议名称,支持http或https两种协议
{ip} 乐创者服务部署所在的 Internet 主机名,支持ip地址或域名
{port} 乐创者服务部署所在Web应用服务器的访问端口。如果是80端口,可缺省
{lczServer} 乐创者服务应用名,乐创者服务部署时的应用上下文根目录(Web Context-root),可根据业务需要调整为其他名称。当乐创者服务代码发布在“ROOT”目录下时,内容为空即可。
{releaseId} 大屏发布后的唯一标识3 请求参数
3.1 明文请求参数
参数名 |
类型 |
默认值 |
说明 |
|---|---|---|---|
| authId | string | 可使用登录乐创者服务成功后返回的authId或匿名authId。 非匿名方式访问:&authId=xxxxxxxxxxxx 如果系统配置中开启了‘允许匿名登录’,则可通过匿名方式直接查看报表。 匿名方式访问:&authId=anonymous_admin 注意:因v7.5.1版本平台改为JWT身份验证机制,本参数作废。 |
|
| lczticket | string | 【v7.5.1版本新增】访问报表的票据凭证,可通过调用乐创者平的的访问票据凭证接口获取。 注意:lczticket只能使用一次,每次请求报表访问都要重新获取。 |
|
| variants | string | 【可选】传入大屏参数,可传递多个参数,格式如下: 参数1=参数值;参数2={参数值};…参数n=参数值 注意:参数值使用’{‘,’}’包括时,代表参数值是js表达式 |
|
| privilege_type | string | 缺省使用在lczPortal中指定的认证类型。 |
【可选】传入第三方认证的认证类型。 |
| validateVariants | string | 【可选】传入第三方认证相关参数。 可传递多个参数,格式如下: 认证参数1=参数值;认证参数2=参数值;…认证参数n=参数值 |
|
| t | string | 【可选】动态的4位时间戳,用于防止前端页面缓存不更新 |
3.1 密文请求参数
参数名 |
类型 |
默认值 |
说明 |
|---|---|---|---|
| privilege_type | string | 传入第三方认证的认证类型 | |
| v | string | 【可选】密文传参方式时的加密内容 加密后的请求参数串,加密前的格式: authId=xxx&validateVariants=xxx&variants=xxx |
|
| t | string | 【可选】动态的4位时间戳,用于防止前端页面缓存不更新 |
作者:柳杨 创建时间:2026-01-23 11:25
最后编辑:柳杨 更新时间:2026-01-23 11:36
最后编辑:柳杨 更新时间:2026-01-23 11:36
扫码关注网盛数新公众号,获取更多帮助资料