本文档重点阐述第三方系统中如何整合数智大屏(弹性布局)发布页面。
注意:【弹性大屏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