自社で注文がどう流れるかを 3 人に聞くと、3 通りの答えが返ってくるかもしれません。請求書は梱包の前に出すという人、出荷の後だという人、在庫切れのときに何が起きるかは誰も知らない、という具合です。ホワイトボードのフローチャートは、2 つのことが同時に起きて、矢印が実在しない順序を示してしまうまでは役に立ちます。
UML アクティビティ図は、まさにこのために作られています。手順、判断、並行作業、そして誰がどの部分を担当するかを表せます。この記事では、1 つの注文処理の例を少しずつ組み立てながら、記号一覧、その背後にあるトークンのルール、よくある間違い、そしてアクティビティ図とフローチャート、BPMN、状態遷移図との違いを説明します。
アクティビティ図が表すもの
アクティビティ図は、振る舞いをフローでつながれたアクションとして表します。ルールは、Object Management Group (OMG) が 2017 年 12 月に公開した UML 2.5.1 仕様に由来し、執筆時点 (2026 年 11 月) でも現行の正式版です。表記は第 15 章 (Activities) と第 16 章 (Actions) で定義されています。
作業の順序が問題になる場面で使います。たとえば、複数のチームをまたぐ業務プロセス、ユースケースの背後にあるシナリオ、分岐や並行ステージを持つパイプラインです。注文がどの状態にあるかが問題なら状態マシン、どのサービスがどのサービスを呼ぶかが問題ならシーケンス図、データがどう構造化されているかが問題ならクラス図を使います。
アクティビティ図の記号
UML は 4 つの制御ノードに 2 つの形を使い回します。判断とマージはどちらもひし形、フォークとジョインはどちらもバーです。入ってくるフローと出ていくフローの数で見分けます。
| 記号 | 見た目 | 意味 |
|---|---|---|
| 開始ノード | 小さな塗りつぶしの円 | フローの開始位置 |
| アクション | 動詞句を入れた角丸の長方形 | 作業の 1 ステップ |
| 制御フロー | 矢印 (任意で [ガード] 付き) | 実行の順序 |
| 判断ノード | ひし形、入るフロー 1 本、出るフロー複数 | 各トークンを、ガードで選んだ 1 方向へ送る |
| マージノード | ひし形、入るフロー複数、出るフロー 1 本 | 待たずに代替経路を 1 本にまとめる |
| フォークノード | バー、入るフロー 1 本、出るフロー複数 | 出ていくすべてのフローを同時に開始する |
| ジョインノード | バー、入るフロー複数、出るフロー 1 本 | 入ってくるすべてのフローを待ってから続行する |
| アクティビティ終了 | 的の形: 輪の中の塗りつぶしの円 | アクティビティ全体を終わらせる |
| フロー終了 | X の入った円 | 到達したフローだけを終わらせる |
| オブジェクトノード | 名詞を入れた長方形、またはアクション上のピン | アクション間で受け渡されるデータ |
| パーティション | 片端に名前を付けたレーン | 1 人の参加者のアクションをまとめる |
仕様では、フォークとジョインは「単なる線分」とされており、ツールがそれを太くしてバーにしています。仕様は、パーティションが「口語ではスイムレーンと呼ばれる」ことにも触れています。
トークンが図の中を進む仕組み
UML はこれらの記号を、ゲーム盤上の駒のようなトークンで定義します。アクティビティが始まると、開始ノードに制御トークンが 1 つ置かれます。アクションは、入ってくるすべてのフローからトークンが提示されると 1 回実行され、その後、出ていくすべてのフローにトークンを提示します。判断は各トークンを、ガードが真になる出口 1 本にだけ送ります。マージはトークンをそのまま通します。フォークはトークンをすべての出口にコピーします。ジョインは入ってくるすべてのフローがトークンを提示するまで待ち、そのうえで 1 つ出力します。アクティビティ終了ノードに最初に到達したトークンが、実行中のものも含めてアクティビティを終わらせます。
フローチャートを先に学んだ人が驚く帰結が 2 つあります。
- アクションに入る矢印が 2 本あると、両方を待つという意味になります。暗黙のジョインです。矢印が判断の 2 つの分岐から来ている場合、トークンを運ぶのは片方だけなので、アクションは開始しません。代替経路は、先にマージで合流させる必要があります。
- アクションから出る矢印が 2 本あると、両方を実行するという意味になります。暗黙のフォークです。仕様上は有効ですが、読み手は見落とします。代わりにフォークのバーを描いてください。
例を順に組み立てる
- まずパーティションを描きます: Customer、Warehouse、Billing です。レーンを引くと、担当の問いを早い段階で突きつけられます。
- フローを開始します。 Customer レーンの開始ノードから Place order へつなぎます。
- 判断を追加します。 Warehouse レーンで、判断が在庫を確認し、ガードは [in stock] と [out of stock] にします。ガードは互いに排他的で、すべてのケースを網羅するのが望ましく、UML があらかじめ定義している [else] ガードが残りを受け止めます。
- 経路をマージします。 在庫切れの注文は Backorder items を通り、その後で両方の経路がマージで合流します。マージは必須です。フォークは入ってくるフローをちょうど 1 本しか受け付けず、入ってくるフローが 2 本あるアクションは両方を待ってしまうからです。
- 並行作業をフォークします。 フォークのバーが Pack items (Warehouse) と Create invoice (Billing) を開始します。並行とは、どちらも相手を待たないという意味であり、同じ瞬間に実行されるという意味ではありません。
- 出荷の前にジョインします。 ジョインのバーは両方が終わるまで待ち、その後でようやく Ship order が実行されます。
- アクティビティを終了します。 Ship order の後にアクティビティ終了ノードを置きます。制御ノードは作業ではないので、どのレーンに置いても構いません。このノードは Customer レーンの Ship order の真上にあります。
PlantUML では、同じフローをプレーンテキストで書けます。レーンは |Customer|、判断は if、else、endif、並行作業は fork、fork again、end fork です。レイアウトは自動なので、制御の細かさと引き換えに速さを得ることになります。
よくある間違い
| 間違い | 何が起きるか | 対処 |
|---|---|---|
| ジョインのないフォーク | アクティビティ終了に最初に到達した分岐がアクティビティを終わらせ、もう一方を止める | 分岐をジョインするか、それぞれをフロー終了で終える |
| 並行作業に判断を使う | 実行される分岐が 1 つだけになる | フォークのバーを使う |
| ジョインが必要な場所のマージ | 次のアクションがトークンごとに 2 回実行されうる | ジョインのバーを使う |
| 判断の後のジョイン | トークンを運ぶ分岐が 1 つだけなので、ジョインが永久に待つ | マージのひし形を使う |
| ラベルのない、または重なるガード | 読み手が推測する。UML はガードの評価順を未定義としている | 互いに排他的なガードと [else] |
| あいまいなアクション名 | 処理中 では作業内容が分からない | 動詞と目的語: Pack items |
3 行目と 4 行目は鏡像の関係です。マージは決して待たず、ジョインは永久に待つことがあります。図を共有する前に、1 つのトークンをすべての分岐でたどってください。
アクティビティ図、フローチャート、BPMN、状態遷移図
| アクティビティ図 | フローチャート | BPMN | 状態マシン図 | |
|---|---|---|---|---|
| 表すもの | データと並行作業を含む、1 つの振る舞いの手順 | 手順と判断 | イベントとメッセージを含む、参加者間のプロセス | 1 つのオブジェクトの状態と、それを変えるイベント |
| 並行作業 | フォークとジョインのバー | 一般的な記号セットにはない | 並行ゲートウェイ | 直交領域 |
| 誰が何をするか | パーティション (スイムレーン) | 部門横断フローチャートのレーン | プールとレーン | 表現されない |
| 標準 | UML 2.5.1 (OMG) | ISO 5807 (1985)、厳密には守られていない | BPMN 2.0.2 (OMG) | UML 2.5.1 (OMG) |
| 向いている用途 | ソフトウェアの振る舞い、ユースケースのフロー、パイプライン | 誰にでも見せる簡単なスケッチ | プロセス自動化、組織間のフロー | 注文やサブスクリプションのライフサイクル |
アクティビティ図と BPMN は親戚のような関係です。どちらもトークンで振る舞いを定義し、BPMN 2.0.2 はプロセスエンジン向けの実行セマンティクスも規定しています。実行可能なプロセスや組織間のメッセージには BPMN を選びます (BPMN 図の例を参照)。1 つのオブジェクトのライフサイクルには状態マシンを選びます (状態遷移図の例を参照)。UML を学ぶ予定のない読み手にはフローチャートを、並行作業と正確な意味が重要なときはアクティビティ図を選びます。
注文処理のアクティビティ図
ダイアグラムの内容
- Customer
- Warehouse
- Billing
- Place order
- In stock?
- Backorder items
- Pack items
- Ship order
- Create invoice
- [in stock]
- [out of stock]
図の読み方は次のとおりです。
- 3 つのスイムレーン: Customer、Warehouse、Billing が、それぞれ自分のアクションを持ちます。
- 塗りつぶしの円から始めます: 顧客が注文を出し、フローは Warehouse レーンへ下りていきます。
- 判断 In stock? には、ガード付きの出口が 2 つあります。[in stock] はマージへ進み、[out of stock] はオレンジ色の Backorder items を経由して迂回します。Y と N の印はエディタ標準の出口マーカーで、UML としての意味を持つのはガードです。
- 小さなひし形は、両方の経路が再び合流するマージです。
- 1 本目のバーはフォークで Pack items と Create invoice を開始し、2 本目はジョインで Ship order が両方を待つようにします。
- Ship order の上にある的の形がアクティビティを終わらせ、レーンの下にある表が各制御ノードのトークンのルールを繰り返し示しています。
アクティビティ図を分かりやすく描く
- 向きを 1 つに決めます。 左から右へ流れる横レーンは横長のページに、下へ流れる縦レーンは長いプロセスに向いています。
- アクションは動詞と目的語で名付けます: Pack items、Create invoice。段落が必要になるアクションはサブアクティビティです。UML の小さな熊手の記号を付けたコール振る舞いアクションとして描き、詳細は別の図に書きます。
- ガードはフローに付けます。 ひし形の中の問いは読み手の助けになりますが、意味を担うのは角括弧付きのガードです。
- マージとジョインはすべて描きます。 暗黙のジョインやフォークは有効ですが、目に見えません。
- レーンは少なく保ちます。 3 本から 5 本なら読みやすさを保てます。8 本になったらプロセスを分割します。
- フローを変えないものは省きます。ステップ内のログ出力やリトライなどです。オブジェクトノードは、データが重要なときだけ追加します。
UML のそれ以外の要素なしでレーンだけを使いたい場合は、スイムレーン図の例を参照してください。
Archboard で作る
- Google または GitHub でサインインし、ダイアグラムを作成します。
- 基本パックから フレーム ノードを 3 つ、横レーンとして追加します: Customer、Warehouse、Billing です。
- 基本パックから、濃い塗りの小さな 楕円 を開始ノードとして追加します。
- フローチャートパックから 処理 ノードを 5 つ、それぞれのレーンに追加します: Place order、Backorder items、Pack items、Create invoice、Ship order です。
- フローチャートパックから In stock? というラベルの 判断 ノードを追加し、マージ用に基本パックから小さな ひし形 を追加します。出口には [in stock] と [out of stock] のラベルを付けます。
- フォークとジョイン用に、基本パックから細長く伸ばした 正方形 ノードを 2 つ、濃い塗りで追加します。
- アクティビティ終了用に、基本パックから record-circle-outline アイコン (輪の中の点) を使った アイコン を追加します。
- ノードを接続し、さらに基本パックの テキスト 注釈を 2 つと、凡例の表を入れた基本パックの Markdown ブロックを追加します。
フローが Mermaid のフローチャートとして既にある場合は、Mermaid からダイアグラムへのツールで編集可能な下書きを作り、これらのノードで仕上げられます。レーン付きの通常のフローチャートなら、フローチャートメーカーから始めてください。
この例で使うダイアグラムノードは 15 個で、Free プランの範囲に収まります。
よくある質問
UML のアクティビティ図とは何ですか? プロセスを、フローでつながれたアクションとして表す振る舞い図です。判断、並行作業のためのフォークとジョイン、誰が何をするかを示すスイムレーンを備えています。UML 2.5.1 では第 15 章で定義されています。
フォークと判断の違いは何ですか? 判断は、ガードで選んだ出口 1 本にだけ各トークンを送ります。フォークはすべての出口にコピーを送るため、分岐は並行して実行されます。判断はひし形、フォークはバーです。
アクティビティ終了とフロー終了ノードの違いは何ですか? 的の形をしたアクティビティ終了は、アクティビティ全体とその中のすべてのフローを終わらせます。X の入った円であるフロー終了は、到達したフローだけを終わらせます。
アクティビティ図でスイムレーンはどう働きますか? スイムレーンは UML のアクティビティパーティションです。各レーンは 1 人、1 チーム、または 1 つのシステムのアクションをまとめます。フローはレーンを自由に横切り、レーンがトークンの動き方を変えることはありません。
アクティビティ図はフローチャートと同じですか? いいえ、見た目は似ていますが別物です。アクティビティ図は、フォークとジョイン、データ用のオブジェクトノード、パーティション、そして各記号に正確な意味を与えるトークンのルールを加えています。