UML(Unified Modeling Language)は、システムや業務の構造・振る舞いを図で表現し、業務担当者・企画担当者・開発担当者の認識をそろえるためのモデリング手法です。
テンプレートを使うときに重要なのは、項目を埋めること自体ではありません。何を確認したいのかを決め、目的に合ったUML図を選び、必要な利用者・機能・処理・データ・状態を整理し、複数図を使う場合は図同士の整合まで確認することです。
この記事では、そのままコピーして使えるUMLテンプレート、図の選び方、各欄の書き方、記入済み具体例、良い例・悪い例、注意点までまとめます。
最初に使う共通UMLテンプレート
【対象システム / 業務】
【UMLを作る目的】
【確認したいこと】
【共有相手】
【対象範囲】
【利用者 / アクター】
【主要機能 / ユースケース】
【主要な業務・処理】
【主要データ / クラス候補】
【主要な状態】
【外部システム】
【例外・差し戻し】
【作成するUML図】
【図同士で確認する整合性】
【未決事項】
【レビュー担当】
目的からUML図を選ぶ早見表
| 確認したいこと | 向いている図 | 主な記入対象 |
|---|---|---|
| 誰がどの機能を使うか | ユースケース図 | アクター、ユースケース、関係 |
| 業務や処理の流れ | アクティビティ図 | 開始、アクション、分岐、並列、終了 |
| 処理・メッセージの順序 | シーケンス図 | 登場オブジェクト、メッセージ、順序、例外 |
| データやオブジェクト構造 | クラス図 | クラス、属性、操作、関連、多重度 |
| 状態変化 | ステートマシン図 | 状態、イベント、遷移条件 |
判断基準:「何を見たいか」を一文で説明できれば、使う図を決めやすくなります。すべての図を作る必要はありません。
そのまま使えるユースケース図テンプレート
【対象システム】
【アクター】
・
・
【ユースケース】
・
・
【アクターとユースケースの関係】
・アクターA → ユースケース1
・アクターB → ユースケース2
【include / extend が必要な関係】
【権限・前提条件】
【対象外】
書き方の判断基準
- アクターは「人名」ではなく役割で書く
- ユースケースは利用者が達成したい機能単位で書く
- 内部処理の細部を書きすぎない
- 誰がどの機能を使えるか明確にする
良い例:営業担当→案件登録、上長→案件承認、管理者→レポート確認。
悪い例:佐藤さん→ボタン押下→DB更新、のように人物名と内部処理を混ぜる。
そのまま使えるアクティビティ図テンプレート
【対象プロセス】
【開始条件】
【アクション】
1.
2.
3.
【分岐条件】
・条件A:
・条件B:
【並列処理】
【差し戻し / 例外ルート】
【終了条件】
【担当レーン】
書き方の判断基準
- 開始と終了を先に決める
- アクションは動詞で書く
- 「OK?」ではなく具体的な分岐条件を書く
- 差し戻しや例外を省略しない
良い例:「必須項目がすべて入力済みか」「申請金額が10万円超か」。
悪い例:「問題あり?」「承認できる?」。
そのまま使えるシーケンス図テンプレート
【対象ユースケース】
【登場する利用者 / オブジェクト / システム】
・
・
【正常系メッセージ】
- A → B:
- B → C:
- C → B:
【分岐 / 条件】
【例外 / エラー】
【戻り値 / 結果】
【外部API / 外部システム】
書き方の判断基準
- 上から下へ時系列で並べる
- メッセージ名は処理内容が分かる動詞で書く
- 正常系だけでなく主要な例外も確認する
- ユースケース図の機能と対応しているか見る
そのまま使えるクラス図テンプレート
【クラス名】
【属性】
・
・
【操作】
・
・
【関連するクラス】
【多重度】
・1
・0..1
・1..*
・0..*
【継承 / 集約 / コンポジション】
【業務ルール】
書き方の判断基準
- 業務上の主要概念をクラスとして抽出する
- 属性はそのクラス自身が持つ事実か確認する
- 関連は業務ルールで説明できるようにする
- 多重度を感覚で決めず、0件許容・必須を確認する
記入済み具体例:営業案件管理システム
共通テンプレートの記入例
- 対象:営業案件管理システム
- 目的:利用者・主要機能・承認フロー・データ構造を整理し、要件定義の認識差を減らす
- 共有相手:営業担当、営業マネージャー、企画担当、開発担当
- 利用者:営業担当、上長、管理者
- 主要機能:案件登録、進捗更新、承認依頼、承認、レポート確認
- 主要データ:顧客、案件、担当者、活動履歴、承認履歴
- 主要状態:下書き、申請中、承認済み、失注、受注
ユースケース図の記入例
- 営業担当 → 案件登録
- 営業担当 → 進捗更新
- 営業担当 → 承認依頼
- 上長 → 案件承認
- 管理者 → レポート確認
権限条件:営業担当は自分の案件だけ編集可能。上長は自部門の案件だけ承認可能。
アクティビティ図の記入例
- 営業担当が案件を登録
- 必須項目を確認
- 承認依頼を送信
- 上長が内容を確認
- 承認 / 差し戻しを判断
- 承認なら案件状態を「承認済み」へ更新
- 差し戻しなら理由を記録し営業担当へ戻す
シーケンス図の記入例
- 営業担当 → Web画面:承認依頼
- Web画面 → 案件サービス:承認依頼登録
- 案件サービス → 承認サービス:承認フロー開始
- 承認サービス → 通知サービス:上長へ通知
- 上長 → 承認サービス:承認 / 差し戻し
- 承認サービス → 案件サービス:状態更新
クラス図の記入例
| クラス | 主な属性 | 関係 |
|---|---|---|
| 顧客 | 顧客ID、顧客名 | 顧客1:案件0..* |
| 案件 | 案件ID、案件名、金額、状態 | 案件1:活動履歴0..*、承認履歴0..* |
| 担当者 | 担当者ID、氏名、部門 | 担当者1:案件0..* |
| 承認履歴 | 承認日時、結果、差し戻し理由 | 案件1:承認履歴0..* |
図同士の整合確認
- ユースケース図の「承認」がアクティビティ図・シーケンス図に存在するか
- シーケンス図で更新する案件状態がクラス図にあるか
- 差し戻し理由を保存する属性が承認履歴にあるか
- 営業担当・上長の権限条件が各図で矛盾していないか
良い使い方と悪い使い方
悪い例:図の種類を先に決める
「とりあえずクラス図を描く」と始める。
良い例:確認したいことから図を選ぶ
「誰がどの機能を使うか」ならユースケース図、「処理順序」ならシーケンス図を選びます。
悪い例:1枚にすべて詰め込む
利用者・業務フロー・データ・処理順序を1つの図へ入れ、読みにくくする。
良い例:目的ごとに図を分ける
全体→流れ→処理→構造と役割を分けて整理します。
悪い例:図同士の名称がずれる
ユースケース図では「案件申請」、シーケンス図では「案件登録」と呼ぶ。
良い例:用語を統一する
同じ機能・データ・役割は同じ名称で統一します。
テンプレートを使うときの注意点
- すべてのUML図を作る必要はない
- 対象・目的・共有相手を先に決める
- 企画段階では全体像、設計段階では詳細へ進む
- 例外・差し戻しを省略しない
- 図同士の名称を統一する
- ユースケースと処理・データ構造の対応を確認する
- 業務担当者と開発担当者の両方でレビューする
- 未決事項は図に無理に埋め込まず別管理する
UMLテンプレートのチェックリスト
- 対象システム・目的・範囲が明確か
- 何を確認したいか言語化したか
- 目的に合ったUML図を選んだか
- アクター・ユースケースを整理したか
- 開始・終了・分岐・例外を整理したか
- 処理順序と外部連携を整理したか
- 主要クラス・属性・関係・多重度を整理したか
- 図同士の名称と前提が一致しているか
- 業務担当者・企画担当者・開発担当者でレビューしたか
- 未決事項を残したまま確定扱いしていないか
まとめ
UMLテンプレートでは、対象システム、目的、確認したいこと、利用者、主要機能、処理、データ、状態、例外を共通項目として整理したうえで、必要に応じてユースケース図、アクティビティ図、シーケンス図、クラス図などへ展開します。
実務で使えるテンプレートにするには、項目を埋めるだけでなく、「何を確認したいか→どの図を使うか→各図で何を書くか→図同士が整合しているか」まで一続きで確認できることが重要です。
このテンプレートをそのままコピーし、共通項目→図選択→各図作成→整合確認→関係者レビューの順に進めれば、UMLをシステム企画・業務設計・要件定義の共通言語として使いやすくなります。