UML(Unified Modeling Language)は、システムや業務の構造・振る舞いを図で表現し、業務担当者・企画担当者・開発担当者の認識をそろえるためのモデリング手法です。
ただし実務では、図を作ること自体が目的になる、目的に合わない図を選ぶ、粒度を細かくしすぎる、図同士の前提がずれる、正常系だけを描いて例外を落とす、開発側だけで作る、更新されない、といった失敗が起こりやすくなります。
この記事では、UMLでありがちな失敗を、具体的な失敗場面、原因、改善策、改善前後、改善後の状態までセットで解説します。最後に、自分のUML運用を点検できるチェックポイントもまとめます。
失敗1:UML図を作ること自体が目的になる
具体的な失敗場面
システム企画で「まずUMLを作ろう」と始め、ユースケース図やクラス図を大量に作成したものの、その図を使って何を決めるかが曖昧なケースです。
原因
UMLを意思決定のための手段ではなく、成果物そのものとして扱っています。
改善策
- 対象システム・業務を明確にする
- 「何を確認するための図か」を先に決める
- 図を見た後に決める事項を明示する
- 不要な図は作らない
改善前後
改善前:「営業案件管理システムのUMLを一式作る」
改善後:「利用者と機能範囲をユースケース図で確認し、案件承認の処理順序をシーケンス図で確認する」
改善後の状態
必要な図だけを作成でき、UMLが要件整理や関係者合意に直結します。
失敗2:目的に合わないUML図を選ぶ
具体的な失敗場面
「誰がどの機能を使うか」を確認したいのにクラス図を作り、「処理順序」を確認したいのにアクティビティ図だけで済ませるケースです。
原因
確認したい論点ではなく、作成者が慣れている図を選んでいます。
改善策
- 利用者と機能 → ユースケース図
- 業務フロー → アクティビティ図
- 処理・メッセージ順序 → シーケンス図
- データ・オブジェクト構造 → クラス図
- 状態変化 → ステートマシン図
改善前後
改善前:「何となくクラス図を作る」
改善後:「誰が何を使うか」を確認したいのでユースケース図を選ぶ。
改善後の状態
図の役割が明確になり、関係者が確認すべき論点を読み取りやすくなります。
失敗3:必要以上に細かく作りすぎる
具体的な失敗場面
企画段階なのに、画面ボタン単位の操作、内部メソッド、細かなAPI呼び出しまで描き込み、全体像が見えなくなるケースです。
原因
フェーズと利用者に合った粒度を決めず、「細かいほど正確」と考えています。
改善策
- 企画段階では主要な利用者・機能・業務フローに絞る
- 詳細設計で必要な箇所だけ深掘りする
- 全体図と詳細図を分ける
- 共有相手が理解できる粒度か確認する
改善前後
改善前:「案件登録」ユースケースの中に、入力欄クリックや保存ボタン押下まで記載。
改善後:企画段階では「案件登録」「進捗更新」「承認依頼」に絞り、詳細操作は別資料へ分離。
改善後の状態
全体像を保ちながら、必要な詳細だけを段階的に追加できます。
失敗4:図同士で名称や前提がずれる
具体的な失敗場面
ユースケース図では「案件申請」、シーケンス図では「案件登録」、クラス図では「商談」と呼び、同じ概念かどうか分からなくなるケースです。
原因
複数の図を別々の成果物として作り、共通用語や対応関係を確認していません。
改善策
- 用語集を決める
- 同じ機能・データ・役割は同じ名称で統一する
- ユースケース、処理、クラスの対応を照合する
- 図同士の前提条件をレビューする
改善前後
改善前:「案件申請」「案件登録」「商談」を混在。
改善後:機能名は「案件承認依頼」、主要データは「案件」に統一。
改善後の状態
図をまたいでも同じ要件を追跡しやすくなり、要件漏れを発見しやすくなります。
失敗5:正常系だけを描き、例外・差し戻しを省く
具体的な失敗場面
申請管理システムで「申請→承認→完了」だけを描き、入力不備、差し戻し、承認却下、タイムアウトを表現しないケースです。
原因
図を簡潔に見せることを優先し、実務で起こる例外処理を省いています。
改善策
- 差し戻し・却下・エラーを確認する
- 正常系と主要例外系を分けて描く
- 例外後にどの状態へ戻るか定義する
- 再実行や補償処理も必要に応じて表す
改善前後
改善前:「承認→完了」のみ。
改善後:「承認→完了」「差し戻し→申請者修正→再申請」を表現。
改善後の状態
実運用に近い要件となり、例外時の責任や再処理条件を明確にできます。
失敗6:開発側だけで作成する
具体的な失敗場面
開発担当者だけでUMLを確定し、後から業務担当者が「実際は上長承認の前に経理確認がある」「差し戻し理由を保存したい」と指摘するケースです。
原因
UMLを開発者向けの設計資料として扱い、業務実態の確認を十分にしていません。
改善策
- 業務担当者、企画担当者、開発担当者でレビューする
- 実際の運用・例外・権限を確認する
- レビュー時に図の読み方を共有する
- 指摘事項を図または未決事項一覧へ反映する
改善前後
改善前:開発担当だけで申請フローを確定。
改善後:申請者・承認者・経理・開発担当でレビューし、経理確認と差し戻し理由を追加。
改善後の状態
業務実態とシステム設計のずれを早い段階で修正できます。
失敗7:図同士の整合性を確認しない
具体的な失敗場面
ユースケース図に「案件承認」があるのに、シーケンス図に承認処理がなく、クラス図にも承認履歴を保存する場所がないケースです。
原因
各図を個別に完成させ、相互に照合していません。
改善策
- ユースケースに対応する処理がシーケンス図にあるか確認する
- 処理で扱うデータがクラス図に存在するか確認する
- 状態変化がステートマシン図と一致するか確認する
- 名称・権限・例外条件を横断的に確認する
改善前後
改善前:「承認」機能はあるが、承認履歴が保存されない。
改善後:承認サービスの処理と承認履歴クラスを追加し、ユースケースからデータ保存まで対応をそろえる。
改善後の状態
機能・処理・データ・状態の抜けを発見しやすくなります。
失敗8:作成後に更新されない
具体的な失敗場面
権限ルールや外部APIが変更されたのにUMLが更新されず、新任担当者が古い図を参照するケースです。
原因
UMLをプロジェクト期間だけの成果物として扱い、更新責任や版管理を決めていません。
改善策
- 変更時にUMLも更新する
- 更新責任者と見直しタイミングを決める
- 版管理する
- 最新図の保管場所を一本化する
改善前後
改善前:2年前の承認フローを共有フォルダに放置。
改善後:要件変更時にUMLも更新し、更新日・版番号・責任者を記録。
改善後の状態
UMLを現行要件の共通資料として使い続けられます。
通し例:営業案件管理システムのUMLを失敗状態から立て直す
改善前
- 「UML一式を作る」が目的
- 企画段階なのに詳細なクラス図から開始
- ユースケース図では「案件申請」、シーケンス図では「案件登録」と名称が不統一
- 承認の正常系だけを描き、差し戻しなし
- 開発担当だけでレビュー
- ユースケース図とクラス図の整合確認なし
この状態では、図は存在していても、利用者・機能・処理・データが一貫せず、要件漏れを防げません。
改善後
対象を「営業案件の登録から承認まで」に絞り、目的を「営業担当・上長・管理者の機能範囲と、承認処理・保存データを合意する」と定義しました。
ユースケース図では、営業担当の案件登録・進捗更新・承認依頼、上長の承認、管理者のレポート確認を整理しました。
アクティビティ図では、案件登録→必須項目確認→承認依頼→上長確認→承認/差し戻し→状態更新という流れを整理しました。
シーケンス図では、営業担当→Web画面→案件サービス→承認サービス→通知サービスの順に処理を整理しました。
クラス図では、顧客、案件、担当者、活動履歴、承認履歴を定義しました。
改善判断
図同士を照合すると、アクティビティ図には差し戻しがあるのに、初期クラス図には差し戻し理由の保存先がないことが分かりました。そこで承認履歴に「結果」「差し戻し理由」を追加しました。
また、全図で「案件承認依頼」「案件」「上長」という名称を統一し、承認結果が案件状態の更新と承認履歴保存の両方につながるように整理しました。
改善後の状態
誰が何を使うか、どの順序で処理するか、どのデータを保存するかが一貫し、業務担当者と開発担当者で同じ要件を確認できる状態になりました。
UMLの失敗を防ぐチェックポイント
- UMLを作る目的と、図を見た後に決めることが明確か
- 確認したい論点に合う図を選んだか
- フェーズと共有相手に合う粒度か
- 図同士で名称・前提が統一されているか
- 正常系だけでなく主要な例外・差し戻しを含めたか
- 業務担当者・企画担当者・開発担当者でレビューしたか
- ユースケース・処理・データ・状態を横断的に照合したか
- 未決事項を確定事項として描いていないか
- 変更時にUMLも更新する運用があるか
- 最新版の保管場所と更新責任者が明確か
まとめ
UMLで失敗しやすいのは、図を作ること自体が目的になる、目的に合わない図を選ぶ、細かく作りすぎる、図同士の名称・前提がずれる、例外を省く、開発側だけで作る、整合性を確認しない、作成後に更新しないといったケースです。
失敗を避けるには、まず「何を確認するための図か」を決め、目的に合う図を選び、適切な粒度で作成し、複数図を使う場合は機能・処理・データ・状態の対応を照合することが重要です。
UMLは、図をきれいに描くためのものではありません。業務要求をシステム要件へ変換し、関係者が同じ前提で判断するための実務ツールとして使うことで効果を発揮します。