SW03-4需求规格说明.ppt

1、需求规格说明,优秀需求具有的特性,需求陈述 1. 完整性 2. 正确性 3. 可行性 4. 必要性 5. 划分优先级 6. 无二义性 7. 可验证性,推荐的编写需求文档的指南,定义标准的文档结构 说明如何使用文档 包含一个需求概要 构造系统的业务案例 定义专业术语 安排好文档的版面使文档易读 帮助读者查找信息 使文档易于变更,推荐的需求描述指南,定义描述需求的标准模板 使用浅显、一致、简明的语言 适当地使用图解 其他需求描述辅助自然语言 定量说明需求 惟一地标识每个需求 记录需求源 需求的理由,1.定义标准的文档结构,为需求确定恰当的结构可有助于： 有利于读者阅读 最小化需求的总量； 理解大量

2、信息； 找出与具体问题有关的需求集合； 发现遗漏和重复； 消除需求之间的矛盾； 管理迭代（例如延迟提出的需求）； 在多个项目中重用需求。,文档结构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通信接口,d.系统特性 d.1说明和优先级 d.2激励/响应序列 d.3功能需求 e.其它非功能需求 e.1性能需求 e.2安全设施需求 e.3安全性需求 e.4软件质量属性 e.5业务规则 e.6用户文

3、档 f.其它需求 附录A：词汇表 附录B：分析模型 附录C：待确定问题的列表,2.说明如何使用文档,效益 减少阅读的成本 明确知识要求 实施 明确所针对不同类型的读者 明确理解文档所需要的专业知识和技术背景 指向概述部分的指示器 明确第一次阅读可以路过的部分 描述阅读各部分的相关顺序,3.包含一个需求概要,效益更易于理解的需求文档 帮助理解概要 关注关键需求，有利于建立需求的优先级 作为文档中的需求的映射，有助于读者发现感兴趣的需求 实施 重要的需求用编号的列表来表示 基于某种分类结构，在表格中列出不同需求 通过把每个主要需求表示成图上的一个结点，可以产生需求的图形化视点,4.构造系统的业务案

4、例,效益提供系统需求的一个理由 帮助评估需求变更 帮助理解包含特殊需求的原因 实施 放在需求文档引言的单独章节中 列出业务目标 给出目标系统有助于这些业务理由,5.定义专业术语,效益避免需求文档的读者与作者之间的误解 帮助读者理解需求文档 帮助不同作者使用相同的术语 减少混淆 实施 定义一个标准的术语表 根据术语表修改需求文档 例如：词汇表,6.安排好文档版面使文档易读,效益使文档易读 读的次数比写的次数多，因此 易于评审时发现更好的问题 实施 使用宽的页边空白来使文本 节和小节的标题采用一致的格式 使用表格、标号列表或数字列表来表示相关信息项的集合。 当许多信息项必须表示成稳定和变化两部分时

5、，使用表格来显示共同点和不同点。 使用空白把方程式和文本分开，并使用不同字体来表示它们。 使用图表来显示过程的各个步骤。 不用使用复杂的图表,7.帮助读者查找信息,效益易于用做系统参考 索引和目录容易使需求规格说明作为参考文档 索引帮助读者评审文档 实施 生成索引和目录 出现在索引中的术语应在正文中标明 可以使用字处理系统中的自动化工具来创建索引,8.使用文档易于变更,效益减少需求变更的成本 制作和分发新的需求文档既昂贵又耗时 有利于及时验证文档 实施（结合“安排好文档的版面使文档易读”一起实施） 把文档做成活页 利用字处理系统的修订模式 写文档时，避免引用文档中的其他页码 确保所有图表都有标

6、签，始终使用标签引用图表 保持章简短以便整章可以被用户替换 在单独的页上开始新的一章 始终根据章给页编号 如果有的话，使用使用字处理系统中制作图、表等的相对引用的功能。以便能够自动变更引用。,9.定义描述需求的标准模板,效益需求前后一致，更加易懂 标准使得需求易于阅读 标准使得需求易于收集 标准使得需求易于书写 实施 针对不同业务领域和技术使用不同的需求模板 对模板的使用进行详细说明（注释） 提供样本以供参考,10.使用浅显、一致、简明的语言,效益需求更加易读易懂 使用浅显的语言书写的需求易于阅读和理解 使用浅显的语言书写的需求有利于让更多的人理解 实施书写规则 用短句，用短段。（一个段落不应

7、该多于七个句子） 一个句子表达一项需求 术语一致（术语表） 使用主动语气而不是被动语气 不要试图在自然语言描述中表达复杂的关系（用图）,需求示例的改进前后,“产品必须在固定的时间间隔内提供状态消息，并且每次时间间隔不得小于6 0秒” 这个需求看起来是不完整的：什么是状态消息，并且在什么情况下向用户提供这些消息？显示时间多长？我们所说的是产品的哪一部分？ 时间间隔也会导致混淆。假定显示状态消息之间的时间间隔只要求不少于6 0秒，按这样推理，是否可以每隔一年显示一次状态信息？消息显示的时间间隔怎样才能一致？“每次”这个词混淆了这一问题。 由于这些问题的存在，导致了需求是不可验证的。,后台任务管理器

8、（ B T M）应该在用户界面的指定区域显示状态消息： a. 在后台任务进程启动之后，消息必须每隔6 0（1 0）秒更新一次，并且保持连续的可见性。 b. 如果正在正常处理后台任务进程，那么后台任务管理器（ B T M）必须显示后台任务进程已完成的百分比。 c. 当完成后台任务时，后台任务管理器（ B T M）必须显示一个“已完成”的消息。 d. 如果后台任务中止执行，那么后台任务管理器（ B T M）必须显示一个出错消息。,需求示例的改进前后,需求示例的改进前后,“产品必须在显示和隐藏非打印字符之间进行瞬间切换” 在瞬间这一时间概念上，计算机不能完成任何工作，因此，这个需求是不可行的。 该需

9、求也是不完整的，因为它没有说清状态切换的原因。在特定的条件下，软件产品是否可以进行自动切换或者可否由用户采取某些措施来激发这样转变？还有，在文档中显示转变的范围是什么？是所选的文本、整个文档或其它内容？ 这个需求也存在一个不确定性问题。“非打印”字符是否指隐藏文本、属性标记或者其它的控制字符？ 由于存在这些问题，该需求是不可验证的。,需求示例的改进前后,改进后的需求描述： “用户在编辑文档时，通过激活特定的触发机制，可以在显示和隐藏所有H T M L标记之间进行切换” 它并没有对设计造成限制，因为它并没有精确定义所使用的机制。设计人员可以选择一种触发机制（例如热键、菜单命令或语音输入）,11.

10、适当地使用图解,效益图解最适于记录需求关系 图解在表示关系时比文本有效得多 图解将大段的文本分为更小的、更易于阅读的片段 图解可能在对客户展示需求时重用 实施时机 当某个对象由多个模块和组件组成，而你希望阐明它们之间的关系时 当需要表达一个系列的行为，而每个行为都有一些输入输出时。图解可以用来表述行为序列，以及在哪些地方这些行为可以并行发生。 当需要说明空间组织，如控制板时 当需要使用一些分解结构，如组织结构图,12.用其他需求描述辅助自然语言,效益更加简明、无二义的需求描述 特殊符号的描述不太可能引起误解 对于对符号熟悉的专家更易发现问题 实施 决策树 结构化语言 代数 数据流图 时序图 。,13.定量说明需求,效益无二义的表达需求 简明的交流方式 可能作为系统验收测试的基准 实施 定义表达这些属性的合适的度量 为属性决定一个合适的值,14.惟一地标识每个需求,效益方便引用、利于管理 可以用来指向相关的需求和构造可跟踪性表 有利于放到数据库中统一管理 有利于需求版本的管理 实施 最常用的方法是根据需求文档中包含的章节分配数字 字处理系统可以自动处理 临时的标识符解决需求无法确认的问题,15. 记录需求源,效益需求可跟踪性 有利于分析和