本章节重点讲述第三方系统中如何整合跨设备表单智能识别页面这种模式。

1 集成说明

请参考跨设备表单列表页面,这里不再敖述。

2 访问规范

Request Method:GET
Request URL(公开访问,不需要身份验证的):
    {http}://{ip}:{port}/{lczServer}/creater/~source/auto/!autoRedirect?VolumeName={VolumeName}&FileName={FileName}{&其他参数}

Request URL(需要身份验证的):
    {http}://{ip}:{port}/{lczServer}/creater/~source/auto/!autoRedirect?VolumeName={VolumeName}&FileName={FileName}&authId={authId}{&其他参数}

组成说明

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

3 请求参数

参数值包含中文或特殊字符时需URL编码。
javascript代码示例:url += encodeURIComponent(字段标识) + encodeURIComponent(‘值’)
java代码示例:url = url + java.net.URLEncoder.encode(“字段标识”, “UTF-8”) + java.net.URLEncoder.encode(“值”, “UTF-8”)

必选参数

参数名
类型
默认值
说明
authId string 登录乐创者服务成功后返回的authId值或匿名authId(anonymous_admin);如果没有authId可通过privilege_type进行实时认证获取。
VolumeName string 所属应用内部名称
FileName string 跨设备表单内部名称

可选参数

参数名
类型
默认值
说明
NoneRowStyle string Error 按照参数过滤后,无数据记录时的处理规则。可选值:
Insert:进入新增页面;
Error:进入错误提示页面。
NoneRowErrorMessage string 无数据记录时,进入错误页面显示的错误提示内容。
OneRowStyle string 无缺省值,必需指定页面类型。 按照参数过滤后,匹配出一行据记录时的处理规则。可选值:
Insert:进入新增页面;
Update:进入修改页面;
Detail:进入详情页面;
Error:进入错误提示页面。
OneRowErrorMessage string 一行数据记录时,进入错误页面显示的错误提示内容。
MultipleRowStyle string Error 按照参数过滤后,匹配出多行据记录时的处理规则。可选值:
List:进入列表页面。
Error:进入错误提示页面。
MultipleRowErrorMessage string 多行数据记录时,进入错误页面显示的错误提示内容。
__SearchConfig json 参考下面格式

__SearchConfig参数值的格式:

{
    "Hide":false,    //【可选】参数面板是否显示,缺省为:false
    "Auto":false,    //【可选】是否使用参数默认值直接查询列表结果,缺省为:false
    "Fields":[{
        "NickName":"字段标识",
        "Hidden":false,    //【可选】在参数面板中是否隐藏,缺省为:false
        "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
最后编辑:柳杨  更新时间:2025-04-22 15:31