实验一 软件开发文档与工具安装

1、实验一 软件开发文档与工具安装与使用实验目的：1、了解软件开发文档的组织、标准及编写。2、了解常用工具的用途及掌握各种工具的安装实验内容：1. 了解GB8567-88，GB8567-2006的内容，掌握需求说明书、概要设计、详细说明书的主要内容2. 了解Visio的作用，安装Visio，按照实验指导使用Visio完成系统流程图、DFD图、业务流程图的绘制，掌握Visio的使用方法3.了解Rational Rose，完成Rose(或starUML)的安装，了解Rose的主要界面及功能实验步骤：1、 阅读实验指导一软件文档的内容、打开软件文档文件夹了解GB8567-88，GB8567-2006的内

2、容，重点阅读需求说明书、概要设计、详细说明书的主要内容，比较GB8567-88与GB8567-2006在内容上有何不同。2、 打开软件工具文件夹分别安装Visio2003、rose2003（或者starUML）。3、 利用Visio2003完成例1，例2，例3系统流程图、DFD图、业务流程图绘制。比较系统流程图、DFD、业务流程图的差异。4、 绘制机票预定系统的业务流程图。5、 实验总结，完成实验报告。实验评分标准1、 仅完成1、2；基本完成3 合格2、 完成1,、2；完成步骤3较好，未完成4 中等3、 完成1,、2、3、4良好4、 完成1、2、3、4 ，实验报告完成较好 优秀实验指导：一、

3、软件文档1.1文档的作用及分类软件文档(document)也称文件，通常指的是一些记录的数据和数据媒体，它具有固定不变的形式，可被人和计算机阅读。它和 计算机程序共同构成了能完成特定功能的计算机软件(有人把源程序也当作文档的一部分)。我们知道，硬件产品和产品资料在整 个生产过程中都是有形可见的，软件生产则有很大不同，文档本 身就是软件产品。没有文档的软件，不成其为软件，更谈不到软件 产品。软件文档的编制(documentation)在软件开发工作中占有突 出的地位和相当的工作量。高效率、高质量地开发、分发、管理和维 护文档对于转让、变更、修正、扩充和使用文档，对于充分发挥软 件产品的效益有着重

4、要意义。 然而，在实际工作中，文档在编制和使用中存在着许多问题，有待于解决。软件开发人员中较普遍地存在着对编制文档不感 兴趣的现象。从用户方面看，他们又常常抱怨：文档售价太高、文档不够完整、文档编写得不好、文档已经陈旧或是文档太多，难于 使用等等。究竟应该怎样要求它，文档应该写哪些，说明什么问题，起什么作用?这里将给出简要的介绍。 文档桥梁作用文档在软件开发人员、软件管理人员、维护人员、用户以及计 算机之间的多种桥梁作用可从 上图中看出。软件开发人员在各 个阶段中以文档作为前阶段工作成果的体现和后阶段工作的依据，这个作用是显而易见的。软件开发过程中软件开发人员需制定 一些工作计划或工作报告，这

5、些计划和报告都要提供给管理人员， 并得到必要的支持。管理人员则可通过这些文档了解软件开发项 目安排、进度、资源使用和成果等。软件开发人员需为用户了解软 件的使用、操作和维护提供详细的资料，我们称此为用户文档。以 上三种文档构成了软件文档的主要部分。我们把这三种文档所包括的内容列在下图中。其中列举了十三个文档，这里对它们作一些简要说明： 可行性研究报告：说明该软件开发项目的实现在技术上、经济上和社会因素上的可行性，评述为了合理地达到开发目标可供 选择的各种可能实施的方案，说明并论证所选定实施方案的理由。 项目开发计划：为软件项目实施方案制定出具体计划，应 该包括各部分工作的负责人员、开发的进度、

6、开发经费的预算、所 需的硬件及软件资源等。项目开发计划应提供给管理部门，并作 为开发阶段评审的参考。 软件需求说明书：也称软件规格说明书，其中对所开发软 件的功能、性能、用户界面及运行环境等作出详细的说明。它是用 户与开发人员双方对软件需求取得共同理解基础上达成的协议， 也是实施开发工作的基础。 数据要求说明书：该说明书应给出数据逻辑描述和数据采 集的各项要求，为生成和维护系统数据文卷作好准备。 概要设计说明书：该说明书是概要设计阶段的工作 成果，它应说明功能分配、模块划分、程序的总体结构、输入输出以及接口设计、运行设计、数据结构设计和出错处理设计等，为详细设计奠定基础。 详细设计说明书：着重

7、 描述每一模块是怎样实现的， 包括实现算法、逻辑流程等。用户手册：本手册详细 描述软件的功能、性能和用户界面，使用户了解如何使用该软件。操作手册：本手册为操作人员提供该软件各种运行情况的有关知识，特别是操作方法的具体细节。 测试计划：为做好组装测试和确认测试，需为如何组织测试 制定实施计划。计划应包括测试的内容、进度、条件、人员、测试用例的选取原则、测试结果允许的偏差范围等。 测试分析报告：测试工作完成以后，应提交测试计划执行情况的说明。对测试结果加以分析，并提出测试的结论意见。 开发进度月报：该月报系软件人员按月向管理部门提交的 项目进展情况报告。报告应包括进度计划与实际执行情况的比较、 阶

8、段成果、遇到的问题和解决的办法以及下个月的打算等。 项目开发总结报告：软件项目开发完成以后，应与项目实 施计划对照，总结实际执行的情况，如进度、成果、资源利用、成本和投入的人力。此外还需对开发工作作出评价，总结出经验和教训。 维护修改建议：软件产品投入运行以后，发现了需对其进行修正、更改等问题，应将存在的问题、修改的考虑以及修改的影响估计作详细的描述，写成维护修改建议，提交审批。 以上这些文档是在软件生存期中，随着各阶段工作的开展适时编制。其中有的仅反映一个阶段的工作，有的则需跨越多个阶段。下表给出了各个文档应在软件生存期中哪个阶段编写。这些文档最终要向软件管理部门，或是向用户回答以下的问题：

9、表1：软件生存期各阶段编制的文档阶段文档可行性研究与计划需求分析设计代码编写测试运行与维护可行性研究报告项目开发计划软件需求说明数据要求说明概要设计说明详细设计说明测试计划用户手册操作手册测试分析报告开发进度月报项目开发总结维护修改建议哪些需求要被满足，即回答“做什么?” 所开发的软件在什么环境中实现以及所需信息从哪里来， 即回答“从何处?” 某些开发工作的时间如何安排，即回答“何时干?” 某些开发(或维护)工作打算由“谁来干?” 某些需求是怎么实现的? 为什么要进行那些软件开发或维护修改工作? 上述十三个文档都在一定程度上回答了这六个方面的问题。这可从表中看到。表 文档所回答的问题所提问题文

10、档什么 何处 何时 谁 如何 为何 可行性研究报告项目开发计划软件需求说明数据要求说明概要设计说明详细设计说明测试计划用户手册 操作手册 测试分析报告 开发进度月报 项目开发总结 维护修改建议 1.2计算机软件文档编制规范GB856788是计算机软件产品开发文件编制指南，供编写软件文档时参考。这些文档主要是：可行性研究报告、项目开发计划、软件需求说明书、概要设计说明书、详细设计说明书、模块开发卷宗、测试计划、测试分析报告、项目开发总结报告。GB/T 8567-2006标准是GB/T 8567-1988计算机软件产品开发文件编制指南的修订版，并改名为计算机软件文档编制规范。2006-03-14发

11、布，2006-07-01实施，从实施之日起替代GB/T 8567-88。一、GB/T 8567-2006与GB856788相比，主要变化如下：二、软件生存周期中产生的基本文档三、人员与文档的关系二、常用软件简介及安装2.1 Visio简介Office Visio便于 IT 和商务专业人员就复杂信息、系统和流程进行可视化处理、分析和交流。使用具有专业外观的 Office Visio图表，可以促进对系统和流程的了解，深入了解复杂信息并利用这些知识做出更好的业务决策。Microsoft Office Visio 可帮助开发人员创建具有专业外观的图表，包括业务流程图、软件界面、网络图、工作流图表、数据

12、库模型和软件图表等直观地记录、设计和完全了解业务流程和系统的状态，以便理解、 记录和分析信息、数据、系统和过程。2.2 Visio2003的安装步骤(省略)2.3 Rose简介UML（Unified Modeling Language）是一种正式的语义规范，它包括抽象语法、符合规范的规则和动态语义。UML又是一种面向对象方法的建模语言，它可以用图形方式表现典型的面向对象方法设计的系统的整个结构。同时，UML还是一种世界公认的建模语言，通过其所规定的图，可以实现为不同领域的开发人员提供统一的交流标准。为了成功地开发一个项目，需要正确的符号、过程和工具。 UML提供了通用的符号管理， Ration

13、al Unified Process提供了开发流程，Rational Rose提供了项目成功的建模工具。Rational Rose是由美国的Rational公司开发的、面向对象的可视化建模工具。利用Rose工具，可以建立用UML描述的软件系统模型，它支持UML中的用例框图、活动框图、序列框图、协作框图、状态框图、组建框图和布局框图等。而且通过其正向和逆向转出工程代码的特性，可以支持C+、Java、Visual Basic和XML DTD 的代码生成和逆向转出工程代码。进入rose建模界面后，可看见Rational Rose模型提供的4种视图：用例视图（Use Case View）、逻辑视图（L

14、ogical View）、组件视图（Component View）和部署视图（Deployment View）。每当创建一个新的Rose模型时（扩展名为.mdl），Rose将自动生成上述视图，Rose把视图看作模型结构的第一层次。每种视图针对不同的对象，具有不同的用途。Rose建模界面2.4 Rose2003的安装步骤(省略)三、使用Visio 2003 绘制系统流程图3.1系统流程图作用及符号系统流程图是描绘物理系统的传统工具。是用图形符号以黑盒子形式描绘系统里面的每个部件（程序、文件、数据库、表格、人工过程等等）。表达的是信息在系统各部件之间流动的情况，而不是对信息进行加工处理的控制过程。

15、其基本符号与扩展符号如下： 基本符号扩展符号如工资管理系统系统流程图如下：3.2利用 Visio 绘制系统流程图（1）基本操作首先选择【开始】|【程序】【Microsoft office Visio 2003】进入Visio启动窗口.。选择【文件】|【新建】|【新建绘图】，出现绘图窗口。选择工具栏上的“形状”按钮，弹出供选择的各类图形文件夹，然后，再选择各类形状集合，如下图所示。例如：如果需要一个“正方形”图形，则选择【框图】|【基本形状】，出现如下图所示的界面。基本图形选择结果按照上述方法，可以依次选择【流程图】【基本流程图形状】，打开基本流程图形状图形对象集；选择【软件】|【GaneSar

16、son】，打开GaneSarson图形对象集；选择【其他Visio方案】|【连接线】，打开连接线图形对象集，最终选择结果下图所示。图形对象集最终选择结果 Visio提供了许多可直接使用的图形对象，使用时将所需图形拖动到绘图板上即可。例如，需要用矩形来描述系统流程中的业务处理动作，则单击左边窗格【形状】|【基本流程图形状】，将矩形图形拖动到绘图板中，然后通过拖动绿色的连接点调整图形大小至合适的尺寸，如下图所示。利用同样的方法，可以对其他的图形进行类似处理。图元拖动示意图(2) 绘制系统流程图 系统流程图的绘制按照业务处理的过程，大致遵循由左至右，由上到下的规律绘制各种图形。操作步骤如下。 先选中

17、已制作好的图元（如“矩形勺并单击鼠标右键，在弹出的快捷菜单中选择【复制】，再选择【粘贴】，即在绘图板上复制出一个矩形图元副本。还可以先选中复制对象，按Ctr+c进行复制操作，再按Ctr+v键进行粘贴操作即可。 获得矩形图元副本后，在该图元上双击，进入文字编辑状态，将所需文字输入到文本框内。还可以定义字体和字的大小，方法是选中图元或双击进入文字编辑状态后选择相应的文字，在工具栏中选择字体、字号，即完成字体样式的设定。采用这种方法也可以为图元定义字体、大小和颜色等属性，从而使图看起来更为规范和美观。 连接图元。选择形状窗口中的连接线集，并选择其中的一个适当的连接线形状，拖动到绘图板中，如果线的两端

18、连接点变为红色，则表示该线段已分别与两端的图元相连接。将线段与连接点连接后，拖动图元则连接特怔保持不变。（3）系统流程图排版先对各类图形进行大致调整，如果需要将一组图形精确对齐，可利用菜单中的【形状】|【对齐形状】来完成。 Visio提供了两类6种对齐方式，并以图的形式非常直观地显示在对话框中，选择其中的一种并单击【确定】按钮即可完成对齐功能。值得注意的是，对齐形状功能是以第一个被选中的图形对象为基准的，因此要留心图形的对齐基准。当需要调整图形之间的间隔距离，使得间隔距离相等时，可利用菜单中的【形状】|【分配形状】来完成。 Visio也为图形分配提供了两类 6种分配方式，并以图的形式形象地显示

19、在对话框中，选择其中的一种，单击【确定】按钮即可完成分配形状的功能。（4）实例 【例1】某装配厂有一个存放零件的仓库，仓库中现有的各种零件的数量及每种零件的库存量临界值等数据记录在库存清单主文件中。当仓库中零件数量有变化时，应该及时修改库存清单主文件；如果哪种零件的库存量少于它的库存量临界值，则应该报告给采购部门以便订货，规定每天向采购部门送一次订货报告。该装配厂使用一台小型计算机处理更新库存清单主文件和产生订货报告的任务。零件库存量的每一次变化称为一个事务，由放在仓库中的CRT终端输入到计算机中；系统中的库存清单程序对事务进行处理，更新存储在磁盘上的库存清单主文件，并且把必要的订货信息写在磁

20、带上。最后，每天由报告生成程序读一次磁带，并且打印出订货报告。下图所示的系统流程图描绘了上述系统的概貌。库存清单系统流程图 库存清单系统流程图的绘制过程如下。 绘制图元。 用鼠标单击【形状】窗口中的基本流程图形状图形对象集中的相应图形，将所需图形拖动到绘图板上，得到如下图所示的图形。图元绘制 图元的文字编辑。在每个图元上双击，进入文字编辑状态，将所需文字输入到文本框内，为图元定义字体、大小和颜色等属性，得到如下图所示的图形。图元的文字编辑 连接图元。选择形状窗口中的连接线集，并选择其中适当的连接线形状，拖动到绘图板中，如果线的两端连接点变为红色，则表示该线段已分别与两端的图元相连接，得到如下图

21、所示的图形。连接图元排版。利用Visio菜单中的【形状】|【对齐形状】完成排版。四、使用Visio 2003 绘制数据流图4.1、数据流图的作用及基本符号数据流图（DFD）是软件系统系统的逻辑模型，仅仅描绘数据在软件中流动（从输入移动到输出）的过程中所经受的变换（即加工处理）。数据流图有4种基本符号，如下图所示。图5-17数据流图的基本符号4.2数据流图的绘制过程数据流图的绘制方法：根据数据流图的四种成分：源点或终点，处理，数据存储和数据流，从问题描述中提取数据流图的四种成分；然后依据“自顶向下、从左到右、由粗到细、逐步求精”的基本原则进行绘制。 数据流图的绘制过程与系统流程图的绘制过程基本类

22、似，大致分成四个步骤：第一步，绘制图元；第二步，编辑图元的文字；第三步，连接图元；第四步，排版。下面用一个例子来具体说明绘制数据流图的过程。【例2】利用Visio绘制如下图所示的数据流图。 第一步：绘制图元。用鼠标单击【形状】窗口中的 Gane-Sarson图形对象集中的相应图形，并将所需图形拖动到绘图板上，得到如下图所示的图形。绘制图元第二步：编辑图元的文字。在每个图元上双击，进入文字编辑状态，将所需文字输入到文本框内，为图元定义字体、大小和颜色等属性，得到如下图所示的图形。编辑图元的文字 第三步：连接图元。选择【形状】窗口中的连接线集，并选择其中适当的连接线形状，拖动到绘图板中，再编辑连接

23、线上的文字。第四步：排版。利用 VISIO菜单中的【形状】 l【对齐形状】完成排版，并且添加相应的线条。五、使用Visio绘制业务流程图5.1业务流程图的作用及基本符号业务流程调查是需求捕获环节的重要工作，业务流程调查的内容为通过现场调研、业务实习等手段了解业务开展的组织机构、掌握业务活动的规律、理解用户的实际需求。通过简洁直观的方式展示给用户，并以此作为业务讨论的依据，最终形成用户和开发者双方都能理解的标准文档。业务流程描述的主要文档是业务流程图 业务流程是指在组织内部“流转”的一系列相关的活动，流程就是“工作的流动”，是业务与业务之间的传递或转移的动态过程。业务流程图不仅仅限于一个单一的功能或者单一的部门，能够贯穿始终地反映经营情况业务流程图是一种用尽可能少、尽可能简单的方法来描述业务处理过程的方法。由于它的符号简单明了，所以非常易于阅读和理解业务流程。但它的不足是对于一些专业性较强的业务处理细节缺乏足够的表现手段，它比较适合用于事物处理类型的业务过程。业务流程图的基本图元有5种类型，它们分别是业务处理主体、单证、业务处理、数据存储和业务流程的流转方向。 主体 单证 业务处理 数据存储 业务流程的