本章节重点讲述第三方系统中如何整合流程发起表单直接发起流程。

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#/insert?请求参数

组成说明

{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”)

3.1 必选参数

参数名
类型
默认值
说明
privilege_type string
缺省使用乐创者门户中指定的认证类型
传入第三方认证的认证类型。
v string 加密后的相关参数信息

3.2 v参数的原始内容组成

参数名
类型
默认值
说明
targetVolume string 工作流发起表单所属应用内部名称
fileName string 工作流发起表单的内部名称。
validateVariants string 【可选】传入第三方认证相关参数。
可传递多个参数,格式如下:
认证参数1=参数值;认证参数2={year()};…认证参数n=参数值
字段标识 string 【可选】字段标识:一般用于新增页面,需要强制指定字段默认值的字段标识及字段的默认值。
__InsertConfig string 新增字段的部分可选配置,该参数在740以及后续版本提供

__InsertConfig参数值的格式:

{
    "Fields":[{
        "NickName":"字段标识",
        "DecodeExecute":"REVERSE"//【可选】参数控件在解码时使用名称获取值,默认DECODE正常解码 
    }]
}

v的原始内容拼接格式:targetVolume=xxx&fileName=xxx&字段标识1=字段1值&字段标识2=字段2值

作者:柳杨  创建时间:2023-09-05 08:47
最后编辑:柳杨  更新时间:2025-12-12 12:20