软件文档国家标准.ppt
《软件文档国家标准.ppt》由会员分享,可在线阅读,更多相关《软件文档国家标准.ppt(38页珍藏版)》请在咨信网上搜索。
1、郑州大学信息工程学院 徐婷软件文档1-1第第3章章 软件文档国家标准软件文档国家标准 3.1 3.1 计算机软件产品开发文档编制指南计算机软件产品开发文档编制指南3.2 3.2 计算机软件需求说明编制指南计算机软件需求说明编制指南 3.3 3.3 计算机软件测试文档编制规范计算机软件测试文档编制规范 3.4 3.4 软件文档管理指南软件文档管理指南 郑州大学信息工程学院 徐婷软件文档1-23.0 软件工程标准软件工程标准 软件工程标准可以分为软件工程标准可以分为基础标准基础标准、开发标准开发标准、文档标准文档标准以及以及管理标准管理标准4种。种。我国已经发布的文档标准:我国已经发布的文档标准:
2、计算机软件文档编制规范(计算机软件文档编制规范(GB/T 8567-2006GB/T 8567-2006)计算机软件需求规格说明规范(计算机软件需求规格说明规范(GB/T 9385-2008GB/T 9385-2008)计算机软件测试文档编制规范(计算机软件测试文档编制规范(GB/T 9386-2008GB/T 9386-2008)软件文档管理指南(软件文档管理指南(GB/T 16680-1996GB/T 16680-1996)郑州大学信息工程学院 徐婷软件文档1-33.1 计算机软件文档编制规范计算机软件文档编制规范 计算机软件文档编制规范计算机软件文档编制规范(GB/T 8567-2006
3、)是是指导性文档。该标准是指导性文档。该标准是GB/T85671988计算机软计算机软件产品开发文件编制指南的修订版,并改名为计件产品开发文件编制指南的修订版,并改名为计算机软件文档编制规范。并从实施之日起代替算机软件文档编制规范。并从实施之日起代替GB/T85671988。GB/T 8567-1988由原电子工业部提出,中国软件由原电子工业部提出,中国软件技术公司负责起草,技术公司负责起草,国家标准局于国家标准局于1988年年1月月7日批准,日批准,1988年年7月月1日实施。于新标准实施之日废止。日实施。于新标准实施之日废止。郑州大学信息工程学院 徐婷软件文档1-43.1.1 软件文档的组
4、成软件文档的组成 根据该指南,一个计算机软件的开发过程中,一根据该指南,一个计算机软件的开发过程中,一般应产生般应产生14种文档。指南不仅给出了种文档。指南不仅给出了14种文档的编制种文档的编制指导,同时,也是这指导,同时,也是这14种文档编写质量的检验准则。种文档编写质量的检验准则。3.1.2 各类文档的内容要求各类文档的内容要求 14种文档的内容及要求:种文档的内容及要求:详见文档详见文档3.1 计算机软件文档编制规范计算机软件文档编制规范郑州大学信息工程学院 徐婷软件文档1-53.2 计算机软件需求规格说明规范计算机软件需求规格说明规范 计算机软件需求规格说明规范计算机软件需求规格说明规
5、范(GB/T 9385-2008)为软件需求的实践提供了一个规范化的方法。适用于编为软件需求的实践提供了一个规范化的方法。适用于编写软件需求规格说明书,它描述了一个软件需求说明书写软件需求规格说明书,它描述了一个软件需求说明书所必需的内容和质量。所必需的内容和质量。该规范是该规范是GB/T9385-1988计算机软件需求说明编制计算机软件需求说明编制指南的第一次修订。指南的第一次修订。GB/T9385-1988由原电子工业部由原电子工业部于于1988年年4月月26日批准,日批准,1988年年12月月1日实施。于新标准日实施。于新标准实施之日废止。实施之日废止。郑州大学信息工程学院 徐婷软件文档
6、1-63.2.1 软件需求文档的编制目标软件需求文档的编制目标 SRS Software Requirments Specifications 软件需求说明软件需求说明 SRS对于软件顾客来讲,应尽可能准确地描述其所需对于软件顾客来讲,应尽可能准确地描述其所需要的产品;而对于供方来讲,应能准确地理解客户所需要的产品;而对于供方来讲,应能准确地理解客户所需要的产品。要的产品。其作用可概括以下为其作用可概括以下为6个方面个方面:3.2 计算机软件需求规格说明规范计算机软件需求规格说明规范郑州大学信息工程学院 徐婷软件文档1-71对于提供什么软件产品,为顾客和供方之间的协对于提供什么软件产品,为顾客
7、和供方之间的协议建立基础。议建立基础。SRS中软件功能的完备描述将协助潜在用户,中软件功能的完备描述将协助潜在用户,以便确定指定的软件是否满足其需要,或者为满足以便确定指定的软件是否满足其需要,或者为满足其需要应如何定义该软件。其需要应如何定义该软件。2.减少开发工作减少开发工作;SRS文档的编制迫使顾客组织有关各方面人员文档的编制迫使顾客组织有关各方面人员在设计之前严格考虑所有的需求,并减少以后的重在设计之前严格考虑所有的需求,并减少以后的重新设计、重新编码和重新测试。对新设计、重新编码和重新测试。对SRS中的各项需中的各项需求进行仔细评审,可以在开发周期的早期揭示某些求进行仔细评审,可以在
8、开发周期的早期揭示某些遗漏、误解和不一致,此时问题更容易纠正。遗漏、误解和不一致,此时问题更容易纠正。3.2 计算机软件需求规格说明规范计算机软件需求规格说明规范郑州大学信息工程学院 徐婷软件文档1-83为估计成本和进度提供基础;为估计成本和进度提供基础;SRS中给出的待开发产品的描述是估计项目成中给出的待开发产品的描述是估计项目成本的现实基础,可用于取得投标认可或得出价格估本的现实基础,可用于取得投标认可或得出价格估算。算。4.为验证和确认提供基线为验证和确认提供基线;通过一份好的通过一份好的SRS文档,组织可提出更加有效文档,组织可提出更加有效的验证和确认计划。作为开发合同的一部分,的验证
9、和确认计划。作为开发合同的一部分,SRS提供了可用于测量一致性的基线。提供了可用于测量一致性的基线。3.2 计算机软件需求规格说明规范计算机软件需求规格说明规范郑州大学信息工程学院 徐婷软件文档1-95便于软件产品转移;便于软件产品转移;SRS文档使软件产品转移到新的用户机器更容文档使软件产品转移到新的用户机器更容易,顾客因此发现软件产品更容易转移到组织的其易,顾客因此发现软件产品更容易转移到组织的其他部门,供方发现软件产品更容易转移到新的顾客。他部门,供方发现软件产品更容易转移到新的顾客。6.作为进一步增强的基础作为进一步增强的基础;因为因为SRS文档讨论的是产品而不是开发他的项文档讨论的是
10、产品而不是开发他的项目,因此,目,因此,SRS是已经开发产品后续增强的基础。是已经开发产品后续增强的基础。尽管尽管SRS文档或许需要修改,但他确实为后续产品文档或许需要修改,但他确实为后续产品评价提供了基础。评价提供了基础。3.2 计算机软件需求规格说明规范计算机软件需求规格说明规范郑州大学信息工程学院 徐婷软件文档1-103.2.2 软件需求文档的基本要求软件需求文档的基本要求 SRS是对要完成一定功能、性能的软件产品、程是对要完成一定功能、性能的软件产品、程序或一组程序的说明。因此对序或一组程序的说明。因此对SRS的描述有两项基本的描述有两项基本要求:要求:1.必须描述一定的功能、性能;必
11、须描述一定的功能、性能;2.必须用确定的方法叙述这些功能。必须用确定的方法叙述这些功能。SRS作为作为软件开发规范软件开发规范之一,对软件开发的所有之一,对软件开发的所有阶段都起着非常重要的作用。但是,需要注意的是:阶段都起着非常重要的作用。但是,需要注意的是:SRS不能超出其作用范围不能超出其作用范围,即除了,即除了SRS正确地定义所正确地定义所有软件的需求之外,一般地有软件的需求之外,一般地SRS不描述任何设计、验不描述任何设计、验证或项目管理的细节,这是对证或项目管理的细节,这是对SRS的另外两个要求。的另外两个要求。3.2 计算机软件需求规格说明规范计算机软件需求规格说明规范郑州大学信
12、息工程学院 徐婷软件文档1-113.2.3 软件需求标准适用范围软件需求标准适用范围1.适用对象:适用对象:(1)软件客户,以便精确地描述他们想获得什么)软件客户,以便精确地描述他们想获得什么样的产品;样的产品;(2)软件供方,以便准确地理解客户需要什么样)软件供方,以便准确地理解客户需要什么样的产品。的产品。2.目的:目的:(1)要提出开发规范化的)要提出开发规范化的SRS提纲;提纲;(2)定义自己需要的具体的格式和内容;)定义自己需要的具体的格式和内容;(3)产生附加的局部条款。)产生附加的局部条款。3.2 计算机软件需求规格说明规范计算机软件需求规格说明规范郑州大学信息工程学院 徐婷软件
13、文档1-123.指南引用标准:指南引用标准:(1)GB/T 8566-2007信息技术信息技术软件生存周期过程软件生存周期过程 (2)GB/T 11457-2006信息技术信息技术软件工程术语。软件工程术语。4.有关定义:有关定义:(1)合同:是顾客和供方共同签署的具体有法律约)合同:是顾客和供方共同签署的具体有法律约束力的文件。其中包括产品的技术、组织、成本和进束力的文件。其中包括产品的技术、组织、成本和进度计划要求等内容。度计划要求等内容。3.2 计算机软件需求规格说明规范计算机软件需求规格说明规范郑州大学信息工程学院 徐婷软件文档1-13 (2)顾客:为产品支付费用,并通常(但不必要)顾
14、客:为产品支付费用,并通常(但不必要)确定需求的个人或群体,在某些情况下,顾客和供方确定需求的个人或群体,在某些情况下,顾客和供方可以是同一组织的成员。可以是同一组织的成员。(3)供方:为顾客开发产品的个人或群体。在某)供方:为顾客开发产品的个人或群体。在某些情况下,顾客和供方可以是同一组织的成员。些情况下,顾客和供方可以是同一组织的成员。(4)用户:直接运行系统产品或与产品进行交互)用户:直接运行系统产品或与产品进行交互作用的个人或集团。用户和顾客通常不是同一个人或作用的个人或集团。用户和顾客通常不是同一个人或群体。群体。3.2 计算机软件需求规格说明规范计算机软件需求规格说明规范郑州大学信
15、息工程学院 徐婷软件文档1-143.2.4 需求文档的编写大纲需求文档的编写大纲提纲模板提纲模板按照按照运行模式运行模式组织的组织的SRS具体需求模板具体需求模板1、2按照按照用户类别用户类别组织的组织的SRS具体需求模板具体需求模板按照按照对象对象组织的组织的SRS具体需求模板具体需求模板按照按照系统特征系统特征组织的组织的SRS具体需求模板具体需求模板按照按照激励激励组织的组织的SRS具体需求模板具体需求模板按照按照功能功能层次层次组织的组织的SRS具体需求模板具体需求模板体现多种组织形式体现多种组织形式的的SRS具体需求模板具体需求模板3.2.5 需求文档的编制说明需求文档的编制说明3.
16、2 计算机软件需求规格说明规范计算机软件需求规格说明规范郑州大学信息工程学院 徐婷软件文档1-153.3 计算机软件测试文档编制规范计算机软件测试文档编制规范 测试测试是软件生存周期中一个是软件生存周期中一个独立的独立的、关键的关键的阶段,阶段,也是保证软件质量的重要手段。为了提高检测出错的也是保证软件质量的重要手段。为了提高检测出错的几率,使测试能有计划、有条不紊地进行,就必须编几率,使测试能有计划、有条不紊地进行,就必须编制测试文档。而标准化测试文档就如同一种制测试文档。而标准化测试文档就如同一种通用的参通用的参照体系照体系,可达到便于交流的目的。,可达到便于交流的目的。计算机软件测试文档
17、编制规范(计算机软件测试文档编制规范(GB/T 9386-GB/T 9386-20082008)的目的就是)的目的就是规定一组软件测试文档规定一组软件测试文档,定义每一定义每一种基本文档的目的、格式和内容种基本文档的目的、格式和内容。测试文档中所规定。测试文档中所规定的内容可以作为对测试过程完备性的对照检查表,这的内容可以作为对测试过程完备性的对照检查表,这将会提高测试过程的每个阶段的能见度,极大地提高将会提高测试过程的每个阶段的能见度,极大地提高测试工作的可管理性。测试工作的可管理性。郑州大学信息工程学院 徐婷软件文档1-163.3 计算机软件测试文档编制规范计算机软件测试文档编制规范 该规
18、范替代了该规范替代了GB/T9386-1988GB/T9386-1988计算机软件测试计算机软件测试文档编制规范。原标准由上海计算机技术开发中心文档编制规范。原标准由上海计算机技术开发中心负责起草,由原电子工业部于负责起草,由原电子工业部于19881988年年4 4月月2626日批准,日批准,19881988年年1212月月1 1日实施,日实施,于新标准实施之日废止。于新标准实施之日废止。郑州大学信息工程学院 徐婷软件文档1-173.3.1 标准的适用对象及范围标准的适用对象及范围 该规范是为该规范是为软件管理人员软件管理人员、软件开发软件开发、测试和维测试和维护人员护人员、软件质量保证人员软
19、件质量保证人员、审计人员审计人员、客户客户及及用户用户制定的。制定的。用于描述一组用于描述一组与软件测试实施方面有关与软件测试实施方面有关的基本测的基本测试文档,该标准定义每一种基本文档的目的、格式和试文档,该标准定义每一种基本文档的目的、格式和内容。尽管标准所描述的文档内容。尽管标准所描述的文档侧重于动态测试活动侧重于动态测试活动,但是有些文档仍适用于其他种类的测试活动(例如:但是有些文档仍适用于其他种类的测试活动(例如:测试计划可用于设计和代码评审)。测试计划可用于设计和代码评审)。3.3 计算机软件测试文档编制规范计算机软件测试文档编制规范郑州大学信息工程学院 徐婷软件文档1-183.3
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 软件 文档 国家标准
1、咨信平台为文档C2C交易模式,即用户上传的文档直接被用户下载,收益归上传人(含作者)所有;本站仅是提供信息存储空间和展示预览,仅对用户上传内容的表现方式做保护处理,对上载内容不做任何修改或编辑。所展示的作品文档包括内容和图片全部来源于网络用户和作者上传投稿,我们不确定上传用户享有完全著作权,根据《信息网络传播权保护条例》,如果侵犯了您的版权、权益或隐私,请联系我们,核实后会尽快下架及时删除,并可随时和客服了解处理情况,尊重保护知识产权我们共同努力。
2、文档的总页数、文档格式和文档大小以系统显示为准(内容中显示的页数不一定正确),网站客服只以系统显示的页数、文件格式、文档大小作为仲裁依据,个别因单元格分列造成显示页码不一将协商解决,平台无法对文档的真实性、完整性、权威性、准确性、专业性及其观点立场做任何保证或承诺,下载前须认真查看,确认无误后再购买,务必慎重购买;若有违法违纪将进行移交司法处理,若涉侵权平台将进行基本处罚并下架。
3、本站所有内容均由用户上传,付费前请自行鉴别,如您付费,意味着您已接受本站规则且自行承担风险,本站不进行额外附加服务,虚拟产品一经售出概不退款(未进行购买下载可退充值款),文档一经付费(服务费)、不意味着购买了该文档的版权,仅供个人/单位学习、研究之用,不得用于商业用途,未经授权,严禁复制、发行、汇编、翻译或者网络传播等,侵权必究。
4、如你看到网页展示的文档有www.zixin.com.cn水印,是因预览和防盗链等技术需要对页面进行转换压缩成图而已,我们并不对上传的文档进行任何编辑或修改,文档下载后都不会有水印标识(原文档上传前个别存留的除外),下载后原文更清晰;试题试卷类文档,如果标题没有明确说明有答案则都视为没有答案,请知晓;PPT和DOC文档可被视为“模板”,允许上传人保留章节、目录结构的情况下删减部份的内容;PDF文档不管是原文档转换或图片扫描而得,本站不作要求视为允许,下载前自行私信或留言给上传者【快乐****生活】。
5、本文档所展示的图片、画像、字体、音乐的版权可能需版权方额外授权,请谨慎使用;网站提供的党政主题相关内容(国旗、国徽、党徽--等)目的在于配合国家政策宣传,仅限个人学习分享使用,禁止用于任何广告和商用目的。
6、文档遇到问题,请及时私信或留言给本站上传会员【快乐****生活】,需本站解决可联系【 微信客服】、【 QQ客服】,若有其他问题请点击或扫码反馈【 服务填表】;文档侵犯商业秘密、侵犯著作权、侵犯人身权等,请点击“【 版权申诉】”(推荐),意见反馈和侵权处理邮箱:1219186828@qq.com;也可以拔打客服电话:4008-655-100;投诉/维权电话:4009-655-100。