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

《项目接口需求及设计说明文档模板.doc》由会员分享，可在线阅读，更多相关《项目接口需求及设计说明文档模板.doc（11页珍藏版）》请在淘文阁 - 分享文档赚钱的网站上搜索。

1、媒讯集团EAS工程CTC与EAS接口需求及设计说明书文档 创立日期：2021-05-10确认日期：当前版本：1.0拷贝数量：1审批签字:客户方：实施方：第 11 页文档控制修改记录日期作者版本参考版本备注目录1.概述4读者4图例4目的4二、业务现状5三、概要设计5接口通讯方式5通讯内容定义5媒讯CTC系统提供接口使用范例5金蝶EAS提供接口使用范例5媒讯CTC系统提供接口效劳地址7金蝶EAS提供接口效劳地址7接口需求7四、详细设计8XX EAS接口81. 概述金蝶与用户及用户业务系统方通过屡次讨论，制定了接口开发需求设计说明书，作为双方后续开发指引。本文读者对象为业务管理人员、系统设计、开发人

2、员、测试人员。本文中如未进展特殊说明，各图标代表的含义如下：表示一个活动；表示动态的业务数据，如系统单据；表示流程走向；表示条件判断、流程分支；表示静态的业务数据，如根底资料；表示系统外一个手工处理活动；表示系统外手工填制的单据；表示当前系统之外的活动；表示当前系统之外产生的业务数据。本文档是媒讯CTC系统与EAS系统接口的需求及设计方案相关文档，可用于指导开发、测试工作与作为验收相关依据文档。二、业务现状待补充三、概要设计3.1接口通讯方式金蝶EAS与媒讯CTC系统之间通讯采用WebService方式进展数据传输。3.2通讯内容定义对于记录型的大对象，在通讯时，采用String型的xml格式

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

4、供客户端下载，其他业务系统根据下载的wsdl文件，产生客户端。建议使用Axis2来生成客户端代理。下面是登录接口调用参数说明：接口地址ormrpc/services/EASLogin方法名称login参数列表参数名称别名类型备注userNameEAS用户名StringEAS系统一个非异常的账户的用户名Password密码String用户名对应的密码slnName都为easdataCenterName数据中心idStringEAS对应的数据中心Language语言String默认为L2即可dbType数据库类型int0 sql server1 oracle2 db2相关对象描述不需要任何对象类型

5、的数据错误列表错误代码错误概述详细说明概要逻辑说明无调用者说明无其他说明无以下是Java客户端调用Java webservices接口的调用代码例如:public class Demo public static void main(String args) throws Exception Demo demo = new Demo(); demo.login(); * EAS登录 * login方法的参数分别代表为: * java.lang.String userName 用户名, * java.lang.String password 密码, * java.lang.String slnN

6、ame eas, * java.lang.String dcName 数据中心代码, * java.lang.String language 语言，简体中文为L2, * int dbType 0 sql server 1 oracle 2 db2 * throws Exceptionprivate void login() throws Exception String EASLogin_address =; URL url = new URL(EASLogin_address);EASLoginProxy proxy=new EASLoginProxyServiceLocator().get

7、EASLogin(url); WSContext ctx = proxy.login(user, pwd, eas, 001, L2, 1);if(ws != null& ws.getSessionId() !=null)System.out.println(登录成功);elseSystem.out.println(登录失败);媒讯CTC系统提供接口效劳地址待三地方补充。效劳地址测试环境：正式环境：建议把IP地址与端口做成一个可配置参数。3.7接口需求.1接口概况本次集成业务所涉及的接口如下表所示:序号接口名称数据发送方数据接收方接口提供者接口调用者.2接口说明接口处理过程说明：其他逻辑控制说明：四、详细设计4.1XX EAS接口4.1.1设计说明此接口由EAS端(提供者)开发，供媒讯CTC系统 (调用者)调用。4.1.2通讯内容接口地址方法名称参数列表参数名称别名类型备注返回值对象描述bill错误列表错误代码错误概述概要说明调用者说明其他说明4.1.3通讯用例-xmlData格式例子2021203832021-08-29/2021-08-29一分6