需求文档

需求开发的最终成果是：客户和开发小组对将要开发的产品达成一致协议。协议综合了业务需求、 用户需求和软件功能需求。就像我们早先所看到的，项目视图和范围文档包含了业务需求，而使用实例文档则包含了用户需求。你必须编写从使用实例派生出的功能 需求文档，还要编写产品的非功能需求文档，包括质量属性和外部接口需求。只有以结构化和可读性方式编写这些文档，并由项目的风险承担者评审通过后，各方面 人员才能确信他们所赞同的需求是可靠的。

你可以使用以下三种方法编写软件需求规格说明：

用好的结构化和自然语言编写文本型文档。

建立图形化模型，这些模型可以描绘转换过程、系统状态和它们之间的变化、数据关系、逻辑流或对象类和它们的关系。

编写形式化规格说明，这可以通过使用数学上精确的形式化逻辑语言来定义需求。

由于形式化规格说明具有很强的严密性和精确度，因此，所使用的形式化语言只有极少数软件开发 人员才熟悉，更不用说客户了。虽然结构化的自然语言具有许多缺点，但在大多数软件工程中，它仍是编写需求文档最现实的方法。包含了功能和非功能需求的基于 文本的软件需求规格说明已经为大多数项目所接受。图形化分析模型通过提供另一种需求视图，增强了软件需求规格说明。

软件需求规格说明不仅是系统测试和用户文档的基础，也是所有子系列项目规划、设计和编码的基 础。它应该尽可能完整地描述系统预期的外部行为和用户可视化行为。除了设计和实现上的限制，软件需求规格说明不应该包括设计、构造、测试或工程管理的细 节。许多读者使用软件需求规格说明来达到不同的目的：

客户和营销部门依赖它来了解他们所能提供的产品。

项目经理根据包含在软件需求规格说明中描述的产品来制定规划并预测进度安排、工作量和资源。

软件开发小组依赖它来理解他们将要开发的产品。

测试小组使用软件需求规格说明中对产品行为的描述制定测试计划、测试用例和测试过程。

软件维护和支持人员根据需求规格说明了解产品的某部分是做什么的。

产品发布组在需求规格说明和用户界面设计的基础上编写客户文档，如用户手册和帮助屏幕等。

培训人员根据需求规格说明和用户文档编写培训材料。

软件需求规格说明作为产品需求的最终成果必须具有综合性：必须包括所有的需求。开发者和客户不能作任何假设。如果任何所期望的功能或非功能需求未写入软件需求规格说明，那么它将不能作为协议的一部分并且不能在产品中出现。

我见过有一个项目突然接到测试人员发出的错误灾难的报告。结果是他们测试的是老版本的软件需求规格说明，而他们觉得错误的地方正是产品所独有的特性。他们的测试工作是徒劳的，因为他们一直在老版本的软件需求规格说明中寻找错误的系统行为。

在编写软件需求规格说明，希望读者牢记以下的建议：

对节、小节和单个需求的号码编排必须一致。

在右边部分留下文本注释区。

允许不加限制地使用空格。

正确使用各种可视化强调标志（例如，黑体、下划线、斜体和其它不同字体）。

创建目录表和索引表有助于读者寻找所需的信息。

对所有图和表指定号码和标识号，并且可按号码进行查阅。

使用字处理程序中交叉引用的功能来查阅文档中其它项或位置，而不是通过页码或节号。

为了满足软件需求规格说明的可跟踪性和可修改性的质量标准，必须唯一确定每个软件需求。这可 以使你在变更请求、修改历史记录、交叉引用或需求的可跟踪矩阵中查阅特定的需求。由于要达到这一目的，用单一的项目列表是不够的，因此，我将描述几个不同 的需求标识方法，并阐明它们的优点与缺点。可以选择最适合你的方法。

(1) 序列号最简单的方法是赋予每个需求一个唯一的序列号，例如SRS-13。当一个新的需求加入到商业需求管理工具的数据库之后，这些管理工具就会为其分配一 个序列号（许多这样的工具也支持层次化编号）。序列号的前缀代表了需求类型，例如SRS代表“软件需求说明”。由于序列号不能重用，所以把需求从数据库中 删除时，并不释放其所占据的序列号，而新的需求只能得到下一个可用的序列号。这种简单的编号方法并不能提供任何相关需求在逻辑上或层次上的区别，而且需求 的标识不能提供任何有关每个需求内容的信息。

(2) 层次化编码这也许是最常用的方法。如果功能需求出现在软件需求规格说明中第3 . 2部分，那么它们将具有诸如3.2.4.3这样的标识号。标识号中的数字越多则表示该需求越详细，属于较低层次上的需求。即使在一个中型的软件需求规格说 明中，这些标识号也会扩展到许多位数字，并且这些标识也不提供任何有关每个需求目的的信息。如果你要插入一个新的需求，那么该需求所在部分其后所有需求的 序号将要增加。删除或移去一个需求，那么该需求所在部分其后所有需求的序号将要减少。但其他地方的引用将混乱，对于这种简单的层次化编号的一种改进方法是 对需求中主要的部分进行层次化编号，然后对于每个部分中的单一功能需求用一个简短文字代码加上一个序列号来识别。例如，软件需求规格说明可能包含“第 3.2.5部分—编辑功能”，并将此部分编写成子模块文档，然后配置管理。

有时，你觉得缺少特定需求的某些信息。在解决这个不确定性之前，可能必须与客户商议、检查与 另一个系统的接口或者定义另一个需求。使用“待确定”（to be determined, TBD或采用汉语拼音略写DQD）符号作为标准指示器来强调软件需求规格说明中这些需求的缺陷。通过这种方法，你可以在软件需求规格说明中查找所要澄清需 求的部分。记录谁将解决哪个问题、怎样解决及什么时候解决。把每个TBD编号并创建一个TBD列表，这有助于方便地跟踪每个项目。

在继续进行构造需求集合之前，必须解决所有的TBD问题，因为任何遗留下来的不确定问题将会 增加出错的风险和需求返工。当开发人员遇到一个TBD问题或其它模糊之处时，他可能不会返回到原始需求来解决问题。多半开发者对它进行猜测，但并不总是正 确的。如果有TBD问题尚未解决，而你又要继续进行开发工作，那么尽可能推迟实现这些需求，或者解决这些需求的开放式问题，把产品的这部分设计得易于更 改。

编写优秀的需求文档没有现成固定的方法，最好是根据经验进行。从过去所遇到的问题中可使你受益匪浅。许多需求文档可以通过使用有效的技术编写风格和使用用户术语而不是计算机专业术语的方式得以改进。

你在编写优秀的需求文档时，希望读者还需牢记以下几点建议：

保持语句和段落的简短。

采用主动语态的表达方式。

编写具有正确的语法、拼写和标点的完整句子。

使用的术语与词汇表中所定义的应该一致。

需求陈述应该具有一致的样式，例如“系统必须..”或者“用户必须..”，并紧跟一个行为动作和可观察的结果。例如，“仓库管理子系统必须显示一张所请求的仓库中有存货的库存清单。”

为了减少不确定性，必须避免模糊的、主观的术语，例如，用户友好、简单、有效、、最新技术、优越的、可接受的等。当用客说“用户友好”或者“快”时，你应该明确它们的真正含义并且在需求中阐明用户的意图。

避免使用比较性的词汇，定量地说明所需要提高的程度或者说清一些参数可接受的最大值和最小 值。当客户说明系统应该“处理”、“支持”或“管理”某些事情时，你应该能理解客户的意图。由于需求的编写是层次化的，因此，可以把顶层不明确的需求向低 层详细分解，直到消除不明确性为止。

文档的编写人员不应该把多个需求集中在一个冗长的叙述段落中。在需求中诸如“和”，“或”之类的连词就表明了该部分集中了多个需求。务必记住，不要在需求说明中使用“和/或”，“等等”之类的连词。