项目接口需求及设计说明文档(模
板)(总9页)
--本页仅作为文档封面,使用时请直接删除即可-- --内页可以根据需求调整合适字体及大小--
媒讯集团EAS项目
CTC与EAS接口 需求及设计说明书
文档作者:
创建日期: 2013-05-10 确认日期: 当前版本: 拷贝数量: 1
审批签字:
客户方: 实施方:
文档控制 修改记录 日期 作者
版本 参考版本 备注
目录
2
1.
概述 ................................................................................................................. 错误!未定义书签。 读者 ........................................................................................................................ 错误!未定义书签。 图例 ........................................................................................................................ 错误!未定义书签。 目的 ........................................................................................................................ 错误!未定义书签。 二、业务现状 ................................................................................................................. 错误!未定义书签。 三、概要设计 ................................................................................................................. 错误!未定义书签。
接口通讯方式 ........................................................................................................ 错误!未定义书签。 通讯内容定义 ........................................................................................................ 错误!未定义书签。 媒讯CTC系统提供接口使用范例 ........................................................................ 错误!未定义书签。 金蝶EAS提供接口使用范例 ................................................................................ 错误!未定义书签。 媒讯CTC系统提供接口服务地址 ........................................................................ 错误!未定义书签。 金蝶EAS提供接口服务地址 ................................................................................ 错误!未定义书签。 接口需求 ................................................................................................................ 错误!未定义书签。 四、详细设计 ................................................................................................................. 错误!未定义书签。
EAS接口 ................................................................................................................ 错误!未定义书签。
1. 概述
金蝶与用户及用户业务系统方通过多次讨论,制定了接口开发需求设计说明书,作为双方后续开发指引。
3
读者 本文读者对象为业务管理人员、系统设计、开发人员、测试人员。
图例 本文中如未进行特殊说明,各图标代表的含义如下:
表示一个活动;
表示动态的业务数据,如系统单据; 表示流程走向;
表示条件判断、流程分支;
表示静态的业务数据,如基础资料; 表示系统外一个手工处理活动; 表示系统外手工填制的单据; 表示当前系统之外的活动;
表示当前系统之外产生的业务数据。
目的 本文档是媒讯CTC系统与EAS系统接口的需求及设计方案相关文档,可用于指导开发、测试工作和作为验收相关依据文档。
4
二、业务现状
待补充
三、概要设计
接口通讯方式
金蝶EAS与媒讯CTC系统之间通讯采用WebService方式进行数据传输。 通讯内容定义
对于记录型的大对象,在通讯时,采用String型的xml格式的参数进行传递。对于其他非记录型的对象,在通讯时,可采用非xml格式的参数进行传递,也可使用多个参数。具体格式,请参照每个接口的通讯用例说明。 媒讯CTC系统提供接口使用范例 待补充。
金蝶EAS提供接口使用范例 规范说明
EAS通过webService接口与异构系统通信。EAS WebService全部是使用java编写的,其接口描述符合WSDL国际标准,其数据描述符合XSD 国际标准。
本次提供的接口除系统登录接口外,其他接口都需要调用登录接口,以便将登陆的SessionId信息放入到 SOAP 的 HEADER 报文中。 使用示例
金蝶在EAS上发布WebService服务,提供wsdl文件供客户端下载,其他业务系统根据下载的wsdl文件,产生客户端。
建议使用Axis2来生成客户端代理。
5
下面是登录接口调用参数说明: 接口地址 sql server 1 oracle 2 db2 详细说明 相关对象描述 错误列表 概要逻辑说明 调用者说明 其他说明 不需要任何对象类型的数据 错误代码 错误概述 无 无 无
以下是Java客户端调用Java webservices接口的调用代码示例: public class Demo {
public static void main(String[] args) throws Exception { Demo demo = new Demo(); (); } /** * EAS登录
* login方法的参数分别代表为: * userName 用户名, * password 密码, * slnName eas,
* dcName 数据中心代码, * language 语言,简体中文为L2,
* int dbType 0 sql server 1 oracle 2 db2 * @throws Exception */
private void login() throws Exception {
String EASLogin_address =\"\"; URL url = new URL(EASLogin_address);
6
EASLoginProxy proxy=new EASLoginProxyServiceLocator().getEASLogin(url);
WSContext ctx = (\"user\ if(ws != null&& () !=null){
}
}
\"登录成功\"); } else {
\"登录失败\"); }
媒讯CTC系统提供接口服务地址 待三地方补充。
金蝶EAS提供接口服务地址 测试环境: EAS接口 设计说明
此接口由EAS端(提供者)开发,供媒讯CTC系统 (调用者)调用。
通讯内容
接口地址 方法名称 参数列表 返回值 对象描述 参数名称 别名 类型 7
备注 bill 错误列表 概要说明 调用者说明 其他说明 错误代码 错误概述 通讯用例
--xmlData格式例子 8
3
2012-08-29 2012-08-29 一分0196 ……
9