`
baichuan
  • 浏览: 7187 次
  • 性别: Icon_minigender_1
  • 来自: 深圳
社区版块
存档分类
最新评论

需求用例文档编写建议 --事件流程(基本流程和扩展流程)部分

阅读更多
  每个用例表示用户为实现某个目标与系统的一次交互,而事件流程则是对实现该目标的描述,事件流程包括基本流程(又称为主成功流程)和可选流程(又称为扩展流程);对这部分的编写应该清晰的描述不同的对象(用户、系统)完成目标的活动序列,例如,像这种方式:球员甲将球传给球员乙,球员乙运球,球员乙将球传给球员丙。
编写一个良好的事件流程有以下准则:

准则一:使用简单语法
主语+谓语+宾语,例如: “系统从帐户余额扣除一定数量金额“,简单的语句与用户沟通起来对需求的理解会更准确。

准则二:明确写出“谁控制球”(比喻)
控球的执行者会做下列事情:自己运球或将球传给别人,在步骤结束时要问问“把球给谁了”。

准则三:从系统外部的角度来编写用例
始终站在用户的角度来编写,而不是系统的角度,例如,不要出现这样的描述“系统读取卡号和密码,并从帐号余额中扣除一定的金额”,而要从系统外部的角度来编写,如:
1)用户输入ATM卡并输入密码
2)系统从帐号余额中扣除一定的金额

准则四:描述过程向前推进
每一个步骤都要离目标更进一步,步骤不要太细,也不能太粗,一般对基本流程3-10步是合适的,过多则会使用例文档显得太长。

准则五:描述执行者的意图而不是动作
编写用例常见的问题就是在操作界面来描述,这应该需要避免,例如:
用例1
1) 系统要求用户输入名字;
2) 用户输入名字;
3) 系统要求用户输入地址;
4) 用户输入地址;
5) 用户点击“确认”
6) 系统显示用户简介
修改后:
1) 用户输入名字和地址
2) 系统显示用户简介
虽然在操作界面进行描述能很精确的定义需求,但过多关注细节会花费大量的精力,同时文档也会变得很长,难以维护。

准则六:包含“合理”的活动集
对场景的描述可以把每个部分作为一个单独的执行步骤,也可以以不同的方式合并其中的几个部分,如何分隔要尽量按“是否合理”进行。一个常用的步骤模板如下:
1) 用户向系统发送请求数据
2) 系统验证请求
3) 系统更新内部状态
4) 系统显示成功处理结果
任何用例流程的描述,都可以在上述基础上进行适当的扩展完成。

准则七:“确认”而不是“检查与否”
描述中不要出现“如果”字句,例如
2) 系统检查密码是否正确
3) 如果密码正确,系统显示主页面
要修改为:
2) 系统确认密码正确
3) 系统显示主页面
对于密码错误的流程,则放到可选流程中处理

准则八:习惯描述“循环执行步骤X到Y,直到条件满足”
例如“用户重复步骤3-4,直到完成选购”

准则九:对于可选流程,格式如下:
如准则七的中的例子
2a:无效密码:
1)系统显示登陆失败页面
2b:用户没有响应(超时)
1)系统自动关闭该页面

参考资料:
《编写有效用例》
分享到:
评论

相关推荐

    用例文档.docx

    编写目的部分会介绍用例文档的编写目的和用途,而背景部分则会介绍系统的背景信息和开发目的。内容概述部分将对用例文档的结构和内容进行概述。 背景及内容概述 背景部分会介绍系统的开发背景和目的。例如,在本例...

    需求用例编写详细规范

    【需求用例编写详细规范】 1. 简介 1.1 文档目的 本规范旨在为EBS(Enterprise Business System)开发小组提供一套详细的需求用例编写指南,确保需求能够清晰、完整且准确地传达给所有项目参与者。通过遵循此规范...

    用例文档模板(用户需求文档)

    《用例文档模板详解》 在软件开发过程中,用例文档是记录...编写高质量的用例文档能够帮助团队准确理解用户需求,减少误解和沟通成本,提高软件质量。因此,对用例文档模板的熟练掌握是软件开发过程中不可或缺的一环。

    用例文档编写指南

    三、用例文档编写步骤 1. **确定参与者**:识别与系统交互的所有角色。 2. **识别用例**:观察参与者的需求,列出系统应提供的功能。 3. **绘制用例图**:根据用例和参与者创建图形表示。 4. **编写用例描述**:...

    需求--编写有效的用例

    首先,需求用例是一种详细描述系统或产品如何响应特定事件或输入的文档,它是用户需求的直接反映。编写有效用例的关键在于确保它们全面、准确、无歧义。以下是一些核心要点: 1. **明确的参与者(Actor)**:用例应...

    用例模板:”提交订单“用例文档示例.docx

    用例文档,作为用例建模的核心部分,详尽地记录了用户与系统间的交互流程,为系统设计和开发提供了清晰的指南。本文将深入探讨“提交订单”这一具体用例的文档内容,以期提供一种理解和编写用例文档的实例。 用例...

    软件用例编写说明文档

    ### 软件用例编写说明文档 #### 一、什么是用例? 用例(Use Case)是指系统的一种行为模式,即系统与外部参与者(Actor)之间的交互过程,该过程产生了对参与者有价值的可观察结果。它是系统分析设计的重要组成...

    用例文档.zip

    1. 明确需求:用例文档通过具体的用户操作流程,帮助团队理解和记录用户的需求,避免在开发过程中出现需求不清晰的问题。 2. 设计指导:用例文档为系统设计提供依据,设计师可以根据用例来设计界面布局和交互流程。...

    17-用例(UC)文档模板.zip

    6. **扩展流程(异常或辅助场景)**:当基本流程不能顺利完成时,描述可能发生的分支情况及处理方法,如错误处理、异常恢复等。 7. **业务规则**:约束或指导用例执行的规则,确保业务流程的正确性。 8. **交互图*...

    用例编写模——项目管理

    - 事件流:描述用例的主要流程(基本流)和异常情况(备选流),包括Actor与系统的交互、信息传递和可能的分支。 - 非功能需求:描述与用例相关的性能、安全、兼容性等非功能性需求,确保可度量和验证。 - 前置...

    软件需求和用例编写指南

    本文将深入探讨软件需求和用例的编写,旨在帮助读者更好地理解和掌握这两个关键概念。 首先,我们要明确需求的基本定义。需求是定义系统需要做什么,而不是如何实现这些功能。它涉及到软件系统的目的,即系统存在的...

    3-接口自动化测试规划+执行excel用例-V8.3-20210117.pdf

    通过这些知识点的学习,可以帮助开发人员和测试工程师更好地理解和实施接口自动化测试流程,提高测试效率并确保软件质量。 ### 扩展阅读 - **MD5算法**: 进一步了解MD5算法的工作原理及其应用场景。 - **Requests库...

    用例文档书写案例[word]

    用例文档的编写需要明确地表达出系统各个功能的使用场景和流程,同时要确保覆盖所有关键角色、操作步骤、异常情况及业务规则。通过对零件销售系统用例文档的编写案例分析,开发人员可以参考这些结构和内容来创建自己...

    用例分析技术-一个实例来讲解过程

    3. **细化用例**:编写用例描述,包括主成功场景和可能的扩展场景。 4. **绘制用例图**:用图形方式表示参与者和用例之间的关系,帮助理解系统整体架构。 5. **用例关系**:包括扩展(Extends)、包含(Includes)...

    需求分析用例模板

    在实际应用中,可以使用各种工具来创建和管理这些用例,例如Microsoft Word(如提供的“需求分析用例模板.doc”可能就是这样一个文档模板),或者专门的需求管理工具,如JIRA、Confluence等。这些工具可以帮助组织和...

    软件体系结构实验(UML):类图,用例图,用例文档,需求模型检查矩阵

    本实验重点在于理解并应用UML中的关键概念,包括类图、用例图、用例文档以及需求模型检查矩阵,这些都是软件体系结构设计的重要组成部分。 首先,我们来探讨类图。类图是UML中描述类和它们之间关系的图形表示。它...

    用例文档~1.2.pdf

    《用例文档~1.2》是一份详细记录软件或系统功能需求的文档,由韩尚佑、陆怡平、沈茹和申慧超共同编撰,并经过多次修订完善。这份文档是项目开发过程中的重要参考资料,用于确保开发团队理解和实现用户的需求。 1. *...

    国际软件设计文档---流程面

    在软件开发过程中,设计文档是至关重要的组成部分,它详尽地描述了软件系统的设计思路、架构和实现细节,为开发团队提供清晰的工作指南。本文将深入探讨“国际软件设计文档”中的“流程面”,主要围绕以下几个核心...

    用例建模的PDF, 比较详细,易于理解.

    - **描述用例**:编写简短的用例描述,包括基本流程、备选流程和异常流程。 - **绘制用例图**:用UML(统一建模语言)表示用例模型,包括参与者、用例和它们之间的关系。 - **细化用例**:编写更详细的用例规范,...

Global site tag (gtag.js) - Google Analytics