软件工程过程资料接口设计说明书Word文档下载推荐.docx
《软件工程过程资料接口设计说明书Word文档下载推荐.docx》由会员分享,可在线阅读,更多相关《软件工程过程资料接口设计说明书Word文档下载推荐.docx(8页珍藏版)》请在冰点文库上搜索。
注:
更改人除形成初稿,以后每次修改在未批准确认前均需采用修订的方式进行修改。
1引言
1.1设计目标
无相关图表的章节中,可自行根据需要加入图表说明,下同。
要达到的目的简述,例如说明需要支持的功能目标等。
1.2适用范围
文档的适用范围,比如是在全公司适用还是在某个产品部适用等。
预期的读者是哪些等。
1.3相关术语
列出本文件中用到的专门术语的定义,例如中间库在本项目中的的含义,如果没有需特别要说明的,可删除此章节
术语
解释
1.4参考资料
列出有关的参考资料
2分析设计
2.1设计思想
【说明本模块的基本设计概念,比如对需求是如何考虑的,为什么要把对应的需求转换成这样的设计处理,以及接口的概况性的描述、要求】
2.2接口结构
说明接口的系统、功能的分布关系,优先图示说明,如果需要,可以列出接口功能清单。
2.3数据流分析
为说明数据流向描述功能模块实现对应需求的数据流程图,说明数据经过处理后的输出传输情况。
可选
3中间库接口
通常不建议使用此接口方式实现,没有此接口方式可以删除此目录.
3.1中间库说明
说明传输数据库版本等
3.2传输交互方法
说明数据交互的频率、主动、触发等方式。
3.3中间库接口结构
3.3.1XXX1表/视图
如果是表采用下表描述结构
序号
字段中文名
字段英文名
字段类型
字段含义
1
抄表接口数据标识
DATA_ID
NUMBER(15)
本实体记录的唯一标识,产生规则为流水号。
下装时填写
2
申请编号
APP_NO
VARCHAR2(16)
流程实例的唯一标识,可自行编码。
3.3.2XXX2表/视图
相关内容同表1
3.3.3XXX1方法/函数
功能说明
提供客户的基本信息查询
调用位置
所在的包,直接调用存储过程或函数不用说明
函数方法
输入参数
参数代码
数据类型
参数说明
输出参数
示例
使用开发代码举例说明如何调用
4页面集成接口
没有此接口方式可以删除此目录
4.1对外提供
页面调用路径
入参
出参
备注
可说明调用的示例等
4.2外部调用
可说明提供方的相关信息
5Tuxedo接口
没有此接口方式可删除此章节目录。
5.1接口功能1
如提供给银行的“查询电费”功能,一些需要说明的信息在此说明;
如果功能比较复杂,可以根据需要设立下级子功能的目录结构。
TUXDEO服务的使用表格描述。
5.1.1接口子功能1
如果功能简单,此级目录可以不要,使用TUXDEO服务表格描述。
TUXDO接口服务表格如下:
服务名称
说明服务的CODE和名称
描述
参数名称
数据长度
错误信息
部署情况
5.1.2接口子功能2
结构示意如果功能简单,此级目录可以不要。
6WebService服务接口
6.1接口综述
综述WebService接口相关的技术,如简介认证、压缩、数据规约及需要描述的一些规定等,根据需要增加下级目录说明,下述目录为建议性质.
6.1.1WebService概述
本节可根据需要增删。
6.1.2认证机制
说明认证机制
6.1.3数据规约
说明格式约定、DTD等
6.2接口功能1
Webservice服务的使用表格描述。
6.2.1接口子功能1
如果功能简单,此级目录可以不要,使用Webservice服务表格描述。
Webservice接口服务表格如下:
方法名称
发布路径
7文件接口
7.1文件名称
说明传输文件的名称规则及格式,如MRDATA.DBF
7.2文件格式定义
根据需要,说明文件的列分割,行分割等条件,建议用表格方式。
例如字段可以使用下列表格。
7.3传输方法
说明定期传递,FTP或者指定目录等,如果使用方法,则参照类似格式:
向抄表机中传输文件
例如DLL/OCX等文件的路径名称等,如sendFileToHc.dll
PublicStringqryOwe(StringszStringRequest)throwsRemoteException,Uexception,Exception;
参数代码/名称
PORT
char
通讯端口号,参见标准代码PORT_NO
BAUDRATE
通讯波特率,参见标准代码BAUD_RATE
intSendFileToHc(charPORT,charBAUDRATE,charDATAFILE,charAPPFILE,charPROMPT);
SendFileToHc(‘1’,‘05’,’C:
\F1.DBF;
F2.DBF’,‘C:
\F3.dwn;
F4.mid’,’1’);
参数1:
’1’表述端口号为COM1,见标准代码PORT_NO
参数2:
’05’表示波特率为115.2k,见标准代码BAUD_RATE
参数3:
F2.DBF的路径同F1.DBF的路径。
参数4:
F4.mid的路径同F3.dwn的路径。
7.4{其他约定}
标题名称自定,例如可以约定目录结构、某某协议内容等,自行扩展。
8标准代码
约定的标准参数代码、返回代码等,自行扩展。