需要根据表单编码发起指定流程,翼飞生成一个表单实例appRunId;每个表单实例运行期间会生成多个任务ruWfTaskId,任务推送时会推送appRunId和ruWfTaskId,调用翼飞接口进行流程操作(例如审批,驳回,转交等)也需将这两个参数传递回来。
URI
POST https://yifei-global.ctapi.ctyun.cn/v1/forms/instances/startFlow
请求体
名称 | 类型 | 是否必填 | 描述 |
---|---|---|---|
formCode | String | 是 | 表单编码,例如"614e7bbc413a44b6a4ad8588c6c09ac6" |
flowParam | String | 是 | 表单数据,例如{"seqNo":"001","startUserId":"11111","FC0000001":"条件1"}。需要注意人员控件和组织机构控件的数据需要放在数组中。例如:"FC000002":"['user1']" |
createUserId | String | 是 | 翼飞用户id |
outSysInstanceId | String | 否 | 外系统实例id,不能重复 |
返回结果
名称 | 类型 | 描述 |
---|---|---|
code | String | 响应状态,0表示成功,非0表示失败 |
msg | String | 返回信息 |
appRunId | String | 返回数据,翼飞的表单实例id |
示例
请求示例
POST https://yifei-global.ctapi.ctyun.cn/v1/forms/instances/startFlow
{
"createUserId": "xxx",
"flowParam": {
"FC0000001": "销售",
"FC0000002": "产品",
"FC0000003": "v2.0",
"FC0000005": "销售注意事项"
},
"formCode": "xxx",
"outSysInstanceId": ""
}
正常返回示例
{
"msg": "提交成功",
"appRunId": "xxx",
"code": "0"
}