MENU

UMLテンプレート|そのまま使える項目例と書き方

UML(Unified Modeling Language)は、システムや業務の構造・振る舞いを図で表現し、業務担当者・企画担当者・開発担当者の認識をそろえるためのモデリング手法です。

テンプレートを使うときに重要なのは、項目を埋めること自体ではありません。何を確認したいのかを決め、目的に合ったUML図を選び、必要な利用者・機能・処理・データ・状態を整理し、複数図を使う場合は図同士の整合まで確認することです。

この記事では、そのままコピーして使えるUMLテンプレート、図の選び方、各欄の書き方、記入済み具体例、良い例・悪い例、注意点までまとめます。

目次

最初に使う共通UMLテンプレート

【対象システム / 業務】

【UMLを作る目的】

【確認したいこと】

【共有相手】

【対象範囲】

【利用者 / アクター】

【主要機能 / ユースケース】

【主要な業務・処理】

【主要データ / クラス候補】

【主要な状態】

【外部システム】

【例外・差し戻し】

【作成するUML図】

【図同士で確認する整合性】

【未決事項】

【レビュー担当】

目的からUML図を選ぶ早見表

確認したいこと 向いている図 主な記入対象
誰がどの機能を使うか ユースケース図 アクター、ユースケース、関係
業務や処理の流れ アクティビティ図 開始、アクション、分岐、並列、終了
処理・メッセージの順序 シーケンス図 登場オブジェクト、メッセージ、順序、例外
データやオブジェクト構造 クラス図 クラス、属性、操作、関連、多重度
状態変化 ステートマシン図 状態、イベント、遷移条件

判断基準:「何を見たいか」を一文で説明できれば、使う図を決めやすくなります。すべての図を作る必要はありません。

そのまま使えるユースケース図テンプレート

【対象システム】

【アクター】
・
・

【ユースケース】
・
・

【アクターとユースケースの関係】
・アクターA → ユースケース1
・アクターB → ユースケース2

【include / extend が必要な関係】

【権限・前提条件】

【対象外】

書き方の判断基準

  • アクターは「人名」ではなく役割で書く
  • ユースケースは利用者が達成したい機能単位で書く
  • 内部処理の細部を書きすぎない
  • 誰がどの機能を使えるか明確にする

良い例:営業担当→案件登録、上長→案件承認、管理者→レポート確認。

悪い例:佐藤さん→ボタン押下→DB更新、のように人物名と内部処理を混ぜる。

そのまま使えるアクティビティ図テンプレート

【対象プロセス】

【開始条件】

【アクション】
1.
2.
3.

【分岐条件】
・条件A:
・条件B:

【並列処理】

【差し戻し / 例外ルート】

【終了条件】

【担当レーン】

書き方の判断基準

  • 開始と終了を先に決める
  • アクションは動詞で書く
  • 「OK?」ではなく具体的な分岐条件を書く
  • 差し戻しや例外を省略しない

良い例:「必須項目がすべて入力済みか」「申請金額が10万円超か」。

悪い例:「問題あり?」「承認できる?」。

そのまま使えるシーケンス図テンプレート

【対象ユースケース】

【登場する利用者 / オブジェクト / システム】
・
・

【正常系メッセージ】
  1. A → B:
  2. B → C:
  3. C → B:
【分岐 / 条件】 【例外 / エラー】 【戻り値 / 結果】 【外部API / 外部システム】

書き方の判断基準

  • 上から下へ時系列で並べる
  • メッセージ名は処理内容が分かる動詞で書く
  • 正常系だけでなく主要な例外も確認する
  • ユースケース図の機能と対応しているか見る

そのまま使えるクラス図テンプレート

【クラス名】

【属性】
・
・

【操作】
・
・

【関連するクラス】

【多重度】
・1
・0..1
・1..*
・0..*

【継承 / 集約 / コンポジション】

【業務ルール】

書き方の判断基準

  • 業務上の主要概念をクラスとして抽出する
  • 属性はそのクラス自身が持つ事実か確認する
  • 関連は業務ルールで説明できるようにする
  • 多重度を感覚で決めず、0件許容・必須を確認する

記入済み具体例:営業案件管理システム

共通テンプレートの記入例

  • 対象:営業案件管理システム
  • 目的:利用者・主要機能・承認フロー・データ構造を整理し、要件定義の認識差を減らす
  • 共有相手:営業担当、営業マネージャー、企画担当、開発担当
  • 利用者:営業担当、上長、管理者
  • 主要機能:案件登録、進捗更新、承認依頼、承認、レポート確認
  • 主要データ:顧客、案件、担当者、活動履歴、承認履歴
  • 主要状態:下書き、申請中、承認済み、失注、受注

ユースケース図の記入例

  • 営業担当 → 案件登録
  • 営業担当 → 進捗更新
  • 営業担当 → 承認依頼
  • 上長 → 案件承認
  • 管理者 → レポート確認

権限条件:営業担当は自分の案件だけ編集可能。上長は自部門の案件だけ承認可能。

アクティビティ図の記入例

  1. 営業担当が案件を登録
  2. 必須項目を確認
  3. 承認依頼を送信
  4. 上長が内容を確認
  5. 承認 / 差し戻しを判断
  6. 承認なら案件状態を「承認済み」へ更新
  7. 差し戻しなら理由を記録し営業担当へ戻す

シーケンス図の記入例

  1. 営業担当 → Web画面:承認依頼
  2. Web画面 → 案件サービス:承認依頼登録
  3. 案件サービス → 承認サービス:承認フロー開始
  4. 承認サービス → 通知サービス:上長へ通知
  5. 上長 → 承認サービス:承認 / 差し戻し
  6. 承認サービス → 案件サービス:状態更新

クラス図の記入例

クラス 主な属性 関係
顧客 顧客ID、顧客名 顧客1:案件0..*
案件 案件ID、案件名、金額、状態 案件1:活動履歴0..*、承認履歴0..*
担当者 担当者ID、氏名、部門 担当者1:案件0..*
承認履歴 承認日時、結果、差し戻し理由 案件1:承認履歴0..*

図同士の整合確認

  • ユースケース図の「承認」がアクティビティ図・シーケンス図に存在するか
  • シーケンス図で更新する案件状態がクラス図にあるか
  • 差し戻し理由を保存する属性が承認履歴にあるか
  • 営業担当・上長の権限条件が各図で矛盾していないか

良い使い方と悪い使い方

悪い例:図の種類を先に決める

「とりあえずクラス図を描く」と始める。

良い例:確認したいことから図を選ぶ

「誰がどの機能を使うか」ならユースケース図、「処理順序」ならシーケンス図を選びます。

悪い例:1枚にすべて詰め込む

利用者・業務フロー・データ・処理順序を1つの図へ入れ、読みにくくする。

良い例:目的ごとに図を分ける

全体→流れ→処理→構造と役割を分けて整理します。

悪い例:図同士の名称がずれる

ユースケース図では「案件申請」、シーケンス図では「案件登録」と呼ぶ。

良い例:用語を統一する

同じ機能・データ・役割は同じ名称で統一します。

テンプレートを使うときの注意点

  • すべてのUML図を作る必要はない
  • 対象・目的・共有相手を先に決める
  • 企画段階では全体像、設計段階では詳細へ進む
  • 例外・差し戻しを省略しない
  • 図同士の名称を統一する
  • ユースケースと処理・データ構造の対応を確認する
  • 業務担当者と開発担当者の両方でレビューする
  • 未決事項は図に無理に埋め込まず別管理する

UMLテンプレートのチェックリスト

  • 対象システム・目的・範囲が明確か
  • 何を確認したいか言語化したか
  • 目的に合ったUML図を選んだか
  • アクター・ユースケースを整理したか
  • 開始・終了・分岐・例外を整理したか
  • 処理順序と外部連携を整理したか
  • 主要クラス・属性・関係・多重度を整理したか
  • 図同士の名称と前提が一致しているか
  • 業務担当者・企画担当者・開発担当者でレビューしたか
  • 未決事項を残したまま確定扱いしていないか

まとめ

UMLテンプレートでは、対象システム、目的、確認したいこと、利用者、主要機能、処理、データ、状態、例外を共通項目として整理したうえで、必要に応じてユースケース図、アクティビティ図、シーケンス図、クラス図などへ展開します。

実務で使えるテンプレートにするには、項目を埋めるだけでなく、「何を確認したいか→どの図を使うか→各図で何を書くか→図同士が整合しているか」まで一続きで確認できることが重要です。

このテンプレートをそのままコピーし、共通項目→図選択→各図作成→整合確認→関係者レビューの順に進めれば、UMLをシステム企画・業務設計・要件定義の共通言語として使いやすくなります。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!
目次