项目接口需求及设计说明文档模板

1、媒讯集团EAS项目CTC与EAS接口需求及设计说明书文档作者：创建日期：2013-05-10确认日期：当前版本：1.0拷贝数量：1审批签字:客户方：实施方:文档控制修改记录日期作者版本笏马版本备注目录1. 概述41.1 读者41.2 图例41.3 目的4二、业务现状5三、概要设计51.1.* 接口通讯方式51.2.* 通讯内容定义51.3.* 媒讯CTC系统提供接口使用范例51.4.* 金蝶EAS提供接口使用范例51.5.* 媒讯CTC系统提供接口服务地址71.6.* 金蝶EAS提供接口服务地址71.7.* 接口需求7四、详细设计8XXEAS接口8.概述金蝶与用户及用户业务系统方通过多次讨论，

2、制定了接口开发需求设计说明书，作为双方后续开发指引。读者本文读者对象为业务管理人员、系统设计、开发人员、测试人员。图例本文中如未进行特殊说明，各图标代表的含义如下：表示一个活动；表示流程走向；U二二二表示条件判断、流程分支；：I、表示静态的业务数据，如基础资料;/表示系统外一个手工处理活动；表示系统外手工填制的单据;表示当前系统之外的活动;L/表示当前系统之外产生的业务数据。目的本文档是媒讯CTC系统与EAS系统接口的需求及设计方案相关文档，可用于指导开发、测试工作和作为验收相关依据文档。二、业务现状待补充三、概要设计接口通讯方式金蝶EASt媒讯CTC系统之间通讯采用WebService方式进

3、行数据传输。通讯内容定义对于记录型的大对象，在通讯时，采用String型的xml格式的参数进行传递。对于其他非记录型的对象，在通讯时，可采用非xml格式的参数进行传递，也可使用多个参数。具体格式，请参照每个接口的通讯用例说明。媒讯CTC系统提供接口使用范例待补充。金蝶EAS提供接口使用范例规范说明EAS通过webService接口与异构系统通信。EASWebService全部是使用java编写的，其接口描述符合WSDL国际标准，其数据描述符合XSD国际标准。本次提供的接口除系统登录接口外，其他接口都需要调用登录接口，以便将登陆的SessionId信息放入到SOAP的HEADER报文中。使用示例

4、金蝶在EAS上发布WebService服务，提供wsdl文件供客户端下载，其他业务系统根据下载的wsdl文件，产生客户端。建议使用Axis2来生成客户端代理。axis2Clientjar下面是登录接口调用参数说明：接口地址http:ip:port/ormrpc/services/EASLogin方法名称login参数列表参数名称别名备注userNameEAS用户名StringEAS系统一个非异常的账户的用户名Password密码String用户名对应的密码slnName都为easdataCenterName数据中心idStringEAS对应的数据中心Language语百String默认为L2即

5、可dbType数据库类型int0sqlserver1oracle2db2相关对象描述不需要任何对象类型的数据错误列表错误代码错误概述详细说明概要逻辑说明无调用者说明无其他说明无以下是Java客户端调用Javawebservices接口的调用代码示例publicclassDemopublicstaticvoidmain(Stringargs)throwsExceptionDemodemo=newDemo();demo.login();/*EAS登录login方法的参数分别代表为用户名，密码，eas,数据中心代码，语言，简体中文为L2,0sqlserver1oracle2db2java.lang.

6、StringuserNamejava.lang.Stringpasswordjava.lang.StringslnNamejava.lang.StringdcNamejava.lang.StringlanguageintdbTypethrowsException/privatevoidlogin()throwsExceptionStringEASLogin_address="http:/IP:6888/ormrpc/services/EASLogin"URLurl=newURL(EASLogin_address);EASLoginProxyproxy=newEASLogin

7、ProxyServiceLocator().getEASLogin(url);WSContextctx=proxy.login("user","pwd","eas","001","L2",1);if(ws!=null&&ws.getSessionId()!=null)System.out.println("登录成功");elseSystem.out.println("登录失败");媒讯CTC系统提供接口服务地址待三地方补充。金蝶EAS提供接

8、口服务地址测试环境：09:6888/ormrpc/services正式环境：http::6888/ormrpc/services建议把IP地址和端口做成一个可配置参数。接口需求接口概况本次集成业务所涉及的接口如下表所示序号接口名称数据发送方数据接收方接口提供者接口调用者接口说明接口处理过程说明:其他逻辑控制说明:其他要求四、详细设计XXEAS接口设计说明此接口由EAS端（提供者）开发，供媒讯CTC系统（调用者）调用通讯内容接口地址方法名称参数列表参数名称别名备注返回值对象描述bill错误列表错误代码P错误概述概要说明调用者说明其他说明通讯用例-xmlData格式例子<ComplaintBill><bill><number>201220383</number><recordTime>2012-08-29</<recordTime><recorder>