用例建模是什么:定义、组成与边界

用例建模是一种从使用者视角描述系统需求的方法:它把系统视为一个整体,围绕外部参与者与系统交互、达成某个可观察目标的过程,用用例及其场景表达“谁在什么条件下做什么、系统应给出什么结果”。本文说明用例建模的定义、组成要素、覆盖范围与边界,并用一个具体例子对照常见误解。




要点总览(TL;DR)


  • 用例建模从参与者视角描述系统需求:识别参与者、划定系统边界、按可观察目标划分用例,并组织主成功场景与异常场景。
  • 用例建模的产出是需求表示,覆盖参与者、用例、场景与用例关系;系统架构、界面布局、需求价值判断与优先级取舍不在其范围内。
  • 用例粒度以参与者一次完整交互获得可观察结果为准,界面操作步骤应写进场景,而不是拆成独立用例。
  • 用例建模与用户故事、流程图、功能清单各有分工:用户故事适合需求收集与排期,用例把目标与场景写透,流程图描述步骤流转,功能清单盘点能力项。
  • 常见误解包括把界面操作当用例、把用例当测试用例、追求用例数量;纠正时回到参与者是谁、要达成什么可观察结果两个问题。


用例建模的准确定义


用例建模(Use Case Modeling)是以参与者与系统交互达成目标的过程来描述需求的一种建模方法。它关注的不是系统内部由哪些模块构成,而是系统对外表现出什么行为、为谁服务、在什么条件下给出什么结果。用例建模的产出是需求表示,用于在需求阶段与利益相关方沟通和确认系统应当做什么,它本身不是设计文档,也不规定实现方式。


理解这个定义,需要先厘清三个术语:


  • 用例(use case):指一个完整的、以参与者目标为导向的交互过程,从触发开始到目标达成或明确失败为止。它不等于单个功能点,也不等于一次界面操作。例如“提交报销单”是一个用例,而“点击保存按钮”只是该用例过程中的一个步骤。
  • 参与者(actor):指与系统交互的外部角色或外部系统。参与者可以是人(如报销人、审批人),也可以是其他系统(如财务系统)。参与者位于系统边界之外,代表的是角色而非某个具体的人。
  • 场景(scenario):指用例的一次具体执行路径。一个用例通常包含一条主成功场景和多条备选或异常场景,它们共同构成对该用例的完整描述。

因此,用例建模可以概括为:识别参与者、划定系统边界、划分用例、组织场景,并把这些内容写成可评审、可追溯的需求描述。它回答的是“系统为谁达成什么目标”,而不是“系统内部如何实现这个目标”。



用例建模包括什么、不包括什么


用例建模有明确的工作范围。把它与相邻工作区分开,能避免在需求文档里混入设计内容,也能避免把本该由需求分析承担的价值判断误当作建模任务。下面的清单按“包括”和“不包括”两类列出边界。


类别 内容 说明
包括 参与者识别 找出所有与系统交互的外部角色和外部系统,明确各自的目标
包括 用例划分 按参与者可获得的可观察结果划分用例,确定系统边界内外的职责
包括 主成功场景与异常场景 描述目标顺利达成的主路径,以及条件不满足、失败、中断等分支
包括 用例之间的关系 用包含、扩展、泛化等关系表达用例之间的复用与变化
包括 用例与需求条目的追溯 把每个用例关联到具体的需求条目,便于评审、变更影响分析和验收对照
不包括 系统内部架构与模块划分 分层、组件、接口设计属于设计阶段的工作
不包括 界面布局与交互视觉稿 页面结构、控件摆放、视觉规范属于交互与视觉设计
不包括 需求价值判断与优先级取舍 某个需求是否值得做、先做哪个,属于需求分析与决策
不包括 需求澄清结论 与业务方确认口径、消除歧义的过程属于需求澄清,建模以其结论为输入

需要说明的是,边界清单划的是职责归属,不是禁止事项。用例描述中可以出现必要的业务规则和数据约束,因为这些是判断场景是否达成的条件;但不应展开到数据库表结构或类设计。同样,用例建模可以为优先级讨论提供素材,但优先级结论本身来自需求分析与取舍,建模阶段只负责把需求表达清楚。



用例建模的组成与运作机制


一份可评审的用例描述,是参与者、系统边界、用例、场景和用例关系共同配合的结果。下面按建模的实际推进顺序说明各组成部分如何运作。


确定参与者与系统边界


先找出所有与系统交互的外部角色和外部系统,再据此划定系统边界。判断标准是:谁使用系统、谁从系统获取结果、谁向系统提供输入、哪些外部系统需要与系统交换信息。边界一旦确定,边界之内是需要建模的系统职责,边界之外是参与者或外部系统。参与者按角色命名,同一角色可以有多个具体用户,不同角色即使由同一人兼任也应分别列出。


判断用例粒度


用例粒度的核心标准是:一个参与者通过一次完整的交互获得一个可观察的结果,构成一个用例。粒度太细会把界面操作拆成用例,导致用例数量膨胀且失去目标感;粒度太粗会把多个目标混在一个用例里,使场景描述难以评审。实践中可以用“参与者做完这件事后,能否向他人描述一个明确的结果”来检验粒度是否合适。


组织主成功场景与备选、异常场景


每个用例先写主成功场景,即一切条件正常时从触发到目标达成的步骤序列;再补充备选场景和异常场景,覆盖条件不满足、输入有误、外部系统不可用、参与者中途取消等情况。场景描述应写清每一步由谁发起、系统做出什么响应、在什么条件下进入哪个分支。主成功场景保持简洁,异常场景按触发条件单独列出,避免把所有分支混写成一条长流程。


使用包含、扩展与泛化关系


用例关系用于表达复用与变化:包含关系表示某个用例必然执行另一段公共行为;扩展关系表示在特定条件下插入一段可选行为;泛化关系表示一个用例是另一个用例的特化形式。这些关系的常见误用是把它们当作功能拆分的工具,把本应写在一个用例里的步骤拆成多个小用例再用包含关系拼接,结果反而增加了阅读成本。关系应当服务于表达清晰,能用一个用例说清的内容不必强行拆分。


建立追溯并组织评审


用例写完后,需要把每个用例与需求条目建立追溯关系:一个用例可能对应一条或多条需求,一条需求也可能由多个用例共同支撑。追溯关系让评审有据可依,也让后续的需求变更能够定位到受影响的用例和场景。评审时按用例逐个确认参与者、目标、主成功场景和关键异常场景是否完整、口径是否一致,评审结论回写到需求条目上,形成从用例到需求、再到评审结论的流转。


在需求条目数量较多、参与方较多的项目中,用例与需求条目的追溯、评审流转往往需要工具承载。ONES 的需求管理能力支持将需求条目与用例描述关联管理,并在评审环节记录结论与状态,使建模产出与需求条目保持同步,便于变更时定位影响范围。这一衔接服务于需求表示与评审,不改变用例建模本身的方法。


一份用例描述可以采用如下结构骨架:


  • 用例名称:以参与者目标命名,如“提交报销单”
  • 参与者:主要参与者与辅助参与者
  • 触发条件:什么情况下开始这个用例
  • 前置条件:开始前系统应满足的状态
  • 主成功场景:编号步骤,写清参与者动作与系统响应
  • 备选与异常场景:按触发条件分列,标明分支去向
  • 后置条件:目标达成后系统的状态
  • 关联需求条目:追溯到的需求编号与评审记录


用例建模与用户故事、流程图、功能清单的区别


用例建模常与几个相邻概念一起出现,混用会导致需求表达的粒度与完整性失控。下面的对照表按同一口径比较它们在描述对象、粒度、场景覆盖和主要用途上的差异。


概念 描述对象 粒度 场景覆盖 主要用途
用例建模 参与者与系统交互达成目标的过程 一个完整目标为一个用例 主成功场景加备选、异常场景,覆盖较完整 需求表示与评审,明确系统对外行为
用户故事 以简短句式表达的用户需求 较小,通常作为待细化的需求单元 本身不含完整场景,细节在后续讨论中补充 需求收集与排期,强调对话与迭代
流程图 步骤之间的流转与判断分支 按流程节点划分 描述路径,不区分系统职责与参与者目标 说明业务或操作流程如何流转
功能清单 系统具备的能力项 按功能点罗列 通常不描述场景 范围盘点与工作量估算

与用户故事相比,用例建模的粒度更大、场景更完整:用户故事适合作为需求收集和排期的单元,用例适合在需求明确后把目标与场景写透。两者可以配合使用,由用户故事引出需求,再用用例补充完整场景。与流程图相比,流程图描述步骤如何流转,用例描述参与者要达成什么目标以及系统承担什么职责,同一个用例的场景可以用流程图辅助表达,但流程图本身不替代用例对目标的界定。与功能清单相比,功能清单列出系统有哪些能力,用例强调谁在什么条件下使用这些能力达成目标,功能清单容易遗漏参与者视角,用例则把参与者放在描述的中心。


此外还需区分业务用例与系统用例两个层次:业务用例描述业务活动如何为业务参与者创造价值,范围覆盖人工与系统协作的完整业务过程;系统用例描述某个系统为参与者提供什么行为,范围限定在系统边界之内。两者可以逐层细化,业务用例中的系统职责部分通常对应一个或多个系统用例。



一个具体例子与常见误解


下面以“提交报销单”为例,示范用例建模的写法,并对照说明哪些内容属于建模、哪些属于后续设计。


示例:提交报销单


  • 参与者:报销人(主要参与者)、审批人(辅助参与者)、财务系统(外部系统)。
  • 前置条件:报销人已登录系统,且存在可报销的费用记录。
  • 主成功场景:报销人选择费用记录并填写报销单;系统校验必填项与金额;报销人提交报销单;系统生成报销单编号并流转至审批人;审批人确认通过;系统将结果同步至财务系统;系统通知报销人提交成功。
  • 异常场景:提交时财务系统不可用,系统保留报销单为待同步状态并提示报销人,待外部系统恢复后重试同步;若重试仍失败,转人工处理并记录。
  • 后置条件:报销单处于已提交或待同步状态,审批记录可查。

在这个例子里,参与者识别、目标界定、主成功场景与异常场景的划分、系统与外部系统的职责边界,都属于用例建模的内容。而报销单在数据库中如何存储、审批流转采用什么技术实现、提交页面的按钮如何布局,属于后续的设计与交互工作,不应写进用例描述。


常见误解与纠正


  • 把界面操作步骤当用例:将“点击新增”“填写表单”“点击提交”逐条列为用例,会让用例退化为操作说明,丢失参与者目标。纠正方向是按参与者可获得的结果划分用例,把界面操作收进场景步骤。
  • 把用例当测试用例:用例描述系统应达成的目标与场景,测试用例则针对具体输入和预期输出设计验证步骤。两者可以相互对照,但用例不承担测试设计的职责,也不应写成断言式的验证条目。
  • 用例越多越完整:为追求覆盖而把每个分支拆成独立用例,会导致用例数量膨胀、关系复杂、评审困难。纠正方向是控制用例数量,把变化放在场景和扩展关系中表达,保持每个用例对应一个清晰目标。

这些误解的共同后果是需求描述偏离目标:读者看到的是操作步骤或功能碎片,难以判断系统是否真正满足了参与者的需要。纠正时回到两个基本问题即可——这个用例的参与者是谁,他要达成的可观察结果是什么。围绕这两个问题组织场景,用例建模就能保持作为需求表示方法的准确性。



常见问题


用例建模应该在需求流程的哪个阶段做,和需求澄清怎么衔接?


用例建模通常安排在需求方向基本明确之后、进入设计与开发之前。它的输入是需求澄清的结论,包括业务口径、范围约定和关键业务规则;输出是可评审的用例描述与需求条目追溯关系。如果需求本身还存在歧义,先做澄清再建模,否则用例里的场景会建立在不确定的前提上,评审时容易反复返工。


两者也可以交替推进:建模过程中发现的口径问题,回退到澄清环节确认,确认后再补进用例描述。


一个系统要写多少个用例才算合适?


用例数量没有统一标准,判断依据是参与者目标是否被完整覆盖,而不是数量多少。可以按参与者逐一检查:每个参与者有哪些需要系统支持的可观察目标,每个目标对应一个用例。如果两个用例的参与者相同、目标相同,只是条件不同,应合并为一个用例并用备选或异常场景表达差异。


用例数量明显偏多时,通常是把界面操作或功能点拆成了用例,需要回到目标层面重新归并。


用例描述里可以写业务规则和数据字段吗?


可以写判断场景是否达成所必需的业务规则,例如金额上限、审批层级、必填条件,这些是场景分支的依据。数据字段可以写到理解场景所需的程度,例如报销单需要哪些信息才能提交。


不宜展开的是实现层面的内容,例如数据库表结构、字段类型长度、接口协议。区分标准是:这条信息用于判断系统对外行为是否正确,还是用于指导内部如何实现。前者属于用例建模,后者属于设计。


团队已经在用用户故事,还需要补用例建模吗?


取决于需求的风险与复杂度。用户故事简短、便于收集和排期,适合需求尚在讨论、细节待补充的阶段。当某个需求涉及多个参与者、多条异常路径,或者需要与外部系统交互、验收标准较复杂时,用用例把主成功场景和异常场景写完整,可以减少开发与测试阶段的理解偏差。


常见做法是用户故事作为需求单元,对其中复杂的故事补充用例描述,两者通过需求条目关联,不必对所有故事都写用例。


用例和测试用例之间是什么关系?


用例描述系统为参与者达成目标应表现出的行为,包括主成功场景和异常场景;测试用例针对具体输入与预期输出设计验证步骤。两者可以对照使用:用例中的每条场景路径,通常可以派生出若干测试用例来验证。


用例本身不承担测试设计职责,不应写成断言式的验证条目;测试用例也不必逐条复述用例背景。保持两者通过需求条目追溯关联,变更时更容易判断哪些测试需要同步调整。

animation hi
animation dot left
animation dot right
animation dot right bottom
avatar circle
WeChat QR Code
长按将二维码保存为图片

售前电话

400-188-1518

文章配图预览