需求用例编写规范

《需求用例编写规范》由会员上传分享，免费在线阅读，更多相关内容在行业资料-天天文库。

1、EBS开发小组需求用例编写规范-V1.0文档编号：文档名称：需求用例编写规范文档类别：设计规范密级：机密版本信息：1.0建立日期：2005-08-26创建人：016审核者：批准人：批准日期：编辑软件：MicrosoftOffice2003中文版EBS开发小组文档修订记录版本编号*变化状态简要说明(变更内容和变更范围)日期变更人批准日期批准人更改请求号V1.0C参考《编写有效用例》2005-08-26016*变化状态：C——创建,M——修改，D——删除文档审批信息序号审批人角色审批日期签字备注EBS开

2、发小组目录1简介11.1文档目的11.2有效范围12梗概12.1用例定义12.2用例格式22.2.1非正式用例22.2.2正式用例33非正式用例33.1用例名33.2自然语言描述体43.3图例说明44正式用例44.1范围44.2级别44.3主执行者44.4项目相关人员和利益44.5前置条件44.6最小保证54.7成功保证54.8触发事件54.9主成功场景54.10扩展场景54.11相关信息64.11.1解释说明64.11.2约束条件74.11.3改进建议75编号76批注77超链接88字体及颜色89如

3、何快速书写需要用例89.1非正式用例8EBS开发小组9.2正式用例910范例10EBS开发小组1简介1.1文档目的本文档中的内容是为了更好的书写与理解需求用例，阅读本文后，达到读者能够书写规范有效的需求用例。如果读者需要立即书写需求用例，则可以直接阅读第9节“如何快速书写需求用例”。本文参考AlistairCockburn编著，王雷、张莉翻译由机械工业出版社出版的《编写有效用例（WritingEffectiveUseCases）》一书，有兴趣的读者可以详细阅读此书。1.2有效范围本文适用于各种软件开

4、发项目的需求分析。2梗概2.1用例定义用例是代表系统中各个项目相关人员之间就系统的行为所达成的契约，用例描述了在不同条件下，系统对某一项目相关人员的请求所作出的响应。如果用用例来记录一个组织的业务过程，那么被讨论的系统是指组织本身，项目相关人员是指公司的股东、客户、供应商和政府管理部门，这种用例称为业务用例，业务用例可以作为软件需求采集时使用；如果用用例来记录一个软件的行为需求，那么被讨论的系统是指计算机程序，项目相关人员是指使用该程序的人、拥有该程序的公司、政府管理部门和其他一些计算机程序，这种用

5、例称为系统用例，系统用例可以作为软件需求分析时使用。用例不是所有的需求，用例不能详细地描述外部接口、数据格式、业务规则和复杂公式，用例只是需要收集的所有需求中的一部分，虽然这一部分是非常重要的一部分，但毕竟仅仅是“一部分”，不能全部反映“需求”。UI需求业务规则数据格式I/O协议性能需求······用例UI设计第12页共16页EBS开发小组1.1用例格式需求用例分为正式用例与非正式用例，非正式用例是用自然语言及图例进行用例描述，正式用例是具有规范格式的用例描述。读者在此不必深究用例如何书写，后续章节

6、中有详细说明。1.1.1非正式用例用例名自然语言描述体图例说明第12页共16页EBS开发小组用例名自然语言描述体图例说明范围：级别：主执行者：项目相关人员和利益：前置条件：最小保证：成功保证：触发事件：主成功场景：1.成功动作描述2.成功动作描述扩展：1.a.场景执行过程中非顺利情况1.a.1.处理动作描述1.b.场景执行过程中非顺利情况1.b.1.处理动作描述相关信息：²解释说明²约束条件²改进建议1.1.1正式用例2非正式用例非正式用例包括三部分：用例名、自然语言描述体、图例说明。2.1用例名用

7、例名就是用例的名称，应是一个主动语态动词短语来表示的用例目标。第12页共16页EBS开发小组1.1自然语言描述体用自然语言描述成功场景和可能会出现的失败场景，及其相应的处理动作，还包括用例所需要的功能操作等。1.2图例说明对于较复杂的需求用例，可以用图表说明用例之间关系，使用例更加清晰明朗。2正式用例正式用列具有格式规范，包括：用例名、自然语言描述体、图例说明、范围、级别、主执行者、项目相关人员和利益、前置条件、最小保证、成功保证、触发事件、主成功场景、扩展场景和相关信息等项目，用例格式并不是硬性规

8、定必须包括这此内容，只是为需求用例编写者提供正式用例编写格式参考，具体项目具体分析，以增减正式用例内容，更好地为需求分析服务；用例名、自然语言描述体、图例说明的编写方法同非正式用例，只是自然语言描述体只阐述不能在主成功场景和扩展场景中描述的部分，不必将场景全部说明。2.1范围范围（scope）用来描述项目开发人员负责的设计工作的边界，以便与应由其他人负责的设计工作或已经完成的设计工作相区别；范围应该是一个简单明确的名词，比如说需求人员正在对“固定资产”项目进行需求分析