小编推荐

大企内部业务系统和自研OA种类繁多，想知道如何更加高效地整合、协同各个系统之间的信息交互，并融合OA系统，实现快速高效的资源整合和办公+业务管理一体化的办公平台？

本期OA系统集成的落地实践方案告诉你答案，基于金蝶云·苍穹平台，通过登录集成、页面集成和数据集成，让业务系统深度融合OA系统，实现高效协同办公~

案例撰稿人：徐玲。

1 业务背景

随着国家大力推动企业数字化转型，企业内部数字化建设需要各种业务系统来提高企业生产力，同时，市面上以协同办公为目的的移动OA办公平台也是层出不穷。

大企自研内部OA种类繁多，在业务数据量逐步增大的情形下，如何更加高效地整合、协同各个系统之间的信息交互，并且更好地融合OA系统，实现快速高效的资源整合和办公+业务管理一体化的办公平台，是一个值得深究的问题。

客户A在进行数字化转型过程中，面临以下痛点：

1、业务系统数量多，系统间数据封闭性较高，导致各个业务系统的基础数据交互不够流畅，同时人工维护的差异导致各系统的数据一致性较差。

2、OA办公系统厂商多，小厂自研OA或大厂主流OA的接口对接成本高、对接难度大，差异化明显。

3、随着企业规模增大，业务量剧增，需要用户深度参与的流程审批需求量巨大，尤其是针对财务审批、生产制造及供应链等相关系统的单据审批处理，加大了用户审批工作量。

4、当下企业对于业务响应的时效性要求越来越高，如何确保用户能够快速高效地实现异地办公协同，加快业务审批的效率，也是客户急需解决的痛点。

基于以上用户存在的痛点问题，不难发现，用户需要的是：

1、能够快速高效实现异构系统间基础数据交互能力的业务平台

打通各个业务系统之间的基础数据同步，确保人员、组织等基本信息在各个系统间无差异，并且可以实现多系统只需要用户在一个系统进行安全性验证登录后即可切换至其余业务系统及OA系统的能力，无需重新登录。

2、具备多种类，可扩展化的多OA系统集成能力的对接平台

预置各种常见的OA系统的快速集成对接的接口，并整合抽象，形成可配置化的OA系统对接方案，能够实现如企业微信、钉钉等常用OA协同办公系统的快速对接的能力。同时又开放与其他自研OA系统的可扩展接口。

3、拥有业务单据移动化、审批流程高效化的业务审批协作平台

拥有完善的业务工作流审批机制，能够满足各种场景、各种配置下的审批，并且兼具PC端及移动端的业务审批能力，提供多样化、便捷的审批入口。业务流转能够结合OA协同工具，实现异地快速响应处理。

2 解决方案

2.1 方案整体思路

针对以上问题，如何基于苍穹平台，让业务系统深度融合OA系统，实现高效协同办公，可以从以下三个方面入手：

登录集成：结合第三方登录认证平台或者基于OA系统已有的登录认证服务，实现用户一次登录认证，可无需再次登录后直接切换业务系统，即单点登录（SSO）。

页面集成：不进行整体的苍穹登录集成，且不需要切换系统，直接通过后台处理免登录的方式将苍穹业务单据等页面展示在OA系统平台，通过链接或者其他入口跳转打开页面，比如消息集成和待办集成。

数据集成：苍穹平台基于开放平台API的功能，以及集成方案的能力，实现OA系统与苍穹平台的基础数据等信息交互协同展示：将人员档案、组织信息、供应商或者银行信息进行数据交互，在两个系统进行展示。

2.2 涉及功能及实现步骤

单点登录（SSO）功能

单点登录业务时序图如下：

上传图片

图-单点登录业务时序图

实现步骤：

① 编写二开单点登录插件，类继承标准接口kd.bos.login.thirdauth.ThirdSSOAuthHandler并实现callTrdSSOLogin方法（拦截需要通过统一认证平台进行登录认证的链接，转发至CAS平台，进行登入、登出、转发）、以及getTrdSSOAuth方法（获取并解析CAS平台返回的token，解析携带的用户信息并登录放行），并部署至苍穹服务器。

以下为关键代码截图示例（完整代码见后文附录）：

上传图片

上传图片

② 进入MC（苍穹管理中心）中对应的数据中心配置页面，配置二开插件。

上传图片

图-配置二开插件

③ 进入MC的公共配置方案页面，在login.properties目录下，配置CAS server地址。

上传图片

图-配置CAS server地址

④ 登录访问http:[ip:port]/ierp/index.html链接，系统即可跳转至cas统一认证平台进行登录苍穹系统。此时，其他业务系统如果也实现了单点登录，也可直接进行与苍穹系统的业务切换，无需再次登录。

免登陆苍穹待办集成OA功能

实现步骤：

①继承标准的第三方待办对接接口kd.bos.workflow.engine.msg.AbstractMessageServiceHandler，并且实现createToDo方法（苍穹标准待办创建后触发），实现dealToDo方法（苍穹标准待办任务处理后触发），以及deleteToDo方法（苍穹标准待办删除后触发），并部署至苍穹服务器。

以下为关键代码截图示例（完整代码见后文附录）：

上传图片

上传图片

上传图片

② 进入【系统管理】应用→【消息平台】→【消息渠道】，新建消息渠道，配置对应需要对接的第三方消息渠道信息（此处以“丰声”为例），并在【实现类】中配置第一步的二开插件。

上传图片

图-新建消息渠道

上传图片

图-配置消息渠道

③ 进入【系统管理】应用→【消息平台】→【消息类型】，修改task任务，添加“丰声”为任务的一种消息渠道。

上传图片

图-消息类型中添加消息渠道

④ 对需要集成待办任务到OA系统的业务单据进行工作流配置，进入【工作流服务】→【管理中心】→【流程管理】，选中工作流中具体需要推送待办的审批流转节点，在右侧【审批设置】→【基本信息】页签中，【任务处理终端】配置选择“PC端和移动端同时处理”；并在【节点控制】页签打开“允许发送渠道待办”开关。

上传图片

上传图片

图-工作流属性配置

⑤ 配置完毕后，当苍穹端业务单据进入审批工作流程后，节点流转到节点“一级审批”时，第三方OA系统就会同步收到一条需要处理的待办任务。点击“详情”，即可跳转至苍穹的单据审批/查看页面。

上传图片

上传图片

图-OA系统收到待办任务示例

免登陆苍穹消息集成OA功能

实现步骤：

① 继承标准的第三方消息对接接口kd.bos.workflow.engine.msg.AbstractMessageServiceHandler，并且实现sendMessage方法（苍穹标准流程消息创建后触发），并部署至苍穹服务器。

以下为关键代码截图示例（完整代码见后文附录）：

上传图片

图-关键代码示例

② 进入【系统管理】应用→【消息平台】→【消息渠道】，新建消息渠道，配置对应需要对接的第三方消息渠道信息，并把第一步的二开插件配置到渠道插件中。

上传图片

上传图片

图-配置消息渠道

③ 进入【系统管理】应用→【消息平台】→【消息类型】，修改message通知，添加“丰声”为通知的一种消息渠道。

上传图片

图-消息类型中添加消息渠道

④ 对需要集成消息通知到OA系统的业务单据进行工作流配置，进入【工作流服务】→【管理中心】→【流程管理】，选中工作流中具体需要推送消息的审批流转节点，选择【消息通知】页签，在各个发送时机中，新增配置一条符合业务要求的消息格式数据。

上传图片

图-工作流消息通知配置

⑤ 配置完毕后，当苍穹业务单据进入需要审批的业务节点时，就会触发苍穹后台往第三方OA系统推送一条消息，此时，用户就可以在OA系统收到相关格式的消息通知。

上传图片

图-OA系统收到消息通知示例

苍穹开放API对基础数据集成OA功能

实现步骤：

① 在【开放平台】→【API管理】→【第三方API】中，新增API接口配置，绑定插件，并发布。

上传图片

图-新增API接口配置

② 在【开放平台】→【安全策略】→【第三方应用维护】中，将新增的API添加至接口白名单中进行API授权。

上传图片

图-API授权

③ 授权完毕，导出API接口文档，即可进行接口对接。

苍穹集成方案对基础数据集成OA功能

实现步骤：

① 在【集成管理】→【连接管理】→【数据源管理】中，新增数据源。

上传图片

图-新增数据源

② 在【集成管理】→【集成元数据】→【集成对象】中，新增集成对象。

上传图片

图-新增集成对象

③ 在【集成管理】→【数据集成】→【数据集成方案】中，新增集成方案。

上传图片

图-新增集成方案

④ 设置启用方案的【启动条件】后，启动方案即可实现数据集成。

3 竞品比较

相比于其他同类平台，苍穹OA系统集成解决方案，适配度高，几乎适配所有市面上的OA系统，部分需要进行二开的逻辑已高度抽象封装，无需过多二开改造和维护。

4 方案的复用价值

行业的普适程度

该方案不限制行业，所有需要集成OA协同系统的企业，均可使用，只需要结合企业的规模大小、业务复杂程度以及客户投入成本综合评估，选择最合适的解决方案即可。

对客户的价值

1、提高生产力，加快业务流转及时性、高效率

A企业通过实现苍穹系统和OA系统的集成，提升了员工的工作效率，审批单据从原来的只能通过登录业务系统进行审批，到可以通过OA协同平台进行免登陆的快速集中审批；

且实现了移动端、PC端两种方式的审批，为员工提供了极大的便利，从以前的PC端才能审批的限制中解放出来，并且可以通过待办消息及时通知到审批人，提高了消息处理的及时性。

2、信息聚合，破除系统壁垒，打造高效的信息门户

实现了企业用户的高效协同办公，整合多业务系统，实现了各异构系统间的数据交互，打破了系统间的数据壁垒。

A企业原来基础数据维护需要在业务系统和OA系统上分别维护，既无法保证数据的一致性和准确性，又增加了员工的工作量和企业成本，而通过苍穹的OA集成方案施行后，在某种程度上确保了该企业基础数据的一致性和准确性，避免了OA系统和业务系统的数据不一致的问题，实现了数据的统一高效管理。

5 附录

单点登录代码示例

/** 
 * @author :xuling 
 * @Notes  :用于单点登录接口处理插件逻辑 
 */  
public class CasSSOPlugin implements ThirdSSOAuthHandler {  
    /** 
     * 跳转CAS 
     */  
    @Override  
    public void callTrdSSOLogin(HttpServletRequest request, HttpServletResponse response, String backUrl) {  
        String urlToRedirectTo = CommonUtils.constructRedirectUrl(this.casSeverLoginUrl,  
            this.getProtocol().getServiceParameterName(), serviceUrl, false, false, (String) null);  
        logger.info(String.format("redirecting to \"%s\"", new Object[] { urlToRedirectTo }));  
        String requestURI = request.getRequestURI();  
        // 退出登录  
        if (StringUtils.endsWith(requestURI, "logout.do")) {  
            String initCasLogoutUrl = initCasLogoutUrl();  
            // 退出cas 调用地址  
            String loginUrl = initCasLogoutUrl + "?service=" + serviceUrl;  
            try {  
                response.sendRedirect(loginUrl);  
            } catch (IOException e) {  
                e.printStackTrace();  
            }  
        }  
        try {  
            // 重定向到index.html  
            this.authenticationRedirectStrategy.redirect(request, response, urlToRedirectTo);  
        } catch (IOException arg6) {  
            arg6.printStackTrace();  
        }  
    }  
  
    /** 
     *  登录结果返回，可在此判断登录是否成功，和用户信息是否正确 
     */  
    @Override  
    public UserAuthResult getTrdSSOAuth(HttpServletRequest request, HttpServletResponse response) {  
        UserAuthResult result = new UserAuthResult();  
        result.setSucess(false);  
        //获取CAS认证中心返回的用户token，并验证解析用户登录信息  
        String ticket = this.retrieveTicketFromRequest(request);  
        if (CommonUtils.isNotBlank(ticket)) {  
            try {  
                //验证请求地址  
                String volidateurl = casSeverLoginUrl.substring(0,casSeverLoginUrl.length()-6); //截取掉登录接口地址的"/login"字符串  
                Cas20ServiceTicketValidator cas20ServiceTicketValidator = new Cas20ServiceTicketValidator(volidateurl);  
                Assertion cas20assertion = cas20ServiceTicketValidator.validate(ticket,service);  
                //验证解析结果，获取token的用户信息  
                if(cas20assertion!=null){  
                    String uservalue = cas20assertion.getPrincipal().getName();  
                    System.out.println("单点登录用户名是："+uservalue);  
                    if(!StringUtils.isEmpty(uservalue)&&uservalue!="null"){  
                        result.setUser(uservalue);  
                        result.setUserType(UserProperType.Mobile);  
                        result.setSucess(true);  
                        return result;  
                    }  
                }  
                tologin(request, response);  
            } catch (Exception arg6) {  
                logger.error("token校验信息"+arg6.getLocalizedMessage()+arg6);  
            }  
        }  
        return result;  
    }  
}

OA待办集成代码示例

/** 
 * 招采系统对接丰声消息助手：第三方待办插件 
 * @author 徐玲 
 * 
 */  
public class FengshengOATaskServiceHelper extends AbstractMessageServiceHandler {  
      
    private static final Log logger = LogFactory.getLog(FengshengOATaskServiceHelper.class);  
    private static final String CHANNEL_TYPE = "fengsheng"; //消息渠道标识  
      
    /** 创建待办任务 */  
    @Override  
    public void createToDo(MessageContext msgcontext, ToDoInfo todoinfo) {  
        logger.error("测试丰声待办插件createToDo："+WfConfigurationUtil.isEnabled(CHANNEL_TYPE));  
        // 工作流创建待办任务  
        if (WfConfigurationUtil.isEnabled(CHANNEL_TYPE)) {  
            try {  
                FengshengOATaskUtils.initParams();  
                //请求丰声接口，对丰声待办同步创建  
                FengshengOATaskUtils.doSendMsg(FengshengOATaskUtils.access_token, FengshengOATaskUtils.getSendReqBody(todoinfo,msgcontext));  
            }catch (Exception e) {  
                throw new WFMessageServiceException(e, new ErrorCode("bos.wf.msg.fengshengCreatToDoError" , "丰声待办任务创建失败"), e.getMessage());  
            }  
        }  
    }  
  
    /** 删除待办任务 */  
    @Override  
    public void deleteToDo(MessageContext msgcontext, ToDoInfo todoinfo) {  
        logger.error("测试丰声待办插件deleteToDo："+WfConfigurationUtil.isEnabled(CHANNEL_TYPE));  
        // 工作流待办任务删除处理  
        if (WfConfigurationUtil.isEnabled(CHANNEL_TYPE)) {  
            try {  
                FengshengOATaskUtils.initParams();  
                //请求丰声接口，对丰声待办同步删除  
                FengshengOATaskUtils.rebackMsg(FengshengOATaskUtils.access_token, FengshengOATaskUtils.getRebackReqParams(msgcontext));  
            }catch (Exception e) {  
                throw new WFMessageServiceException(e, new ErrorCode("bos.wf.msg.fengshengDeleteToDoError" , "丰声待办任务删除失败"), e.getMessage());  
            }  
        }  
    }  
      
    /** 完结待办任务 */  
    @Override  
    public void dealToDo(MessageContext msgcontext, ToDoInfo todoinfo) {  
        logger.error("测试丰声待办插件dealToDo："+WfConfigurationUtil.isEnabled(CHANNEL_TYPE));  
        // 工作流待办任务结办处理  
        if (WfConfigurationUtil.isEnabled(CHANNEL_TYPE)) {  
            try {  
                FengshengOATaskUtils.initParams();  
                //请求丰声接口，对丰声待办同步结办  
                FengshengOATaskUtils.DealMsg(FengshengOATaskUtils.access_token, FengshengOATaskUtils.getDealReqParams(msgcontext));  
            }catch (Exception e) {  
                throw new WFMessageServiceException(e, new ErrorCode("bos.wf.msg.fengshengDealToDoError" , "丰声待办任务结办失败"), e.getMessage());  
            }  
        }  
    }  
      
}

OA消息集成代码示例

/** 
 * 招采系统对接丰声消息助手：第三方待办插件 
 * @author 徐玲 
 * 
 */  
public class FengshengOATaskServiceHelper extends AbstractMessageServiceHandler {  
      
    private static final Log logger = LogFactory.getLog(FengshengOATaskServiceHelper.class);  
    private static final String CHANNEL_TYPE = "fengsheng"; //消息渠道标识  
      
    /** 发送消息 */  
    @Override  
    public void sendMessage(MessageContext ctx, MessageInfo message) {  
        super.sendMessage(ctx, message);  
        logger.error("测试丰声消息插件createToDo："+WfConfigurationUtil.isEnabled(CHANNEL_TYPE));  
        // 工作流发送消息  
        if (WfConfigurationUtil.isEnabled(CHANNEL_TYPE)) {  
            try {  
                String taskid = message.getId().toString();//任务ID  
                Long processId = message.getProcessInstanceId();//流程实例ID  
                String content = message.getContent();//标题  
                String url = message.getContentUrl();//待办链接  
                String targetsstr = OATaskUtils.getTargets(message.getUserIds());//待办任务处理人  
                String doccreatorstr = OATaskUtils.setDocCreator(null);//创建者  
                OATaskUtils.sendMessage(taskid,content,url,targetsstr,null);  
            }catch (Exception e) {  
                throw new WFMessageServiceException(e, new ErrorCode("bos.wf.msg.fengshengCreatToDoError" , "丰声消息发送失败"), e.getMessage());  
            }  
        }  
    }  
}

#往期推荐#

# 实践案例 | WebService服务，解决多系统集成问题

# 实践案例 | 多异构系统间的数据集成

# 实践案例 | 系统集成-亿级库存数据同步与初始化

更多精彩内容，“码”上了解！↓

上传图片

实践案例 | 打破信息孤岛，OA系统集成的方案落地与实践

实践案例 | 打破信息孤岛，OA系统集成的方案落地与实践

恭喜您！