GB/T26805.4-2011
工业控制计算机系统软件第4部分：工程化文档规范
Industrialcontrolcomputersystem-Software-Part4:Engineeringdocumentspecification
- 中国标准分类号（CCS）N18
- 国际标准分类号（ICS）25.040.40
- 实施日期2011-12-01
- 文件格式PDF
- 文本页数80页
- 文件大小893.53KB
以图片形式预览工业控制计算机系统软件第4部分：工程化文档规范
工业控制计算机系统软件第4部分：工程化文档规范
国家标准 GB/T26805.4一2011 工业控制计算机系统软件 第4部分:工程化文档规范 ndustrialcontrolcomputersystem一Software Part4:Engineeringdoeumentspeeificationm 2011-07-29发布 2011-12-01实施 国家质量监督检验检疫总局 发布 国家标准化管理委员会国家标准
GB/T26805.4一2011 目 次 前言 范围 规范性引用文件 术语和定义 文档规范 附录A规范性附录可行性研究报告的编写格式 附录B(规范性附录软件项目开发计划书的编写提示 4 42 附录C规范性附录)软件需求规格说明书的编写提示 附录D 规范性附录 数据需求说明书的编写提示 附录E(规范性附录 46 附录！ 规范性附录 48 附录G 51 规范性附录 附录H 规范性附录 软件模块规格说明书的编写提示 53 附录1规范性附录 55 附录J(规范性附录 58 附录K(规范性附录 61 用户手册的编写提示 附录L规范性附录)操作手册的编写提示 63 附录M(规范性附录)程序维护手册的编写提示 65 附录N(规范性附录)测试计划的编写提示 667 附录o(规范性附录测试分析报告的编写提示 69 附录P(规范性附录安装实施过程的编写提示 71 表1各阶段的质量记录 22 表2项目质量保证活动日程表 22 表3配置项命名规则表 26 表4配置项和配置基线列表 26 表5项目配置管理活动的日程表 2
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部分:工程化文档规范 范围 GB/T26805的本部分规定了工业控制软件项目,在其生命周期的各个阶段所产生的主要软件文 档的内容、格式及编制要求,以便作为软件项目的开发、评审使用与维护的基准
本部分适用于工业控制软件及其修订版本的技术文档的编制
规范性引用文件 下列文件中的条款通过GB/T26805的本部分的引用而成为本部分的条款
凡是注日期的引用文 件,其随后所有的修改单(不包括勘误的内容)或修订版均不适用于本部分,然而,鼓励根据本部分达成 协议的各方研究是否可使用这些文件的最新版本
凡是不注日期的引用文件,其最新版本适用于本 部分
GB/T7714一2005文后参考文献著录规则(IsO690:1987,NEQ GB/T8567一2006计算机软件文档编制规范 GBy/T1l457一206信息技术软件工程术语 GB/T26805.3一2011工业控制计算机系统软件第3部分;文档管理指南 术语和定义 GB:/T11457一2006确立的以及下列术语和定义适用于GB:/T26805的本部分
3.1 系统systemm 除有特殊说明外,是指软件系统
3.2 敏感部位 sensitivepositiom 系统或某一部分对某些因素易于感受的性能的部分或部位 3.3 敏感度sensitiveness 系统或某一部分对某些因素易于感受的性能
敏感条件sensitivecondition 系统或某一部分对某些因素易于感受的性能的条件
3.5 工程化文档engineeringdocument 工业控制软件项目的生命周期中产生的文档
文档规范 可行性研究报告 总则 可行性研究报告要对工业控制对象作概要的描述,根据需求和实现环境把对软件开发项目在一定
GB/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) 提出者和交办单位; e)承办单位和承办人员; 用户
d 41.2.1.3爹考资料 -2005格式要求,列出本文档中引用到的参考资料,包括资料的编号,作者,标题 按照GB/T7714一 来源,出版单位、日期等
4.1.2.1.4术语与缩略语 列出本文档中专用的术语、定义或缩略语
4.1.2.2可行性研究的前提 4.1.2.2.1概述 说明开发项目进行可行性研究的前抛,如需求、目标、假定,限制,进行方法和评价准则
4.1.2.2.2需求 根据工业控制对象和用户的要求说明对软件开发的基本需求,如 a)功能,如数据采集,调节控制、图形显示、组态功能等; 性能.如控制精度、响应时间、实时性要求、可靠性、灵活性等 b 输出,如控制量、开关量、报告、文件或数据,对每项输出要说明其特征,如用途、产生频率,类型 以及接口: 输人,说明来自工业控制对象和操作者的各种输人,包括数据的来源、类型、数量、数据的组织 D 以及提供的频率 e 用图表的方式表示出最基本的数据流程和处理流程,并扼要说明 在安全与保密方面的要求; g同本系统相连接的其他系统; h 完成期限
4.1.2.2.3目标 说明建议开发软件的主要开发目标,如 a)处理速度的提高; b)控制精度的提高 调节品质的改善; c 提高工作效率和减轻劳动强度 提高经济效益(提高产品质量,降低能源消耗等); f 提高生产自动化程度
GB/T26805.4一2011 4.1.2.2.4条件、假定和限制 说明开发工作中作出的假定和所受到的限制,如 a整个系统的运行寿命 b 经费、投资方面的来源和限制; c硬件、软件,运行环境和开发环境方面的条件和限制 d)法律和政策方面的限制
4.1.2.2.5可行性研究的方法 说明可行性研究的基本方法和评价准则,如调查、加权、确定模型、建立基准点或仿真等 4.1.2.2.6评价尺度 说明对系统进行评价时的主要尺度,如费用多少,各项功能的优先次序,可靠性的地位、实时性的考 虑等
4.1.2.3现有系统的分析 4.1.2.3.1定义 现有系统是指当前实际使用的系统.这个系统可能是计算机系统,也可能是一个机械系统甚至是一 个人工系统
分析现有系统的目的是为了进一步闸明开发新系统或修改现有系统的必要性
4.1.2.3.2处理流程和数据流程 说明现有系统的基本的处理流程和数据流程
4.1.2.3.3工作负荷 列出现有系统所承担的工作及工作量
4.1.2.3.4费用开支 列出由于运行现有系统所引起的费用支出,如人力,设备、空间支持性服务、材料等项开支以及开 支总额
4.1.2.3.5局限性 列出现存系统的各种主要局限性,如处理时间不能满足需要、响应时间不及时、数据存储能力不足、 处理功能不够等
4.1.2.4建议的系统 4.1.2.4.1概述 说明建议系统的目标和要求将如何被满足 4.1.2.4.2说明 概括地说明所建议系统,说明要求将如何得到满足,说明所使用的基本方法及理论根据 4.1.2.4.3处理流程和数据流程 如用户的操作规程,源数据的处理,系统失效的后果及恢复的处理办法等
4.1.2.4.4改进之处 根据主要开发目标,逐项说明所建议系统相对于现存系统具有的改进
4.1.2.4.5影响 说明在建立所建议系统时,预期将带来的影响,包括 a)设备的影响
说明新提出的设备要求,对现有设备的修改
b对软件的影响
说明对现有应用软件和支持软件所作的修改和补充
对系统运行过程的影响
如用户的操作规范、源数据的处理,系统失效的后果及恢复的处理办 法等 4.1.2.4.6局限性 说明建议的系统尚存在的局限性以及这些问题未能消除的原因
GB/T26805.4一2011 4.1.2.4.7其他可选择的系统 说明曾研究过的各种可选择的系统,包括需开发的和可从国内外直接购买的,若没有可供选择的系 统方案,则要加以说明
4.1.2.4.8技术条件方面的可行性 说明技术条件方面的可行性,如 a) 在当前的限制条件下,该系统的目标能否达到 利用现有的技术,该系统的功能能否实现 b c)对开发人员的数量和质量的要求能否满足 d)在规定的期限内本系统的开发能否完成
4.1.2.5投资及效益分析 4.1.2.5.1 支出 说明建议系统需要的费用 4.1.2.5.2基本建设投资 包括采购、开发和安装下列各项所需费用,如 计算机及外围设备; a 数据通讯设备 b 支持软件 c d 其他
4.1.2.5.3经常性支出 经常性支出包括 人员工资; a) b) 管理费用 e)设备租金折旧费用 其他
d 4.1.2.5.4效益 说明所建议系统能带来的效益
4.1.2.5.5技术效益 技术效益包括 a)关键技术或新技术的使用与突破,技术的难度分析; b 系统的技术水平与分析
4.1.2.5.6经济效益 经济效益包括 a)因生产能力的提高,使产量增加; b 因系统精度的提高,使产品质量得到提高,消耗降低; e自动化程度的增强和工作效率的提高,使生产周期缩短,消耗减少; d 可靠性安全性加强,减少或避免事故及其所带来的损失
4.1.2.5.7社会效益 社会效益包括 a)系统的灵活性(包括可扩展性和可移植性)分析; b推广价值,应用面及其所产生的效益
4.1.2.6结论 根据上述分析,对所提出的软件开发项目必须作出是否可行的结论
结论可以是下列之一 可以立即开始进行;
GB/T26805.4一2011 需推迟至某些条件(如经费投资,人力技术等)具备之后才能开始进行 b c)须对开发目标进行某些修改后才能进行; 不能或没有必要进行如没有实用价值、技术上不成熟、投资不合算)
d) 4.2软件项目开发计划书 4.2.1出处 软件项目开发计划书见cB/T8567一20o6中的了.2 4.2.2总则 软件项目开发计划书是把项目开发过程中各项工作任务的负责人员、开发进度、经费预算、硬软件 资源条件等问题所作的安排用文档的方式记载下来,以便依本计划开展和检查项目开发工作,保证项目 开发正常进行
软件项目开发计划书的编写示例见附录B 4.2.3软件项目开发计划书的内容 4.2.3.1概述 编写目的 4.2.3.1.1 编写本计划的目的是把在×××x(项目名称)项目开发过程中各项工作任务的负责人员、开发进 度、经费预算、硬软件资源条件等问题所作的安排用文档的方式记载下来,以便依本计划开展和检查项 目开发工作,保证项目开发正常进行
4.2.3.1.2背景 包括 a)提出者与交办单位; 提出经过 b e)承办单位与承办人员 d 软件名称 e)用户 4.2.3.1.3参考资料 按照GB/T77142005格式要求,列出本文档中引用到的参考资料,包括资料的编号、作者、标题、 来源、出版单位、日期等
4.2.3.1.4术语和缩写词 列出本文档所用的专业术语、定义和缩写词
4.2.3.2项目任务概要 4.2.3.2.1前提 说明开发项目进行可行性研究的前提,如需求、目标,假定,限制,进行方法和评价准则
4.2.3.2.2工作内容 简要说明在本项目开发过程中须进行的各项主要工作
合理划分阶段,说明各阶段的主要任务和 功能
4.2.3.2.3主要人员 简要说明参加本项目工作的主要人员(开发人员,管理人员,测试人员、用户等)
包括人数和他们 的技术水平 4.2.3.2.4产品 包括以下几个方面 程序
列出向用户移交的程序清单和数据库文件清单及存储介质,并引用有关文档扼要说明 其作用和功能
b 文档
列出需移交给用户的每种文档的名称及内容要点
GB/T26805.4一2011 服务
列出需向用户提供的各项服务,如培训、安装、维护和运行支持,应逐项规定开始日期、 所提供支持的级别和服务的期限 d 非移交的产品
列出开发集体应向本单位交出但不必向用户移交的产品文件甚至某些程 序) 4.2.3.2.5验收标准 对于上述这些应交出的产品和服务,逐项说明或引用资料说明验收标准
4.2.3.2.6完成项目的最迟期限 指明项目完成的最迟期限
4.2.3.2.7项目批准 指项目的批准者和批准日期
4.2.3.3实施总计划 工作任务分解 4.2.3.3.1 对项目开发中需要完成的各项工作,从需求分析、概要设计,详细设计、编码、测试、安装、验收及各 种文档编制等要按层次进行分解,并指明每项任务的负责人和主要参加人员
接口人员 4.2.3.3.2 说明负责接口工作的人员及他们的职责,包括 负责本项目同用户的接口人员 a 负责本项目同本单位各管理机构,如合同计划管理部门、财务部门、质量管理部门等的接口 b 人员 负责本项目同各分合同负责单位的接口人员等
c) 4.2.3.3.3进度 对于需求分析、设计、编码实现、测试、移交、培训和安装等工作,给出每项工作任务的预定开始日 期,完成日期及所需资源,规定各项工作任务完成的先后顺序以及表征每项任务完成的进度表
4.2.3.3.4预算 逐项列出本开发项目所需要的劳务(包括人员的数量和时间)以及经费的预算(包括工资、差旅费、 办公费、机时费、资料费,通讯设备和专用设备的租金等)和来源
4.2.3.3.5关键问题 逐项列出能够影响整个项目成败的关键问题,技术难点和风险,指出这些问题对项目的影响
如 技术难点、可靠性措施、,现场维护等
4.2.3.4支持条件 4.2.3.4.1概述 说明为支持项目的开发所需要的各种条件和设施
4.2.3.4.2计算机系统支持 逐项列出所需计算机系统支持,包括计算机、输人输出设备,模拟器、编译、汇编,操作系统、数据管 理程序包、数据存储能力及测试支持能力等
逐项给出有关到货日期、使用时间的要求 4.2.3.4.3用户支持 应该逐项列出由用户承担的工作和完成日期,包括由用户提供的条件及日期
4.2.3.4.4其他单位的支持 应该逐项列出由其他分合同承包者承担的工作和完成的时间,包括由他们提供的条件和日期
4.2.3.5专题计划要点 说明本项目开发中需制订的各个专题计划要点,如 a 分合同计划 b 培训计划;
GB/T26805.4一2011 4.3.3.3功能要求 4.3.3.3.1概述 分项详细描述软件系统的功能要求,主要包含以下部分
4.3.3.3.2数据采集 说明采样信号的类型(模拟量、数字量),采集对象数量、输人处理要求、上下限极限值、报警要求、存 储要求、,采样周期、量程范围单位换算及输人处理方法(平均、滤波、解码等)等
4.3.3.3.3调节控制 说明控制类型(连续控制、顺序控制等、控制回路数、控制方式(PID控制,串级控制等、参数整定 及失控处理等
4.3.3.3.4画面显示 说明画面种类(总体画面,回路画面,趋势显示等),数据项目和数据数量、存储介质、数据保留时间 及显示方式要求等
4.3.3.3.5组态功能 说明组态的目的和内容,组态工作方法,输人要求及输出画面要求等
4.3.3 性能要求 概述 4.3.3.4 详细描述软件系统的性能要求
具体性能要求 定量地描述软件的具体性能要求,主要的具体性能要求如下;精度
详细描述系统的精度要 求,如 数据的精度要求,如数据的输人精度(A/D)12位; 1 2)数字计算的精度要求,如尾数有效位15位,阶码有效位7位
时间特性
详细说明系统时间特性要求,如: b 实时性要求
执行计算机系统基本负载的时间
如要求“软件系统在1s之内采集并处 理完接人系统的所有信号,至少包括546个参数,每个参数长度为2个字节”
数据处理时间
2 3) 输人到输出的响应时间
事件的数量和优先级别
40 可靠性要求
说明软件系统的可靠性要求及所要求的保证措施
如要求对输人参数的可靠性 判别提供出错测点等
灵活性
说明当需求发生某些变化时系统的适应能力,指出为适应这些变化而要设计的软件 成分或过程
可能的变化有: 1) 操作方式上的变化 2) 运行环境的变化 同其他软件接口的变化; 3) 精确和实时性要求的变化
人机接口
必须描述操作者与软件系统接口的特点
例如,如果系统的用户是由显示终端操 作时,就必须指定以下需求 1 需求的各种屏幕格式; 菜单的格式和内容; 21 3)功能键的使用规定 4.3.3.4.3输入-输出 描述输人输出的每个数据元素
对每个数据元素要列出数据类型、格式,度量单位、数值范围和精
GB/T26805.4一2011 度要求
对于输人数据,必须说明时间要求,优先顺序和输人来源
对于输出数据,必须说明时间要求
优先级别和输出去向
4.3.3.4.4故障处理要求 列出可能出现的故障,并提出为保证系统性能而要求采取的技术措施
4.3.3.5环境 4.3.3.5.1设备环境 列出硬件系统所需的设备种类(处理器、存储介质1I/o设备,通信网络)设备数量,型号、特性及连 接方法
4.3.3.5.2支持软件 列出与开发软件相配合的,运行时的支持软件
对每个支持软件系统和子系统,程序都应提供正确 的名称、版本和文档资料,以及该软件使用的语言、操作系统和数据管理系统
4.3.3.5.3接口 若软件系统包含若干子系统或与其他系统发生关系,要对其接口进行如下说明 数据传递方式; a) b 数据传送的通信介质; e)数据量格式,度量单位和数据代码; d) 接口类型,如人工的或自动的; e)接口规程,如通信协议 4.3.3.6测试纲要 4.3.3.6.1概述 明确软件系统的测试范围,测试要求及测试环境,为制定软件测试计划和审查软件测试报告提供 依据
4.3.3.6.2测试环境 说明软件系统进行测试运行环境,包括 应交付用户的工业控制计算机硬件配置,如机箱、电源,处理器模板、显示器,键盘/鼠标,通信 接口、存储器的规格和数量等; b)应交付用户的软件配置,包括操作系统或管理程序,应用程序、,诊断程序等及使用方法 e)满足用户需求的输人/输出配置; 系统仿真手段,包括工程系统仿真、工况仿真和工程环境仿真
d 4.3.3.6.3软件系统的测试范围和要求 在模拟仿真)环境中用黑盒法、白盒法对软件系统进行测试,测试项目应覆盖软件需求并分类 列出 a)需测试的软件系统的功能,如数据采集,调节控制等; 需测试的软件系统的性能,如实时性,精度等; b e需测试的系统逻辑关系,如调用关系,控制关系,制约关系等; d)需测试的敏感度,包括敏感部位,敏感条件和敏感程度,以及对软件系统以至整个工程系统的 影响; 需测试的软件系统的可靠性措施,包括自诊断、自恢复、联锁保护等 需测试的软件系统的健壮性目标,如系统负荷能力的考核、故障承受能力的考核等
数据需求说明书 出处 数据需求说明书见GB/T8567一2006中的7.12
GB/T26805.4一2011 4.4.2总则 数据需求说明书是提供并定义软件系统必须处理的各种数据元素,并向用户传达数据采集要求
数据需求说明书的编写示例见附录D. 4.4.3数据需求说明书的内容 4.4.3.1概述 4.4.3.1.1 编写目的 编写数据需求说明书的目的是提供并定义×××X系统名称)系统必须处理的各种数据元素,并 向用户传达数据采集要求
4.4.3.1.2参考资料 按照GBy/T7714一2005格式要求,列出本文档中引用到的下述参考资料,包括资料的编号、作者 标题,来源、出版单位、日期和保密级别 a 项目申请书; 其他技术文档 b 软件需求说明
c 4.4.3.1.3术语和缩写词 把本文档专用的名词术语、定义和缩写词列成一份清单或一个附录
4.4.3.2数据描述 4.4.3.2.1概述 数据可分为静态数据和动态数据
静态数据称为参数数据,动态数据称为非参数数据,它们都由若 干个数据元索组成
要给出每一数据元素的名称(包括缩写和代码)、定义、度量单位、值域、格式和类型 等有关信息
4.4.3.2.2静态数据 列出所有作为控制或参考用的静态数据元素
4.4.3.2.3动态输入数据 列出动态输人数据元素(包括在常规运行中或联机操作中要改变的数据)
4.4.3.2.4动态输出数据 列出动态输出数据元素(包括在常规运行中或联机操作中要改变的数据)
4.4.3.2.5内部生成数据 列出用户关心的内部生成的数据,只列出对用户有信息价值的那些数据元素
4.4.3.2.6数据约束 说明对数据要求的制约
逐条列出对进一步扩大或使用方面的考虑而提出的数据要求的限制(容 量,文卷,记录和数据元的个数的最大值)
必须强调在系统进一步开发中将成为关键性的那些限制
4. .4.3.3数据的采集 4.4.3.3.1概述 描述用户必要的数据采集活动,以便采集该系统使用的数据值
4.4.3.3.2要求和范围 按数据元的逻辑分组来说明数据采集的要求和范围,指明数据的采集方法,说明数据采集工作的承 担者(用户、开发者)
具体内容包括: 数据元素的输人源
说明输人数据元素的来源是操作员,输人站还是某个专门的输人系统; a b数据输人所用的媒体和硬设备; 说明输出数据的接受者; c d)列出输出数据的形式和硬设备
形式如打印输出,显示设备上的字符或图形,均应具体说明 数据值的范围,要给出一个数据元素的合法值的范围; e 10
GB/T26805.4一2011 f 数据值的量纲,数据元素所使用的单位,如在工业控制现场流量所使用的单位常使用t/、和 m/s:; g测量单位的零点(如压力测量是相对于绝对零压还是大气压力); h 换算因子,对必须经模拟转换和数字转换处理的实测量要规定换算因子 iD 扩充因子,指出系统进行扩充时,数据元素项能增加到最大数目的扩充因子
4.4.3.3.3预处理 对数据的采集和预处理过程提出专门的规定,包括适合应用的数据格式,预定的数据通信媒体和对 输人的时间要求等
对于需经模拟转换或数字转换处理的数据量,要给出转换方法和转换因子等有关 信息
以便软件系统使用这些数据
4.4.3.3.4数据采集方式和数据传递方式 具体说明数据获取的方式和详细约定,还应包括其时间特性
主要包括 输人方式
说明所有的输人方式,如数据采集卡、串口,网络,光盘、软件模块等
a 输出方式
说明所有的输出方式,如打印机、显示器、,网络、串口,软件模块等 b e数据库影响
说明数据库的采集和维护对设备、软件、机构、运行和开发环境的影响
还应给 出由于数据库的故障而导致对系统的影响
4.5软件概要设计说朋书 4.5.1总则 软件概要设计说明书要详细定义软件项目的总体功能;交换用户和开发人员之间当前分析的细节 定义系统的接口及实现这些接口要使用的设备
软件概要设计说明书的编写示例见附录E
4.5.2软件概要设计说明书的内容 4.5.2.1概要 4.5.2.1.1编写目的 编写本说明书的目的是;详细定义××××(项目名称)软件的总体功能;交换用户和开发人员之间 当前分析的细节;定义系统的接口及实现这些接口要使用的设备
4.5.2.1.2参考资料 按照GB/T7714一2005格式要求,列出本文档中引用到的下述参考资料,包括资料的编号、作者、 标题,来源、出版单位、日期 a)软件需求规格说明书 b 与概要设计有关的文档资料; c)其他引用到的文档资料
4.5.2.1.3术语和缩写词 列出本文档中专用的术语、定义和缩写词
4.5.2.2需求 4.5.2.2.1概述 本章概述系统的特性和需求,扩充软件需求规格说明书中的信息,给出增加的细节,详尽地指出对 软件需求说明中有关特性和需求作出的变更
4.5.2.2.2总体描述 对软件系统进行总体描述,用图表示出软件系统的组成,相互联系和外部接口
4.5.2.2.3功能 定性地描述软件的功能需求
如数据采集、调节控制、画面显示及在线组态等
4.5.2.2.4性能 定量地描述系统的性能需求
如精度、时间特性、可靠性要求、灵活性及人机接口等
11
GB/T26805.4一2011 4.5.2.2.5环境 本章对软件需求规格说明书中规定的环境提供补充,反应环境的变化,并对环境作补充分析
如设 备环境、支持软件及接口等
4.5.2.3总体设计 4.5.2.3.1系统逻辑流程 用图的形式描述系统从输人经处理到输出的逻辑流程,并加以必要的解释
各图表将集中反映出 系统的动态特性,人口和出口,与其他系统或程序的接口,进程的优先级别等
4.5.2.3.2并发性 如果被控对象是一个并发活动的有机实体,在若干事件同时驱动系统并要求同时响应时,系统是如 何满足并发要求的,必须给予详细描述
4.5.2.3.3在线性 当系统要求在线组装或在线维护时,系统是如何满足的,必须给予描述 4.5.2.3.4系统结构 用图表形式说明本系统的结构组成,并说明组成系统的系统元素(子系统、模块、子程序,公用程序 等)的划分和名称
扼要说明每个系统元素的标识符和功能,分层次地给出各元素之间的控制关系
4.5.2.4系统设计 数据结构设计 4.5.2.4.1 数据结构设计主要包插" 输人输出数据
描述输人输出的每个数据元素,对每个数据元素要列出名称和标识符、数据类 型、格式、量纲、数值范围和精度要求等
对于输人数据,必须说明时间特性、优先顺序和输人 方式(数据采集卡、串口、网络、光盘、软件模块、键盘,其他I/o设备等)
对于输出数据,必须 说明时间特性、优先级别和输出方式(打印机、显示器、网络、串口,软件模块等)
数据结构
主要包括 b 系统状态数据结构; 1 2) 系统生成(组态)数据结构; 采样数据数据结构 3) 回路参数数据结构 控制数据数据结构 报警数据数据结构 显示数据数据结 8)打印数据数据结构; 操作台功能键数据数据结构; 9 10)通信数据数据结构 11诊断维护数据数据结构
4.5.2.4.2流程设计 使用图、表、文的形式描述软件系统的处理流程
说明为实现功能需求,处理流程的设计方法与过 程
主要包括 实时控制管理程序流程设计; a b)数据输人处理流程; 控制调节处理流程 d)数据输出处理流程 时钟中断处理流程 fD 操作台(键盘)输人处理流程 12
GB/T26805.4一2011 画面总貌画面、模拟表头、回路画面、趋势画面等)处理流程方案; g h 表格生成处理流程; 系统生成(在线组态)处理流程; 系统维护处理流程,包括诊断,出错处理,恢复等
4.5.2.4.3算法子程序库(包 算法子程序库一般包括;模拟量输人、模拟量输出,数据采集,基本PI,配比PID,算术运算、丽数 发生、高低选择,逻辑运算、线性化、补偿等模块
要说明算法子程序库的功能、种类、数量及数学模型等
4.5.2.4.4数据库设计 如果软件需求要求采用数据库技术,必须对数据库作如下的说明 概要
包括 a 标题和标识符 D) 2) 内容摘要; 数据结构; 存储介质和容量 数据字典及算法; s 6 数据库管理系统的基本功能 敏感程度 7 文件组织,包括文件的名称和标识符,文件性质及备份 8 b)数据库的数据元素
包括 名称和标识符,同义名; 1 数据库中的位置 2 37 定义 ) 量纲 57 格式和值域 数据项名、缩写调整和代码,包括用于数据库的规格说明 6) 7 敏感程度 4.5.2.5集成测试纲要 4.5.2.5.1概述 对本系统中各程序(子系统)逐个明确集成测试纲要,说明集成测试环境、测试范围和要求,为制定 集成测试计划和审查测试报告提供依据
4.5.2.5.2子系统1的集成测试纲要 主要包括 集成测试环境
包括 a 子系统名称; 1) 2 子系统进行集成测试所需的硬件环境 3 子系统进行集成测试所需的系统软件及接口; 与子系统相关的软件子系统或模块
测试范围和要求
包括: b 1 需测试的功能和性能指标; 2)需测试的逻辑关系,如调用关系、控制关系、制约关系等; 3)需测试的敏感度,包括敏感部位、敏感条件、敏感程度,以及对被测子系统及其他子系统的 影响; 13
GB/T26805.4一2011 可靠性、健壮性有关的成分,如诊断措施和诊断信息、联锁保护及其状态、负荷分析和统 计等
4.5.2.5.3子系统2的集成测试纲要 按照4.5.2.5.2同样格式,说明子系统2到子系统N的集成测试纲要
4.6软件详细设计说明书 4.6.1总则 软件详细设计说明书要尽可能详细地说明每个程序的设计思想,以利于制作软件模块规格说明书 和编码
软件详细设计说明书的编写示例见附录F 4.6.2软件详细设计说明书的内容 4.6.2.1概述 4.6.2.1.1编写目的 编写本说明书的目的是尽可能详细地说明程序的设计思想,以利于制作软件模块规格说明书和 编码
4.6.2.1.2参考资料 按照GB/T7714一2005格式要求,列出本文档中引用到的下述参考资料,包括资料的编号、作者、 标题,来源、出版单位、日期 a)软件需求规格说明书; b)软件概要设计说明书; e)有关软件详细设计说明书; d 其他有关文档
4.6.2.1.3术语和缩写词 列出本文档中的专业术语和缩写词
4.6.2.2需求 4.6.2.2.1总体描述 对软件系统进行总体描述,用图表示出软件系统的组成、相互联系和外部接口 4.6.2.2.2功能 定性地描述软件的功能需求
如数据采集,调节控制,画面显示和在线组态等
4.6.2.2.3性能 定量地描述系统的性能需求
如精度、时间特性、可靠性要求,灵活性和人机接口等
4.6.2.2.4环境 详细说明系统运行所需的环境
如设备环境、支持软件和接口等
4.6.2.3程序系统结构 4.6.2.3.1系统逻辑流程 用图的形式描述系统从输人经处理到输出的逻辑流程,并加以必要的解释
各图表将集中反映出 系统的动态特性,人口和出口,与其他系统或程序的接口,进程的优先级别等
4.6.2.3.2组织结构 用图表的形式列出软件系统各层模块和程序单元的名称、标识符和它们之间的层次结构、调用关 系,通信方式等
4.6.2.3.3程序运行过程 说明该程序的装载、启动、停止、恢复和再启动的过程,并说明该程序和操作人员之间的“交互” 14
GB/T26805.4一2011 4.6.2.4程序1名称)设计说明 4.6.2.4.1概述 从本节开始,逐个地描述各个层次中每个程序的设计考虑 4.6.2.4.2程序描述 对该程序进行简要描述,说明设计本程序的目的、意义,还要说明本程序的特点,如: a)常驻内存 b 可重人运行; e并发处理 4.6.2.4.3功能 详细说明该程序具有的功能可采用IPO图形式)
如:实时管理程序包括任务调度,设备管理,内 存管理通讯管理等
4.6.2.4.4性能 详细说明该程序的全部性能要求
如;精度包括转换精度12位,内部运算精度浮点4字节,数据计 算精度0.05%等
4.6.2.4.5输入 详细描述每个输人的特性
包括名称,标识、数据的类型,格式、量程范围、数值的有效范围,输人的 方式和媒体等
4.6.2.4.6输出 详细描述每个输出的特性
包括名称、标识、数据的类型、格式、量纲变换、数值的有效范围、输出媒 体、输出图形及符号的说明等
4.6.2.4.7算法 详细说明本程序所选用的算法、具体的计算公式和计算步骤
4.6.2.4.8流程 用图表例如流程图,判定表等)辅以必要的说明来表示本程序的逻辑流程
逻辑流程详细描述程 序的一切处理过程,详细解释程序间转移的测试条件,并注明出错条件及出错处理方法
4.6.2.4.9接口 说明该程序同其他程序的接口,对每个接口都必须说明 a)接口类型 数据传送说明; b e)数据的输人、输出要求(包括数据内容、顺序,时间性等); d)接口规程,包括远程通信的考虑
4.6.2.4.10存储分配 说明该程序的存储要求和所有限制条件,即 a)说明并图示内存分配 o 说明程序所要求的外存类型及限制条件,并指明是永久性的还是暂时性的存储
4.6.2.4.11注释 说明准备在本程序中安排的注释,如 a)加在程序首部的注释; 加在程序各分枝点的注释; b 对各变量的功能、范围、缺省条件等所加的注释
c 4.6.2.4.12限制 说明本程序运行中所受到的限制条件
15
GB/T26805.4一2011 4.6.2.4.13测试纲要 对程序规定测试纲要,说明测试范围和要求,为制定测试计划和审查测试报告提供依据
主要 包括 测试环境
包括 a 被测程序的名称; 1 27 被测程序在系统或子系统中的逻辑地位; 3)与被测程序有关的程序或模块名称及相互关系
b 测试范围和要求
包括: 1 需测试的功能和性能指标; 需测试的逻辑关系,如调用关系、控制关系、制约关系等 2 需测试的敏感度,包括敏感程度以及对程序或系统的影响 3 需测试的与可靠性、健壮性有关的成分
4！ 4.6.2.5程序2名称)设计说明 按4.6.2.4格式,说明程序2到程序N的设计说明和测试纲要
4.7数据库设计说明书 4.7.1出处 数据库设计说明书见GB/T8567一2006中的7.14
4.7.2总则 数据库设计说明书要描述软件项目中的存储分配和数据库组织,为构造系统文件、表,字典和目录 提供基本设计依据
数据库设计说明书的编写示例见附录G 4.7.3数据库设计说明书的内容 4.7.3.1概述 4.7.3.1.1编写目的 编写本说明书的目的是描述×××X(项目名称)中的存储分配和数据库组织,为构造系统文件、 表、字典和目录提供基本设计依据
4.7.3.1.2参考资料 按照GB/T7714一2005格式要求,列出本文档中引用到的参考资料,包括资料的编号、作者、标题 来源、出版单位、日期等
4.7.3.1.3术语和缩写词 列出本文档用到的专业术语和缩写词
4.7.3.2数据库描述 4.7.3.2.1标识 给出用来唯一标识数据库的代码、名称或标识符
还要说明附加的描述性信息
4.7.3.2.2功能 详细描述数据库的下述功能: a)数据库生成,包括建立过程子库、组定义,过程点信息输人; 数据库修改,包括过程子库修改、组定义修改、过程点信息修改; b e数据库检索,包括过程子库列表及打印、组定义检索,过程参数信息检索
4.7.3.2.3数据流图 给出数据库的数据流图
4.7.3.2.4使用系统 列出使用该数据库的系统、子系统和程序
包括名称、代码和版本
16
GB/T26805.4一2011 4.7.3.2.5存储要求 给出数据库的存储要求和限制条件
4.7.3.2.6约定 叙述为了能更好地使用数据库而事先确定的有关标号和标记的使用约定
如;用于更新版本的标 识约定,用于标识库内各个文件、记录、数据项的命名约定等
4.7.3.2.7数据压缩技术 应对数据存储采用的压缩算法给出详细的描述
4.7.3.2.8特别说明 为数据库生成、测试和操作提供特别的说明
包括检查进人该数据库的数据准则;数据进人数据库 要遵循的准则和过程;数据控制操作的标识;数据说明表的格式;用于生成修改,更新该数据库文件的 说明
4.7.3.2.9安全保密 叙述与整个系统的数据有关的安全保密措施
如通过对不同的访问者、不同的访问类型和不同的 数据对象,进行分别对待的设计考虑即为安全措施之 4.7.3.3数据库组织 为设计数据库管理系统提供信息,促进物理数据库文件组织与操作设计的一致性,对数据库组织要 进行如下描述 -般文件设计; a) b) 设计原理 e)数据库管理功能流程 数据字典
d 4.7.3.4数据定义 4.7.3.4.1概述 详细说明系统使用的全部数据的定义,包括物理数据的信息和表示物理数据的逻辑数据的信息
4.7.3.4.2数据项 数据项包括 a)标识符或标号 b) 用途; 格式,值域、量纲 c) d 项所在表的类型; e)在表中的位置 fD 项的使用说明,如表控制项,关键字项、串控制项、数据项等; g)项类型说明(如字符、整数、小数、混合数、串、状态码等)及与类型有关的代码 指出可以加快项存取或修改的机器指令; h 项的敏感程度
i 4.7.3.4.3记录 记录是数据文件的基本单位,应像定义表那样来定义记录,除用语言描述文件结构外,还要对每个 记录列出下列信息 全名和用途 a 每个项的解释; b c)最大长度; d 在文件中的图形表示
17
GB/T26805.4一2011 4.7.3.4.4 表包括: a标识符或标号; b 表的全名和用途; c包含该表的数据文件 d 使用该表的数据文件; 内部表块或分表等逻辑划分及表结构(定长或不定长固定表项或可变表项)
e 4.7.3.4.5文件 文件包括 名称、标识符或标号; a 文件用途; b c 文件内容和格式,包括表.记录,项等元素的文件结构 内容形式(文本或二进制)7 d e程序使用的文件控制信息,如存储控制项,目录,指针,空白连续特征和文件结束标志 f主要和辅助的存储媒体 4.7.3.5数据库运行 4.7.3.5.1运行环境 列出数据库运行时的环境条件,如 a)硬件环境,如;服务器、工作站等; b) 软件环境,如;分布式操作系统,大型数据库管理系统等
4.7.3.5.2运行要求 详细述说数据库运行时的条件要求、操作要求等以供数据库设计时提供信息
4.8软件模块规格说明书 4.8.1总则 软件模块规格说明书是为了按软件项目的设计要求编码和测试,以及为了便于审查,维护和配置 管理
软件模块规格说明书的编写示例见附录H
4.8.2软件模块规格说明书的内容 4.8.2.1概述 4.8.2.1.1编写目的 编写模块规格说明书的目的是为了按××××系统名或组名)的设计要求编码和测试,以及为了 便于审查、维护和配置管理
4.8.2.1.2参考资料 按照GB/7714一2005格式要求,列出本文档中引用到的参考资料,包括资料的编号、作者、标题、 来源,出版单位、日期等
4.8.2.1.3术语和缩写词 列出本文档中专用的术语、定义和缩写词
4.8.2.2系统概述 4.8.2.2.1系统名称 写明系统(或子系统)的名称,标识符或代码
一组相关的模块汇成一本模块卷宗时,可按主要模块 的功能命名这一组模块
模块标识符和代码要符合配置标识的要求,避免重复
4.8.2.2.2系统模块表 用表格或目录形式列出本文档所描述的全部模块名称,包括标识符、代码及页码 18
GB/T26805.4一2011 4.8.2.3模块设计说明 4.8.2.3.1概述 逐个模块详细说明模块设计要求和测试、使该说明足以指导编码和制定测试计划
4.8.2.3.2模块1(标识符或代码)设计说明 包括以下几个方面 模块流程与数据结构
说明程序模块的流程与数据结构 a b 设计要求
应根据软件概要设计说明书、详细设计说明书及软件需求规格说明书的有关要求 说明模块设计的下述各项要求 作用说明本模块在系统(或子系统、模块组)中的作用 功能:包括输人/输出描述及处理过程的简单描述; 2 3)性能:如实时性、精度、运算或处理速度等; 算法和处理步骤,应给出具体公式或步骤,并作说明 4！ 接口和调用;描述本模块与其他模块或外界的数据传递(通信)的要求和具体规定,说明本 5 模块及有关模块的接口关系和调用关系; 数据要求;说明本模块涉及的局部数据和全局数据的数目、容量、格式、存储分配的约定及 数据结构的约定; 编码要求:说明如可再定位性、可重人性等特性要求、目标代码长度、数制要求和规定语言 及版本等约束条件,以及其他的要求,如出错处理的措施等
存储分配
说明存储分配的情况
c) 开发环境
说明模块开发时所用到的硬件配置和软件支持等
d 测试要术
在编码前提出能覆盖设计要求的测试要求,说明测试方法、测试例和预期测试结 ee 果,便于最终制定测试计划
包括 功能、性能的测试; 1) 算法和处理步骤测试; 2) 33 接口和调用测试; 数据格式和数据结构测试 57 编码性能测试
适当的测试例可以使上述各款合并或部分合并
源代码清单
必须给出按设计要求编制的源代码清单,该清单已经汇编或编译排除语法错误， 并已经过静态检查和动态调试,已经按测试计划进人测试阶段
源代码清单包括 1 编码者;姓名、所在单位,完成日期 静态检查;责任人员姓名、检查记录及完成日期; 2) 3) 动态调试;责任人员姓名、检查记录及完成日期 4) 进人测试前的源代码清单;验收人员姓名
4.8.2.3.3模块2(标示符或代码)设计说明 按照4.8.2.3.2格式,描述模块2到模块N的设计说明
4.8.2.4模块测试 4.8.2.4.1概述 按模块逐个说明该模块的测试目的、测试方法、测试步骤及测试结论以指导模块进行具体测试
4.8.2.4.2模块1(标识符或代码)测试 应包含以下内容 测试目的
包括功能性能测试,算法测试、接口测试、数据测试及编码性能测试等
a b 测试环境
硬件配置及支持软件等 测试方法
黑盒法、白盒法及灰盒法等 c 19
GB/T26805.4一2011 d 测试结果
包括测试结果描述、描述测试结果者姓名和测试日期
测试结论
包括测试结论描述,描述测试结论者姓名和测试日期
e 4.8.2.4.3模块2(标识符或代码)测试 按照4.8.2.4.2格式,描述模块2到模块N的测试
4.8.2.5模块配置说明 4.8.2.5.1概述 配置人员将确认的源代码清单,对应的过程分析图,测试记录及测试结论等资料附在模块规格说明 书中一起纳人配置
4.8.2.5.2单元测试总结 说明本卷宗模块是否通过单元测试和审查,给出是否进人集成测试的结论,署明验收人的姓名 日期
4.8.2.5.3源代码清单及使用说明 以下包括 模块1(标识符或代码)
包括 a 修正后的源代码清单; 2)使用说明
b模块2(标识符或代码)
按a)的格式,描述模块2到模块N的源代码清单和使用说明
4.9软件质量保证计划 4.9.1出处 软件质量保证计划见GB/T8567一2006中的7.18
4.9.2总则 软件质量保证计划指出特定的软件质量保证计划的具体目的、任务,还指出该计划所针对的软件项 目(及其所属的各个子项目)的名称和用途
软件质量保证计划的编写示例见附录J
4.9.3软件质量保证计划的内容 4.9.3.1概述 4.9.3.1.1编写目的 编写本计划的目的是指出特定的软件质量保证计划的具体目的,还指出该计划所针对的软件项目 及其所属的各个子项目)的名称和用途
4.9.3.1.2参考资料 按照GB/T77142005格式要求,列出本文档中引用到的下述参考资料,包括资料的编号、作者、 标题,来源、出版单位、日期
4.9.3.1.3术语及缩写词 把文档中专用的名词术语、定义、缩写词列成清单
4.9.3.2管理 4.9.3.2.1概述 必须描述负责软件质量保证的机构,任务及其有关的职责
4.9.3.2.2机构 必须描述与软件质量保证有关的机构的组成,还必须清楚地描述来自项目委托单位,项目承办单 位、软件开发单位或用户中负责软件质量保证的各个成员在机构中的相互关系
4.9.3.2.3任务 必须描述计划所涉及的软件生存周期中有关阶段的任务,特别是要把重点放在描述这些阶段所应 进行的软件质量保证活动上
20
GB/T26805.4一2011 4.9.3.2.4职责 必须指明软件质量保证计划中规定的每一个任务的负责单位或成员的责任
4.9.3.3文档 4.9.3.3.1概述 必须列出在该软件的开发、验证与确认以及使用与维护等阶段中需要编制的文档,并描述对文档进 行评审与检查的准则
4.9.3.3.2基本文档 为了确保软件的实现满足需求,至少需要下列基本文档: 软件需求规格说明书 D) b 软件设计(概要设计,详细设计)说明
e测试计划与测试分析报告 4.9.3.3.3 用户文档 例如,用户手册,操作手册等
其他文档 4.9.3.3.4 除上述文档外,还应包括以下文档 项目开发计划(其中可包括软件配置管理计划,必要时该计划也可单列). a) 项目开发各阶段的评审报表
b) e)项目总结报告
4.9.3.4标准,规程和约定 必须列出软件开发过程中要用到的标准,规程和约定,并列出监督和保证执行的措施
4.9.3.5评审和检查 4.9.3.5.1概述 必须规定所要进行的技术和管理两方面的评审和检查工作,并编制或引用有关的评审和检查规程 以及通过与否的技术准则
至少要进行下列各项评审和检查工作 4.9.3.5.2软件需求(规格)评审 在软件需求分析阶段结束后必须进行软件需求评审,以确保在软件需求(规格)说明中所规定的各 项需求的合适性
4.9.3.5.3系统/子系统设计评审 在系统/子系统设计结束后必须进行系统/子系统设计的评审,以评价软件(结构)设计说明中所描 述的软件设计在总体结构、外部接口、主要部件功能分配、全局数据结构以及各主要部件之间的接口等 方面的合适性
4.9.3.5.4软件设计评审 在软件设计结束后必须进行软件设计的评审,以评价软件(结构)设计说明中所描述的软件设计,在 功能、算法和过程描述等方面的合适性
4.9.3.5.5软件验证与确认计划评审 在制订软件验证与确认计划之后要对它进行评审,以评价软件验证与确认计划中所规定的验证与 确认方法的合适性与完整性
4.9.3.5.6功能检查 在软件发行前,要对软件进行功能检查,以确认已经满足在软件需求规格说明中规定的所有需求 4.9.3.5.7物理检查 在验收软件前,要对软件进行物理检查,以验证程序和文档已经一致并已做好了交付的准备 4.9.3.5.8综合检查 在软件验收时,要允许用户或用户委托的专家对所要验收的软件进行设计抽样的综合检查,以验证 21
GB/T26805.4一2011 代码和设计文档的一致性、接口规格说明之间的一致性<硬件和软件,设计实现和功能需求之间的一致 性,功能需求和测试描述的一致性
4.9.3.5.9管理评审 要对计划的执行情况定期(或按阶段)进行管理评审;这些评审必须由独立于被评审单位的机构或 授权的第三方主持进行
4.9.3.6项目策划阶段的软件质量保证活动 描述软件质量保证负责人参与制定项目的软件开发计划和配置管理计划的活动,以及他们三者之 间的关系
4.9.3.7评审和审核 4.9.3.7.1过程的评审 描述对项目进行过程评审的方法和依据,并在表1中列出项目定义的过程以及相应的过程评审
4.9.3.7.2过程产品的审核 描述进行产品审核的方法和依据,并在表1中列出项目过程应产生的工作产品和质量记录,以及需 要由软件质量保证负责人审核的工作产品和相应的产品审核活动
4.9.3.7.3不符合问题的解决 描述过程评审和产品审核的结果怎样形成记录,应形成哪些记录,记录如表1所示
描述处理在评审中出现的不符合问题的解决方法
表1各阶段的质量记录 阶段 项目定义的过程 工作产品 质量记录 评审/审核活动 4.9.3.8软件配置管理 必须编制有关软件配置管理的条款,或单独制订文档
在这些条款或文档中,必须规定用于标识软 件产品、控制和实现软件的修改、记录和报告修改实现的状态以及评审和检查配置管理工作等四方面的 活动
还必须规定用以维护和存储软件受控版本的方法和设施;必须规定对所发现的软件问题进行报 告,追踪和解决的步骤,并指出实现报告,追踪和解决软件问题的机构及其职责
4.9.3.9工具,技术和方法 必须指明用以支持特定软件项目管理保证工作的工具,技术和方法,描述它们的用途 4.9.3.10媒体控制 必须指出保护计算机程序物理媒体的方法和设施,以免非法存取,意外损坏或自然老化
4.9.3.11对供货单位的控制 供货单位包括项目承办单位、软件开发单位或软件子开发单位
必须规定对这些供货单位进行控 制的规程,从而保证项目承办单位从软件销售单位购买的,其他开发单位(或子开发单位)开发的或从开 发(或自开发)单位现存软件库中选用的软件能满足规定的需求
4.9.3.12记录的收集,维护和保存 必须指明需要保存的软件质量保证活动的记录,并指出用于汇总、保护和维护这些记录的方法和设 施,并指明要保存的期限
4.9.3.13日程表 列出项目质量保证活动的日程表,并确保质量保证的日程表与项目开发计划以及配置管理计划保 持一致
日程表如表2所示
表2项目质量保证活动日程表 阶段 活动 日期 22
GB/T26805.4一2011 4.10软件配置管理计划 4.10.1出处 软件配置管理计划见GB/T8567一2006中的7.17
4.10.2总则 软件配置管理计划指出特定的软件配置管理计划的具体目的,还必须描述该计划所针对的软件项 目及其所属的各个子项目)的名称和用途
软件配置管理计划的编写示例见附录K
4.10.3软件配置管理计划的内容 4.10.3.1概述 4.10.3.1.1 编写目的 编写该管理计划的目的是指出特定的软件配置管理计划的具体目的,还必须描述该计划所针对的 软件项目(及其所属的各个子项目)的名称和用途
4.10.3.1.2参考资料 -2005格式要求,列出本文档中引用到的下述参考资料,包括资料的编号、作者 按照GB/T7714一 标题,来源、出版单位、日期
4.10.3.1.3术语及缩写词 把文档中专用的名词术语、定义、缩写词列成清单
4.10.3.2管理 4.10.3.2.1概述 描述负责软件配置管理的机构、任务、职责及其有关的接口控制
4.10.3.2.2机构 描述在各阶段中负责软件配置管理的机构
描述的内容如下 a)描述在软件生存周期各阶段中软件配置管理的功能和负责软件配置管理的机构 说明项目和子项目与其他有关项目之间的关系 b) e)指出在软件生存周期各阶段中的软件开发或维护机构与配置控制委员会的相互关系
4.10.3.2.3任务 描述在软件生存周期各阶段中的配置管理任务以及要进行的评审和检查工作,并指出各个阶段的 阶段产品应存放在哪一类软件库中(软件开发库、软件受控库或软件产品库)
4.10.3.2.4职责 描述与软件配置管理有关的各类机构或成员的职责,并指出这些机构或成员相互之间的关系
a)指出负责各项软件配置管理任务如配置标识、配置控制、配置状态记录以及配置的评审与检 查)的机构的职责; 指出上述机构与软件质量保证机构,软件开发单位、,项目承办单位,项目委托单位以及用户等 机构的关系 4.9.3.2.3中指明的生存周期各阶段的评审、检查和审批过程中的用户职责以及相关的开发 和维护活动 指出与项目有关的各个机构的代表的软件配置管理职责; d 指出其他特殊职责,例如为满足软件配置管理要求所必要的批准要求
4.10.3.2.5接口控制 描述: 接口规格说明标识和文档控制的方法; a b对已交付的接口规格说明和文档进行修改的方法; 对要完成的软件配置管理活动进行跟踪的方法 23
GB/T26805.4一2011 d)记录和报告接口规格说明和文档控制状态的方法; 控制软件和支持它运行的硬件之间的接口的方法
4.10.3.2.6实现 规定实现软件配置管理计划的主要里程碑,例如: a)建立配置控制委员会 b)确定各个配置基线; 建立控制接口协议 c d)制定评审与检查软件配置管理计划和规程; 制定相关的软件开发、测试和支持工具的配置管理计划和规程
e 4.10.3.2.7适用的标准、条例和约定 应包括以下内容 指明所适用的软件配置管理标准,条例和约定
必须说明这些标淮、条例和约定要实现的 程度
描述要在本项目中编写和实现的软件配置管理标准条例和约定
这些标谁、条例和约定可 以包括以下内容: 软件结构层次树中软件位置的标识方法; 2 程序和模块的命名约定 版本级别的命名约定; 3 软件产品的标识方法; 4 规格说明、,测试计划与测试规程、程序设计手册及其他文档的标识方法; 5 媒体和文档管理的标识方法; 文档交付过程; 8)软件产品库中软件产品人库、移交或交付的过程; 问题报告、修改请求和修改次序的处理过程; 9 配置控制委员会的结构和作用 10) 1软件产品交付给用户的验收规程; 12)软件库的操作,包括准备、存储和更新模块的方法; 13)软件配置管理活动的检查; 14)问题报告、修改请求或修改次序的文档要求,指出配置修改的目的和影响 15)软件进人配置管理之前的测试级别 16)质量保证级别,例如,在进人配置管理之前,验证软件满足有关基线的程度
4.10.3.3软件配置管理活动 4.10.3.3.1概述 描述配置标识、配置控制、配置状态记录与报告以及配置检查与评审等四方面的软件配置管理活动 的需求
4.10.3.3.2配置标识 应包括以下内容 必须详细说明软件项目的基线即最初批准的配置标识)
把它们与4.9.3.2.3中描述的生存 周期的特定阶段相联系
在软件生存周期中,主要有三种基线,它们是功能基线、分配基线和 产品基线
对于每个基线,必须描述下列内容 1 每个基线的项(包括应交付的文档和程序); 2与每个基线有关的评审与批准事项以及验收标准; 3 在建立基线的过程中用户和开发者参与情况 214
工业控制计算机系统软件第4部分：工程化文档规范GB/T26805.4-2011
随着信息技术的不断发展和应用，工业控制计算机系统在现代工业生产中起着越来越重要的作用。而工业控制计算机系统的软件则是该系统中不可或缺的组成部分。为了规范工业控制计算机系统软件的文档编写和管理，国家标准化委员会于2011年发布了《工业控制计算机系统软件第4部分：工程化文档规范GB/T26805.4-2011》。 该标准主要涉及到工业控制计算机系统软件的各种文档的规范要求，包括文档的命名、格式、内容等方面，并且针对不同的文档类型设置了具体的规范要求。通过这些规范要求，可以使得工业控制计算机系统软件的文档编写和管理更加规范化、标准化。同时，也可以提高工业控制计算机系统软件的质量和可靠性，降低开发成本和维护成本。 具体来说，该标准对各种文档的命名规则进行了详细说明，确保每个文档都有一个唯一的名称，便于管理和查找；对文档的格式要求也进行了严格规定，包括字体、字号、行距等方面，以确保文档的可读性和统一性。此外，该标准还对各种文档的内容和组织结构进行了规范，以便于开发人员理解和维护文档。 总之，《工业控制计算机系统软件第4部分：工程化文档规范GB/T26805.4-2011》是一项非常重要的标准，能够帮助企业更好地规范其工业控制计算机系统软件的文档编写和管理，提高软件质量和可靠性，并且为软件的开发和维护节省时间和成本。企业应该重视并遵守这一标准，以确保其工业控制计算机系统软件的成功开发和运营。
工业控制计算机系统软件第4部分：工程化文档规范的相关资料
- 工业控制计算机系统功能模块模板第5部分：数字量输入输出通道模板通用技术条件GB/T26804.5-2011
- 工业控制计算机系统功能模块模板第3部分：模拟量输入输出通道模板通用技术条件GB/T26804.3-2011
- 工业控制计算机系统功能模块模板第1部分：处理器模板通用技术条件GB/T26804.1-2011
- 工业控制计算机系统总线第2部分：系统外部总线串行接口通用技术条件GB/T26803.2-2011
- 工业控制计算机系统总线第1部分：总论GB/T26803.1-2011介绍
- 信息技术软件资产管理：GB/T26236.1-2010
- 软件工程开发方法元模型GB/T26239-2010
- 信息技术蒙古文类文字通用编辑软件的基本要求GB/T26233-2010
- 信息技术软件生存周期过程重用过程GB/T26224-2010
- 粮油储藏粮情测控系统第3部分：软件GB/T26882.3-2011介绍
- 工业控制计算机系统软件第4部分：工程化文档规范GB/T26805.4-2011
- 工业控制计算机系统软件第4部分：工程化文档规范GB/T26805.4-2011
