本文档重点阐述第三方系统中如何整合数智大屏预览页面。

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#/publish/{releaseId}

2.2 通过乐创者用户凭证的方式访问

Request Method:GET
Request URL:{http}://{ip}:{port}/{lczServer}/lczMatrix/index.html?authId={authId}&请求参数=xxxxxxx#/publish/{releaseId}

2.3 通过指定认证的方式访问

Request Method:GET
Request URL:{http}://{ip}:{port}/{lczServer}/lczMatrix/index.html?privilege_type=xxxx&请求参数=xxxxxxx#/publish/{releaseId}

2.4 通过跳转方式访问

在集成到第三方系统时,某些系统不支持路由地址中注入参数(即智能将参数追加到路由地址后面),可通过本方式进行跳转处理。

Request Method:GET
Request URL:{http}://{ip}:{port}/{lczServer}/matrix/publish/{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(anonymous_admin)
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位时间戳,用于防止前端页面缓存不更新
作者:柳杨  创建时间:2023-06-07 12:01
最后编辑:柳杨  更新时间:2025-04-22 15:31