方法: UML モデリング プロジェクトおよび UML モデリング図を生成する
UML モデルは、ソフトウェア システムを理解したり設計したりするときに役立つほか、ソフトウェア システムについて話し合うときにも役立ちます。 Visual Studio Ultimate には、最もよく使用される 5 つの UML 図 (アクティビティ図、クラス図、コンポーネント図、シーケンス図、およびユース ケース図) のテンプレートが用意されています。 また、システムの構造の定義に役立つレイヤー図も生成できます。
UML モデリング図とレイヤー図は、モデリング プロジェクト内にしか存在できません。 各モデリング プロジェクトには、1 つの共有 UML モデルといくつかの UML 図が含まれています。 各図はモデルの部分ビューです。 UML モデルには、UML 図のすべての要素が含まれています。UML モデルは、UML モデル エクスプローラーを使用して表示できます。 モデルおよびモデルと図の関係の詳細については、「方法: UML モデルおよび UML 図を編集する」を参照してください。 バージョン管理下のモデリング プロジェクトの詳細については、「モデルおよびグラフのバージョン管理」および「モデリング ソリューションの構築」を参照してください。
注意
このほか、プログラム コードを視覚化するために使用される、.NET クラス図と呼ばれる図もあります。 詳細については、「クラスと型のデザインおよび表示」を参照してください。
このトピックの内容
モデリング プロジェクトでの図の生成
モデリング プロジェクトからの図の削除
モデリング プロジェクトが不要な図
モデリング プロジェクトと図のトラブルシューティング
モデリング プロジェクトでの図の生成
図を生成してプロジェクトに追加するには
[アーキテクチャ] メニューの [新しいダイアグラム] をクリックします。
[アーキテクチャ] メニューは、Visual Studio Ultimate でのみ使用できます。
[新しいダイアグラムの追加] ダイアログ ボックスで、目的のモデリング図の種類をクリックします。
新しい図の名前を入力します。
[モデリング プロジェクトへの追加] ボックスで次の操作を行います。
- ソリューション内に既に存在するモデリング プロジェクトを選択し、[OK] をクリックします。
または
[新しいモデリング プロジェクトを作成します] を選択し、[OK] をクリックします。
[新しいモデリング プロジェクトの作成] ダイアログ ボックスで、新しいプロジェクトの名前と場所を入力し、[OK] をクリックします。
ソリューションが開いている場合は、新しいプロジェクトがソリューションに追加されます。 開いているソリューションがない場合は、新しいソリューションの名前を入力できます。
モデリング プロジェクトが既に存在する場合は、次の手順を使用することもできます。
既存のモデリング プロジェクトに図を追加するには
ソリューション エクスプローラーで、モデリング プロジェクト ノードをクリックします。
注意
モデリング プロジェクトには、ModelDefinition という名前のモデル定義フォルダーがあります。
[プロジェクト] メニューの [新しい項目の追加] をクリックします。
[新しい項目の追加 - <プロジェクト名>] ダイアログ ボックスの [テンプレート] で、モデリング図の種類 ([UML コンポーネント図] など) をクリックします。
図の名前を入力し、[追加] をクリックします。
モデリング図が開き、モデリング プロジェクトに表示されます。
ヒント
他のモデリング プロジェクトまたはソリューション内の他の場所に、既存の図ファイルを追加、コピー、またはドラッグしないでください。 これを行うと、コピーした図から要素が消えたり、図を開いたときにエラーが発生したりします。 図のファイルは、そのファイルが生成されたモデリング プロジェクトから開く必要があります。 これは、UML 図がそのモデリング プロジェクトによって所有されるモデルのビューであるためです。 図のファイルをコピーするには、新しい図を生成し、コピー元の図から新しい図に要素をコピーします。 詳細については、「モデリング プロジェクトと図のトラブルシューティング」を参照してください。
空のモデリング プロジェクトを生成するには
[ファイル] メニューの [新規作成] をポイントし、[プロジェクト] をクリックします。
[新しいプロジェクト] ダイアログ ボックスの [インストールされたテンプレート] で、[モデリング プロジェクト] をクリックします。
中央のウィンドウで、[モデリング プロジェクト] をクリックします。
[名前] ボックスにプロジェクトの名前を入力し、[場所] ボックスで場所を指定します。
[ソリューション] ボックスで、[ソリューションに追加] を選択し、既に開いているソリューションに新しいプロジェクトを追加するか、[新しいソリューションを作成する] を選択し、開いているソリューションを閉じて、プロジェクトを新しいソリューションに追加します。
プロジェクトからのモデリング図の削除
図を完全に削除することも、プロジェクトから図を一時的に除外し、後で元に戻すこともできます。
プロジェクトから図を完全に削除するには
ソリューション エクスプローラーで、図を表すメイン ファイルを右クリックし、[削除] をクリックします。
プロジェクトとファイル システムから図が削除されます。 図に表示されている要素は、UML モデル エクスプローラーからは削除されません。
注意
各図は 2 つのファイルを持ちます。一方のファイルは、もう一方の付属ファイルです。 たとえば、CD1 という名前のコンポーネント図がある場合は、CD1.componentdiagram という名前のファイルを削除する必要があります。 CD1.componentdiagram.layout という名前の付属ファイルは自動的に削除されます。
プロジェクトから図を一時的に除外するには
ソリューション エクスプローラーで、図のファイルを右クリックし、[プロジェクトから除外] をクリックします。
プロジェクトから図が削除されます。 ファイル システムからは削除されません。
注意
図に表示されている要素は、UML モデル エクスプローラーからは削除されません。
一時的に除外した図をプロジェクトに戻すには
ソリューション エクスプローラーで、モデリング プロジェクト ノードをクリックします。
注意
モデリング プロジェクトには、ModelDefinition という名前のモデル定義フォルダーがあります。
[プロジェクト] メニューの [既存項目の追加] をクリックします。
[既存項目の追加] ダイアログ ボックスで、図のファイルを探して選択し、[追加] をクリックします。
モデリング図が開き、モデリング プロジェクトに表示されます。
注意
それぞれの図に対応するファイルは、ファイル システム内に 2 つ存在します。 .layout という拡張子のファイルは選択しないでください。 また、Visual Studio Ultimate では、既存の UML 図を複数のモデリング プロジェクトに追加することはできません。 図のファイルは、そのファイルが生成されたモデリング プロジェクトの中で開く必要があります。 これは、UML 図にそのモデリング プロジェクトが所有するモデルのビューが表示されるためです。
モデリング プロジェクトが不要な図
次の種類の図は、モデリング プロジェクトには含まれません。
ソース コードから生成されたシーケンス図。 詳細については、「方法: シーケンス図を使ってコードを精査する」を参照してください。
ソース コードのビューとして生成されたクラス図。 これらの図は、UML クラス図とは無関係です。 詳細については、「クラスと型のデザインおよび表示」を参照してください。
依存関係グラフ。 詳細については、「方法: .NET コードに対する依存関係グラフを生成する」を参照してください。
UML 図でもレイヤー図でもない図 (ドメイン固有の言語など)。
モデリング プロジェクトと図のトラブルシューティング
次の表で、モデリング プロジェクトまたは図で発生する可能性のある問題と、その解決方法を説明します。
懸案事項 |
原因 |
解決策 |
---|---|---|
モデリング プロジェクトを開いたり、ソリューションに読み込むことができません。 次のメッセージが表示されます。 "ソリューション内の 1 つ以上のプロジェクトが正しく読み込まれていません。 詳細については、出力ウィンドウを確認してください。" [出力] ウィンドウに次のメッセージが表示されます。 "ModelingProjectFilenameAndPath.modelproj: エラー: 認識されない GUID 形式です。" |
モデリング プロジェクトに、同じソリューション内にある同じ名前のプロジェクトへの参照が含まれています。 たとえば、同じソリューション内にある同じ名前のプロジェクトにレイヤーがリンクされています。 |
テキスト エディターを使用してモデリング プロジェクト ファイルを開き、参照を削除して、モデリング プロジェクトを再度開きます。 この問題を回避するには、同じ名前のプロジェクトへの参照を追加しないようにします。 プロジェクト名が一意であることを確認します。 |
他のモデリング プロジェクトまたはソリューション内の他の場所に追加、コピー、またはドラッグした図から要素が消えます。 または 図を開こうとすると、次のメッセージが表示されます。
または
|
モデリング プロジェクトから別のモデリング プロジェクトまたはソリューション内の別の場所に、図のファイルが追加、ドラッグ、またはコピーされました。 |
図のファイルをコピーするには、新しい図を生成し、コピー元の図から新しい図に要素をコピーします。 |