成都语意科技有限公司EAS接口平台及案例介绍EAS接口平台及案例介绍成都语意科技有限公司2021年5月作者：杨剑18019987142金蝶异构服务平台是由杨剑在持续多年的、大量接口项目开发经验基础上，对如何改进接口开发模式、提供更好的接口开发和应用实践上，进行深入总结和分析，在金蝶EAS平台上总结和研发了一整套面向异构系统对接的业务和开发平台，并且规划近期在金蝶云星空、金蝶云苍穹平台上提供相应的接口平台。该平台针对常见的接口对接需求，提供了成熟稳定的技术实现，并且具有强大的扩展功能。1.为什么要用平台异构系统接口的设计和开发，其复杂度和难度远远超过一般的开发任务，对设计者和开发者的经验和能力要求很高。经验欠缺的顾问在设计和开发接口时，极易存在种种缺陷、隐患、不稳定、不合理的因素。大部分设计者仅局限于数据或功能的对接，有限的时间和成本使其对于日志、数据转换、数据安全、可配置、可扩展性等等，难以兼顾。平台的应用可以把优秀的接口设计开发模式和成果带给更多的客户，提升客户体验和交付成果质量，赢得用户的好评。平台的应用可以极大的降低接口开发中的重复工作量，有效降低交付成本，提高接口的可维护性、可配置性、可追溯性。2.平台简介提供基于WebService＋JSON/XML的异构系统对接基础功能平台。对常见接口对接的功能、日志、安全、测试、内容等各方面需求，提供了灵活强大的支撑，并且具有良好的可扩展性。本平台在两年多的时间里，先后在多家大型集团企业的复杂接口对接中成功应用，稳定运行。按照接口对接中的角色分为两部分：1)WS服务平台：服务提供者，提供WebService，由第三方调用2)WS调用平台：服务调用者，主动调用第三方提供的WebService1/15成都语意科技有限公司EAS接口平台及案例介绍2.1.WS服务平台由第三方调用，提供统一入口，统一的请求和响应报文格式，统一登录方式，支持XML/JSON两种格式提供接口日志功能提供基础数据映射表和数据转换组件，支持双向映射提供基于AES和RSA的数据加密和解密的功能（可二次开发扩展），提供数据加解密测试工具，提供集群环境可用的缓存管理、缓存监视工具集成了基于SQL数据集的数据读取功能提供面向单据和基础资料的数据输出/输入功能提供单据附件文件的上传和下载功能提供可灵活扩展的接口功能扩展开发机制提供可视化接口测试工具提供第三方格式请求和响应报文的自动转换处理2.2.WS调用平台第三方接口地址配置接口数据源配置：SQL取数，公式计算，参数定义接口请求和响应报文模板配置，支持JSON和XML通过自定义公式实现报文取数，支持节点绑定数据源并动态扩展常见接口调用后处理功能常见接口通讯组件，支持SOAP协议和HTTP协议2.3.平台项目案例通威永祥资金接口一期、二期四川天立教育费用接口、收费接口、统一认证接口、HR薪资接口成都万华集团合同接口、保理业务接口航达钢铁MES、WMS接口四川中车紧固件MES接口华川集团移动应用接口依米康集团移动应用接口新易盛MES接口2/15成都语意科技有限公司EAS接口平台及案例介绍3.WS服务平台功能示例3.1.可配置和可扩展的接口功能架构通过定义接口功能处理器，实现配置、控制接口可以完成的功能。平台预置了以下处理器，支持XML/JSON两种报文格式：SQL数据查询：基于SQL命令和结果集查询EAS数据接口测试：第三方测试EAS接口是否可用面向基础资料和单据的数据读取：第三方获取标准报文格式的EAS单据和基础资料数据面向基础资料和单据的数据写入：第三方按照标准报文格式，向EAS传递单据和基础资料附件上传：第三方按照接口规范，基于字节流向EAS传递附件文件附件下载：第三方按照接口规范，从EAS获取字节流的附件文件二次开发人员可以按照接口处理器的要求开发新的处理器，注册到接口中，即可实现接口功能的扩展。3.2.接口日志对所有EASWS服务平台被调用的情况进行详细记录，调用过程中发生错误也会一并记录，方便服务调用追踪和错误分析。3/15成都语意科技有限公司EAS接口平台及案例介绍4/15成都语意科技有限公司EAS接口平台及案例介绍3.3.基础数据映射表对所有外部系统、所有类型的数据映射关系提供统一的定义和维护，提供Excel批量导入功能；支持多维度的组合映射，支持把数据映射表作为参数平台使用。为二次开发人员提供统一的带缓存的映射转换功能组件；提供编码到对象的转换功能。5/15成都语意科技有限公司EAS接口平台及案例介绍3.4.测试工具提供EAS客户端可用的接口测试工具，模拟第三方调用EAS服务。支持附件上传下载接口测试。6/15成都语意科技有限公司EAS接口平台及案例介绍3.5.缓存监控管理针对频繁的数据映射关系访问、基础数据对象访问，提供了集群环境可用的缓存体系。提供针对服务器缓存的观测、清除工具。为二次开发人员提供缓存调用组件。3.6.加解密工具提供基于RSA、DES对数据进行加解密的测试工具，提供RSA密钥对生成工具，方便对加密报文的测试观察。为二次开发人员提供加解密功能组件。7/15成都语意科技有限公司EAS接口平台及案例介绍3.7.基于SQL的数据读取功能平台预置了基于SQL语句的受控的数据查询获取功能，支持传递查询参数，理论上可以解决所有的EAS数据读取需求。SQL数据读取支持两种模式：1)直接SQL查询模式：执行请求报文中附带SQL查询语句，优点是EAS配置开发成本低，缺点是风险高，且对第三方不友好，不建议使用2)预定义SQL查询模式：需要执行的SQL语句由EAS管理员预配置，第三方在请求中提供事先分配的预定义SQL编码，系统执行对应的预定义SQL并返回结果，支持参数传递。优点是安全性高、保密性好、可零部署灵活修改，推荐使用8/15成都语意科技有限公司EAS接口平台及案例介绍3.8.面向单据的可配置输入输出提供基于模板配置的可控的单据数据（包括基础资料）输入和输出。支持按照编码映射表完成外部数据转换、支持编码到对象的转换。可实现简单业务单据的零代码输入输出。能够生成第三方和测试使用的格式报文（请求和响应报文）。第三方向EAS写入具有复杂计算逻辑和业务逻辑的单据，例如合同、订单、收付款单等等，可通过二次开发的插件完成标准数据赋值之外的数据检查、数据计算、数据补全等逻辑，以及后续业务的自动处理。9/15成都语意科技有限公司EAS接口平台及案例介绍3.9.附件上传下载提供面向单据的基于二进制流的附件上传、附件下载功能3.10.第三方格式报文处理第三方格式，是指金蝶WS服务的请求报文格式、响应报文格式，不是金蝶制定，而是第三方要求的格式。提供第三方制定格式的请求报文处理，基于模板把第三方报文转换为金蝶格式报文后完成服务处理；提供把标准金蝶响应报文，基于模板转换为第三方制定格式的响应报文。4.WS调用平台功能示例4.1.第三方接口连接配置配置第三方接口的地址、接口调用所需的参数，应当使用的向第三方发起接口调用的接口连接实现类。平台预置了常见的基于SOAP协议和基于HTTP协议的接口调用实现类，二次开发人员可按照规范开发新的接口调用实现类。10/15成都语意科技有限公司EAS接口平台及案例介绍4.2.数据源和功能配置配置调用第三方接口发送请求时，请求报文中需要引用的SQL数据源、特定方法的参数、可以使用的计算功能和公式11/15成都语意科技有限公司EAS接口平台及案例介绍4.3.第三方报文模板配置配置第三方接口所要求的请求报文模板、返回的成功状态和失败状态的响应报文模板。请求报文可通过自定义公式从以下对象中取数：单据、上下文环境、自定义变量、接口参数、SQL数据源、请求和响应报文，能够执行公式和计算功能。请求报文模板允许定义节点和数据源的绑定，报文节点按数据源动态展开，支持多数据源的交叉绑定，支持一个报文模板的多重数据源绑定。能够定义响应报文成功或失败的识别方法，失败消息的识别方法。执行成功或失败后的后处理功能，分为：SQL执行、属性反写、单据生成。12/15成都语意科技有限公司EAS接口平台及案例介绍13/15成都语意科技有限公司EAS接口平台及案例介绍4.4.数据推送日志记录调用第三方接口平台所发送的请求报文、接收到的反馈报文，接口后处理执行状态。14/15成都语意科技有限公司EAS接口平台及案例介绍15/15
