小编推荐

当你遇到系统集成场景多、集成开发效率低、问题定位难等问题的时候，没有很好的解决方案，但项目又要着急上线，该怎么办？

不愁，本期为大家带来多异构系统间集成的实践案例，通过集成服务云的解决方案，帮助客户快速实现在星瀚系统统一管理凭证的业务诉求。

撰稿人：金蝶伙伴—杨鸿杰。

1 业务背景

该案例来自于一家大型贸易与供应链集团，旗下有400多家核算单元，整个财务共享平台涉及与EAS、SAP、OA、影像、税务等9种系统的对接。

客户在使用星瀚前的核算系统是SAP系统，现集团要求统一在星瀚系统做核算，必须实现客户在星瀚做凭证的需求，需要把SAP系统的会计科目、凭证类型、核算维度、成本中心、利润中心等十几种生成凭证需要的基础数据集成到星瀚系统。

在此业务背景下，客户在数据集成时面临着三个主要问题：系统集成场景多、集成开发效率低、问题定位难。

2 解决方案

针对第一个“系统集成场景多”的问题，集成服务云可以将所有的外围系统注册到连接类型中，通过连接配置可配置外网系统的协议、IP、端口，并在外部API中配置该系统相应的接口。

针对第二个“集成开发效率低”的问题，采用集成服务云的数据集成方案、服务流程、集成方案转API等方式，可大幅减少开发人员的代码量，且方案简单、易上手，实施人员通过配置即可实现。

针对第三个“问题定位难”问题，集成服务云对于接口的调用或是集成方案的运行有完整的日志记录，让用户在使用过程中能更快更精准地定位问题。

接下来我们通过“星瀚与SAP核算系统对接的场景”来详细介绍该解决方案。

案例：星瀚与SAP核算系统对接时，共享平台需要通过调用SAP-ESB的接口获取核算维度的基础资料数据。针对这种场景下的集成解决方案通常有以下5个步骤：

步骤一：建立与第三方系统的连接类型

关于连接类型配置，有四个需要关注的配置项：

（1）配置连接器工厂类

kd.isc.iscb.platform.core.connector.ConnectionFactory为此工厂类必须实现的接口，且需要部署在“集成云”的应用上。

ESB使用集成服务云的标准WebAPI连接器器工厂类：

kd.isc.iscb.platform.core.connector.webapi.WebApiConnectionFactory

（2）“配置表单”项

此处设置为“zjmi_isc_link_sap”。

（3）其对应API调用脚本

API调用细节及错误处理，具体如下：

var url = $protocal + "://" + $ip + $service +"?apikey="+ $password;
//return HttpInvoke(url, {});
var  esb = HttpInvoke(url, $params);//HttpInvoke 为调用接口的直接返回值
// throw esb;
if(esb.code!=null){
  throw esb;
}else{
  return esb;
}

（4）服务器状态测试脚本

API调用细节及错误处理，具体如下：

var url = $protocal + "://" + $ip + $service +"?apikey="+ $password;
return HttpPost(url, null, "UTF-8");

建立连接类型后，根据实际情况选择合适的连接工厂类。注意，此时需要在API调用脚本中写调用脚本。

连接类型表单

步骤二：建立与第三方系统的连接配置并建立数据源

选择步骤一中配置的连接类型，在连接配置中定义外围系统的协议、IP、端口号，连接配置建好后创建数据源并保存，如下图所示：

连接配置表单

步骤三：将外部系统的API接口注册到苍穹外部API

选择步骤二中的数据源，在接口标识中，根据连接类型—调用脚本的参数填写需要调用接口的标识，如下图所示：

外部API表单

步骤四：新建结构类型的集成对象，用来接收API接口返回的数据

该结构类型的集成对象，其属性层级和编码都需要和外部接口返回的数据格式一致。此处可以通过数据集的方式，导入一个出参结构（JSON格式）的报文，发布为结构类型集成对象。系统支持分录等层级结构的创建，十分便捷，如下图所示：

集成对象表单

步骤五：使用集成方案或服务流程对返回的数据进行集成操作

首先，需要通过脚本获取所有满足条件的公司代码。其次，遍历步骤一中获取的公司代码，并将遍历后的公司代码作为参数，传入SAP主数据接口中并使用结构类型的集成对象接收接口返回的所有数据。

然后，遍历每一条返回的资产卡片数据，将遍历后的数据作为源对象，使用星瀚实物卡片实体作为目标集成对象进行数据映射。需要注意的是，如果有循环操作，在映射前应该把临时变量清空，以免上个循环的数据携带过来，造成数据错乱。

最后，调用目标对象实体操作，保存目标集成对象，系统将继续遍历数据，如下图所示：

服务流程表单

3 方案的可推广价值

通过集成服务云的这套解决方案，该客户成功把SAP系统的会计科目、凭证类型、核算维度、成本中心、利润中心等十几种生成凭证需要的基础数据集成到了星瀚系统，实现了客户在星瀚系统统一管理凭证的业务诉求。

对于集成服务云调用外部系统的集成方案，客户在实际执行过程中，可以根据情况选择定时同步或者人工操作触发的形式将SAP系统的主数据同步星瀚平台。通过外部API日志还可以精准查看每次调用的数据入参与返回报文，在遇到两边数据不一致时方便用户去查询分析问题，解决了客户集成过程繁琐、遇到问题无法定位的问题。

该客户的财务共享平台涉及9个系统的对接，因此星瀚系统若需要调用其他的异构系统的API时，同样可以复用这套方案的逻辑进行数据集成。

4 相关资料

自定义连接器类型登记与连接配置：

https://developer.kingdee.com/school/89389204685524480

数据集：

https://developer.kingdee.com/article/183670

#往期推荐#

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

# 集成健康度检测，一切尽在掌控中

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

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

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

恭喜您！