FZ∕T 90060.10-2014 纺织机械产品图样及设计文件 第10部分：软件开发及管理

FZ纺织机械产品图样及设计文件第10部分：软件开发及管理Part10:Softwaredevelopmentandmanagement2014-10-14发布中华人民共和国工业和信息化部发布FZ/T90060.10—2014前言 I 12规范性引用文件 3软件开发流程 4产品软件设计 5产品软件调试 26产品软件验证 27产品软件归档 28产品软件使用 29产品软件维护 310各阶段技术文件 3附录A(资料性附录)软件需求说明书 附录B(资料性附录)软件设计说明书 6附录C(资料性附录)软件调试说明书 附录D(资料性附录)软件验证报告 附录E(资料性附录)软件安装说明 附录F(资料性附录)软件归档说明 附录G(资料性附录)软件更改说明 IFZ/T90060《纺织机械产品图样及设计文件》包括以下10个部分：——第2部分：编号；——第3部分：图样的要求；——第4部分：设计文件的要求；——第5部分：格式；——第6部分：完整性；——第8部分：标准化审查； 第10部分；软件开发及管理本部分为FZ/T90060的第10部分。本部分按照GB/T1.1—2009给出的规则起草。本部分由中国纺织工业联合会提出，本部分由全国纺织机械与附件标准化技术委员会(SAC/TC215)归口，全国工业机械电气系统标准化技术委员会纺织机械电气系统分技术委员会(SAC/TC231/SC1)专业归口。本部分起草单位：青岛宏大纺织机械有限责任公司、恒天重工股份有限公司、北京经纬新技术有限电科技有限公司、北京众仁智杰科技发展有限公司、绍兴县通利企业管理咨询有限公司。1纺织机械产品图样及设计文件第10部分：软件开发及管理FZ/T90060的本部分规定了纺织机械的产品软件设计、调试、验证、归档、使用及维护的内容和本部分适用于自行开发、合作开发或委托开发的纺织机械产品软件。2规范性引用文件下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本(包括所有的修改单)适用于本文件。GB/T8567计算机软件文档编制规范3软件开发流程——产品软件设计，包括编写软件需求说明书，编写软件设计说明书(含流程图)和编程三个阶段；——产品软件调试，包括编写软件调试说明书；的媒体(如刻录光盘等)、软件安装说明、软件归档说明及软件更改说明等；——产品软件使用，包括软件的媒体(如刻录光盘等)和软件安装说明等使用阶段；4产品软件设计4.1编写软件需求说明书软件需求说明书是整个软件开发工作的基础，一般由产品(项目)电气负责人编写，并组织相关人员进行评审，以确保软件需求说明书是充分的和适宜的。编写软件需求说明书的内容和要求参见附录A。4.2编写软件设计说明书软件需求说明书通过评审后，进入编写软件设计说明书阶段。软件设计说明书是说明对软件系统的设计考虑，为软件的编程提供基础。由软件设计人员负责编写，产品(项目)负责人组织相关人员进行评审。编写软件设计说明书的内容和要求参见附录B。在完成编写软件设计说明书并通过评审后，进入编程阶段。根据软件需求说明书和软件设计说明2书的内容进行编程。5产品软件调试在完成编程工作后，进入软件调试阶段。编程人员编写软件调试说明书，并对整个软件系统进行调试。编写软件调试说明书具体的内容和要求参见附录C。6产品软件验证为确保产品软件满足产品对软件需求的要求，在完成软件调试工作后，由产品(项目)负责人组织软件测试人员对产品软件进行测试验证。由软件测试人员编写软件验证报告书，根据软件需求说明书列出每一项验证内容，并指明实际进行的验证工作内容与设计中的内容之间的差别，说明作出这种改变的原因。由软件测试人员填写验证结论，经过验证确认后的产品软件方可正式投入使用，并编制软件版本号。软件验证报告书具体编写内容和要求参见附录D。7.1归档文件经验证确认后的产品软件应及时归档。产品软件的源程序(要求程序的各条和程序块应加相应的注释)和目标程序分别以软件媒体(如刻录光盘等)形式归档。同时还应归档相关的文字资料，包括软件说明等。所有归档文件应有制定、校对、标准化、审核和批准等相关流程签字。软件上载可设置密码保护。软件安装说明是指导软件安装与运行的技术文件。内容包含：运行本产品软件所需要的支持软件，本产品软件下载所必须配备的硬件、本产品软件的安装和下载说明及补充说明。编写软件安装说明的内容和要求参见附录E。用表格的形式列出归档产品软件相对应的产品型号、电路图的图号、软件版本号、用于生产的批次、归档日期、软件媒体(如刻录光盘等)的编号以及配置说明等。编写软件归档说明的内容和要求参见附录F。7.4软件更改说明产品使用中发现问题或用户提出要求时，需要更改软件。软件更改说明详细记录软件更改的原因，更改的具体内容；对更改前的软件的使用说明(是继续使用还是回收作废)及其他补充说明。同时应将《软件更改说明》与更改后的软件媒体(如刻录光盘等)一并归档。编写软件更改说明的内容和要求参见附录G。8产品软件使用产品软件由相关部门按规定进行发放、接收和使用，同时应制定产品软件安全保密规定。发放内容3包括软件的媒体(如刻录光盘等)(有目标程序光盘的源程序光盘不发放)和软件安装说明等。9产品软件维护9.1产品软件在生命周期内，因产品改进等原因需对软件进行修改和升级。9.2对已归档产品软件进行修改(升级)时应对过程进行有效控制。修改过程包括需求、评审、编程、归档：a)需求：由项目(产品)负责人或软件负责人提出书面的软件修改的需求内容及修改的理由。b)评审：由项目(产品)负责人组织相关人员对软件修改内容进行评议，包括审查该项修改的必要性，确定这一修改的影响范围，明确进行修改的方法、步骤和实施计划。评审后由软件负责人编写软件设计说明书。c)编程：由软件编制人员按照已批准的修改计划，对软件进行编程修改，并进行调试。由项目(产品)负责人组织相关人员对修改的软件进行验证、试用和确认。并由电气负责人编写验证报d)归档：编写软件更改(升级)说明书，详细说明软件更改的内容，更改前的软件使用情况(继续使用还是回收作废),技术档案室在相应的软件更改记录上作标记。软件更改说明和软件媒介以及编写的修改的需求内容和评审报告、验证报告一同归档。10各阶段技术文件各阶段及相应的技术文件目录见表1,编写内容和要求参见附录A～附录G,其他软件产品技术文件编制参见GB/T8567的有关规定。产品软件开发管理各阶段技术文件名称内容和要求设计阶段软件需求说明书软件设计说明书附录B调试验证阶段软件调试说明书软件验证报告归档阶段软件安装说明软件归档说明软件更改说明附录G软件媒体(如刻录光盘等)使用阶段软件媒体(如刻录光盘等)软件安装说明维护阶段根据更改需求，提供(需求、评审、编程、归档)各阶段的相关技术文件4(资料性附录)软件需求说明书A.1引言说明编写这份软件需求说明书的目的。A.1.2背景a)待开发的软件系统的名称；c)该软件同其他系统的基本的相互关系。A.1.3参考资料a)本项目的经核准的计划任务书或合同。b)本文件中各处引用的文件、资料、包括所要用到的软件开发标准。列出这些文件资料的标题、文件编号、发表日期和出版单位，说明能够得到这些文件资料的来源。A.2任务概述列出进行本软件开发工作的约束，例如开发期限等。并描述与其使用有关的保密性要求。A.3需求规定A.3.1对功能的规定用列表的方式(例如IPO表即输入、处理、输出表的形式),逐项定量和定性地叙述对软件所提出的A.3.2对性能的规定A.3.2.1精度说明对该软件的输入、输出数据精度的要求，可能包括传输过程中的精度。5A.3.2.2时间特性要求说明对于该软件的时间特性要求，如：a)响应时间；b)更新处理时间；c)数据的转换和传送时间；d)解题时间。说明对该软件的灵活性的要求，即当需求发生某些变化时，该软件对这些变化的适应能力，如：a)操作方式上的变化；b)运行环境的变化；c)同其他软件的接口的变化；d)精度和有效时限的变化；e)计划的变化或改进。对于为了提供这些灵活性而进行的专门设计的部分应该加以标明。A.3.3输入输出要求解释各输入输出数据类型，并逐项说明格式、数值范围、精度等。对软件的数据输出及必须标明的控制输出量进行解释，包括对硬拷贝报告(正常结果输出、状态输出及异常输出)以及图形或显示报告的描述。A.3.4数据管理能力要求说明需要管理的数据和记录的个数、表和文卷的大小规模，要按可预见的增长对数据及其分量的存储要求作出估算。A.3.5故障处理要求列出可能的软件、硬件故障以及对各项性能而言所产生的后果和对故障处理的要求。A.3.6其他专门要求如用户单位对软件产品安全保密的要求，对使用方便的要求，对可维护性、可补充性、易读性、可靠性、运行环境可转换性的特殊要求等。A.4运行环境规定A.4.1支持软件列出支持软件，包括要用到的操作系统、编译(或汇编)程序、测试支持软件等。说明该软件同其他软件之间的接口、数据通信协议等。6(资料性附录)软件设计说明书B.1.1编写目的说明编写这份软件设计说明书的目的。B.1.2背景a)待开发软件系统的名称；b)列出此项目的任务提出者、开发者。B.1.3参考资料a)本项目的经核准的计划任务书或合同。b)本文件中各处引用的文件、资料，包括所要用到的软件开发标准。列出这些文件的标题、文件编号、发表日期和出版单位，说明能够得到这些文件资料的来源。B.2总体设计B.2.1需求规定说明对本软件的主要的输入输出项目、处理的功能性能要求。B.2.2运行环境简要地说明对本系统的运行环境(包括硬件环境和支持环境)的规定。B.2.3基本设计概念和处理流程说明本系统的基本设计概念和处理流程，尽量使用图表的形式。B.2.4逻辑控制叙述逻辑控制关系及逻辑控制图表。B.2.5时序控制叙述时序控制关系及时序控制图。B.2.6结构用一览表及框图的形式说明本软件的系统元素(各层模块、子程序、公用程序等)的划分，扼要说明每个系统元素的标识符和功能，分层次地给出各元素之间的控制与被控制关系。7B.2.7功能需求与软件的关系用如下的矩阵图说明各项功能需求的实现同各块程序的分配关系。程序1程序2…程序n功能需求1√功能需求2√功能需求n√√说明在本软件系统的工作过程中不得不包含的人工处理过程(如果有的话)。B.2.9尚未解决的问题说明在概要设计过程中尚未解决而设计者认为在系统完成之前必须解决的各个问题。B.3接口设计说明本软件同外界的所有接口的安排包括软件与硬件之间的接口、本软件与各支持软件之间的接B.3.2内部接口说明本软件之内的各个系统元素之间的接口的安排。B.4运行设计B.4.1运行模块组合说明对系统施加不同的外界运行控制时所引起的各种不同的运行模块组合，说明每种运行所历经的内部模块和支持软件。B.4.2运行控制说明每一种外界的运行控制的方式方法和操作步骤。B.4.3运行时间说明每种运行模块组合将占用各种资源的时间。B.5系统数据结构设计B.5.1逻辑结构设计要点给出本系统内所使用的每个数据结构的名称、标识符以及它们之中每个数据项、记录、文卷和系统8B.5.2物理结构设计要点给出本系统内所使用的每个数据结构中的每个数据项的存储要求，访问方法、存取单位、存取的物B.5.3数据结构与软件的关系说明各个数据结构与访问这些数据结构的形式。B.6系统出错处理设计用一览表的方式说明每种可能的出错或故障情况出现时，系统输出信息的形式、含义及处理方法。B.6.2系统维护设计说明为了系统维护的方便而在软件内部设计中作出的安排，包括在软件中专门安排用于系统的检查与维护的检测点和专用模块。9(资料性附录)软件调试说明书C.1引言C.1.1编写目的本调试说明书的具体编写目的。C.1.2背景a)调试说明所从属的软件的名称；b)说明在开始执行本软件调试之前必须完成的各项工作。C.1.3参考资料a)本项目的经核准的计划任务书或合同。b)本文件中各处引用的文件、资料，包括所要用到的软件开发标准。列出这些文件的标题、文件编号、发表日期和出版单位，说明能够得到这些文件资料的来源。C.2调试内容列出软件调试中的每一项调试内容的名称标识符、这些内容的进度安排以及这些调试的内容和目试等。C.2.1控制说明本软件的控制方式，手动、自动控制方式的调试内容和方法。C.2.2输入说明本软件中所使用的输入数据，数据处理方式及调试方法。C.2.3输出说明预期的输出数据，如调试结果及可能产生的中间结果或运行信息。说明完成此项调试的一个个步骤和控制命令，包括调试的准备、初始化、中间步骤和运行结束方式。C.2.5故障说明所有故障的调试内容和方法。给出对这项测试的进度安排，包括进行测试的日期和工作内容(如熟悉环境、培训、准备输入数据说明所选择的测试用例能够检查的范围及其局限性。(资料性附录)软件验证报告D.1.1编写目的说明这份软件验证报告的具体编写目的。a)被验证软件系统的名称；D.1.3参考资料a)本项目的经核准的计划任务书或合同。b)本文件中各处引用的文件、资料，包括所要用到的软件开发标准。列出这些文件的标题、文件编号、发表日期和出版单位，说明能够得到这些文件资料的来源。D.2验证概要用表格的形式列出每一项验证的标识符及其验证内容，并指明实际进行的验证工作内容与需求计划中预先设计的内容之间的差别，说明作出这种改变的原因。D.2.1验证内容及结果把本项测试中实际得到的动态输出(包括内部生成数据输出)结果同对于动态输出的要求进行比简述该项功能，说明为满足此项功能而设计的软件能力以及经过一项或多项验证已证实的能力。D.2.3限制说明测试数据值的范围(包括动态数据和静态数据),列出就这项功能而言，测试期间在该软件中查D.3分析摘要陈述经验证证实了的本产品软件的能力。如果所进行的测试是为了验证一项或几项特定性能要求的实现，应提供这方面的测试结果与要求之间的比较，并确定测试环境与实际运行环境之间可能存在的差异对能力的测试所带来的影响。D.3.2缺陷和限制陈述经验证证实的软件缺陷和限制，说明每项缺陷和限制对软件性能的影响，并说明全部验证的性能缺陷的累积影响和总影响。对每项缺陷提出改进建议，如：a)各项修改可采用的修改方法；b)各项修改的紧迫程度；c)各项修改预计的工作量；d)各项修改的负责人。D.3