GB T 26805.3-2011 工业控制计算机系统 软件 第3部分:文档管理指南.pdf
《GB T 26805.3-2011 工业控制计算机系统 软件 第3部分:文档管理指南.pdf》由会员分享,可在线阅读,更多相关《GB T 26805.3-2011 工业控制计算机系统 软件 第3部分:文档管理指南.pdf(20页珍藏版)》请在麦多课文档分享上搜索。
1、ICS 25.040.40 N 18 中华人民和国国家标准GB/T 26805.3-2011 工业控制计算机系统软件第3部分:文档管理指南Industrial control computer system-Software Part 3: GuideIines for the document management 2011-07-29发布2011-12-01实施数码防伪中华人民共和国国家质量监督检验检茂总局中国国家标准化管理委员会发布G/T 26805.3-2011 目次I I 范围2 规范性引用文件.3 术语和定义4 软件文档.4.1 概述24. 2 主要功能24. 3 工作文档34.4
2、 产品文档44. 5 用户软件包文档45 软件文档的计划管理45. 1 基本任务45. 2 管理要点46 软件文挡的质量管理86.1 软件文档的质量分级及质量要求86.2 软件文档的复审7 软件文挡的配置管理108 管理要点总结m附录A(规范性附录)软件生命周期的定义及阶段划分UA.1 软件生命周期的定义MA.2 软件定义阶段MA.3 软件开发阶段A.4 运行维护阶段附录B(规范性附录)软件生命周期各个阶段应当产生的主要软件文档图1软件文档分级与对应文档6图B.l软件生命周期各个阶段应当产生的重要软件文档示意11目。吕GB/T 26805(工业控制计算机系统软件分为以下部分:第1部分:评价体系
3、;第2部分:测试方法;一-第3部分:文档管理指南;第4部分:工程化文档规范;第5部分:用户软件包文档。本部分是GB/T26805的第3部分。本部分的附录A和附录B为规范性附录。本部分由中国机械工业联合会提出。本部分由全国工业过程测量和控制标准化技术委员会CSAC/TC121)归口。本部分负责起草单位:西南大学。GB/T 26805.3-2011 本部分参加起草单位:深圳市研祥软件技术有限公司、北京研华兴业电子科技有限公司、中国计算机学会工业控制计算机专业委员会。本部分主要起草人:吕静、杨颂华、张为群、张渝、祁虔。本部分参加起草人:陈志列、刘志永、刘学东、刘永池、杨孟飞。I 工业控制计算机系统软
4、件第3部分:文档管理指南G/T 26805.3-2011 1 范围GB/T 26805的本部分规定了工业控制软件文档管理的基本任务和管理要点,为项目管理者实施该类文档的管理提供指南。本部分适用于工业控制计算机系统的软件文档管理。2 规范性引用文件下列文件中的条款通过GB/T26805的本部分的引用而成为本部分的条款。凡是注日期的引用文件,其随后所有的修改单(不包括勘误的内容)或修订版均不适用于本部分,然而,鼓励根据本部分达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件,其最新版本适用于本部分。GB/T 11157 2006 信息技术软件工程术语GB/T 26805.4-
5、2011 工业控制计算机系统软件第4部分:工程化文档规范GB/T 26805. 5 2011 工业控制计算机系统软件第5部分:用户软件文档3 术语和定义GB/T 11457 2006中确立的以及下列术语和定义适用于GB/T26805的本部分。3.1 文档document 一种数据媒体和其上所记录的数据。它具有永久性并可以由人或机器阅读。3. 2 用户user a) 使用软件求解某一问题的技术人员;b) 实际使用软件产品或操作运行软件的组织、单位或个人。3. 3 产品文档product documentation 软件项目开发过程中,应当编制的各种技术资料或技术管理资料。3.4 工作文档work
6、 documentation 软件项H开发过程中,所填写的或使用过的各种图表或文字资料。3.5 用户需求user requirement 用户所期望的软件产品的全部性能、功能和限制。它主要包括对软件产品的功能要求、性能要求,如实时性、可靠性和可维护性要求以及安全保密要求,还包括在开发费用、时间、进度和可用资源等方面的限制。3.6 评审review 软件项目开发中的个重要环节。它是对某个开发产品或过程进行的全面检查、鉴定和认可。目GB/T 26805.3-2011 的在于尽可能早地发现错误,将实现和要求进行统一和协调。3. 7 配置管理configuration management 标识和确定
7、系统中配置项的过程,在系统整个生存周期内控制这些项的投放和更动,记录并报告配置的状态和更动要求,验证配置项的完整性和正确性。3.8 软件产品库software production library 在软件生命周期的集成与系统测试阶段结束后,用于存放作为最终产品而交付给用户运行或现场安装的软件库。3.9 软件文档software documentation 以人们可读的形式出现的技术数据和信息,包括计算机列表和打印输出,它们描述或规定软件设计或细节,说明软件具备的能力,或为使用软件以便从软件系统得到所期望的结果而提供的操作指令。4 软件文档4.1 概述有关软件文档概述如下:a) 软件文档是由制造
8、商提供的、软件产品生命周期中的所有文档;b) 软件文档归入工作文档和产品文档两类;c) 软件文档是与软件产品有关的可读文件,用以描述和记载软件广=川生命周期各阶段的活动及结果;d) 软件文档的表现形式可以盐文字、表楠、图形和IT像等;e) 软件文档中包含描述硬件访问接口(如奇存器、31脚定义、端口、组态、中断等)的文档,以及工业现场对软件产品的要求(且11可靠性、实J性、安全性等); f) 软件文档可以记载于多种媒体(例如光盘、磁盘、磁带、If:易失性在储器和纸等介质)上,具有持久性,便f保存、修改、传输和自动化管理;g) 软件文档iif以复削;软件文档口J随软件升级而更新(经授权许可)。4.
9、2 主要功能4.2. 1 概述软件文档应该具备以下主要功能:a) 实现软件管理的依据;b) 实现任务之间联系的凭证;c) 提供使用须知与说明;d) 提供质量保证支持;e) 作为历史资料;f) 提供产权声明。4.2.2 实现软件管理的依据软件文档记录了软件产品在生命周期内各阶段的活动情况,为各阶段的检查、评审和管理提供依据,同时,软件文档记录的技术信息,可以为软件产品开发的技术管理提供依据。4.2.3 实现任务之间联系的凭证软件开发项目的任务主要由以下各类人员承担:a) 软件项目管理人员;2 b) 提出用户需求及项H要点的专家;c) 系统分析师;d) 软件项门的程序设计师;c) 提供程序代码的程
10、序员;f) 软件测试员;g) 质量保证专家和l审核人员;h) 改进操作或开发加强和扩展产品性能的维护程序员。GB/T 26805.3-2011 根据软件工程化的要求,软件文档是以上各类人员之间通信和交流的凭证,从而实现任务间的联系。4.2.4 提供使用须知与说明软件文档能够提供使用须知与说明,告知系统管理人员、操作人员、用户及维护人员系统怎样工作、如何正确使用系统去实现他们的目标,同时可实现对用户的技术培训,帮助用户尽快掌握软件产品的使用方法。4.2.5 提供质量保证支持软件文档必须保证向质量保证、维护和审核人员提供执行其任务时所需要的各种质量标准以及关于期望系统完成什么功能和系统怎样实现这些
11、功能的清晰说明;必须制订测试计划和测试规程,并报告测试结果;还必须说明和评估相关的控制、计算、检验例行程序及其他技术。4.2.6 作为历史资料将软件文档用作将来进行项目开发的一种资源。通常文档记载系统的开发历史,可使有关系统结构的基本思想和开发经验为以后的项目利用。良好的系统文档有助于把程序移植和转移到各种新的系统环境中。4.2.7 提供产权声明软件文档包含软件产品的评测报告、版权、著作权、知识产权等相关资料。4. 3 工作文档4.3.1 工作文档的目的工作文档的目的包括:a) 工作文档主要记录需求、设计、程序和测试方面有关决定的细节;b) 工作文档明确划分全体开发人员的职责范围,规定每一个人
12、应该做什么,使他们能够各司其职;c) 工作文档明确规定检查要点和进度,便于项目管理者评估项目的进展情况;d) 工作文档记录项目开发的历史,为开发后续项目提供参考。4.3.2 工作文档的内容工作文档可分为开发文档和管理文档。开发文档描述项目开发过程本身,以开发所涉及的工具、方法等技术为主;管理文档描述开发阶段划分,各开发阶段的任务确定,以及如何实现各个阶段的衔接,记录进度、变更和职责定义、评定等管理工作。工作文档内容包括:-可行性研究报告;一一软件项目开发计划书;软件质量保证计划书;软件配置管理计划书;安全与控制信息规格说明;备忘录或改变控制形式的记录。3 GB/T 26805.3-2011 实
13、际的工作文档可以包括上述文档中的部分或全部。根据项目开发的特点,还可以产生新的工作文档。工作文档的内容与格式应符合GB/T26805.1-2011的有关规定。4.4 产品文档4.4. 1 产品文档的目的产品文档提供有关软件产品的有效使用、运行、维护、更新方面的信息,包括:a) 向程序员、操作员和最终用户提供所需的文档资料;b) 为项目管理者实现科学管理提出的各种资料,以监控产品的开发与应用;c) 说明产品可用性、为促进产品推广而具体阐述应用范围的宣传资料;d) 向关心软件产品的人们提供的、用以描述产品特点的信息交流资料。4.4.2 产品文档的范围产品文挡一般包括:软件需求规格说明书;数据需求说
14、明书;系统(子系统设计说明白;-软件概要设计说明书;-软件详细设计说明书;数据库设计说明书;软件模块规格说明书;技术评审;一一测试计划;一测试分析报告;用户于册E操作手册;程序维护于册;安装实施过程;用户培训资料及宣传资料。实际的产品文档可以包括上述文档中的部分或全部,根据项目开发的特点,还可以产生新的产品文档。产品文档的内容与格式应符合GB/T26805. 1-2011的有关规定。4.5 用户软件包文挡用户软件包文档见GB/T26805. 5-2011 0 5 软件文挡的计划管理5.1 基本任务软件文档计划管理的基本任务是:a) 明确划分软件生存周期的各个阶段;b) 确定每个阶段应当编制的软
15、件文档;c) 提出软件文档编制计划,并监督实施。5.2 管理要点5.2. 1 软件生命周期的阶段划分附录A给出了软件生命周期的定义及阶段划分的常用方法。4 G/T 26805.3-2011 对于一个具体的软件开发项t,软件生命周期的各个阶段应当如何划分,项目管理者应着重考虑以下两个因素:5.2. 1. 1 标识阶段的名称可以改变随着所用开发方法的不间,开发项H的不同,阶段名称允许有相河大的差异。El必须!哩持阶段的明确划分,以便分段实施、加强管理。5.2. 1. 2 阶段划分具有灵活性阶段划分的详细程度取决于软件项目的重要性、复杂程度、使用频度、软件规模、技术水平和成败风险等诸种因素。项目管理
16、者应根据软件项目的实际情况进行权衡。5.2.2 文档编制应考虑的因素5.2.2. 1 总则坚持在软件生存周期的各个阶段必须编制对应的软件文档,是项目管理者实施文档计划管理的另一个管理要点。然而,一个具体的软件开发项目究竟需要编制哪些软件文档,是由多种因素决定的,项目管理者必须充分地予以考虑。5.2.2.2 必要性为了保证软件项目开发工作的顺利进行,作为软件生存周期各个阶段工作完成的重要标志,开发人员必须按开发阶段的要求认真编制相应的软件文档。与软件生存周期各个阶段对应的软件文档见附录Bo5.2.2.3 重复性在确定软件文档种类时,应保持每种文档的独立性,但允许内容上存在某些重复,以适合不同读者
17、的需要。5.2.2.4 灵活性和软件生命周期的阶段划分具有灵活性一样,需要编制的文档种类也具有灵活性。一般说来,当软件项H的复杂程度、软件规模和成败风险增大时,软件文挡的种类、详细程度将随之增加。反之,可适当减少,为了避免在软件项目开发中文档编制的不足或过度,项目管理者可主要根据软件规模去确定需要编制哪些软件文档。软件规模可分为以下三级:a) 小规模软件源程序行数少于3000行的软件;b) 中规模软件源程序行数为300030 000行的软件;c) 大规模软件源程序行数为30000行以上的软件。对软件开发项n文梢编制的要求亦相应地分为三级,如图1所示。根据图1,某些文档可以是某种文梢的扩展和细分
18、。在最简单的情况下,可合并成软件需求说明与开发计划、软件设计说明、使用说明和项H开发总结阿种文梢。而在软件规模特别庞大的情况下,可进一步细分为更多的软件文档。5 GB/T 26805.3-2011 小规模软件软件JJ求说明与开发计划软件设计说明使用说明项目开发总结5.2.3 软件文档编制计划5.2.3.1 总则中规模软件动lH开发计划大规模软件厂一可行性研究报行1软刊项日开发讨划一一一一寸:软件质j,t保证计划一软件配置信:理计划广软件需求规格说明软件活求说明一一一一斗一数据需求说明软件计划测试计划软件设计说明J明软件详细设计说明数据库设号|说明软件模块规格说明国| 操作手册使用说明! L一一
19、支装实施f-册一开发进度定期报fT厂一一开发进皮定期报告I . n TTtJ_.4fA- I 项H开发阶段总结| 项门开发总结一-一一一一一评1t报价一评f育报告图1软件文档分级与对应立档软件文档编制计划可以是整个项目计划的一部分,也可以是一个独立的文档。它作为说明文档重要性的具体资料,也作为项目管理者的备忘录,是型式检查、复审和验收的重要依据。文档编制计划应包括对以下几个问题的陈述:一文档内容与型式;文档格式与标示;文档编制的进度;开发人员的职责范围。5.2.3.2 文挡内容与形式文档内容着重于功能方面的说明,告诉软件开发人员本阶段做什么。现就与产品文档有关的几个问题规定如下。5.2.3.2
- 1.请仔细阅读文档,确保文档完整性,对于不预览、不比对内容而直接下载带来的问题本站不予受理。
- 2.下载的文档,不会出现我们的网址水印。
- 3、该文档所得收入(下载+内容+预览)归上传者、原创作者;如果您是本文档原作者,请点此认领!既往收益都归您。
下载文档到电脑,查找使用更方便
5000 积分 0人已下载
下载 | 加入VIP,交流精品资源 |
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- GB 26805.3 2011 工业 控制 计算机系统 软件 部分 文档 管理 指南
