跨设备表单(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