项目接口需求和设计说明文档(模板)

1、媒讯集团EAS项目CTC 与 EAS 接 口需求及设计说明书文档作者：创建日期： 2013-05-10确认日期：当前版本：1.0拷贝数量：1审批签字：客户方：实施方:文档控制修改记录日期作者版本笏马版本备注word完美格式目录1. 概述 41.1 读者 41.2 图例 41.3 目的 4二、业务现状 5三、概要设计 53.1 接口通讯方式 53.2 通讯内容定义 53.3 媒讯CTC系统提供接口使用范例 53.4 金蝶EAS提供接口使用范例 53.5 媒讯CTC系统提供接口服务地址 73.6 金蝶EAS提供接口服务地址 73.7 接口需求 8四、详细设计 94.1 XX EAS 接口 91.概

2、述金蝶与用户及用户业务系统方通过多次讨论，制定了接口开发需求设计说明书，作为双方后续 开发指引。1.1 读者本文读者对象为业务管理人员、系统设计、开发人员、测试人员。1.2 图例本文中如未进行特殊说明，各图标代表的含义如下：表示一个活动；/表示动态的业务数据，如系统单据；表示流程走向；表示条件判断、流程分支；(+山",表示静态的业务数据，如基础资料；/表示系统外一个手工处理活动；L1一表示系统外手工填制的单据；表示当前系统之外的活动;L；表示当前系统之外产生的业务数据。1.3 目的本文档是媒讯 CTC系统与EAS系统接口的需求及设计方案相关文档，可用于指导开发、测试 工作和作为验收相

3、关依据文档。二、业务现状待补充三、概要设计3.1 接口通讯方式金蝶EAS与媒讯CTC系统之间通讯采用 WebService 方式进行数据传输。3.2 通讯内容定义对于记录型的大对象，在通讯时，采用String型的xml格式的参数进行传递。对于其他 非记录型的对象，在通讯时，可采用非 xml格式的参数进行传递，也可使用多个参数。 具体格式，请参照每个接口的通讯用例说明。3.3 媒讯CTC系统提供接口使用范例待补充。3.4 金蝶EAS提供接口使用范例3.4.1 规范说明EAS通过webService 接口与异构系统通信。EAS WebService 全部是使用java 编写的，具接口描述符合 WS

4、DL国际标准，其数据描述符合 XSD国际标准。本次提供的接口除系统登录接口外，其他接口都需要调用登录接口，以便将登陆的Sessionld信息放入到 SOAP的HEADER报文中3.4.2 使用示例金蝶在EAS上发布WebService服务，提供wsdl文件供客户端下载，其他业务系统根据下载的wsdl文件，产生客户端建议使用Axis2来生成客户端代理naxis2ClientJar卜面是登录接口调用参数说明：接口地址http:ip:port/ormrpc/services/EASLogin方法名称login参数列表参数名称别名备注userNameEAS用户名StringEAS系统一个非异常的 账户

5、的用户名Password密码String用户名对应的密码slnName都为easdataCenterNam e数据中心idStringEAS对应的数据中心Language语百String默认为L2即可dbType数据库类型int0 sql server1 oracle2 db2相关对象描述不需要任何对象类型的数据错误列表错误代码错误概述详细说明概要逻辑说明无调用者说明无其他说明无以下是Java客户端调用Java webservices接口的调用代码示例public class Demo public static void main(String口 args) throws Exception

6、 Demo demo = new Demo();demo.login();/* EAS登录* login方法的参数分别代表为* java.lang.String userName* java.lang.String password* java.lang.String slnName* java.lang.String dcName* java.lang.String language* int dbType* throws Exception*/用户名，密码，eas,数据中心代码，语言，简体中文为 L2,0 sql server 1 oracle 2 db2private void logi

7、n() throws ExceptionString EASLogin_address ="http:/IP:6888/ormrpc/services/EASLogin"URL url = new URL(EASLogin_address);EASLoginProxy proxy=new EASLoginProxyServiceLocator().getEASLogin(url);WSContext ctx = proxy.login("user", "pwd", "eas", "001", &

8、quot;L2", 1); if(ws != null && ws.getSessionId() != null )System. out .println("登录成功");else System. out .println("登录失败");3.5 媒讯CTC系统提供接口服务地址待三地方补充。3.6 金蝶EAS提供接口服务地址测试环境：09:6888/ormrpc/services正式环境：http::6888/ormrpc/services建议把IP地址和端口做成一个可配

9、置参数。3.7 接口需求3.7.1 接口概况本次集成业务所涉及的接口如下表所示序号接口名称数据发送方数据接收方接口提供者接口调用者3.7.2 接口说明接口处理过程说明:其他逻辑控制说明:3.7.3 其他要求四、详细设计4.1 XX EAS 接口4.1.1 设计说明此接口由EAS端（提供者）开发，供媒讯CTC系统（调用者）调用4.1.2 通讯内容接口地址方法名称参数列表参数名称别名备注返回值对象描述bill错误列表错误代码P错误概述概要说明调用者说明其他说明4.1.3通讯用例-xmlData 格式例子<ComplaintBill><bill><number>201220383</number><recordTime>2012-08-29</<recordTime><re