UML ユースケース図: ガイドライン

[アーティクル]
06/10/2015

Visual Studio Ultimate では、アプリケーションまたはシステムを使用するユーザーや、ユーザーが実行できる操作を要約するユースケース図を描画できます。UML ユースケース図を生成するには、[アーキテクチャ] メニューの [新しい図] をクリックします。

ビデオデモについては、「Organizing Features into Use Cases (機能をユースケースにまとめる)」を参照してください。

ユースケース図は、次の情報を検討および伝達するのに役立ちます。

システムまたはアプリケーションがユーザー、組織、または外部システムと対話するシナリオ。
これらのアクターが達成するゴール。
システムのスコープ。

ユースケース図には、ユースケースの詳細は示されません。ユースケース図は、ユースケース、アクター、およびシステムの間のいくつかの関係を要約したものにすぎません。特に、各ユースケースのゴールを実現するために実行されるステップの順序は図に示されません。このような詳細については、他の図およびドキュメントに記述し、これらのファイルを各ユースケースにリンクできます。詳細については、このトピックの「ユースケースの詳細な記述」を参照してください。

ユースケースの記述では、システムが運用されるドメインに関連する用語 (たとえば、"セール"、"メニュー"、"顧客") を使用します。その際、これらの用語とその関係を明確に定義することが重要になります。UML クラス図を使用することで、これが可能になります。詳細については、「UML クラス図: ガイドライン」を参照してください。

ユースケースは、システムの機能要求のみを扱います。ビジネスルール、サービス品質要求、実装の制約などの他の要求は、別個に表す必要があります。同様に、アーキテクチャおよび内部の詳細も別個に記述する必要があります。ユーザー要求を定義する方法の詳細については、「ユーザー要求のモデリング」を参照してください。

このトピックでは、顧客が近所のレストランに料理を注文できる Web サイトに関する例を使用しています。

ユースケースダイアグラムの要素

アクター (1) は、システムと対話するユーザー、組織、デバイス、または外部ソフトウェアコンポーネントを表すクラスです。たとえば、Customer、Restaurant、Temperature Sensor、Credit Card Authorizer のようなアクターを設定します。
ユースケース (2) は、特定のゴールに到達するために 1 つまたは複数のアクターによって実行されるアクションを表します。たとえば、Order Meal、Update Menu、Process Payment のようなユースケースを設定します。

ユースケース図では、ユースケースを、ユースケースを実行するアクターと関連付けます (3)。
システム (4) は、現在開発しているシステムを表します。システムとして、小さなソフトウェアコンポーネントを定義できます。その場合のアクターは、他のソフトウェアコンポーネントです。また、完全なアプリケーションや、数多くのコンピューターおよびデバイスに配置される大規模な分散型のアプリケーションスイートをシステムとして定義する場合もあります。たとえば、Meal Ordering Website、Meal Delivery Business、Website Version 2 のようなサブシステムを設定します。

ユースケース図では、システムまたはそのサブシステムでどのユースケースがサポートされるかが示されます。

このトピックの内容

ユースケース図を描画するための基本的な手順

アクターおよびユースケースの描画

ユースケースの詳細な記述

ユースケースの構成

サブシステム境界の使用

ユースケース図を描画するための基本的な手順

注意

モデル図を生成するための詳細な手順については、「UML モデルとダイアグラムの編集」を参照してください。

新しいユースケース図を生成するには

[アーキテクチャ] メニューの [新しいダイアグラム] をクリックします。
[テンプレート] の [UML ユースケース図] をクリックします。
図に名前を付けます。
[モデリングプロジェクトへの追加] で、ソリューション内の既存のモデリングプロジェクトを選択します。または、[新しいモデリングプロジェクトを作成します] を選択し、[OK] をクリックします。

ユースケース図を描画するには

システム全体または主要なコンポーネントを表すために、サブシステム境界をツールボックスから図にドラッグします。
- システムまたはそのコンポーネントでどのユースケースがサポートされるかを記述しない場合は、システム境界を省略してユースケース図を描画できます。
- 必要に応じて、システムの角をドラッグしてサイズを拡大します。
- 適切に名前を変更します。
アクターをツールボックスから図にドラッグし、いずれかのシステム境界の外側に配置します。
- アクターは、ユーザー、組織、および外部システムと対話するクラスを表します。
- 適切に名前を変更します。たとえば、Customer、Restaurant、Credit card agency のような名前を付けます。
ユースケースをツールボックスから適切なシステムにドラッグします。
- ユースケースは、アクターがシステムを使用して実行するアクティビティを表します。
- アクターが理解できるタイトルに名前を変更します。コードに関連付けられたタイトルは使用しないでください。例: Order Meal、Pay for Meal、Deliver Meal
- Order Meal のような主要なトランザクションから開始し、Select Menu Item のようなより小さな相互作用は後回しにします。
- それぞれのユースケースを、システムまたはそれをサポートする主要サブシステムに配置します (このとき、ユーザーへの接続のみに関連するファサードまたはコンポーネントは無視します)。
- ユースケースをシステム境界の外側に描画すると、(特定のバージョンまたはリリースの) システムでユースケースがサポートされていないことを表すことができます。
ツールボックスの [関連] をクリックします。ユースケースをクリックし、次にそのユースケースに参加するアクターをクリックします。手順を繰り返して、それぞれのアクターをユースケースにリンクします。
包含、拡張、および汎化関係を使用して、ユースケースを構成します。これらのリンクを生成するには、目的のツールをクリックし、リンク元ユースケース、リンク先ユースケースの順にクリックします。後の「ユースケースの構成」を参照してください。
ユースケースの詳細を記述します。後の「ユースケースの詳細な記述」を参照してください。
別のサブシステムまたは関連付けられているユースケースの別のグループにフォーカスした図を別個に描画します。 1 つのモデリングプロジェクトに含まれる図は、すべて同じモデルのビューを示しています。

アクターおよびユースケースの描画

ユースケース図の主な目的は、システムと対話するユーザーと、ユーザーがシステムを使用して実現する主要なゴールを示すことにあります。

アクターを生成すると、システムまたはサブシステムと対話するユーザー、組織、他のシステム、ソフトウェア、またはデバイスのクラスを表すことができます。
- アクターおよびその他の要素を描画する方法の詳細については、「UML モデルとダイアグラムの編集」を参照してください。
- それぞれのゴールのセットに対して、物理的なユーザーまたはエンティティが同一になることがある場合でも、型またはロールに基づいてアクターを識別します。たとえば、レストランの従業員が顧客になるケースもありますが、Restaurant と Customer は別個のアクターです。
それぞれのアクターがシステムを使用して追求するそれぞれのゴールのユースケースを生成します。
- 実装の用語を使用する代わりに、アクターが理解できる表現でユースケースを記述します。
関連を使用して、アクターをユースケースにリンクします。

アクター間での継承

継承を示すユースケースダイアグラム

アクター間に汎化リンクを描画できます。例の Club Customer が示す特化されるアクターは、汎化されるアクター Customer のユースケースを継承します。より一般的なアクター (この例では Customer) は、矢じりによって指し示します。リンクを生成するときは、特化されるアクターを最初にポイントします。

特化されるアクターは、他のアクターが利用することができない、追加のユースケースを独自に持つことができます。

注意

アクターがアクター自体を汎化することになる汎化関係のループを作成しないでください。ループによってエラーが生成される可能性があります。

代替アクターアイコン

標準のスティック図形の代わりにカスタムアイコンを使用して、アクターを表すことができます。たとえば、デバイス、レストラン、銀行などを模した図形にアイコンを変更できます。

アクターの外観を変更するには

アクターを右クリックし、[プロパティ] をクリックします。

[プロパティ] ウィンドウが表示されます。
Image Path プロパティをイメージファイルの位置に設定します。
- 使用できるイメージの形式は、.gif、.jpg、および .bmp です。
- ソリューションまたはプロジェクトソース管理に含まれているファイルを使用します。これにより、ソリューションを移動またはコピーした場合でも、そのファイルを使用できます。
この外観を他のユースケース図に複製するには、アクターをコピーし、別の図に貼り付けます。
- イメージに対する変更は、特定の図のビューにのみ適用されます。基になるモデル要素には適用されません。アクターを UML モデルエクスプローラーから別の図にドラッグした場合、アクターは標準のスティック図形として表示されます。

アクターとユースケースの間の多重度

アクターとユースケースの間の関連では、各端部に多重度を表示できます。

アクターと 1 対 1 対応のユースケース

注意

ユースケース図において関連の両端部の多重度が 1 の場合、多重度は非表示になります。

既定では、それぞれの多重度は 1 です。モデルの厳密な解釈において、多重度が 1 であることは、たとえば、それぞれの料理の注文に関連付けられる顧客は 1 人だけで、かつそれぞれの顧客は一度に 1 つの料理しか注文しないことを表します。

これらの多重度は変更できます。

次に例を示します。

多対多の多重度を示すユースケース

同じクラスの複数のアクターがユースケースの単一のオカレンスに参加できることを示すには、関連のアクター側の多重度を 1..* に設定します。

この図では、1 つ以上のレストランが同じ料理の注文を受けることができます。
それぞれのアクターがユースケースの複数のオカレンスに同時に参加できることを示すには、関連のユースケース側の多重度を * に設定します。

この図では、各レストランは複数の注文を同時に受けることができます。

複数の図でのアクターまたはユースケースの使用

複数の図に同じアクターおよびユースケースを表示できます。次に例を示します。

1 つのアクターが関係している異なるユースケースを異なる図に記述できます。
ユースケースが関連付けられているアクターおよびサブシステムを 1 つの図に示し、このユースケースを包含されるユースケースと拡張されるユースケースにどのように構成するかを別の図に示すことができます。

同じアクターまたはユースケースを異なる図に表示するには

アクターまたはユースケースを 1 つの図に生成します。
別のユースケース図を生成します。
モデルエクスプローラーから新しい図にアクターまたはユースケースをドラッグします。

注意

既に関連付けが行われているアクターとユースケースを新しい図に配置すると、アクターとユースケースの間の関連も自動的に新しい図に表示されます。

ユースケースの詳細な記述

ユースケースは、次の要素を表します。

システムを使用してアクターが実現するゴール (たとえば、"料理を買う"。
1 つまたは複数のシナリオ。シナリオは、ゴールに到達するために実行される一連のステップ (たとえば、{Order Meal、Meal、Deliver}) です。成功のシナリオだけでなく、Credit Card Rejected のような例外や失敗のシナリオもあります。

ユースケースは、異なる詳細レベルで記述できます。設計の早い段階では、ユースケース図に名前を付けるだけで十分です。後で、シナリオのより詳細な内容を記述できます。

Visual Studio Ultimate では、ユースケースをさまざまな方法で記述して、別個に使用したり、組み合わせて使用したりできます。

ユースケースをプロジェクトに含まれる 1 つまたは複数の別の図にリンクします。
- アクティビティ図は、ループ、分岐、および並列スレッドが含まれるより複雑なプロセスを説明するのに便利です。アクティビティ図には、プロセスのパート間のデータのフローを示すこともできます。詳細については、「UML アクティビティ図: ガイドライン」を参照してください。
- シーケンス図は、異なるアクター間で行われる一連の複雑な相互作用を説明するのに便利です。シーケンス図を使用して、各ユースケースに対してシステム内部で発生する処理を示すこともできます。詳細については、「UML シーケンス図: ガイドライン」を参照してください。
ユースケースの詳細が示されている OneNote ページ、セクション、またはパラグラフにユースケースをリンクします。
テキストや画面ショットを使用してユースケースのシナリオが記述されている Word 文書にユースケースをリンクします。詳細については、「ユーザー要求のモデリング」を参照してください。

ユースケースを同じソリューションに含まれる図またはファイルにリンクするには

ユースケースのシナリオを示すために、シーケンス図やアクティビティ図などの図を描画します。
ユースケース図に戻ります。
ソリューションエクスプローラーから図またはファイルをユースケース図の空白部分にドラッグします。
依存関係を使用して、成果物からユースケースへの接続を設定します。

Word 文書や PowerPoint プレゼンテーションなどのソリューションファイルにリンクするには

テキストや画面ショットを使用してユースケースのシナリオが記述されているドキュメントを作成します。
ソリューションにドキュメントを追加します。
1. Word 文書をソリューションと同じ Windows フォルダーに移動します。
2. ソリューションエクスプローラーで、ソリューションを右クリックします。次に、[追加] をポイントし、[既存の項目] をクリックします。
3. Word 文書を参照し、[追加] をクリックします。
  
  Word 文書がソリューションエクスプローラーのソリューションフォルダーに表示されます。
ソリューションエクスプローラーから Word 文書をユースケース図の空白部分にドラッグします。

新しい成果物が表示されます。
依存関係を使用して、成果物からユースケースへの接続を設定します。

共有ドキュメント、OneNote 要素、または Web ページにリンクするには

共有要素の URL を取得します。これは、たとえば、"\\" で始まるネットワークファイルパス、"http://" で始まる Web ページまたは Sharepoint URL、"onenote" で始まる OneNote セクション、ページ、パラグラフへのリンクなどです。
ツールボックスの [成果物] をクリックし、ユースケース図をクリックします。
新しい成果物を選択した状態で、"ハイパーリンク" プロパティに URL を入力するか貼り付けます。

注意

成果物をダブルクリックすると、リンク先の図またはドキュメントが開きます。

ユースケースから作業項目へのリンクの設定

プロジェクトで Visual Studio Team Foundation Server 2010 を使用していて、チームエクスプローラーを持っている場合、それぞれのユースケースを Team Foundation の作業項目にリンクできます。これらのリンクを設定する方法の詳細については、「モデル要素と作業項目とのリンク」を参照してください。

これにより、次の操作が可能になります。

リンクされた作業項目内でユースケースを記述できます。特に、プロジェクトで Visual Studio フォーマルプロセステンプレートを使用する場合、ユースケース作業項目へのリンクを設定できます。この作業項目の種類は、ユースケースのゴールおよびシナリオを記述するためのフィールドを提供します。
テストケースをユースケースにリンクして、開発中のコードにどの程度ユースケースが実装されているかのレポートを取得できます。
タスクをユースケースにリンクして、開発作業の進捗状況を追跡できます。

ユースケースの構成

いくつかの主要なユースケースだけにシステムの振る舞いを記述することをお勧めします。それぞれの主要なユースケースでは、"製品を購入する"、"(ベンダーの視点から) 販売用の製品を提供する" など、アクターが実現する主要なゴールを定義します。

これらのゴールを明確にした後で、それぞれのゴールをどのように実現するかに関する詳細や、基本的なゴールのバリエーションを定義できます。

ユースケースをあまりに細かく分解することは避けてください。ユースケースは、システムの内部動作ではなく、システムに関するユーザーのエクスペリエンスを表します。また、一般的には、コードの初期動作バージョンを生成する方が、詳細なユースケースを構成するために時間を費やすよりも生産的です。

主要なユースケースと詳細なユースケースの間の関係はユースケース図に要約できます。以下のセクションで、この方法について説明します。

包含によるユースケースの詳細の表示
汎化によるゴールの共有
拡張によるバリエーションの分離

包含によるユースケースの詳細の表示

包含関係は、あるユースケースが別のユースケースの詳細を記述していることを示すために使用します。この図の Order a Meal は、Pay、Choose Menu、および Choose Menu Item を包含しています。包含されているより詳細なユースケースのそれぞれは、包含するユースケースの全体的なゴールを達成するために 1 つ以上のアクターが実行する必要があるステップを表します。より詳細な包含されるユースケースは、矢じりによって指し示します。

注意

ユースケースがユースケース自体を包含することになる包含関係のループを作成しないでください。ループによってエラーが生成される可能性があります。

包含されるユースケースは共有できます。この例の Order a Meal ユースケースと Subscribe to Reviews ユースケースは、どちらも Pay を包含しています。

包含によって分解されたユースケース

包含されるユースケースのゴールとシナリオは、後で設計されたユースケースで包含できるように、単独で意味を成している必要があります。

ユースケースを包含するパートと包含されるパートに分離することで、次のゴールを達成するのが容易になります。

ユースケースの記述を異なる詳細レイヤーに構成する。
異なるユースケースでの共有シナリオの繰り返しを回避する。

詳細なステップの順序の定義

ユースケース図では、より詳細なステップを実行する順序や、各ステップを必ず実行する必要があるかどうかは示されません。

ステップの順序を明確にするには、成果物を使用して、包含するユースケースに別のドキュメントをアタッチします。下の例では、アクティビティ図が Order a Meal ユースケースにアタッチされています。ここでは、ステップのリストや一覧の画面ショットが記録されたテキストドキュメントを代わりに使用することもできます。詳細については、「ユースケースの詳細な記述」を参照してください。

アクティビティ図を使用する場合は、次の名前付け規則に注意してください。

アクティビティ全体の名前は、包含するユースケースと同じです。
アクティビティ図のアクションは、包含されるユースケースと同じ名前を持ちます。

詳細については、「UML アクティビティ図: ガイドライン」を参照してください。

リンクされたアクティビティダイアグラムに示されたユースケースのステップ

汎化によるゴールの共有

汎化関係を使用すると、特化されるユースケースが、別の一般的なユースケースによって表されるゴールを実現するための特定の方法であることを示すことができます。より一般的なユースケースは、白抜きの矢印によって指し示します。

汎化関係を示すユースケース

たとえば、Pay は、Pay by Credit Card と Pay by Cash を汎化したユースケースです。

注意

アクターがアクター自体を汎化することになる汎化関係のループを作成しないでください。ループによってエラーが生成される可能性があります。

特化されるユースケースを使用すると、同じゴールを実現するためにシステムが実行できる異なる方法を示すことができます。

特化されるユースケースは、一般的なユースケースのゴールおよびアクターを継承すると見なされます。一般的なユースケースには、シナリオを設定する必要はありません。特化によって、ゴールを実現するための異なる方法が記述されます。

2 つ以上のユースケースから共通のゴールをリファクタリングするには

新しい一般的なユースケースを生成し、名前を付けます。
新しい一般的なユースケースが大きい矢印で指し示される、汎化関係を生成します。
1. ツールボックスの [汎化] をクリックします。
2. 特化されるユースケース (例の Pay by Credit Card) をクリックします。
3. 一般的なユースケース (例の Pay) をクリックします。
特化されるユースケースのゴールを既に記述している場合は、共通のパートを一般的なユースケースに移動します。
特化されるユースケースの間で共有されるアクターは、一般的なユースケースに移動できます。

拡張によるバリエーションの分離

特定の状況下においてあるユースケースが別のユースケースに機能を追加できることを示すには、拡張リンクを使用します。メインの拡張されるユースケースは、矢じりによって指し示します。

1 つのユースケースが別のユースケースを拡張

注意

アクターがアクター自体を汎化することになる拡張関係のループを作成しないでください。ループによってエラーが生成される可能性があります。

たとえば、一般的な Web サイトの Login ユースケースは、Register New User を包含することができますが、それはユーザーがまだアカウントを持っていない場合に限られます。

ユースケースをメインパートと拡張パートに分離するには

新しい拡張ユースケースを生成し、名前を付けます。
拡張されるユースケースが矢印で指し示される、拡張関係を生成します。
1. ツールボックスの [拡張] をクリックします。
2. 拡張するユースケース (例の Register New User) をクリックします。
3. 拡張されるユースケース (例の Login) をクリックします。
  
  注意
  
  図に拡張関係ループを生成することは避けてください。ユースケースをそれ自体の拡張にすることはできません。
拡張されるユースケースのシナリオを既に生成している場合は、該当するステップを拡張のシナリオに移動します。
拡張 (例の Register New User) の記述には、ユースケースが、どのような状況で、メインユースケースシナリオのどこで発生するかに関する詳細が含まれている必要があります。メインケースの記述を変更する場合は、この点に注意してください。

拡張ユースケースは、メインユースケースのシナリオとなるようなシナリオステップを表します。拡張のシナリオおよびゴールは、メインユースケースのコンテキストで読み取られます。したがって、これらは単独で実用的である必要はありません。

拡張の分離は、次のような状況を記述するのに便利です。

拡張ユースケースにのみ関連する追加のアクターが存在する場合。たとえば、Web サイトへの顧客の登録を承認するには、管理者が必要になります。
拡張ユースケースが別のサブシステムで処理される場合。
この拡張を利用できるのがシステムの特定のバージョンに限られる場合。それぞれのバージョンを別個のサブシステムとしてユースケース図に示すことができます。

サブシステム境界の使用

サブシステム境界は、システムのスコープ内にあるユースケースを示すために使用します。

サブシステム境界を描画するには

ツールボックスの [サブシステム] をクリックし、図をクリックします。

サブシステムが図に表示されます。
サブシステムの角をドラッグして、サイズを調整します。
既存のユースケースをサブシステム内にドラッグするか、またはサブシステムの外部にユースケースをドラッグして、その内容を調整します。

または

サブシステム内に新しいユースケースを直接生成するには、ツールボックスの [ユースケース] をクリックし、次にサブシステムの内部をクリックします。

注意

ユースケースの Subjects プロパティは、そこに含まれているサブシステムを示します。

システムのスコープ外のユースケース

ビジネスの一部に含まれているユースケースであれば、開発中のシステムで処理されないものであっても、図に含めておくと便利です。このような情報は、開発者が自分の作業のコンテキストを理解するのに役立ちます。たとえば、Meal Ordering Web サイトの責任の範囲外になりますが、Restaurant と Customer というアクターが関連する Deliver Meal をユースケースとして表示できます。

複数のサブシステム

複数のサブシステム境界を生成すると、システムの異なるコンポーネントで異なるユースケースが処理されることを示すことができます。たとえば、Add Restaurant Appraisal が別個のフォーラム Web サイトで処理されるケースです。ユースケース図では、ユーザーに表示するものを扱う必要があります。システムの内部の作業区分を記述する場合は、コンポーネント図の使用を検討してください。

システムバージョン

異なるサブシステム境界を使用すると、システムの異なるバージョンを示すことができます。たとえば、Website Version 2 には、Version 1 に含まれていない Pay ユースケースが含まれているとします。これは、顧客が注文を行うのをシステムが手助けすることを暗示します。しかし、顧客はレストランに直接代金を支払う必要があります。

異なるバージョンまたはバリアントを表すサブシステムどうしをリンクするには、依存関係を使用します。

サブシステムがシステムの異なるバージョンを示している

参照

概念

その他の技術情報

ビデオ: 収集機能を使用する場合

次の方法で共有

UML ユースケース図: ガイドライン

このトピックの内容