目次
ユースケース記述とは
ユースケース記述は、システムがユーザー（アクター）の要求に対してどのように振る舞うかを、文章で具体的に表現した仕様書です。主な目的は、開発者やデザイナー、そして顧客の間で、システムの機能やゴールに関する共通認識を持つことにあります。記述内には、標準的な操作の流れである「基本フロー」だけでなく、エラーや例外に対応する「代替フロー」や「例外フロー」も網羅して記載します。これによりシステムの具体的な利用シーンが明確になり、開発工程における要件定義の漏れや誤解を防ぐことができます。図で表した「ユースケース図」と組み合わせることで、システムの全体像と詳細な挙動の両方を直感的に理解できるようになります。
本ページではユースケース記述のExcelテンプレートと記入例を紹介します。
入力フォーマット例
スクロールできます
| No. | x | ユースケースの名前を入力します | |
|---|---|---|---|
| 追加／変更日 | |||
| 概要 | ユースケースの概要を記載します。 | ||
| アクター | ユースケースに関係するアクターをリストアップして記載します。 | ||
| 開始条件 | ユースケースを開始する条件を記載します。 | ||
| 事前条件 | ユースケースが開始する前に満たされているべき条件を記載します。 | ||
| フ ロ ｜ | 基本 | 1 | ユースケースの実行に伴って起きる、アクターとシステムとのやりとりのうち、正常に処理が進んだ場合の手順を記載します。 |
| 代替 | Ax | イベントフローのうち、途中でシステムがエラーを発生した場合などに分岐する、基本フローの代わりとしてはたらく手順を記載します。 ※「Ax」の「x」には、基本フローの番号を入れ、どの段階からの分岐であるかを示します。 ※代替フローを実行する場合、事後条件は満たされます。 | |
| 例外 | Ex | イベントフローのうち、ユースケースの実行を断念しなければならないような場合の手順を記載します。 ※「Ex」の「x」には、基本フローの番号を入れ、どの段階からの分岐であるかを示します。 ※例外フローを実行する場合、事後条件は満たされません。 | |
| 事後条件 | ユースケースが実行された後に満たされているべき条件を記載します。 | ||
| 備考 | 補足や解説など、その他何を記載しても構いません。 | ||
ユースケース記述を書く際の注意点
- アクターの「主語」とシステムの「振る舞い」を明確に書き分けてください。
「〜する」だけでなく、「ユーザーが〜を入力する」「システムが〜を表示する」と主語を明示してください。 - UI（画面デザイン）に依存した表現を避けてください。
「OKボタンをクリックする」「赤色でエラーを表示する」ではなく、「入力を確定する」「エラーメッセージを表示する」と記述します。画面デザインの変更に左右されない、本質的なロジックに集中するためです。 - 正常系（基本フロー）の処理をシンプルに保ち、例外はすべて代替フローに逃がします。
基本フローに条件分岐を記載すると、基本の処理フローが見えなくなります。 - システムの内部処理を細かく書きすぎてはいけません。
ユースケース記述は外部から見たシステムの振る舞いを定義すべきものです。 - アクターの目的が達成される単位で切り出します。
「ログインする」「パスワードを入力する」といった細かな操作単位ではなく、「商品を購入する」「アカウントを登録する」といった、ユーザーが価値を得られるひとまとまりの「目的」の単位で1つのユースケースを作成します。
記述例
スクロールできます
| No. | 例 | ホテルの客室を予約する | |
|---|---|---|---|
| 追加／変更日 | 2000年1月1日 | ||
| 概要 | 旅行者が希望する部屋とプランを選択し、決済を完了させて予約を確定します。 | ||
| アクター | 旅行者 | ||
| 開始条件 | 予約手続きに入ります。 | ||
| 事前条件 | 旅行者がログインしており、特定の部屋とプランを選択済みであること。 | ||
| フ ロ ｜ | 基本 | 1 | 旅行者は予約内容を確認し、決済方法としてクレジットカード決済を選択して予約を確定します。 |
| 2 | システムは選択された部屋の空室状況を確認し、ロックします。 | ||
| 3 | システムは登録されたクレジットカードで与信決済処理をします。 | ||
| 4 | システムは予約完了画面を表示し、予約確認メールを送信します。 | ||
| 代替 | A1 | 現地決済の選択 | |
| 1,旅行者は決済方法として「現地払い」を選択して予約を確定します。 | |||
| 2.システムは選択された部屋の空室状況を確認し、ロックします。 | |||
| 3.システムは決済処理をスキップし、基本フローの手順4に進みます。 | |||
| 例外 | E2 | タッチの差で満室 | |
| 1.他ユーザーがすでに部屋を予約していた場合、システムは「ご希望の部屋は満室になりました」とエラーを表示し、予約を中断して部屋選択画面に戻ります。 | |||
| E3 | クレジットカード決済エラー | ||
| 1.クレジットカードの有効期限切れや限度額オーバーが発生した場合、システムはエラーを表示し、予約を確定せずに基本フローの手順1に戻ります。 | |||
| 事後条件 | 部屋を確保（ロック）し、予約完了メールが送信されます。 | ||
| 備考 | |||
Excelファイルダウンロード
ユースケース記述テンプレートのExcelファイルデータです。
ZIP形式で圧縮してあり、解凍するとxlsx形式のExcelファイルが現れます。
個人・商用利用を問いませんので、ダウンロードしてご自由に使用してください。
ファイル名：GN0014-00.zip
ファイル容量：16.2KB
コメント