接口设计说明IDD文档标准模版

合集下载

接口设计说明

接口设计说明

接口设计说明文件编号:KJXXW-XXSJ-M002-V1.0版本号:V1.0受控状态:■受控□非受控保密级别:公司级编制人/编制时间:王攀坤2014年7月审核人/审核时间:批准人/批准时间:生效日期:新疆泰戈瑞信息技术有限责任公司发布变更记录(注:更改状态包括:C-创建、A-增加、M-修改、D-删除)2/ 14目录1.引言 (5)1.1标识 (5)1.2系统概述 (5)1.3文档概述 (5)1.4基线 (6)2.引用文件 (7)3.系统级设计决策........................................................................................................... 错误!未定义书签。

4.系统体系结构设计....................................................................................................... 错误!未定义书签。

4.1系统总体设计.................................................................................................... 错误!未定义书签。

4.1.1概述 ............................................................................................................ 错误!未定义书签。

4.1.2设计思想 .................................................................................................... 错误!未定义书签。

软件(结构)设计说明(SDD)文档标准模版

软件(结构)设计说明(SDD)文档标准模版

软件(结构)设计说明(SDD)XXXX公司文件更改记录文件版本变更记录软件(结构)设计说明(SDD)说明:1.《软件(结构)设计说明》(SDD)描述了计算机软件配置项(CSCI的设计。

它描述了CSCI级设计决策、CSCI体系结构设计(概要设计)和实现该软件所需的详细设计。

SDD可用接口设计说明IDD和数据库(顶层)设计说明DBDD加以补充。

2.SDD连同相关的IDD和DBDD是实现该软件的基础。

向需方提供了设计的可视性,为软件支持提供了所需要的信息。

3.IDD和DBDD是否单独成册抑或与SDD合为一份资料视情况繁简而定。

模版说明:1、文档字体设定:标题1:小一标题2:二号标题3:小二标题4:三号标题5:小三标题6:四号正文:四号2、文章编号,请使用格式刷刷,不要手工编号。

目前格式都是对的。

3、内容根据实际情况裁剪,一般可行性研究报告,模版章节不可缺。

4、封面图片请根据实际情况自行替换。

5、关于修订记录,请根据文档需要自行添加。

1.引言本章应分为以下几条。

1.1.标识本条应包含本文档适用的系统和软件的完整标识。

(若适用)包括标识号、标题、缩略词语、版本号、发行号。

1.2.系统概述本条应简述本文档适用的系统和软件的用途。

它应描述系统与软件的一般性质;概述系统开发、运行和维护的历史;标识项目的投资方、需方、用户、开发方和支持机构;标识当前和计划的运行现场;并列出其他有关文档。

1.3.文档概述本条应概述本文档的用途与内容,并描述与其使用有关的保密性或私密性要求。

1.4.基线说明编写本系统设计说明书所依据的设计基线。

2.引用文件本章应列出本文档引用的所有文档的编号、标题、修订版本和日期。

本章也应标识不能通过正常的供货渠道获得的所有文档的来源。

3.CSCI级设计决策本章应根据需要分条给出CSCI级设计决策,即CSCI行为的设计决策(忽略其内部实现,从用户的角度看,它如何满足用户的需求)和其他影响组成该CSCI 的软件配置项的选择与设计的决策。

代码接口设计模板

代码接口设计模板

代码接口设计模板设计代码接口时,可以采用一种清晰、一致的模板,以确保代码的可读性、可维护性和易用性。

以下是一个简单的代码接口设计模板示例,其中包含了一些常见的元素:```cpp// 文件名: YourModule.h#ifndef YOURMODULE_H#define YOURMODULE_H#include <iostream>#include <vector>// 命名空间(如果需要)namespace YourNamespace {// 类的前向声明(如果有类的定义)class YourClass;// 函数的前向声明(如果有函数的定义)void YourFunction(int param1, double param2);// 类的定义(如果有的话)class YourClass {public:// 构造函数YourClass();// 析构函数~YourClass();// 成员函数void memberFunction(int param);// 静态成员函数static void staticFunction();// 常量成员函数void constMemberFunction() const;private:// 私有成员变量int privateVariable;// 私有成员函数void privateFunction();};// 函数的定义void YourFunction(int param1, double param2);} // namespace YourNamespace#endif // YOURMODULE_H```上述代码接口设计模板包含了以下几个主要元素:1. 文件头部注释:包括文件名、宏定义防止多次包含、头文件包含等信息。

2. 命名空间:如果你的模块需要使用命名空间,可以在这里定义。

3. 类的前向声明:如果有类的定义,可以提前声明,以便其他模块在引用时知道这个类的存在。

接口方案模板

接口方案模板

接口方案模板在软件开发的过程中,接口方案是一个至关重要的部分。

接口方案提供了一种规范和指导,确保不同模块之间的顺利交互和数据传递。

一个优秀的接口方案能够提高开发效率,减少沟通成本,同时提供可扩展性和可维护性。

在本文中,我们将探讨一个典型的接口方案模板,旨在帮助开发者更好地规划和设计接口。

1. 概述接口方案的概述部分通常用于对接口方案进行简要介绍和背景阐述。

在此部分,我们可以描述接口方案的目的、所涉及的系统和业务场景。

同时,还可以简要说明接口方案的优势和预期的效果。

概述部分的主要目的是引起读者的兴趣,并为接下来的内容做好铺垫。

2. 接口设计接口设计是接口方案的核心内容。

在此部分,我们需要详细描述每个接口的功能和输入输出参数。

对于复杂的接口,我们还可以使用流程图或示例代码来说明其工作原理。

在接口设计时,我们需要考虑如下几个方面:2.1 数据格式数据格式是接口设计的重要组成部分。

在此部分,我们需要详细描述数据的类型、大小和可能存在的约束条件。

如果需要传递大文件或者二进制数据,我们还可以讨论使用文件上传或者Base64编码的方式。

2.2 接口调用方式接口调用方式描述了客户端如何与接口进行交互。

我们可以选择使用HTTP协议、WebSocket还是其他传输协议。

在此部分,我们需要定义接口的URL、请求方法和参数格式。

2.3 接口鉴权接口鉴权是保证接口安全性的关键环节。

我们需要定义鉴权方式,如基于API密钥、Access Token等。

同时,我们还需要说明鉴权过程中可能涉及的加密算法、签名规则等。

2.4 异常处理在接口设计时,我们需要考虑异常情况的处理方式。

这些异常包括客户端错误、服务端错误以及网络错误等。

我们需要定义异常的错误码和错误信息,以及对应的处理方式。

此外,我们还可以描述接口的幂等性和事务性。

3. 接口文档接口文档是接口方案的重要组成部分。

在此部分,我们需要详细描述每个接口的功能、输入输出参数、示例请求和响应。

软件接口需求规格说明模板

软件接口需求规格说明模板

编号:xxxxxxxxxx当前版本:密级:软件名称接口需求规格说明负责人:编制人:审核人:批准人:发布日期:xxxx年xx月xx日XXX公司上下文[上文指的是本文件的父文件,如果所编写的《设计开发策划书》是一系列总体策划的一部分,那么这个总体策划就是上文。

下文指的是本文件的子文件,如果所编写的《设计开发策划书》还有其他的策划文件来描述其他子项工作的策划,那么这些描述子项工作策划的文件就是下文。

在填写下面的表格时,先填写‘上文’,后天写‘下文’文件;如果《设计开发策划书》版本历史参考资料[列出有关的参考文件,如:本项目经营核准的计划任务或合同,上级机关的批文属于本项目的其他已发表文件;本文件中各处引用的文件、资料、,包括所用到的软件开发标准。

列出这些文件的标题、文件编号、发表日期和出版表单位,说明能够得到这些文件资料的来源。

若没有参考资料,请删去此节]目录软件名称 (1)上下文 (1)版本历史 (2)参考资料 (3)目录 (1)1引言 (2)1.1标识 (2)1.2系统概述 (2)1.3文档概述 (2)2引用文件 (2)3需求 (2)3.1接口标识和接口图 (2)3.2(接口的项目唯一标识符) (3)3.3需求的优先顺序和关键程度 (5)4合格性规定 (5)5需求可追踪性 (5)6尚未解决的问题 (6)7注解 (6)附录 (6)1 引言本章应分为以下几条。

1.1 标识本条应包含本文档适用的系统接口实体和接口的完整标识,(若适用)包括标识号、标题、缩略词语、版本号和发行号。

1.2 系统概述本条应简述本文档适用的系统和软件的用途,它应描述系统和软件的一般特性;概述系统开发、运行和维护的历史;标识项目的投资方、需方、用户、开发方和支持机构;标识当前和计划的运行现场;列出其他有关的文档。

1.3 文档概述本条应概述本文档的用途和内容,并描述与其使用有关的保密性或私密性要求。

2 引用文件本章应列出本文档引用的所有文档的编号、标题、修改版本和发行日期,也应标识不能通过正常的供货渠道获得的所有文档的来源。

接口文档设计规范

接口文档设计规范
可空
2088001159940003
参数编码字符集
String(10)
不可空
GBK
签名
String(64)
不可空
e8qdwl9caset5zugii2r7q0k8ikopxor
签名方式
String(10)
不可空
MD5
页面跳转同步返回页面路径
String(1000)
可空
备注
String(1000)
可空
接口文档设计分为两部分:
一、对外接口设计规范,
1.提供完整的接口文档
2.提供接口调用的代码Demo
示例如下:
请求的基本参数
参数
参数名称
类型
(长度范围)
参数说明
是否可为空
样例
基本参数
接口名称
String(64)
不可空
send_goods_confirm_by_platform
合作者身份ID
String(16)
同步返回时,需要的基本参数
参数
参数名称
类型
(长度范围)
参数说明
是否可为空
样例
基本参数
成功标识
String(1)
不可空
T
合作者身份ID
String(16)
可空
2088001159940003
参数编码字符集
String(10)
不可空
GBK
签名
String(64)
不可空
e8qdwl9caset5zugii2r7q0k8ikopxor
N
String(64)
N
String(256)
N
String(12)

接口详细设计文档

.接口详细设计文档作者:唐为(为哥)审核:赵锟日期:2005-5-27接口详细设计文档 (1)1编写目的 (3)2名词解释 (3)3组件分布图 (4)4程序结构 (5)4.1接入处理线程类图 (5)4.2接收线程类图 (6)4.3启动控制图 (6)5程序设计说明 (7)5.1对原系统的改动 (7)5.2ThreadInSvcProcessor 接入处理器 (8)5.2.1类图 (8)5.2.2时序图 (9)5.2.3流程图 (9)5.2.4ThreadInSvcProcessor类说明 (11)5.3PatternNewSyncAsyncInnerDir 同异步向内处理模式 (16)5.3.1类图 (16)5.3.2描述 (17)5.3.3流程图 (17)5.3.4类说明 (19)5.4ThreadReplySvcProcessor 异步应答返回处理器 (24)5.4.1类图 (24)5.4.2类说明 (24)5.5ClientInfo 客户端连接数据 (33)5.5.1类图 (33)5.5.2类描述 (33)5.6ClientInfoTable 客户端连接数据表 (34)5.6.1类图 (34)5.6.2类描述 (34)5.7ClientInfoTableMonitor 客户端连接数据表监控程序 (38)5.7.1类图 (38)5.7.2类说明 (38)5.8FrontMain 主控程序 (40)5.8.1类间关系 (40)5.8.2流程图 (41)5.8.3类说明 (42)5.9问题 (44)1编写目的预期读者:对接口行为和目的有一定了解的人背景说明⏹软件系统名称:接口前端接入服务器⏹描述<接口> 接收不同商家的接入,接收数据转发给主机服务器,并同步/异步将返回数据发给接入商家的行为2名词解释⏹ChannelBase渠道,通信基类,提供数据收发和释放的方法接口用子类实现来封装了不同通信方式目前有TCP短连接接入,从ACE Message_Queue中读取(IPC MessageQueue-> ACE_Message_Queue)⏹Trade* trade商家对象,代表的其实是针对该商家处理方法的集合将接入数据的商家称为服务商家而将请求面向的商家称为主机商家,主机商家负责同步/异步返回交易的应答数据给接口平台⏹而接口(数据交换)平台是在两者之间的交换平台⏹渠道工厂:把接入数据的渠道工厂统一定为服务渠道工厂,发送数据的渠道工厂统一定为主机通道工厂4程序结构4.1接入处理线程类图Process() TradeOutProcess() ClearDataBus() CallHost() TradeInProcess()is_sync_return()is_same_rw_sv createClientInfo() addToClientInfoTable()PatternASyncInnerDir()Process()GetSelf()GetHostChannelObj()ProcessPattern()<<v<<v<<v<<v<<v<<v<<v<<v<<v<<vshm_mgr()res_mgr()SvGetChannel()TradeRecvTradeInProcess()ExecPattern()RequestSecureFailedProcess()ThreadInSv_trade_code : std::string<<v<<v<<vshm_mgr()_trade_code : char [TRADECODELEN+1]_trade_name : char [TRADENAMELEN+1]_compress_flag : SINT32_encry_flag : SINT32_trade_type : SINT32_err_times : SINT32_infun_ser : v_outfun_ser : v_pack_strategy : GenericFmlTranslaterInterface *4.2接收线程类图begin_time timeout_time trade_code : string interface_id : string pkggrp_id : int pkg_idx : int mutex : ACE_Thread_Mutexinstance_mutex : ACE_Thread_mutexgetInstance()addRecord()fetchRecord()clearTimeoutRecords()generateKey()cleanup()_trade_code : char [TRADECODELEN+1]_trade_name : char [TRADENAMELEN+1]_compress_flag : SINT32_encry_flag : SINT32_trade_type : SINT32_err_times : SINT32_infun_ser : vector< SINT32 >_outfun_ser : vector< SINT32 >_pack_strategy : GenericFmlTranslaterInterface *p_recv_trade : Trade*data_bus : DataBusb_exit : bool*SvcRun()GetRecvChannel(p_recv_trade : Trade*) : ChannelBase*TradeRecvData(p_chnbase : ChannelBase*, p_trade : Trade*, p_databus : DataBus*, p_timeout : ACE_Time_Value*) : intUnpackRecvData(p_databus : DataBus*) : intfetchClientInfoRecord(key : string) : ClientInfo*RecoverDataBusInfo(p_clientinfo_record : ClientInfo*, p_databus : DataBus*) : intgetTrade(trade_code : string) : Trade*TradeOutProcess(p_trade : Trade*, p_databus : DataBus*) : intCreateOutputChannel(out_trade : Trade*) : ChannelBase*TradeSendData(p_trade : Trade*, p_databus : DataBus*) : intThreadReplySvcProcessor(pTrade : Trade*, pFactory : SvcChannelFactory*, pBExit : bool*)_trade_code : std::string<<virtual>> GetChannel()<<virtual>> Initialize()<<virtual>> ~SvcChannelFactory()shm_mgr()4.3启动控制图FrontMain() startup()shutdown()ClientInfoTableMonitor ClientInfoTableMonitor()startup()shutdown()_trade_code : std::string <<v<<v<<vshm_mgr()_bexit : SINT32_v_trade_code : string_nthreads : SINT32 InteTask()Start()Stop()AddThread()~InteTask()<<static>> ThreadProc() CreateSvres_manager()SvGetChannel()TradeRecvTradeInProcess()ExecPattern()RequestSecureFailedProcess()ThreadInSv ThreadReplySvcProcessorp_recvdata_bus : DataBusb_exit : bool*SvGetRecvTradeRecvUnpackRecvfetchClientInfoRecord()RecovgetTrade()TradeOutProcess()CreateOutputChannel()TradeSendData()ThreadReplySv5程序设计说明5.1对原系统的改动⏹改变原有商家Trade类,不存放渠道对象在商家类中,商家类只执行商家处理,不负责渠道的管理⏹改动原有的系统中所有模式的处理,模式处理必须对渠道的释放负责⏹修改MidHstChannel,添加后台服务需要的2个FML字段,这两个字段是:FML域名描述S_INTERF_NO接口标识号,整数。

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

媒讯集团 EAS 项目CTC与 EAS接口需求及设计说明书文档作者:创建日期:2013-05-10确认日期:当前版本:拷贝数量:1审批签字:客户方:实施方:文档控制修改记录日期作者版本参考版本备注目录1.概述错误 !未定义书签。

读者错误 ! 未定义书签。

图例错误 ! 未定义书签。

目的错误 ! 未定义书签。

二、业务现状错误 !未定义书签。

三、概要设计错误 !未定义书签。

接口通讯方式错误 !未定义书签。

通讯内容定义错误 !未定义书签。

媒讯 CTC系统提供接口使用范例错误!未定义书签。

金蝶 EAS提供接口使用范例错误!未定义书签。

媒讯 CTC系统提供接口服务地址错误!未定义书签。

金蝶 EAS提供接口服务地址错误!未定义书签。

接口需求错误!未定义书签。

四、详细设计错误 !未定义书签。

EAS接口错误!未定义书签。

概述金蝶与用户及用户业务系统方通过多次讨论,制定了接口开发需求设计说明书,作为双方后续开发指引。

读者本文读者对象为业务管理人员、系统设计、开发人员、测试人员。

图例本文中如未进行特殊说明,各图标代表的含义如下:表示一个活动;表示动态的业务数据,如系统单据;表示流程走向;表示条件判断、流程分支;表示静态的业务数据,如基础资料;表示系统外一个手工处理活动;表示系统外手工填制的单据;表示当前系统之外的活动;表示当前系统之外产生的业务数据。

目的本文档是媒讯 CTC系统与 EAS 系统接口的需求及设计方案相关文档,可用于指导开发、测试工作和作为验收相关依据文档。

二、业务现状待补充三、概要设计接口通讯方式金蝶 EAS与媒讯 CTC系统之间通讯采用WebService方式进行数据传输。

通讯内容定义对于记录型的大对象,在通讯时,采用 String 型的 xml 格式的参数进行传递。

对于其他非记录型的对象,在通讯时,可采用非xml 格式的参数进行传递,也可使用多个参数。

具体格式,请参照每个接口的通讯用例说明。

媒讯 CTC系统提供接口使用范例待补充。

接口详细设计文档

接口详细设计文档.接口详细设计文档 (1)1 编写目的 (5)2 名词解释 (5)3组件分布图 (6)4 程序结构 (8)4.1 接入处理线程类图 (8)4.2 接收线程类图 (9)4.3 启动控制图 (9)5 程序设计说明 (10)5.1 对原系统的改动 (10)5.2 ThreadInSvcProcessor 接入处理器 (11)5.2.1 类图 (11)5.2.2 时序图 (12)5.2.3 流程图 (12)5.2.4 ThreadInSvcProcessor类说明 (14)5.3 PatternNewSyncAsyncInnerDir 同异步向内处理模式 (21) 5.3.1 类图 (21)5.3.2 描述 (21)5.3.3 流程图 (21)5.3.4 类说明 (23)5.4 ThreadReplySvcProcessor 异步应答返回处理器 (29)5.4.1 类图 (29)5.4.2 类说明 (29)5.5 ClientInfo 客户端连接数据 (39)5.5.1 类图 (39)5.5.2 类描述 (39)5.6 ClientInfoT able 客户端连接数据表 (40)5.6.1 类图 (40)5.6.2 类描述 (40)5.7 ClientInfoT ableMonitor 客户端连接数据表监控程序 (45)5.7.1 类图 (45)5.7.2 类说明 (45)5.8 FrontMain 主控程序 (47)5.8.1 类间关系 (47)5.8.2流程图 (48)5.8.3 类说明 (50)5.9 问题 (53)1编写目的预期读者:对接口行为和目的有一定了解的人背景说明软件系统名称:接口前端接入服务器描述<接口> 接收不同商家的接入,接收数据转发给主机服务器,并同步/异步将返回数据发给接入商家的行为2名词解释ChannelBase 渠道,通信基类,提供数据收发和释放的方法接口用子类实现来封装了不同通信方式目前有TCP短连接接入,从ACE Message_Queue中读取(IPC MessageQueue-> ACE_Message_Queue)Trade* trade 商家对象,代表的其实是针对该商家处理方法的集合将接入数据的商家称为服务商家而将请求面向的商家称为主机商家,主机商家负责同步/异步返回交易的应答数据给接口平台而接口(数据交换)平台是在两者之间的交换平台渠道工厂:把接入数据的渠道工厂统一定为服务渠道工厂,发送数据的渠道工厂统一定为主机通道工厂。

接口设计说明书课件.doc

接口设计说明书修订历史记录目录0.模板说明 (4)0.1编写目的 (4)0.2适用范围 (4)0.3术语定义 (4)1.说明 (4)2.新增接口 (4)2.1新增对象so*** (4)2.1.1说明: (4)2.1.2属性 (4)2.1.3方法 (5)3.修改接口 (5)3.1修改控件:Super*** (5)3.1.1新增接口 (5)3.1.2修改接口 (5)3.2修改对象so*** (6)3.2.1新增接口 (6)3.2.2修改接口 (6)3.3修改常数 (7)3.3.1新增常数 (7)3.3.2修改常数 (7)0.模板说明0.1编写目的[本报告的主要目的:本报告相关流程活动]0.2适用范围[本报告适用范围(角色、部门、岗位、人员)使用本报告的约束条件本报告不适用的领域]0.3术语定义[列出本报告中所使用的所有术语和缩略语。

可引用已有的数据字典,如没有则需要在此列出。

例如:参见《数据字典.doc》术语——列出在本报告中用到的关键词和专用词,并给出其含义;缩略语——列出在本报告中用到的所有缩略语,并给出中英文全称;另外在正文中缩略语首次出现处要给出中英文全称。

]1.说明[SuperMap Objects(COM)的接口设计采用此说明书,其他产品,如SuperMap Objects .NET、SuperMap Objects Java、SuperMap IS Java和SuperMap IS .NET等产品由于采用Java和.NET技术,接口可以通过先写完接口定义代码,然后通过集成环境自动生成相应接口说明文档。

其他产品如果需要制定接口设计说明书,则可以参考本说明书制定。

]2.新增接口2.1新增对象so***2.1.1说明:2.1.2属性2.1.3方法3.修改接口3.1修改控件:Super***3.1.1新增接口属性方法事件3.1.2修改接口属性方法事件3.2修改对象so*** 3.2.1新增接口属性方法3.2.2修改接口属性方法3.3修改常数3.3.1新增常数3.3.2修改常数。

  1. 1、下载文档前请自行甄别文档内容的完整性,平台不提供额外的编辑、内容补充、找答案等附加服务。
  2. 2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
  3. 3、如文档侵犯您的权益,请联系客服反馈,我们会尽快为您处理(人工客服工作时间:9:00-18:30)。

接口设计说明(IDD)
XXXX公司
文件版本V1.0
XXXX
接口设计说明(IDD)
版本/更改状态
1/0
文件更改记录
^件版本变更记录
接口设计说明(IDD)
说明:
1.《接口设计说明》(IDD)描述了一个或多个系统或子系统、硬件配置项HWCI、计算机软件配置项CSCI、手工操作或其他系统部件的接口特性。

一个IDD可以说明任何数量的接口。

2.IDD可用于补充《系统/子系统设计(结构设计)说明》(SSDD)、《软件(结构)设计说明》(SDD)和《数据库(顶层)设计说明》(DBDD)。

IDD及其相伴的《接口需求规格说明》(IRS)用于沟通和控制接口的设计决策。

模版说明:
1、文档字体设定:
标题1:小一
标题2:二号
标题3:小二
标题4:三号
标题5:小三
标题6:四号
正文:四号
2、文章编号,请使用格式刷刷,不要手工编号。

目前格式都
是对的。

3、内容根据实际情况裁剪,一般可行性研究报告,模版章节
不可缺。

4、封面图片请根据实际情况自行替换。

5、关于修订记录,请根据文档需要自行添加。

1.引言
本章分为以下几条。

1.1.标识
本条应包含本文档适用的系统、接口实体和接口的完整标识,(若适用)包括标识号、标题、缩略词语、版本号、发行号。

1.2.系统概述
本条应简述本文档适用的系统和软件的用途。

它应描述系统与软件的一般性质;概述系统开发、运行和维护的历史;标识项目的投资方、需方、用户、开发方和支持机构;标识当前和计划的运行现场;并列出其他有关文档。

1.3.文档概述
本条应概括本文档的用途与内容,并描述与其使用有关的保密性或私密性要求。

1.4.基线
说明编写本系统设计说明书所依据的设计基线。

2.引用文件
本章应列出本文档引用的所有文档的编号、标题、修订版本和日期。

本章也应标识不能通过正常的供货渠道获得的所有文档的来源。

3.接口设计
本章应分条描述一个或多个系统、子系统、配置项、手工操作和其他系统部件的接口特性。

如果设计的部分或全部依赖于系统状态或方式,则应指出这种依赖性。

如果设计信息在多条中出现,则可只描述一次,而在其他条加以引用。

如果此信息的部分或全部在别处提供,则此处可以引用。

应给出或引用为了理解设计所需的设计约定。

3.1.接口标识和接口^
对于1.1中所标识的每个接口,本条应陈述赋予该接口的项目唯一标识符,(若适用)并用名字、编号、版本和文档引用等标识接口实体(系统、配置项、用户等)。

该标识应说明哪些实体具有固定的接口特性(因而要对这些接口实体强加接口需求),哪些实体正被开发或修改(从而已将接口需求施加于它们)。

(若适用)可用一个或多个接口图来描述这些接口。

3.2.3.x (接口的项目唯一标蝴)
本条(从3.2开始编号)应通过项目唯一标识符标识接口,应简要标识接口实体,并且应根据需要划分为几条描述接口实体的单方或双方的接口特性。

如果一给定的接口实体本文没有提及(例如,一个外部系统),但是其接口特性需要在本
文描述的接口实体时提到测这些特性应以假设、或〃当[未提到实体]这样做时,[被提到的实体]将……〃的形式描述。

本条可引用其他文档(例如数据字典、协议标准、用户接口标准)代替本条的描述信息。

(若适用)本设计说明应包括以下内容,它们可按适合于要提供的信息的任何次序给出,并且应从接口实体角度指出这些特性之间的区别(例如数据元素的大小、频率或其他特性的不同期望)。

a.接口实体分配给接口的优先级别;
匕要实现的接口的类型(如:实时数据传送、数据的存储和检索等);
c.接口实体必须提供、存储、发送、访问、接收的单个数据元素的特性,如:1)名
称/标识符;
a)项目唯一标识符;
b)非技术(自然语言)名称;
c)标准数据元素名称;
d)技术名称(如代码或数据库中的变量或字段名称);
e)缩写名或同义名;
2)数据类型(字母数字、整数等);
3)大小和格式(如:字符串的长度和标点符号);
4)计量单位(如:米、元、纳秒);
5)范围或可能值的枚举(如:0-99);
6)准确度(正确程度)和精度(有效数字位数);
7)优先级别、时序、频率、容量、序列和其他的约束条件,如:数据元素是否可被更新和业务规则是否适用;
8)保密性和私密性的约束;
9)来源(设置/发送实体)和接收者(使用/接收实体);
d.接口实体必须提供、存储、发送、访问和接收的数据元素集合体记录、消息、文件、显示和报表等)的特性,如:
1)名称/标识符;
协项目唯一标识符;
3
b)非技术(自然语言)名称;
c)技术名称(如代码或数据库的记录或数据结构);
d)缩写名或同义名;
2)数据元素集合体中的数据元素及其结构(编号、次序和分组);
3)媒体(如盘)和媒体中数据元素/数据元素集合体的结构;
4)显示和其他输出的视听特性(如:颜色、布局、字体、图标和其他显示元素、蜂鸣声、亮度等);
5)数据元素集合体之间的关系,如排序/访问特性;
6)优先级别、时序、频率、容量、序列和其他的约束条件,如:数据元素集合体是否可被修改、业务规则是否适用;
7)保密性和私密性约束;
8)来源(设置/发送实体)和接收者(使用/接收实体);
e.接口实体必须为接口使用通信方法的特性。

如:
1)项目唯一标识符;
2)通信链接/带宽/频率/媒体及其特性;
3)消息格式化;
4)流控制(如:序列编号和缓冲区分配);
5)数据传送速率,周期性/非周期性,传输间隔;
6)路由、寻址、命名约定;
7)传输服务,包括优先级别和等级;
8)安全性/保密性/私密性方面的考虑,如:加密、用户鉴别、隔离和审核等;
f.接口实体必须为接口使用协议的特性,如:
1)项目唯一标识符;
2)协议的优先级别/层次;
3)分组,包括分段和重组、路由、寻址;
4)合法性检查、错误控制和恢复过程;
5)同步,包括连接的建立、维护、终止;
6)状态、标识、任何其他的报告特征;
g其他所需的特性,如:接口实体的物理兼容性(尺寸、容限、负荷、电压和接插
件兼容性等)。

4.需求的可追踪性
本章应包括:
a.从本文提到的每个接口实体到该实体的接口设计所涉及的系统或CSCI需求的可追踪性;
b.从影响本IDD所覆盖的接口的每个系统或CSCI需求到涉及它的接口实体的可追踪性。

5. 注解
本章应包含有助于理解本文档的一般信息(例如背景信息、词汇表、原理)。

本章应包含为理解本文档所需要的术语和定义,所有缩略语和它们在本文档中的含义的字母序列表。

6.附录
附录可用来提供那些为便于文档维护而单独出版的信息、(例如图表、分类数据)。

为便于处理,附录可单独装订成册。

附录应按字母顺序(A,B等)编排。

相关文档
最新文档