编写规格说明书

《编写规格说明书》由会员上传分享，免费在线阅读，更多相关内容在行业资料-天天文库。

1、编写规格说明书　　项目视图和范围文档包含了业务需求，而使用实例文档则包含了用户需求。你必须编写从使用实例派生出的功能需求文档，还要编写产品的非功能需求文档，包括质量属性和外部接口需求。软件需求规格说明阐述一个软件系统必须提供的功能和性能以及它所要考虑的限制条件,它不仅是系统测试和用户文档的基础，也是所有子系列项目规划、设计和编码的基础。它应该尽可能完整地描述系统预期的外部行为和用户可视化行为。除了设计和实现上的限制，软件需求规格说明不应该包括设计、构造、测试或工程管理的细节。　　1）采用软件需求规格说明模版:采用需求规格说明书模板在你的组织中要为编写软件需求文档定义一种标准模板。该模板为记

2、录功能需求和各种其它与需求相关的重要信息提供了统一的结构。注意，其目的并非是创建一种全新的模板，而是采用一种已有的且可满足项目需要并适合项目特点的模板。许多组织一开始都采用IEEE标准830-1998(IEEE1998)描述的需求规格说明书模板。要相信模板是很有用的，但有时要根据项目特点进行适当的改动。 123456A引言目的文档约定预期的读者和阅读建议产品的范围参考文献 B综合描述产品的前景产品的功能用户类和特征运行环境设计和实现上的限制假设和依赖附录C外部接口需求附录用户界面附录硬件接口软件接口通信接口  D系统特性说明和优先级激励/响应序列功能需求   E其它非功能需求性能需求安全设

3、施需求安全性需求软件质量属性业务规则用户文档F其它需求      G附件词汇表分析模型待确定问题的列表   　　　　　　　　a.引言　　　引言提出了对软件需求规格说明的纵览，这有助于读者理解文档如何编写并且如何阅读和解释。　　a.1目的　　　对产品进行定义，在该文档中详尽说明了这个产品的软件需求，包括修正或发行版本号。如果这个软件需求规格说明只与整个系统的一部分有关系，那么就只定义文档中说明的部分或子系统。　　a.2文档约定　　　描述编写文档时所采用的标准或排版约定，包括正文风格、提示区或重要符号。　　a.3预期的读者和阅读建议　　　列举了软件需求规格说明所针对的不同读者，例如开发人员、项

4、目经理、营销人员、用户、测试人员或文档的编写人员。描述了文档中剩余部分的内容及其组织结构。提出了最适合于每一类型读者阅读文档的建议。　　a.4产品的范围　　　提供了对指定的软件及其目的的简短描述，包括利益和目标。把软件与企业目标或业务策略相联系。可以参考项目视图和范围文档而不是将其内容复制到这里。　　a.5参考文献　　　列举了编写软件需求规格说明时所参考的资料或其它资源。这可能包括用户界面风格指导、合同、标准、系统需求规格说明、使用实例文档，或相关产品的软件需求规格说明。　　b.综合描述　　　这一部分概述了正在定义的产品以及它所运行的环境、使用产品的用户和已知的限制、假设和依赖。　　b.1

5、产品的前景　　　描述了软件需求规格说明中所定义的产品的背景和起源。说明了该产品是否是产品系列中的下一成员，是否是成熟产品所改进的下一代产品、是否是现有应用程序的替代品，或者是否是一个新型的、自含型产品。　　b.2产品的功能　　　概述了产品所具有的主要功能。其详细内容将在d中描述，所以在此只需要概略地总结。很好地组织产品的功能，使每个读者都易于理解。　　b.3用户类和特征确定你觉得可能使用该产品的不同用户类并描述它们相关的特征。有一些需求可能只与特定的用户类相关。　　b.4运行环境　　　描述了软件的运行环境，包括硬件平台、操作系统和版本，还有其它的软件组件或与其共存的应用程序。　　b.5设计

6、和实现上的限制　　　确定影响开发人员自由选择的问题，并说明这些问题为什么成为一种限制。　　b.6假设和依赖　　　列举出在对软件需求规格说明中影响需求陈述的假设因素（与已知因素相对立）。这可能包括你打算要用的商业组件或有关开发或运行环境的问题。你可能认为产品将符合一个特殊的用户界面设计约定，但是另一个SRS读者却可能不这样认为。如果这些假设不正确、不一致或被更改，就会使项目受到影响。　　此外，确定项目对外部因素存在的依赖。例如，如果你打算把其它项目开发的组件集成到系统中，那么你就要依赖那个项目按时提供正确的操作组件。如果这些依赖已经记录到其它文档(例如项目计划)中了，那么在此就可以参考其它文

7、档。　　c.外部接口需求　　　利用本节来确定可以保证新产品与外部组件正确连接的需求。关联图表示了高层抽象的外部接。需要把对接口数据和控制组件的详细描述写入数据字典中。如果产品的不同部分有不同的外部接口，那么应把这些外部接口的详细需求并入到这一部分的实例中。　　c.1用户界面　　　陈述所需要的用户界面的软件组件。描述每个用户界面的逻辑特征。而对于用户界面的细节，例如特定对话框的布局，应该写入一个独立的用户界面规格说明中，而