本文档重点阐述第三方系统中如何整合数智大屏预览页面。
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
最后编辑:柳杨 更新时间:2025-04-22 15:31
