SW03–4需求规格说明.ppt

优秀需求具有的特性 需求陈述 1. 完整性 2. 正确性 3. 可行性 4. 必要性 5. 划分优先级 6. 无二义性 7. 可验证性 推荐的编写需求文档的指南 定义标准的文档结构 说明如何使用文档 包含一个需求概要 构造系统的业务案例 定义专业术语 安排好文档的版面使文档易读 帮助读者查找信息 使文档易于变更 推荐的需求描述指南 定义描述需求的标准模板 使用浅显、一致、简明的语言 适当地使用图解 其他需求描述辅助自然语言 定量说明需求 惟一地标识每个需求 记录需求源 需求的理由 1.定义标准的文档结构 为需求确定恰当的结构可有助于： 有利于读者阅读 最小化需求的总量； 理解大量信息； 找出与具体问题有关的需求集合； 发现遗漏和重复； 消除需求之间的矛盾； 管理迭代（例如延迟提出的需求）； 在多个项目中重用需求。 文档结构－IEEE/ANSI1830-1993 a.引言 b.综合描述 b.1产品的前景 b.2产品的功能 b.3用户类和特征 b.4运行环境 b.5设计和实现上的限制 b.6假设和依赖 c.外部接口需求 c.1用户界面 c.2硬件接口 c.3软件接口 c.4通信接口 2.说明如何使用文档 效益 减少阅读的成本 明确知识要求 实施 明确所针对不同类型的读者 明确理解文档所需要的专业知识和技术背景 指向概述部分的指示器 明确第一次阅读可以路过的部分 描述阅读各部分的相关顺序　 3.包含一个需求概要 效益－更易于理解的需求文档 帮助理解概要 关注关键需求，有利于建立需求的优先级 作为文档中的需求的映射，有助于读者发现感兴趣的需求 实施 重要的需求用编号的列表来表示 基于某种分类结构，在表格中列出不同需求 通过把每个主要需求表示成图上的一个结点，可以产生需求的图形化视点 4.构造系统的业务案例 效益－提供系统需求的一个理由 帮助评估需求变更 帮助理解包含特殊需求的原因 实施 放在需求文档引言的单独章节中 列出业务目标 给出目标系统有助于这些业务理由 5.定义专业术语 效益－避免需求文档的读者与作者之间的误解 帮助读者理解需求文档 帮助不同作者使用相同的术语 减少混淆 实施 定义一个标准的术语表 根据术语表修改需求文档 例如：词汇表 6.安排好文档版面使文档易读 效益－－使文档易读 读的次数比写的次数多，因此…… 易于评审时发现更好的问题 实施 使用宽的页边空白来使文本 节和小节的标题采用一致的格式 使用表格、标号列表或数字列表来表示相关信息项的集合。 当许多信息项必须表示成稳定和变化两部分时，使用表格来显示共同点和不同点。 使用空白把方程式和文本分开，并使用不同字体来表示它们。 使用图表来显示过程的各个步骤。 不用使用复杂的图表 7.帮助读者查找信息 效益－易于用做系统参考 索引和目录容易使需求规格说明作为参考文档 索引帮助读者评审文档 实施 生成索引和目录 出现在索引中的术语应在正文中标明 可以使用字处理系统中的自动化工具来创建索引 8.使用文档易于变更 效益－减少需求变更的成本 制作和分发新的需求文档既昂贵又耗时 有利于及时验证文档 实施（结合“安排好文档的版面使文档易读”一起实施） 把文档做成活页 利用字处理系统的修订模式 写文档时，避免引用文档中的其他页码 确保所有图表都有标签，始终使用标签引用图表 保持章简短以便整章可以被用户替换 在单独的页上开始新的一章 始终根据章给页编号 如果有的话，使用使用字处理系统中制作图、表等的相对引用的功能。以便能够自动变更引用。 9.定义描述需求的标准模板 效益－－需求前后一致，更加易懂 标准使得需求易于阅读 标准使得需求易于收集 标准使得需求易于书写 实施 针对不同业务领域和技术使用不同的需求模板 对模板的使用进行详细说明（注释） 提供样本以供参考 10.使用浅显、一致、简明的语言 效益－－需求更加易读易懂 使用浅显的语言书写的需求易于阅读和理解 使用浅显的语言书写的需求有利于让更多的人理解 实施－书写规则 用短句，用短段。（一个段落不应该多于七个句子） 一个句子表达一项需求 术语一致（术语表） 使用主动语气而不是被动语气 不要试图在自然语言描述中表达复杂的关系（用图） 需求示例的改进前后 “产品必须在固定的时间间隔内提供状态消息，并且每次时间间隔不得小于6 0秒” 这个需求看起来是不完整的：什么是状态消息，并且在什么情况下向用户提供这些消息？显示时间多长？我们所说的是产品的哪一部分？ 时间间隔也会导致混淆。假定显示状态消息之间的时间间隔只要求不少于6 0秒，按这样推理，是否可以每隔一年显示一次状态信息？消息显示的时间间隔怎样才能一致？“每次”这个词混淆了这一问题。 由于这些问题的存在，导致了需求是不可验证的。 后台任务管理器（ B T M）应该在用户界面的指定区域显示状态消息：