ICS25.040.40 N18 中华人民共和国国家标准 GB/T26805.4—2011 工 业控制计算机系统 软件 第4部分:工程化文档规范 Industrialcontrolcomputersystem—Software— Part4:Engineeringdocumentspecification 2011-07-29发布 2011-12-01实施 中华人民共和国国家质量监督检验检疫总局 中国国家标准化管理委员会发布目 次 前言 Ⅲ ………………………………………………………………………………………………………… 1 范围 1 ……………………………………………………………………………………………………… 2 规范性引用文件 1 ………………………………………………………………………………………… 3 术语和定义 1 ……………………………………………………………………………………………… 4 文档规范 1 ………………………………………………………………………………………………… 附录A(规范性附录) 可行性研究报告的编写格式 37 …………………………………………………… 附录B(规范性附录) 软件项目开发计划书的编写提示 40 ……………………………………………… 附录C(规范性附录) 软件需求规格说明书的编写提示 42 ……………………………………………… 附录D(规范性附录) 数据需求说明书的编写提示 44 …………………………………………………… 附录E(规范性附录) 软件概要设计说明书的编写提示 46 ……………………………………………… 附录F(规范性附录) 软件详细设计说明书的编写提示 48 ……………………………………………… 附录G(规范性附录) 数据库设计说明书的编写提示 51 ………………………………………………… 附录H(规范性附录) 软件模块规格说明书的编写提示 53 ……………………………………………… 附录I(规范性附录) 软件质量保证计划的编写提示 55 ………………………………………………… 附录J(规范性附录) 软件配置管理计划的编写提示 58 ………………………………………………… 附录K(规范性附录) 用户手册的编写提示 61 …………………………………………………………… 附录L(规范性附录) 操作手册的编写提示 63 …………………………………………………………… 附录M(规范性附录) 程序维护手册的编写提示 65 ……………………………………………………… 附录N(规范性附录) 测试计划的编写提示 67 …………………………………………………………… 附录O(规范性附录) 测试分析报告的编写提示 69 ……………………………………………………… 附录P(规范性附录) 安装实施过程的编写提示 71 ……………………………………………………… 表1 各阶段的质量记录 22 ………………………………………………………………………………… 表2 项目质量保证活动日程表 22 ………………………………………………………………………… 表3 配置项命名规则表 26 ………………………………………………………………………………… 表4 配置项和配置基线列表 26 …………………………………………………………………………… 表5 项目配置管理活动的日程表 27 ……………………………………………………………………… ⅠGB/T26805.4—2011 前 言 GB/T26805《工业控制计算机系统 软件》分为以下几部分: ———第1部分:评价体系; ———第2部分:测试方法; ———第3部分:文档管理指南; ———第4部分:工程化文档规范; ———第5部分:用户软件文档。 本部分是GB/T26805的第4部分。 本部分的附录A、附录B、附录C、附录D、附录E、附录F、附录G、附录H、附录I、附录J、附录K、附 录L、附录M、附录N、附录O和附录P均为规范性附录。 本部分由中国机械工业联合会提出。 本部分由全国工业过程测量和控制标准化技术委员会(SAC/TC124)归口。 本部分负责起草单位:深圳市研祥软件技术有限公司。 本部分参加起草单位:北京研华兴业电子科技有限公司、西南大学、中国计算机学会工业控制计算 机专业委员会。 本部分主要起草人:陈志列、刘志永。 本部分参加起草人:刘学东、刘永池、杨颂华、刘枫、张为群、吕静、杨孟飞。 ⅢGB/T26805.4—2011 工业控制计算机系统 软件 第4部分:工程化文档规范 1 范围 GB/T26805的本部分规定了工业控制软件项目,在其生命周期的各个阶段所产生的主要软件文 档的内容、格式及编制要求,以便作为软件项目的开发、评审、使用与维护的基准。 本部分适用于工业控制软件及其修订版本的技术文档的编制。 2 规范性引用文件 下列文件中的条款通过GB/T26805的本部分的引用而成为本部分的条款。凡是注日期的引用文 件,其随后所有的修改单(不包括勘误的内容)或修订版均不适用于本部分,然而,鼓励根据本部分达成 协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件,其最新版本适用于本 部分。 GB/T7714—2005 文后参考文献著录规则(ISO690:1987,NEQ) GB/T8567—2006 计算机软件文档编制规范 GB/T11457—2006 信息技术 软件工程术语 GB/T26805.3—2011 工业控制计算机系统 软件 第3部分:文档管理指南 3 术语和定义 GB/T11457—2006确立的以及下列术语和定义适用于GB/T26805的本部分。 3.1 系统 system 除有特殊说明外,是指软件系统。 3.2 敏感部位 sensitiveposition 系统或某一部分对某些因素易于感受的性能的部分或部位。 3.3 敏感度 sensitiveness 系统或某一部分对某些因素易于感受的性能。 3.4 敏感条件 sensitivecondition 系统或某一部分对某些因素易于感受的性能的条件。 3.5 工程化文档 engineeringdocument 工业控制软件项目的生命周期中产生的文档。 4 文档规范 4.1 可行性研究报告 4.1.1 总则 可行性研究报告要对工业控制对象作概要的描述,根据需求和实现环境把对软件开发项目在一定 1GB/T26805.4—2011 工业、技术、经济和社会条件下实现的可行性研究结果写成文档,为管理部门决定本开发项目的进行提 供依据。可行性研究报告见GB/T8567—2006中的7.1部分。 可行性研究报告的编写示例见附录A。 4.1.2 可行性研究报告的内容 4.1.2.1 概述 4.1.2.1.1 编写目的 对工业控制对象作概要的描述,根据需求和实现环境把对软件开发项目在一定工业、技术、经济和 社会条件下实现的可行性研究结果写成文档,为管理部门决定本开发项目的进行提供依据。 4.1.2.1.2 背景 包括: a) 待开发的软件系统的名称; b) 提出者和交办单位; c) 承办单位和承办人员; d) 用户。 4.1.2.1.3 参考资料 按照GB/T7714—2005格式要求,列出本文档中引用到的参考资料,包括资料的编号、作者、标题、 来源、出版单位、日期等。 4.1.2.1.4 术语与缩略语 列出本文档中专用的术语、定义或缩略语。 4.1.2.2 可行性研究的前提 4.1.2.2.1 概述 说明开发项目进行可行性研究的前提,如需求、目标、假定、限制、进行方法和评价准则。 4.1.2.2.2 需求 根据工业控制对象和用户的要求说明对软件开发的基本需求,如: a) 功能,如数据采集、调节控制、图形显示、组态功能等; b) 性能,如控制精度、响应时间、实时性要求、可靠性、灵活性等; c) 输出,如控制量、开关量、报告、文件或数据,对每项输出要说明其特征,如用途、产生频率、类型 以及接口; d) 输入,说明来自工业控制对象和操作者的各种输入,包括数据的来源、类型、数量、数据的组织 以及提供的频率; e) 用图表的方式表示出最基本的数据流程和处理流程,并扼要说明; f) 在安全与保密方面的要求; g) 同本系统相连接的其他系统; h) 完成期限。 4.1.2.2.3 目标 说明建议开发软件的主要开发目标,如: a) 处理速度的提高; b) 控制精度的提高; c) 调节品质的改善; d) 提高工作效率和减轻劳动强度; e) 提高经济效益(提高产品质量,降低能源消耗等); f) 提高生产自动化程度。 2GB/T26805.4—2011