业务数据通讯模块概要设计文档.doc

业务数据通讯模块概要设计文档杭州方欣计算机工程有限公司2009年7月目录引言3概述41、背景介绍42、通讯需求4采用TCP/IP协议4传递报文4同步或异步传输4文本或文件传输43、通讯示意图4第一章通讯业务基本规则61、通讯中涉及到的数据范围及数据流向：62、总公司FTP服务器规范说明：63、分公司端与总公司端通讯报文：63.1、用途63.2、格式6第二章客户端交易过程流程图7第三章服务端交易过程9第四章通讯相关业务描述9一、基础资料传输交易9二、基础资料传输流程图10三、开票信息传输交易10四、开票信息传输流程图10第五章通讯报文格式描述12分公司与总公司通讯报文121、基础资料传输交易122、基础资料传输状态查询交易143、开票信息传输交易144、开票信息传输状态查询交易155、网络状态查询17第六章附录17一、交易存储过程返回代码说明：17引言〖阅读指南〗。〖阅读对象〗〖名词解释〗【注意】联系人【警告】无。概述1、背景介绍在某大型企业的信息化应用中分公司的业务系统需要和总公司的系统进行数据通讯和传输每天总公司需要获得分公司的业务数据如产品销售情况同时更新分公司相应的基础资料信息。数据通讯必须要遵守标准协议和约定所以分公司数据通讯客户端与总公司的数据通讯模块服务器端之间要有统一的业务接口。以便通讯服务器端在接收客户端数据后可把数据传递给总公司管理系统总公司管理系统把处理的结果返回给通讯服务器端通过服务器端再把应答消息返回给分公司数据通讯客户端。2、通讯需求采用TCP/IP协议采用标准的TCP/IP协议。通讯服务端是TCP/IP的服务端是通讯连接和关闭的被动方。传递报文通讯报文、业务报文格式由总公司已拟订好通讯服务器端在接收客户端的业务报文后根据报文内容进行后续处理处理后生成处理结果再把此结果信息返回给分公司客户端。同步或异步传输传输可以使用同步或异步模式。如果是同步模式服务器端把业务处理完毕后才能返回消息给客户端；如果是异步模式则服务器端接收完数据后就先把应答消息头返回给客户端再传递业务数据处理。文本或文件传输可支持文本传输同时也支持文件的传输。文件的传输通过FTP进行传输。3、通讯示意图传输客户端报文传输服务端总公司管理系统分公司分公司业务系统总公司FTPTCP/IP协议总公司FTP协议第一章通讯业务基本规则1、通讯中涉及到的数据范围及数据流向：注:为了说明方便通讯端客户端指分公司通讯端服务端指总公司。数据流向说明：开票数据：分公司-〉总公司-〉分公司（说明：客户端发起交易生成数据传送到服务端服务端经过数据处理后返回日志客户端获取日志后根据日志内容修改数据库）基础数据：总公司-〉分公司：（说明：客户端发起交易但不生成数据由服务端生成数据客户端获取数据后根据数据内容修改数据库）数据覆盖原则：以总公司为准进行覆盖。数据范围及数据流向表交易名称数据流向落地机制数据覆盖机制基础资料传输交易总公司-〉分公司允许部分落地无法落地的信息记入错误日志表以总公司为准进行覆盖;服务端返回数据项中：总公司没有分公司有采取删除原则。开票信息传输交易分公司-〉总公司-〉分公司允许部分落地无法落地的信息记入错误日志表日志返回成功的结果回写开票表的传送标记字段不成功的结果则不操作2、总公司FTP服务器规范说明：总公司FTP服务器根据不同分公司建立用户用户名和密码都为分公司编码在总公司FTP上建立一个目录做为根目录然后以分公司编码做为子目录名客户端和服务端生成的数据文件上传到该分公司编码的子目录下命名方式以YYYYMMDD-业务名称XX.xml总公司返回日志文件名称为YYYYMMDD-业务名称YZXX.xml。3、分公司端与总公司端通讯报文：3.1、用途通讯中任何方发送或接收的第一个内容必须是专用报文。发送方利用专用报文告诉接收方：本次通讯的目的、方式、内容；接收方必须接收到专用报文后才能确定后续应该如何操作。3.2、格式专用报文长度必须是512字节。如果不足512字节则必须用空格补充。下表说明专用报文的组成结构：序号名称长度（字节）说明1应答码4如果本字段为“9999”则表示是客户端向服务器发送的请求；如果本字段为“0000”则表示服务器向客户端返回成功信息；如果本字段为“0001”则表示客户端接收数据超时；如果本字段为“0002”则表示接收服务器向客户端返回失败信息。如果本字段为“5555”则表示客户端向服务器发送断开连接的请求。2同步或异步10:同步；1:异步3文件名50本字段在服务器端passMessage调用时起作用。4文件传输标识10本字段在服务器向客户端传输文件时的标识值为”0”则代表通过本系统传输值为”1”则代表通过FTP服务器传输。本字段不够长度的用空格补全.5业务报文长度10如果本字段为0则表示专用报文后不需传输业