跨设备表单(lczCreater)是基于元数据技术为基础的简易、快速表单构造器工具,适合在PC、移动下有较好的呈现和交互体验,通过统一的配置,可一次性解决列表页面、新增页面、编辑页面、详情页面4种业务情景,本章节重点讲述如何把跨设备表单列表页面整合到第三方系统中。
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 访问规范
Request Method:GET
Request URL(不需要身份验证的):
{http}://{ip}:{port}/{lczServer}/lczCreater/index.html?#/list?targetVolume={targetVolume}&fileName={fileName}{&__SearchConfig=参数区域配置}
Request URL(需要身份验证的):
{http}://{ip}:{port}/{lczServer}/lczCreater/index.html?#/list?targetVolume={targetVolume}&fileName={fileName}&authId={authId}&__SearchConfig={参数区域配置}
组成说明
{http} 网络协议名称,支持http或https两种协议
{ip} 乐创者服务部署所在的 Internet 主机名,支持ip地址或域名
{port} 乐创者服务部署所在Web应用服务器的访问端口。如果是80端口,可缺省
{lczServer} 乐创者服务应用名,乐创者服务部署时的应用上下文根目录(Web Context-root),可根据业务需要调整为其他名称。当乐创者服务代码发布在“ROOT”目录下时,内容为空即可。
3 请求参数
必选参数
参数名 |
类型 |
默认值 |
说明 |
---|---|---|---|
authId | string | 登录乐创者服务成功后返回的authId值或匿名authId(anonymous_admin);如果没有authId可通过privilege_type进行实时认证获取。 | |
targetVolume | string | 所属应用内部名称 | |
fileName | string | 跨设备表单内部名称 |
参数值包含中文或特殊字符时需URL编码。
javascript代码示例:url += “__SearchConfig=” + encodeURIComponent(‘参数值’)
java代码示例:url = url + “__SearchConfig=” + java.net.URLEncoder.encode(“参数值”, “UTF-8”)
可选参数
参数名 |
类型 |
默认值 |
说明 |
---|---|---|---|
__SearchConfig | json | 参考下面格式 |
__SearchConfig参数值的格式:
{
"Hide":false, //【可选】参数面板是否显示,缺省为:false
"Auto":false, //【可选】是否使用参数默认值直接查询列表结果,缺省为:false
"Fields":[{
"NickName":"字段标识",
"Hidden":false, //【可选】在参数面板中是否隐藏,缺省为:false
"DecodeExecute":"REVERSE",//【可选】参数控件在解码时使用名称获取值,默认DECODE正常解码 该参数在740以及后续版本提供
"Value":{ //值或起始值
"NeedParse":false, //【可选】值是否需要脚本解析,缺省为:false
"Content":"过滤值"
},
"EndValue":{ //【可选】结束值
"NeedParse":false, //【可选】值是否需要脚本解析,缺省为:false
"Content":"过滤值"
}
}]
}
注意:如果不是区间参数,结束值不需要传递
认证参数
参数名 |
类型 |
默认值 |
说明 |
---|---|---|---|
privilege_type | string | 缺省使用乐创者门户中指定的认证类型 |
【可选】传入第三方认证的认证类型。 |
validateVariants | string | 【可选】传入第三方认证相关参数。 可传递多个参数,格式如下: &validateVariants=认证参数1=参数值;认证参数2={year()};…认证参数n=参数值 |
作者:柳杨 创建时间:2023-08-02 19:13
最后编辑:fanchengliang 更新时间:2025-04-22 15:31
最后编辑:fanchengliang 更新时间:2025-04-22 15:31
