U8开发之EAI接口.docx

U8知识库文档U8 EAI接口摘要U8企业应用集成（EAI）产品是U8ERP与第三方系统进行业务数据交换的平台级工具产品，是U8ERP统一的对外开放接口EAI产品包括一整套U8ERP的标准业务数据交换接口，这些接口涵盖基础档案、财务、供应链、生产制造、客户关系管理、HR等ERP业务模块，具备统一的入口、一致的业务外观和相对完整的业务功能，能完成U8基础数据、凭证、业务单据的导入导出及增、删、改查等操作，是U8与外部系统进行应用集成和业务整合的基本资源在技术上，EAI数据交换接口采用符合业界标准的XML作为数据交换接口规范（协议）描述，充分利用了XML跨平台和低耦合的特性基于XML的交换协议描述了数据交换过程中Request/Response消息数据格式及元数据规范（Schema），外部系统只要遵循此标准和规范即可以方便的与U8ERP进行Talking为解决数据交换中系统之间数据格式和数据语义差异问题，EAI产品提供了可扩展的数据适配器和数据映射机制用来进行内外数据的翻译和转换；为方便用户的应用和体验，EAI产品还提供了能直接进行U8数据导入导出的基本用户界面工具，此工具支持手工和自动导入导出。

目标本文主要介绍如何通过EAI接口实现U8与其他业务系统之间的数据交互EAI接口规范EAI接口本地COM接口类库：U8Distribute.DLLProgID：U8Distribute.iDistribute方法：String Process(String RequestXml)参数：数据交换请求消息，详见下文请求消息格式返回：数据交换响应消息，详见下文回执消息格式这种方式可根据开发者的需要批量处理或者实时处理接口调用非常简单，简化了编程开发者只需将标准数据传入接口，如下：1) VB调用代码//引用U8SOFT\EAI\U8Distribute.dll U8Distribute.iDistributeClass eaiBroker = new U8Distribute.iDistributeClass(); //创建EAI服务代理接口对象 String responseXml = eaiBroker.Process(requestXml); //调用EAI服务代理的数据交换方法Process，传入 // Request交换消息， 并获取EAI返回的Response消息。

...... //处理返回结果 System.Runtime.InteropServices.Marshal.FinalReleaseComObject(eaiBroker); //释放EAI服务代理接口对象Dim eaiBroker As Object Set eaiBroker = CreateObject(“U8Distribute.iDistribute”) ’创建EAI服务代理接口对象 Dim responseXml As String responseXml = eaiBroker.Process(requestXml) ’调用EAI服务代理的数据交换方法Process，传入 ‘Request交换消息， 并获取EAI返回的Response消息 ….. ’处理返回结果 Set eaiBroker = Nothing ’释放EAI服务代理接口对象2) .NET调用代码3) JAVA代码采用JNI、JCOM、JACOB技术调用EAI服务代理COM组件，下面以JACOB为例：import .Dispatch; import .Variant; class Test {　 public static void main(String[] args) { //创建EAI服务代理接口对象　　 Dispatch eaiBroker = new Dispatch("U8Distribute.iDistribute"); //调用EAI服务代理的数据交换方法Process，传入Request交换消息， 并获取EAI //返回的Response消息。

String responseXml = Dispatch.call(eaiBroker, "Process", new Variant(requestXml)); ...... //处理返回结果 } } 远程HTTP接口EAI远程数据交换采用Http POST的方式访问网址： http：//U8应用服务器IP或机器名/U8EAI/import.aspPOST上传的数据交换请求消息与本地调用一样 开发者可以用SOAP协议向装有U8-EAI的IIS服务器发送XML数据，类似本地调用分析返回的XML回执，如下：1) VB调用代码Dim xmlhttp As Object Set xmlhttp = CreateObject(“MSXML2.XMLHTTP”) ‘创建XMLHTTP对象 Call xmlhttp.open(“POST”, “http://u8appsrv/u8eai/import.asp”, False) ‘使用XMLHTTP对象打开网络连接 xmlhttp.send requestXml ‘发送Request消息 Dim responseXml As String responseXml = xmlhttp.responseText ‘获取返回Response消息….. ’处理返回结果注意： URL： http：//u8appsrv/u8eai/import.asp 中的u8appsrv应填U8应用服务器IP或机器名。

2) .NET调用代码 //引用U8SOFT\Interop\Interop.MSXML2.dll MSXML2.XMLHTTPClass xmlHttp = new MSXML2.XMLHTTPClass(); //创建XMLHTTP对象 xmlHttp.open(“POST”, “http://u8appsrv/u8eai/import.asp”, false, null, null);//打开网络连接 xmlHttp.send(dom.OuterXml);//发送Request消息 String responseXml = xmlHttp.responseText;//获取返回Response消息 ...... //处理返回结果 System.Runtime.InteropServices.Marshal.FinalReleaseComObject(xmlHttp); //COM释放3) JAVA调用代码 class Test {　 public static void main(String[] args) { URL url = new URL(“http://u8appsrv/u8eai/import.asp”); HttpURLConnection con = (HttpURLConnection)url.openConnection(); con.setConnectTimeout(3000000); con.setReadTimeout(3000000); con.setDoInput(true); con.setDoOutput(true); con.setAllowUserInteraction(false); con.setUseCaches(false); con.setRequestMethod("POST"); con.setRequestProperty("Content-type","application/x-www-form-urlencoded"); //发送Request消息 OutputStream out = con.getOutputStream(); DataOutputStream dos = new DataOutputStream(this.out); dos.write(requestXml.getBytes("UTF-8")); //获取Response消息 InputStream in = con.getInputStream(); BufferedReader br = new BufferedReader(new InputStreamReader(in)); StringBuilder sb = new StringBuilder(); String s = null; while ((s = br.readLine()) != null) { sb.append(s); } String responseXml = sb.toString(); } }调用U8API接口满足现有U8EAI做不到的业务单据操作，如销售报价单增删改，以及业务操作，如审核、弃审，将现有U8API的功能整合进U8EAI，将两者糅合在一起，形成功能互补，为企业应用集成和二次开发提供更强大的支持。

通过参照U8API请求XML模板，填入相应的API参数值，即可实现通过U8EAI统一接口调用U8API服务详细内容请参见文档《 U8API和U8EAI整合》1、 请求XML格式         其中，proc填入操作类型，添加：add；编辑：edit；删除：delete；查询。