学习目标

1. 掌握苍穹流程任务如何与第三方系统集成；

2. 掌握通过API接口方式获取苍穹任务的实现方式；

3. 掌握标准产品中预置的消息渠道推送流程任务的实现方式；

4. 掌握扩展苍穹消息渠道推送待办流程任务的实现方式。

内容简介

本课程会讲解如何将苍穹流程任务集成到第三方系统。

背景

随着企业信息化的建设，大多数的企业都会同时使用多个业务或协同办公系统，为了方便处理工作，企业通常会将待办任务集中某个处理中心进行处理，因此也产生了将苍穹流程任务集成到第三方系统的需求。

影响因素

与第三方系统集成过程中，开发设计时需关注人员信息同步和免登录这两个比较关键的问题。

（1）人员信息同步

推送待办任务至第三方渠道，需要以第三方系统的人员为基础，因此第三方系统人员信息如何同步至苍穹系统，并如何存储双方人员映射关系是一个基本问题。

（2）免登录

第三方系统接收到链接消息以及待办任务后，需要点击链接到苍穹审批处理页面，为了方便用户使用，需要处理第三方系统的登录认证问题。

这两步都在课程《第三方APP如何集成苍穹应用》介绍，此次不再赘述。

实现方式

目前苍穹流程任务集成第三方系统主要有两种实现方式：

（1）通过提供API接口方式，第三方系统查询获取待办任务信息等；

（2）通过集成第三方消息渠道推送待办任务。

通过API获取流程任务信息

接口说明

在客户的第三方系统列表界面调用苍穹工作流提供的API查询某个用户的待办列表，直接格式化融合显示，获取的结果中已经包含了苍穹审批界面的URL，可以直接打开URL进行审批。

工作流中已经提供了标准的获取待办任务等信息的接口，我们可以在开放平台中的API服务管理中的流程服务云，工作流服务中获取详细的接口名称，请求参数等。

在集成过程中比较常用的几个接口：

（1）获取待办任务：/app/wf/getToHandleTasksByUserId

（2）获取已办任务：/app/wf/getHandledTasksByUserId

（3）获取任务数量：/app/wf/getTaskCountByType

3.2接口调用测试

1.接口调用：接口调用需要获取accessToken信息，获取accessToken的方式这里不再赘述，有疑问的请参考

https://dev.kingdee.com/index/docsNew/6668c5c0-b547-4f55-8f74-cc6ea2f5c65c

2.结果演示

场景：获取用户ID920332164929707008的待办任务，限制返回10条；

请求地址：

http://localhost:8080/ierp/kapi/app/wf/getToHandleTasksByUserId?body={"userId":920332164929707008,"start":0,"limit":10}&access_token=1218732684788893696_7rp3jurPNll6XUKb9REHT4FYs4NGcBSQLF6niJA2Nr2H3pNj7aNU87eqLvhQtuKaO698KygXM3ecYKqGgXi2n9iewJaUGAm5ILnZ

注意：如果数据量较大时，需要分页拉取，参数start和limit

通过消息渠道推送流程任务信息

预制的消息渠道

苍穹系统目前预置了六种消息渠道---电子邮件、短信、云之家、钉钉、企业微信，华为Welink。用户可以根据自身需求修改六种的渠道配置参数信息，开发时在苍穹和第三方系统中完成消息渠道配置，具体消息渠道的配置见https://vip.kingdee.com/school/6110的第4节；最后需要在对应消息类型勾选要推送的消息渠道，如图，则该类型的消息才会实际推送到配置的渠道。

扩展消息渠道

这几种消息渠道能满足大部分用户的消息推送需求，若用户需要使用其他第三方移动办公软件，比如泛微OA，蓝凌OA等，则需要对消息渠道进行二次扩展开发，以满足个性化需求。

消息渠道实现类开发

需要继承kd.bos.workflow.engine.msg.handler.AbstractMessageServiceHandler抽象类，并复写抽象类中若干方法。在该类中实现创建待办、处理待办、删除待办、推送消息等相关逻辑内容，具体逻辑可以参考原厂标准云之家渠道解析类YunzhijiaServiceHandler。

以下为复写关键方法说明：

（1）createTodo方法：工作流中的待办任务创建之后，会调用此接口。

public void createToDo(MessageContext ctx, ToDoInfo info){

1. 流程节点任务，创建待办；

2. todoInfo&messageContext中包含了绝大部分场景中待办所需参数数据；

3. 在该方法中调用接口，推送待办任务；

4. 标准产品中没有记录待办日志，二开根据需求决定是否将待办日志落库处理,数据库表以及落库方式没有要求；

5. 在方法的逻辑执行过程中，若是出现异常，请向上抛出，系统会根据异常，自动重试再次推送待办；

6. 对于待办链接的改造可以在该方法中进行；

}

（2）dealTodo方法：工作流中将待办变成已办的时候，会调用此接口进行待办变已办的处理。

public void dealToDo(MessageContext ctx, ToDoInfo info){

1. 流程处理待办任务；

2. 在该方法中调用泛微接口，推送待办处理请求；

}

（3）deleteTodo方法：工作流中撤回，或者多人收到任务，其中一人审批，删除其他人的待办时，调用此接口。

public void deleteTodo(MessageContext ctx, ToDoInfo info){

1. 删除待办任务方法；

2. 转交任务、任务的处理都会调用该方法，删除掉泛微方的待办；

3. 工作流中撤回，或多人收到任务，其中一人审批，删除其他人的待办，会调用该方法

4. 在该方法中调用泛微接口，发起删除泛微待办请求；

}

（4）checkTodo方法：

public void checkTodo(MessageContext ctx, ToDoInfo info){

1.校验第三方待办处理情况，一般不复写该方法；

}

（5）sendMessage方法：

public void sendMessage(MessageContext ctx, MessageInfo message) {

1. 工作流的任务类消息，比如传阅、协办消息、节点消息、催办消息等都会推送到该方法中，业务调用消息中心接口推送的消息同理也会推送到该接口中；

2. 发送报警、预警、通知消息，调用该方法；

3. Ctx=null, 对于流程类消息，可以在messageInfo.getParam()方法中获取到ctx数据；

4. 调用推送消息接口，推送消息；

5. 若是调用接口部分请求失败，请向上抛出异常，异常方式可以参考原厂逻辑，系统会自动重试再次推送消息；

6. 对于链接消息中URL的改造可以在该方法中进行

}

（6）deleteProcessInstance方法：

public void deleteProcessInstance(MessageContext ctx, Long proceInstanceId){

1.若第三方系统中有流程，苍穹删除流程的动作会推送到该方法汇总，若第三方系统中没有流程相关，则无需复写该方法；

}

（7）completeProcessInstance方法：

public void completeProcessInstance(MessageContext ctx, Long proceInstanceId){

1. 若第三方系统中有流程，苍穹流程结束动作会推送到该方法汇总，若第三方系统中没有流程相关，则无需复写该方法;

}

消息渠道实现类配置

新增消息渠道：移动应用选择”其他“，填写对应的实现类，完成新增消息渠道界面配置。

说明

(1) 由于苍穹与第三方系统之间，通过网络关联，由于网略不稳定性等因素，可能导致消息推送失败，此时，可以在sendMessage方法中抛出异常，该异常被上游功能捕获，失败消息记录到消息日志列表中，等待重试机制重试；

参考YunzhijiaServiceHandler处理方式：

（2）待办创建、处理、删除若是遇到调用接口失败的情况，请抛出异常给上游逻辑，触发重试机制；参考YunzhijiaServiceHandler处理方式：云之家目前会先重试3次，失败再直接抛出等待定时重试

（3）第三方系统中待办请重视待办ID的唯一性问题，苍穹中多人处理的任务，taskId是一样的，针对有的第三方系统，可以拼接人员Id做唯一性处理。

参考文档

消息中心应用开发手册： https://vip.kingdee.com/school/6110

第三方系统集成苍穹流程任务

恭喜您！