Appearance
任务结果反馈
任务数据主要为各项任务进行中的进度、结果等相关数据,通过统一的任务管理实现任务统一平台发布、总体进度管理等。任务结果反馈包括服务创建统一赋码、任务对象推送部署、任务状态开始关闭、任务采集结果反馈等,实现任务的状态跟踪和记录。调用接口前请 签名授权 确认相关权限。
1.任务创建统一赋码
任务中心中任务具有唯一的编码,任务创建统一赋码是根据统一规则创建唯一编码,各个应用需要记录该任务编码以便后续流程推进。本接口多次调用将产生不同编码,请注意留存。
yaml
URL: /bizp/xrwez/create
Method: POST
Content-Type: application/json
Accept: */*
Request:
Parameter | Type | Description |
---|---|---|
name | String | 任务名称 |
note | String | 任务描述 |
areaCode | String | 行政区划[国家为空串] |
bizType | String | 业务类型(1:教育/2:康复/3:就业/4:培训/5:保障/6:维权/7:文体/8:无碍/9:其他) |
btime | Date | 开始时间 |
etime | Date | 截至时间 |
appid | String | 应用标识(自定表单亦有) |
operator | String | 操作人员 |
Response:
Field | Type | Description |
---|---|---|
meta | Meta | 响应头部 |
success | boolean | 状态(true:成功/false:失败) |
message | String | 中文消息 |
data | Object | 响应内容 |
reid | String | 任务唯一标识 |
2.任务对象推送部署(多次)
任务对象指针对任务设定的残疾人对象,任务对象推送部署是将残疾人对象增加到任务中,本接口支持残疾人对象的多次推送,同一任务中残疾人对象不做重复校验,请各应用注意控制。
yaml
URL: /bizp/xrwez/object
Method: POST
Content-Type: application/json
Accept: */*
Request:
Parameter | Type | Description |
---|---|---|
reid | String | 任务标识 |
projCode | String | 主题标识 |
projName | String | 主题名称 |
operator | String | 操作人员 |
areaCode | String | 行政区划 |
citizenIds | String | 身份数组 |
Response:
Field | Type | Description |
---|---|---|
meta | Meta | 响应头部 |
success | boolean | 状态(true:成功/false:失败) |
message | String | 中文消息 |
data | Object | 响应内容 |
objs | Long | 推送成功对象数量 |
3.任务状态开始关闭
任务状态控制直接影响任务的执行,本接口用于各级对任务的开始/关闭进行控制,实现任务无人值守,任务状态切换不可逆,请各应用注意控制。
yaml
URL: /bizp/xrwez/status
Method: POST
Content-Type: application/json
Accept: */*
Request:
Parameter | Type | Description |
---|---|---|
reid | String | 任务标识 |
operator | String | 操作人员 |
state | String | 状态(1:开始/2:结束) |
Response:
Field | Type | Description |
---|---|---|
meta | Meta | 响应头部 |
success | boolean | 状态(true:成功/false:失败) |
message | String | 中文消息 |
data | Boolean | 是否成功(true:成功/false:失败) |
4.任务执行结果反馈
任务执行结果主要包括任务执行内容和任务执行进度两个部分。本接口为其他应用接入任务时提供必要的反馈机制,实现任务驿站的统一展示。本接口需要配合任务驿站对接使用。
yaml
URL: /bizp/xrwez/result
Method: POST
Content-Type: application/json
Accept: */*
Request:
Parameter | Type | Description |
---|---|---|
roid | String | 任务对象标识 |
dataJson | String | 数据JSON |
dataTime | Date | 数据采集时间 |
state | String | 状态(0:未采集/1:已采集/2:空采集) |
stateNote | String | 状态说明 |
operator | String | 操作人员 |
operateTime | Date | 操作时间 |
Response:
Field | Type | Description |
---|---|---|
meta | Meta | 响应头部 |
success | boolean | 状态(true:成功/false:失败) |
message | String | 中文消息 |
data | Boolean | 是否成功(true:成功/false:失败) |