01 实验一 (2) 软工标准化

实验一（2）软件工程标准化文档

一、背景知识

1.软件工程标准化软件工具

软件工程标准化涉及软件设计的标准化，文件编写的标准化和项目管理的标准化三个方面。软件设计标准化包括设计方法、设计表达方法、程序结构、程序设计语言、程序设计风格、用户接口设计、数据结构设计、算法设计等。文件编写的标准化包括管理文件、项目实施计划、质量保证计划、开发进度月报、可行性分析报告、软件需求说明书、概要设计说明书、详细设计说明书、测试设计说明书、用户手册、维护手册、操作手册、源代码、生成信息、验收报告、开发总结报告等。项目管理的标准包括开发流程、开发作业、设计与进度管理、人员组织、质量管理、成本管理、维护管理、配置管理等。

2.软件工程标准化的意义

任何工程项目都要经过计划、设计、施工、检验等一系列步骤，在这些步骤中，资料和图纸是绝对必要的，其中记载了大量数据、方案、报表、图示和文字说明等有关的工程项目的重要信息。而与之相比，软件工程的文件资料在软件生存周期中的地位和作用就显得更加突出了。

一项计算机软件的筹划、研制及实现，构成一个软件开发项目，它一般需要在人力和资源等方面做重大的投资。为了保证项目开发的成功，最经济地花费这些投资，并且便于运行和维护，在开发工作的每一个阶段，都需要编制一定的文件。这些文件连同计算机程序及数据一起，构成为计算机软件。这些文件作为软件产品的主要形式，集中体现了软件开发人员的大量脑力劳动成果，是软件的不可缺少的组成部分。

3.目的和作用

软件文件（document，通常又称为文档），是指与软件研制、维护和使用有关的材料，是以人们可读的形式出现的技术数据和信息。

软件文件的作用可概括为：

1）提高软件开发过程的能见度。把软件开发过程中一些“不可见的”

事物转变为“可见的”文字资料，以使管理人员在软件开发阶段进行度控制及软件质量管理。

2）提高开发效率。软件文件的编制将使开发人员对各个阶段的工作都进行周密思考、全盘权衡，从而减少返工，并可在卡发早期发现错误及不一致性，便于及时纠正。

3）作为开发人员在一定阶段内的工作成果和结束标志。

4）记录开发过程中的有关技术信息，便于协调以后的软件开发、使用和维护。

4）提供对软件的运行、维护和培训的有关信息，便于管理人员、开发人员、操作人员和用户之间的协作、交流和了解，使软件开发活动更加科学、更有成效。

5）便于潜在用户了解软件的功能、性能等各项指标，为他们选购复合自己需求的软件提供依据。

在有关软件工程的各项国家标准中，对软件文件的编制做出了具体而详尽的

叙述。例如，计算机软件产品开发问卷编制指南（GB/T8569-1988）建议在软件的开发过程中编制下述14种文件，即可行性研究报告、项目开发计划、软件需求说明书、数据要求说明书、概要设计说明书、详细设计说明书、数据库设计说明书、用户书册、操作手册、模块开发卷宗、测试计划、测试分析报告、开发进度月报以及项目开发总结报告等：计算机软件需求说明编制指（GB/T9385-1988）和计算机软件测试文件编制规范（GB/T16680-1996）为那些对软件或基于软件的产品开发负有职责的管理者提供了软件文档的管理指南。

4.文件编制的质量要求

计算机软件产品开发文件编制指南（GB/T8567-1988）给出的14中软件文件的编制提示，同时也是这14中文件编写质量的检验准则。

高质量的文件应当体现在以下一些方面：

1）针对性：应分清读者对象，按不同类型、不同层次的读者，决定怎样适应他们的需要。

2）精确性：文件的行文应当十分确切，不能出现多义性的描述。

3）清晰性：文件编写应力求简明，如有可能，配以适当的图表，以增强其清晰性。

4）完整性：任何一个文件都应是完整的、独立的，它应自称体系。

5）灵活性：各个不同的软件项目，其规模和复杂程度有着许多实际差别，不能一概而论。

6）可追溯性：由于各个开发阶段编制的文件与各阶段完成的工作有着紧密的关系，前后两个阶段生成的文件，随着开发工作的逐步扩展，具有一定的集成关系。在一个项目各个开发阶段之间提供的文件必定存在着可追溯的关系。

二、实验目的与要求

（1）熟悉和掌握软件工程标准化的概念、内容及其意义。

（2）了解那些支持国家标准和其他相关信息的专业网站。

（3）熟悉和掌握国家标准GB/T8567-1988。

（4）学习和掌握软件产品开发文件的基本内容。

三、实验内容与步骤

1.请查阅相关网站或资料，了解软件工程标准一般分为哪5个层次，完成表1-1的内容。

表1-1

2.查阅相关网站了解GB、GJB、ISO、ANSI、IEEE的含义，完成表格2-2的内容。

表1-2

3.软件生存周期与各种文件的编制

软件文件是在软件开发过程中产生的，与软件生存周期有着密切关系。请参阅有关资料（教科书、背景知识或专业网站等），了解就一个软件而言，其生存周期各阶段与各种文件编写的关系，并在表1-3中适当的位置填上“ ”。

表1-3 软件生存周期各阶段中的文件编制

请注意其中有些文件的编写工作可能要在若干个阶段中延续进行。

4.文件的读者及其关系

文件编制是一个不断努力的工作过程，是一个从形成最初轮廓，经反复检查和修改，直到程序和稳健正式交付使用的完整过程。

在软件开发的各个阶段中，不同人员对文件的关心不同。请根据你的判断，用符号“ ”表示某部分人员对某个文件的关心，完成表1-4的填写。

表1-4 各类人员与软件文件的关系

5.文件内容的重复性

由于不同软件在规模上合复杂程度上差别极大，在计算机软件产品开发文件

编制指南（GB/T8567-1988）所要求的14钟软件文件的编制中，允许有一定的灵活性，这主要体现在应编制文件种类的多数、文件的详细程度、文件的扩展与缩并、程序设计和文件的表现形式等方面。

此外，分析在计算机软件产品开发问卷编制指南（GB/T8567-1988）中列出的14种软件文件的“内容要求”部分，可以看出其中存在着某些重复。较明显的重复又两类，即：第一类：___ ______________________________________________ ____ _ 第二类：___ ______________________________________________ ____ _ 这种内容重复的目的，是为了：________________________________________ _ _______________________________________________________________________________ ___________________________________________________________

6.文件编制实施规定的实例

GB/T8567-1988指出，对于具体的软件开发任务，应编制的文件种类、详细程度等取决于开发单位的管理能力、任务规模、复杂性和成败风险等因素。为了控制文件编制中存在的灵活性，保证文件质量，软件开发单位应该制定一个文件编制实施规定，说明在说明情况下应该编制哪些文件。

我们通过下面的例子，来说明了如何建立这种实施规定，使项目经理能确定本项目开发过程中应编制的文件的种类。

我们采用求和法来确定应编制的文件。该方法的要点是：提出12个考虑因素来衡量一个应用软件，每个因素可能取值的范围是1至5。项目经理可用这12个因素对所要开发的

程序进行衡量，确定每个因素的具体值；把这12个因素的值相加，得到一个总和；然后由这个总和的值来确定应该编制的文件的种类。

表1-5 文件编制的12项衡量因素