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

1、媒讯集团EAS项目CTC 与 EAS 接口需求及设计说明书文档作者：创建日期：20XX-05- 10确认日期：当前版本：1.0拷贝数量：1审批签字:客户方：实施方:客户化开发需求规格说明书文档控制修改记录日期作者版本参考版本备注11目录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接口需求7四、详细设计84.1 XX EAS 接口 81概述金蝶与用户及用户业务系统方

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

3、S与媒讯CTC系统之间通讯采用 WebService方式进行数据传输。3.2通讯内容定义对于记录型的大对象，在通讯时，采用 String型的xml格式的参数进行传递。对于其他 非记录型的对象，在通讯时，可采用非 xml格式的参数进行传递，也可使用多个参数。 具体格式，请参照每个接口的通讯用例说明。3.3媒讯CTC系统提供接口使用范例待补充。3.4金蝶EAS提供接口使用范例 3.4.1规范说明EAS通过webService接口与异构系统通信。EAS WebService全部是使用java编写 的，其接口描述符合 WSDL国际标准，其数据描述符合 XSD国际标准。本次提供的接口除系统登录接口外，其

4、他接口都需要调用登录接口，以便将登陆的Sessionld信息放入到 SOAP的HEADER 报文中。3.4.2使用示例金蝶在EAS上发布WebService服务，提供wsdl文件供客户端下载，其他业务系统 根据下载的wsdl文件，产生客户端。建议使用Axis2来生成客户端代理。ads2 ClientjarF面是登录接口调用参数说明:接口地址http:/ip:port/ormrpc /services/EASLogin方法名称logi n参数列表参数名称别名类型备注userNameEAS用户名Stri ngEAS系统一个非异常的 账户的用户名Password密码Stri ng用户名对应的密码sl

5、nN ame都为easdataCe nterName数据中心idStri ngEAS对应的数据中心Language语言Stri ng默认为L2即可dbType数据库类型int0 sql server1 oracle2 db2相关对象描述不需要任何对象类型的数据错误列表错误代码错误概述详细说明概要逻辑说明无调用者说明无其他说明无以下是Java客户端调用Java webservices接口的调用代码示例public class Demo public static void main( Stri ng args) throws Excepti on Demo demo = new Demo();d

6、em o.login();* EAS登录用户名，密码，eas,数据中心代码，语言，简体中文为 L2,0 sql server 1 oracle 2 db2* login 方法的参数分别代表为* java.lang.String userName* java .Ian g.Str ing password* java.lang.String slnName* java.lang.String dcName* java .Ian g.Str ing Ian guage* int dbType* throws Excepti on*/private void log in() throws Exce

7、pti onString 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", "L2",

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

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