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

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?authId={authId}&请求参数=xxxxxxx#/{targetVolume}

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

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

组成说明

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

3 请求参数

3.1 明文请求参数

参数名
类型
默认值
说明
authId string 【可选】登录乐创者服务成功后返回的authId值或匿名authId(anonymous_admin)
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