メインコンテンツへスキップ
見出し画像

UMLの書き方をわかりやすく解説!クラス図・シーケンス図など5つの図の描き方からAI活用まで【図解付き】

    こんにちは、栗原です。

    「設計書にUMLの図が出てきたけれど、読み方も書き方もわからない」

    「クラス図やシーケンス図を書くことになったけれど、何から手を付ければいいかわからない」

    そんな方へ向けて、このnoteではUML(統一モデリング言語)の書き方を、実務でよく使う5つの図に絞って図解付きで解説していきます。

    記事の後半では、AIにUMLの叩き台を書かせる方法まで紹介します。


    ※UMLの書き方を体系的に学びたい方は、こちらの講座もご活用ください。

    UMLで描くシステム設計図入門|クラス図・シーケンス図をはじめ5つの図が読める・描けるようになる

    → 講座の詳細はこちら


    UMLとは?システムの「世界標準の書き方ルール」

    UML(Unified Modeling Language)とは、システムの構造や動きを図で表すための世界標準の表記ルールです。日本語では「統一モデリング言語」と呼ばれます。

    国際的な標準化団体OMGが標準を管理していて、ISOの国際規格(ISO/IEC 19505)にもなっています。基本情報技術者試験をはじめ、ITエンジニアの試験でも出題され続けている、公的なお墨付きのある書き方です。

    「システムの図なんて、四角と矢印で自己流に書けばいいのでは?」と思うかもしれません。ただ、自己流の図には弱点があります。

    - 書く人によって記号の意味がバラバラで、読む側が毎回ルールを推測することになる

    - 「箱の中に何を書くか」「矢印が何を意味するか」が決まっていないので、大事な情報が抜け落ちる

    UMLは、この「書き方のルール」を世界共通で決めたものです。たとえば次の図は、この記事でも扱う「クラス図」の完成形です。

    クラス図
    クラス図

    UMLの図は全部で14種類ありますが、安心してください。実務の図の大半は、ごく少数の図でできています。この記事では、その中でも出番の多い5つの図の書き方を順番に覚えていきます。

    UMLの図は2グループ|「構造」と「振る舞い」

    14種類の図は、大きく2つのグループに分かれます。

    - 構造図: システムに「何があるか」を表す(クラス図など)

    - 振る舞い図: システムが「どう動くか」を表す(シーケンス図・アクティビティ図など)

    この記事で扱う5つの図と、それぞれの役割はこうです。

    1. ユースケース図: 誰がシステムで何をできるかの一覧

    2. アクティビティ図: 作業の流れと分岐

    3. クラス図: 登場するモノ(クラス)とその関係

    4. シーケンス図: 登場人物どうしのやりとりの時間順

    5. 状態機械図: 1つのモノの状態の変化(ステートマシン図とも呼ばれます)

    この記事では「会議室予約システム」を題材に、5つの図を同じ順番で紹介していきます。

    UMLはどこで書ける?無料ツールから始めよう

    書く場所は、無料のツールで十分です。

    - draw.io(diagrams.net): ブラウザで動く作図ツール。UMLの図形が最初から用意されていて、ドラッグで直感的に描けます

    - PlantUML: テキストを書くと図が自動で生成されるツール。公式サイトのオンラインエディタでブラウザから試せます

    これから始めるなら、まずはdraw.ioのようなドラッグ操作のツールで記号に慣れるのがお勧めです。一方のPlantUMLは「テキストから図を作る」仕組みなので、AIとの相性が抜群です。記事の後半で活用方法を紹介します。

    ユースケース図の書き方|「誰が何をできるか」を1枚にする

    最初は、いちばん簡単なユースケース図からです。登場する記号は2つだけです。

    - アクター(棒人間): システムを使う人や外部システム

    - ユースケース(楕円): システムでできること

    ユースケース図
    ユースケース図

    書き方の手順はシンプルです。

    1. システムを使う人をアクターとして左に置く

    2. システムでできることをユースケースとして楕円で並べる

    3. 「誰が何をできるか」を線でつなぐ

    ポイントは名前の付け方です。ユースケースは「会議室を予約する」のように「〜する」で終わる形で書きます。「予約」のような名詞だけだと、予約するのか確認するのか取り消すのかが曖昧になるからです。

    アクティビティ図の書き方|作業の流れと分岐を表す

    アクティビティ図は、作業の流れを表す図です。いわゆるフローチャートにいちばん近い図で、次の記号で書きます。

    - 開始(黒丸)と終了(黒丸を丸で囲んだ記号)

    - アクション(角丸の四角): 実行する作業

    - 矢印: 作業の順番

    - ひし形: 分岐(デシジョン)と合流(マージ)

    アクティビティ図
    アクティビティ図

    分岐で大事なのが、ガード条件です。分岐後の矢印に「[空きがある]」「[空きがない]」のように、角かっこ[ ]で条件を書きます。この図では、空きがなければ別の候補日時を選び直して、もう一度空き状況の確認に戻る、という流れまで表現しています。

    なお、「誰がやるか」を表したいときは、図を担当者ごとの縦の帯(スイムレーン)で区切る書き方もあります。

    クラス図の書き方|モノと関係を3つの区画で表す

    クラス図は、UMLの代表格です。システムに登場するモノ(クラス)を箱で表し、箱どうしの関係を線でつなぎます。

    まず、箱の書き方から。クラスの箱は3つの区画でできています。

    - 1段目: クラス名(例: 予約)

    - 2段目: 属性。そのクラスが持つデータ(例: 予約ID・利用日時)

    - 3段目: 操作。そのクラスができること(例: 取り消す)

    クラスの箱
    クラスの箱

    属性には「利用日時: datetime」のようにコロンで型(データの種類)を添えます。行頭の「+」は、他のクラスから見えるという意味の記号です。

    次に、箱どうしのつなぎ方です。クラスの間に線を引き、関連の名前と多重度(相手がいくつあるか)を書きます。

    箱どうしのつなぎ方
    箱どうしのつなぎ方

    この図はこう読みます。

    - 社員は予約を「行う」という関係にある

    - 多重度「1」と「0..*」: 1人の社員は、予約を0件以上いくつでも持てる。逆に、1件の予約は必ず1人の社員に属する

    「0..*」は「ゼロ以上いくつでも」という意味です。この多重度こそ、クラス図でいちばん情報量のある部分です。「1人1件まで?それとも何件でも?」という業務の決まりが、この小さな数字に込められます。

    シーケンス図の書き方|やりとりを時間順に表す

    シーケンス図は、登場人物どうしのやりとりを時間順に表す図です。クラス図と並んで実務での出番が多い図です。

    - ライフライン: 登場人物ごとの縦の破線。上から下へ時間が流れます

    - メッセージ: ライフラインの間をつなぐ横の矢印。依頼や呼び出しを表します

    シーケンス図
    シーケンス図

    この図は「社員が予約画面で日時と会議室を指定し、予約画面が予約サービスに予約を依頼する」と読みます。

    書き方の手順です。

    1. 登場人物(人・画面・サービスなど)を横に並べる

    2. 最初のきっかけとなるメッセージを、いちばん上に書く

    3. そこから起きるやりとりを、上から下へ時間順に矢印で書いていく

    分岐やループを表したいときは、alt(条件分岐)やloop(繰り返し)という枠でメッセージを囲む書き方が用意されています。

    状態機械図の書き方|1つのモノの「一生」を追う

    状態機械図(ステートマシン図とも呼ばれます)は、1つのモノに注目して、状態がどう変わっていくかを表す図です。

    - 状態(角丸の四角): 「予約済み」「利用中」のような、そのモノの状態

    - 遷移(矢印): 状態から状態への移り変わり。矢印にはきっかけとなる出来事を書きます

    - 始まり(黒丸)と終わり(黒丸を丸で囲んだ記号)

    状態機械図
    状態機械図

    この図は「予約」というモノの一生です。予約が成立すると「予約済み」になり、チェックインで「利用中」へ、チェックアウトで「完了」へ。予約済みの間に取り消し操作があれば「取消済み」へ進みます。

    状態機械図の読みどころは、描かれていない遷移は起きない(できない)という点です。たとえばこの図では「利用中」から「取消済み」への矢印がありません。つまり「利用が始まったら、もう取り消せない」という決まりが、図から読み取れるわけです。

    UMLをきれいに描く3つのコツ

    5つの図の書き方が分かったところで、図の品質を上げるコツを3つ紹介します。

    コツ1: 図の目的を1文にしてから描く

    描き始める前に、「この図は何を伝えるための図か」を1文にします。「会議室予約の取り消しの決まりを共有する」のように目的が決まれば、何を描いて何を省くかが自然に決まります。

    コツ2: 1枚の図に主役は1つ

    関係するものを全部1枚に詰め込むと、こうなります。

    関係するものを全部1枚に詰め込んだ場合
    関係するものを全部1枚に詰め込んだ場合

    1つ1つの記号は正しくても、主役が分からない図は読んでもらえません。伝えたいことが複数あるなら、図を分けましょう。

    コツ3: 分からないことは描かず、質問リストへ

    「利用中の予約は取り消せるのか?」のように、描いている途中で分からないことが出てきたら、推測で描かずに質問リストに残して、詳しい人に確認します。図の目的は正確な共有なので、曖昧なまま埋めるのが一番の禁物です。

    AIにUMLを書かせる方法|叩き台づくりを任せる

    ここまで手で書く方法を紹介してきましたが、ゼロから図を組み立てるのは、慣れるまで時間がかかります。そこで活用したいのが生成AIです。

    先ほど紹介したPlantUMLは、図をテキストで書く仕組みです。テキストならAIの得意分野。ChatGPTやClaudeにシステムの内容を伝えると、PlantUML形式の叩き台を書いてもらえます。

    プロンプト(AIへの依頼文)の例はこちらです。

    次のシステムの内容を、UMLのクラス図にしてください。
    PlantUML形式で、そのまま描画できる完全なソースとして出力してください。
    
    - 題材:会議室予約システム
    - 登場するクラス:社員・予約・会議室
    - 関係:社員は予約を行う(1人の社員が予約を0件以上持つ)。
      予約は1つの会議室を対象にする
    - 制約:書かれていない要素を推測で補わない。
      不明な点は図の注釈で「要確認」と残す
    - 作法:クラス名・属性名は日本語のまま。関連には多重度を付ける

    出力されたソースをPlantUMLのエディタに貼り付ければ、図として表示されます。

    ただし、AIの出力はあくまで叩き台です。次の3つの観点で点検しましょう。

    1. 事実: 多重度やクラス名が、元の情報と合っているか

    2. 記法: この記事で紹介した書き方のルールどおりか

    3. 作法: 1枚の図に主役が1つになっているか。名前に揺れがないか

    UMLの基本の書き方を知っていると、AIの出力を自分の目で点検して、必要な箇所だけ直せるようになります。「読める・直せる」が、AI時代のUMLスキルの核心です。

    UMLに関するよくある質問

    UMLとフローチャート・BPMNの違いは?

    フローチャートは記号の使い方が人によってまちまちですが、UMLは世界標準として記号の意味が厳密に決まっている点が違います。

    BPMNとの使い分けは、対象の違いで考えます。人や組織の業務の流れを描くならBPMN、システムの内側(データや処理のやりとり)を描くならUMLです。BPMNの書き方は別の記事で解説しています(記事末尾のリンクからどうぞ)。

    UMLはもう古くないですか?

    心配ありません。UMLは標準化から20年以上使われ続けている、息の長いスキルです。基本情報技術者試験などの試験でも出題され続けています。

    さらに近年は、AIにシステム開発を任せる際の「設計図の共通言語」としてUMLが再注目されています。テキストで書けるPlantUMLとAIの組み合わせは、その代表例です。

    14種類すべて覚える必要はありますか?

    ありません。実務で目にする図の大半は、クラス図とシーケンス図です。この記事の5つの図が読めて描ければ、実務の入り口としては十分です。残りの図種は、必要になったときに「こういう図もある」と調べられれば問題ありません。

    まとめ:UMLの書き方は5つの図から身につけよう

    改めて、UMLの書き方のポイントをまとめます。

    1. UMLはシステムを図で表す世界標準の書き方ルール(ISO規格・試験でも出題)

    2. 図は構造(何があるか)と振る舞い(どう動くか)の2グループ

    3. まずはユースケース図・アクティビティ図・クラス図・シーケンス図・状態機械図の5つで十分

    4. クラス図は3区画の箱と多重度、シーケンス図は上から下への時間順が読みどころ

    5. きれいに描くコツは「目的を1文に」「主役は1つ」「分からないことは質問リストへ」

    6. AIにPlantUMLで叩き台を書かせて、基本ルールで点検・修正するのが現代的な使い方

    システムの構造や動きを正確に図にできるスキルは、設計・開発・AIへの指示のあらゆる場面で効いてきます。まずはdraw.ioを開いて、あなたの身近なシステムをユースケース図1枚から描いてみてください。

    動画で体系的に学びたい方は、私のUdemy講座もご活用ください。この記事で紹介した5つの図を、1つの通しケースを完成させながら演習形式で身につけられます。


    ※UMLの書き方を体系的に学びたい方は、こちらの講座もご活用ください。

    UMLで描くシステム設計図入門|クラス図・シーケンス図をはじめ5つの図が読める・描けるようになる

    → 講座の詳細はこちら


    ▽あわせて読みたい▽

     
     
    Udemy講師の栗原直樹です。 未学習者の方に向けた、分かりやすい解説が得意です。難しい内容でも、圧倒的に分かりやすく嚙み砕いてお伝えいたします。 【公式サイト】 https://kurihara-naoki.com/

    あなたへのおすすめ