保存并提交表单

一、应用场景

在三方系统里发起单据 然后传到YonSuite并发起审批流程， 该接口不支持上传附件， 支持绑定附件地址信息（即如果需要上传附件，需要先将附件上传到外网可访问的服务器，然后将生成的访问地址，传到表单附件字段即可，具体操作情况下文请求JSON示例）

二、接口调用

三、获取表单模型

3.1、pkBo怎么获取?

协同表单预览查看地址栏，具体操作如下图：

3.2、请求参数

{
    "pkBo": "f967562a7316435aa7b193643aac8fd5",
    "appSource": "approve"
}

3.3、返回结果

• 取出columncode

• 如果存在子表，使用pk_sub_bo

• 如果存在枚举，从对应字段中取selectionId

四、提交表单传参

4.1、iformUserId怎么获取?

一般情况要求三方系统用户信息手机号和YonSuite用户手机号匹配。 根据手机号获取YonSuite用户唯一标识yhtUserId(iformUserId)

• 调用接口，接口名称：【根据手机号邮箱用户名分页查询租户下用户】

• 接口文档地址：查看常见问题

• 返回JSON中的userId就是我们需要的iformUserId

4.2、请求JSON

{
    "startProcess": true,
    "addData2ES": true,
    "iformUserId": "0f059088-9c92-4769-a3e7-8f1a341cc3df",
    "formData": [{
        "columnCode": "wb1_1649235307067854",
        "value": "1222"
    },
    {
        "columnCode": "wb2_1649235307067516",
        "value": "1333"
    },
    {
        "columnCode": "xx_1649235307068237",
        "value": "20220406165413C6HrJoLb0N"
    },
    {
        "columnCode": "fj_1590733790029381",  //附件字段编码
        "value": [{
            "filename": "2.png",  //附件名称
            "filesize": 19696,  //附件大小
            "name": "2.png", //附件名称
            "size": 19696,  //附件大小
            "type": "image/png",   //附件类型
            "url": "http://cs-doc-manager.test.app.yyuap.com/mybook/selfbuild/images/1.png"   //附件地址
        }]
    }],
    "subFormMap": {
        "6ceb513409a646a8bad56297f8270dc2": [{
            "formData": [{
                "columnCode": "wb111_1649235307068441",
                "value": "eee"
            }]
        }],
        "62154772c6524b16b4751e5015b2545c": [{
            "formData": [{
                "columnCode": "wb221_1649235307068644",
                "value": "eee221"
            }]
        }]
    },
    "pkBo": "f967562a7316435aa7b193643aac8fd5"
}

五、常见问题

• 根据以上接口名称，按照以下文档查找接口文档信息

开发必读