描述
添加工作流实例。
请求
URL
https://api.dadayun.cn/v1/workflow/templates/$id/instances/$instanceId
HTTP请求方式
PUT
HTTP请求参数
名称 | 是否必需 | 类型 | 描述 |
---|---|---|---|
id | 是 | String | 工作流模板Id |
$instanceId | 是 | String | 工作流实例Id |
isImportant | 否 | Boolean | 是否重要 |
isUrgent | 否 | Boolean | 是否紧急 |
wfCategory | 否 | String | 菜单类别 |
wfDataObjectInstances | 是 | Object[] | 工作流表单对象实例列表字符串。 参考公共参数 WFDataInstances |
actors | 否 | Object[] | 指定审批者字符串。 参考公共参数 actors |
isSubmit | 是 | String | 是否正式提交 |
keyOption | 否 | String | 字段属性类型 |
- wfDataObjectInstances 参数说明:
名称 | 是否必需 | 类型 | 描述 |
---|---|---|---|
Id | 是 | String | Id |
ObjTplId | 是 | String | 表单模板ID |
WFInstanceId | 是 | String | 工作流实例ID |
ObjDataInstanceId | 否 | String | 表单实例ID |
WFDataTplId | 是 | String | 工作流对象ID |
ObjName | 是 | String | 表单模板名称 |
ReportData | 否 | String | 报表查询信息 |
JsonFormData | 否 | String | 主表单实例数据字符串 |
响应
- 返回参数
返回获取工作流审批历史,数据项参数说明:
名称 | 类型 | 描述 |
---|---|---|
Id | String | 工作流实例Id。 |
Title | String | 工作流实例标题。 |
IsImportant | Boolean | 是否重要。 |
IsUrgent | Boolean | 是否紧急。 |
Status | Integer | 工作流运行状态 - 1 完成,- 2 暂停,- 3 停止,- 4 创建,- 5 运行。 |
CurrentNodeId | String | 当前执行节点Id。 |
CurrentNodeName | String | 当前执行节点名称。 |
CurrentActors | String | 当前执行执行者,多个用逗号分隔。 |
ApproveText | String | 当前执行节点通过按钮文字。 |
RejectText | String | 当前执行节点驳回按钮文字。 |
IsTempCommit | Boolean | 当前岗位是否有提交草稿权限。 |
IsCommit | Boolean | 当前岗位是否有提交保存权限。 |
IsSplitApprove | Boolean | 当前岗位是否有分拆审批权限。 |
SplitItemListFields | String | 当前执行节点主单据可分拆审批的子表控件Id。 |
IsApprove | Boolean | 当前岗位是否有审批权限。 |
IsVeto | Boolean | 当前岗位是否有流程控制权限。 |
IsWithdraw | Boolean | 当前岗位是否有流程撤回权限。 |
IsContinue | Boolean | 当前岗位是否有流程继续权限。 |
IsSuspended | Boolean | 当前岗位是否有流程暂停权限。 |
IsTerminated | Boolean | 当前岗位是否有流程停止权限。 |
WFDataInstances | Object[] | 当前岗位是否有流程停止权限。参考公共参数 WFDataInstances |
示例
请求示例
HTTP/1.1
GET /v1/workflow/templates/55e91105-110e-44a2-b99d-37892cb5e7d6/instances/7d6b79d0-71bf-4043-8cbf-fac0cadf8e44
Host: api.dadayun.cn
Date: Thu, 30 Aug 2018 02:55:22 GMT
{
"Id":"0ed27108-4348-45f2-8eec-95bf3ce38dcf"
"title": "出差申请单",
"isImportant": true,
"isUrgent": true,
"wfCategory": "",
"wfDataObjectInstances":[{
"Id": "87bde971-d158-4db3-8892-f93db80d814c",
"ObjTplId": "86d5d192-93ac-44d3-9542-ac1d91687a57",
"WFDataTplId": "9467915d-7bc5-4a37-9b68-ce883c071fd0",
"ObjType": 1,
"ObjName": "出差申请单",
"ReportData": null,
"MustBeNew": true,
"JsonFormData": "{\"Field1\":\"业务管理员\",\"Field2\":\"业务管理员\",\"Field2\":\"总经理办公室-总经理\",\"Field4\":\"\"}"
}]
"isSubmit": true
}
正常返回示例
HTTP/1.1 200 OK
Date: Thu, 30 Aug 2018 02:55:22 GMT
Content-Type: application/json; charset=utf-8
{
"Id": "0ed27108-4348-45f2-8eec-95bf3ce38dcf",
"Title": "新建出差申请单_2018-09-06_39834",
"IsImportant": true,
"IsUrgent": true,
"Status": 5,
"CurrentNodeId": "6d68491e-577e-4c46-8021-86f2332fa9e8",
"CurrentNodeName": "部门经理审批",
"CurrentActors": "总经理-业务管理员",
"ApproveText": "同意",
"RejectText": "不同意",
"IsTempCommit": false,
"IsCommit": false,
"IsSplitApprove": false,
"IsApprove": true,
"IsVeto": true,
"IsWithdraw": true,
"IsContinue": false,
"IsSuspended": true,
"IsTerminated": true,
"WFDataInstances": [
{
"Id": "87bde971-d158-4db3-8892-f93db80d814c",
"WFInstanceId": "0ed27108-4348-45f2-8eec-95bf3ce38dcf",
"WFDataTplId": "9467915d-7bc5-4a37-9b68-ce883c071fd0",
"DataInstanceId": "2be87695-58d3-4822-b2eb-173004903b17",
"ObjName": "新建出差申请单_2018-09-06_39834",
"ObjType": 1,
"ObjTplId": "86d5d192-93ac-44d3-9542-ac1d91687a57",
"ObjDataInstanceId": "2be87695-58d3-4822-b2eb-173004903b17",
"MustBeNew": true,
"ObjTplName": "出差申请单"
}
]
}
异常返回示例
HTTP/1.1 404 Internal Server Error
Date: Thu, 30 Aug 2018 02:55:22 GMT
Content-Type: application/json; charset=utf-8
{
"Code": "Invalid_Workflow_NotFound",
"Message": "名称等于“xxx”的工作流模板不存在"
}
HTTP/1.1 500 Internal Server Error
Date: Thu, 30 Aug 2018 02:55:22 GMT
Content-Type: application/json; charset=utf-8
{
"Code": "InternalError",
"Message": "未知错误"
}