书面文档 口文档编制,着眼点在其实用性和可读性。 口文档编写要明确谁需要这些文档及他们要用 这些文档干什么。 ①面向用户的文档 ①首先描述系统的用途。可以用3VM中的 上下文图,帮助说明目标系统的范围,系 统需要接收和产生什么信息。 ②接着描述一系列的用户事例 use case) 事件-响应模型。文档应当可以让读者走 查每一个场景或事件,一步一步检查事件 如何被识别,相关的响应如何产生
③建立五层OOA模型的副本,其中应把相 关联的场景或事件的ERO图作为OOA模 型的成分写入文档。 ④对用场景没有描述出来的目标系统的动 态行为进行注释。 ⑤属性和服务的定义以及细节的描述以字 母顺序排列,作为词典放入文档附录中。 ②面向设计者的文档 ①由于读者更想了解系统的结构,因此文 档应当出现完整的五层OOA模型。 ②将OOA模型表示为一组主题集。最好主 题能够小到用单个图表就可表示
面向用户的文档的一般结构 系统契约、目 的、范围等 用户事例 23451 /ERO图描 述系统行为 用对象图描 述系统行为 词典 各种支持细节,包括数据定 义,服务定义和相关描述
用户事例 2 3 4 5 系统契约、目 的、范围等 用EROI图描 述系统行为 用对象图描 述系统行为 各种支持细节,包括数据定 义,服务定义和相关描述
面向设计者的文档的一般结构 (2) 在主题层的 OOA模型 OOA模型的 °各个主题 词典 各种支持细节和定义
OOA模型的 各个主题 各种支持细节和定义 (1) (2) 在主题层的 OOA模型
③这组主题及其基本的细节内容,就可提供 个OOA模型的书面形式。在这种文档的 开头,应当是所有主题的一览表。 ④此外,其他文档,如3M都是很有用的。 附录I,附录J给出利用CASE工具产生的 EcS和SBSS的书面文档的例子