待办任务

简介

本文档介绍了任务的相关内容，如何创建、更新任务，待办中心开放了哪些接口，以及如何接入待办任务能力；

接入准备

应用管理处需打开待办的开关，确定应用授权了相关待办接口

名词解释

任务与流程

由用户在业务系统发起的线上审批内容；帮助用户在行政办公中，简化线下流程，更便捷的让用户可在同一个地方查询所有业务系统的需处理内容；

一个用户在业务系统发起申请后，将会有对应的流程产生，一个流程中涉及多个审批节点，每一个节点将产生一条任务，当节点有多个审批人，则每一个审批人将会收到一条任务；

待办与申请

待办为任务维度，申请为流程维度；

本文档中的待办，包含待办任务与已办任务，因为已办为待办任务的状态变更后发出的变化，固不做区分，统一为待办任务；

任务包含待办与已办数据，流程包含申请数据；

当用户发起审批内容，将会发起一整条审批流程，即为申请数据；对应到流程中不同节点审核人，将会拆分为一个个待办数据存在，当待办处理后该条待办数据将会变为已办数据；

当流程中所有的待办节点都变为已办并通过后，申请数据将为办结；

忽略任务

当有待办一直未处理时，待办中心将会给审批人发送待办处理提醒；

审批人可主动将某条待办任务打上忽略标签，当忽略后，不再接受有忽略标签的待办任务提醒；

同时对应的待办数据统计也会根据管理员配置的内容不展示被忽略的待办任务数据；

业务场景

可理解为任务的分类、标签，将来自于不同业务系统任务归类为同一分类；

如来自于OA、学工的请假审批，可同一存在于“请假审批”业务场景下；

同时门户中也可按照业务场景的维度展示任务数据；

催办任务

申请人可对发起的流程进行催办，催办后，当前节点的任务审批人将会收到催办的消息；

催办有两种：

• 业务系统本身包含催办的功能，可与任务中心进行对接，将催办状态接入至任务中心；

• 任务中心本身的催办功能，管理员可在展示任务的卡片中开启催办功能，用户即可点击催办，审批人将会在收件箱收到消息；

整体接入流程

重要提醒

业务系统与待办中心对接过程中，为了保证数据的实时性，建议业务系统添加如下逻辑：

• 待办任务发生变更后，及时调用任务中心接口完成待办信息的修改
• 业务系统需要增加定时补偿任务，当调用任务中心接口收到应答不是成功或超时，应认为调用失败，需要通过一定的策略定期重新发起，可参考间隔频率为：5m、10m、10m、1h、2h、6h、15h。
• 若基于重试策略最终仍无法调用成功，需要记录调用失败数据，允许用户手动重置标志后，重新触发，确保数据的最终一致性

常用API列表

名称	说明	版本
创建/更新任务（申请）	待办对接核心接口，用于在应用下发起待办任务和申请流程数据、流程流转时更新处理人的任务状态及申请流程状态；	3.6.1.Beta2+
修改待办任务	用于更新任务的字段内容，如任务名称、任务处理人等字段，不涉及状态变更；	3.4.1+
删除待办任务	用于物理删除应用下的待办任务数据；	3.5.4.Beta2+
删除申请	用于物理删除应用下的申请数据；	3.5.4.Beta2+

其它API列表

名称	说明	版本
查询待办列表	用于获取单个用户的任务列表数据；
查询待办统计	用于查询系统中的任务统计数据；
查询个人待办业务场景统计	用于根据业务场景统计用户的任务总数；
查询单条待办任务	用于获取具体的某条待办任务明细数据；	3.5.4.Beta2+
获取申请列表	用于获取单个用户发起的申请列表数据；
申请统计	用于查询系统中的申请统计数据；
更新待办忽略状态	用于某用户忽略/取消忽略待办任务；
更新待办阅读状态	用户标记某用户已读/未读待办任务；
更新待办缓办状态	标记某条待办任务的缓办状态；	3.7.3.Beta2+
创建待办任务	用于在应用下创建一个待办任务，可同时发起一条申请流程；
更新待办任务状态	用于更新任务处理人的处理状态；
取消待办任务	用于取消应用下的待办任务数据；
创建申请	用于在应用下发起一条申请流程；	3.5.5.Beta1.SP1-
更新申请	用于更新申请的字段内容，如申请节点、申请状态等；
删除申请	用于删除应用下的单条申请数据；
查询办结任务	用于获取流程已经办结的申请列表数据；	3.4.1+
查询办理意见列表	用于获取某条申请流程的全部办理意见数据；	3.4.1+
查询服务的待办数量	用于获取服务下的待办数量；	3.4.3+
创建业务场景分类	用于创建一个业务场景分类；	3.5.5.Beta1.SP1+
修改业务场景分类	用于更新单个业务场景分类的字段信息；	3.5.5.Beta1.SP1+
删除业务场景分类	用于删除业务场景分类数据；	3.5.5.Beta1.SP1+
查询业务场景分类	用于查询系统中的业务场景分类列表数据；	3.5.5.Beta1.SP1+
创建业务场景	用于在应用下创建一个业务场景；
修改业务场景	用于更新应用下的业务场景字段信息；
查询业务场景	用于查询应用下的业务场景列表；
删除业务场景	用于删除应用下的某个业务场景；
查询单个应用下的所有待办任务id	用于获取单个应用下的所有第三方任务ID列表数据；	3.6.2.SP2+
根据应用维度统计任务数据	用于查询某应用下的任务统计数据；	3.6.2.SP2+
待办补偿	用于业务系统将一段时间内容的待办任务推送至待办中心，由待办中心比对通过该接口推送的数据，是否一致，若否则进行数据补偿；	3.3.1.Beta2+