待办通知场景

适用于无对应申请流程的任务数据对接，只是对任务处理人做一个消息通知功能，只在门户端处理人的待办/已办任务列表展示。

门户展示

接入流程

涉及接口：创建/更新任务

创建待办任务

用户首次发起申请时需要在待办中心创建一条申请任务，同时向审核人发送待办任务。

请求体

字段名	参数名	必填	类型	描述
新增任务信息	insertModel	*M	List<InsertModel>	新增任务信息

InsertModel

字段名	参数名	必填	类型	描述
第三方任务ID	taskId	M	String(64)	任务业务主键，由第三方提供。业务系统唯一，可使用英文、数字、下划线组成，长度小于64位
业务场景编码	sceneCode	O	String(128)	业务场景编码；可通过查询业务场景进行获取
任务主题	subject	M	String(300)	任务主题
紧急程度	priority	M	integer	1：特急 2：紧急 3：一般 用于展示标签在门户中，并快速筛选
任务类型	taskType	M	integer	1：待阅 2：分发 3：普通 4：内部待阅3.7.3.Beta1+ 5：内部分发3.7.3.Beta1+ 除普通类型外，待阅及分发流程办结后，任务继续保留待办（第三方业务特殊逻辑）
过期时间	expireTime	O	String	过期时间（yyyy-MM-dd HH:mm:ss）
发起人类型	initiatorType	M	integer	1：学工号
发起人ID	initiatorId	M	String(50)	当initiatorType=1，传学工号
用户范围类型	objectScope	O	integer	1：校内用户（默认） 2：校外用户
处理人列表	processors	M	List<Processor>	处理人列表，标记这个待办任务接收人
pc待办任务地址	pcViewUrl	O	String(512)	pc待办任务地址，点击后的跳转地址，建议传入
h5待办任务地址	h5ViewUrl	O	String(512)	h5待办任务地址，点击后的跳转地址，建议传入
处理类型	processType	O	integer	或签/会签逻辑 1:只需要一个人处理 2:所有人都需处理 默认为1
服务ID	serviceId	O	String(128)	所属服务ID，用于统计和门户展示，建议传入
服务名称	serviceName	O	String(300)	所属服务名称，用于统计和门户展示，建议传入

Processor

字段名	参数名	必填	类型	描述
处理人类型	processorType	M	integer	1：学工号
处理人ID	processorId	M	String(50)	当processorType=1，传学工号
用户范围类型	objectScope	O	integer	1：校内用户（默认） 2：校外用户

请求示例

{
    "insertModel": [{
        "sceneCode": "xxx",
        "taskId": "xxx1",
        "subject": "标题",
        "priority": 1,
        "taskType": 3,
        "expireTime": "2023-12-07 12:00:00",
        "initiatorType": 1,
        "initiatorId": "user01",
        "processors": [
            {
                "processorType": 1,
                "processorId": "user02"
            }
        ],
        "pcViewUrl": "http://img.wisedu.com",
        "h5ViewUrl": "http://img.wisedu.com",
        "serviceId": "xxx",
        "serviceName": "xxx",
        "processType": 1
    }]
}

Demo

java

// 创建客户端
Client client = new DefaultClient(BASE_URL, APP_ID, APP_SECRET);
// 创建请求对象
SimpleTaskAddRequest request = new SimpleTaskAddRequest();
SimpleTaskAddRequest.SimpleTaskAddModel model = new SimpleTaskAddRequest.SimpleTaskAddModel();
model.setTaskId("20240808");
model.setSceneCode("testCode1");
model.setSubject("test20240808");
model.setInitiatorId("xxx");
model.setServiceId("xxx");
model.setServiceName("xxx");
model.setProcessors(Arrays.asList(new Processor("user01")));
model.setPcViewUrl("http://www.pc.url");
model.setH5ViewUrl("http://www.h5.url");
request.setSimpleTaskAddModelList(Arrays.asList(model));
BaseResponse response = client.execute(request);
//调用成功，则处理业务逻辑
if (response.isSuccess()) {
    //.....
}

更新待办任务状态

将用户的待办任务变更为已办任务

请求体

字段名	参数名	必填	类型	描述
更新任务信息	updateModel	*M	UpdateModel	更新信息

UpdateModel(返回)

字段名	参数名	必填	类型	描述
任务信息列表	taskModels	*M	List<TaskModel>	需要更新的任务信息

TaskModel(返回)

字段名	参数名	必填	类型	描述
第三方任务ID	taskId	M	String(64)	任务业务主键，由第三方提供
处理人ID	processorId	M	String(50)	处理人ID
处理人类型	processorType	O	integer	1：学工号 2：业务侧自定义
用户范围类型	objectScope	O	integer	1：校内用户（默认） 2：校外用户
任务状态	status	M	String	ACTIVE（激活） COMPLETE（完成） ROLLBACK（退回） WITHDRAW（撤回） TRANSFER（移交） DELEGATE（委派） ABORT（终止）
处理意见	taskComment	O	String(1000)	处理意见
pc已办任务地址	donePcUrl	O	String(512)	pc已办任务地址。如果第三方待办和已办地址不同，需要传入
h5已办任务地址	doneH5Url	O	String(512)	h5已办任务地址。如果第三方待办和已办地址不同，需要传入
任务结束时间	taskEndTime	O	String	任务结束时间（yyyy-MM-dd HH:mm:ss），默认系统当前时间
更新时间	updateTime	O	String	更新时间 （yyyy-MM-dd HH:mm:ss），默认系统当前时间

请求示例

{
    "updateModel": {
        "taskModels": [{
            "taskId": "xxx",
            "processorId": "user01",
            "processorType": 1,
            "status": "COMPLETE",
            "processInstanceImgUrl": "http://img.wisedu.com",
            "processInstanceRecordUrl": "http://img.wisedu.com",
            "updateTime": "2023-08-07 12:00:00",
            "taskComment": "同意",
            "donePcUrl": "http://img.wisedu.com",
            "doneH5Url": "http://img.wisedu.com",
            "taskEndTime": "2023-08-07 12:00:00"
        }]
    }
}

Demo

java

// 创建客户端
Client client = new DefaultClient(BASE_URL, APP_ID, APP_SECRET);
// 创建请求对象
SimpleTaskModifyRequest request = new SimpleTaskModifyRequest();
SimpleTaskModifyRequest.SimpleTaskModifyModel model = new SimpleTaskModifyRequest.SimpleTaskModifyModel();
model.setTaskId("20240808");
model.setProcessorId("xxx");
model.setStatus(TaskStatusType.COMPLETE);
model.setTaskComment("已阅");
model.setDonePcUrl("http://done.pc.url");
model.setDoneH5Url("");
request.setSimpleTaskModifyModelList(Arrays.asList(model));
BaseResponse response = client.execute(request);
//调用成功，则处理业务逻辑
if (response.isSuccess()) {
    //.....
}

创建任务时发送消息【可选】

自闭环查看任务详情【可选】

自闭环处理任务【可选】