UML Profile guideby SparxSystems JapanEnterprise Architect 日本語版
UML プロファイル 機能ガイド(2021/12/27 最終更新)

UML プロファイル 機能ガイド

目次
1.はじめに .............................................................................................................................. 3
2. UML プロファイルの作成 ................................................................................................. 3
3. 作成したプロファイルの利用 ............................................................................................ 9
4. UML プロファイルの作成・応用編 ..................................................................................114.1. タグ付き値 .................................................................................................................114.2. 外見 ........................................................................................................................... 134.3. 描画スクリプト ......................................................................................................... 134.4. クイックリンク ......................................................................................................... 15

Copyright (c) 2003-2021 Sparx Systems Japan2

UML プロファイル 機能ガイド

1.はじめにUML では、ステレオタイプを利用することで既存の要素に意味を追加し、拡張して利用することができます。このステレオタイプは個々の要素に対して個別に指定することもできますが、ステレオタイプの意味と適用する UML 要素を決めておくことで、その要素に強い意味を持たせて利用することができます。
さらに、ステレオタイプの内容は独自に決めることができますので、例えば「<<新規>>」「<<既存>>」などのステレオタイプを定義して、分析段階で利用するような使い方もできます。こうしたステレオタイプを利用することで、その要素が持つ意味をよりわかりやすく、視覚的に表現することができます。Enterprise Architect では、こうした定義済みのステレオタイプに対して、色を指定したり画像ファイルを指定したりすることで、よりわかりやすく利用することができます。
UML プロファイルとは、上記のようなステレオタイプとその適用可能な要素・適用した場合の表現(色などの書式)の情報をひとまとめにしたものです。それぞれの UML プロファ
イルには、例えばビジネスモデリングや XML スキーマのモデリングなど、目的や用途が定義されています。また、ステレオタイプと同じく UML を拡張する手段であるタグ付き値(UML 要素に対して独自の追加属性を保存する領域)も、UML プロファイルで設定することができます。
このドキュメントでは、独自の UML プロファイルを作成するための方法について紹介いたします。Enterprise Architect 15.2 ビルド 1554 を利用しています。
Enterprise Architect では、作成した UML プロファイルを単独で使うこともできますが、「MDG テクノロジー」に含めて使われることが一般的です。「MDG テクノロジー」として作成することで、ドキュメントやソースコード生成のテンプレートなど他の情報とまとめて 1 つのファイルとして配布できたり、変更があった場合に自動更新される仕組みを利用したりすることができます。
「MDG テクノロジー」の詳細につきましては、ヘルプや PDFドキュメント「MDG テクノロジー 機能ガイド」をご覧下さい。

2. UMLプロファイルの作成
Enterprise Architect では、UML プロファイルを簡単に作成することができます。作成

Copyright (c) 2003-2021 Sparx Systems Japan

3

UML プロファイル 機能ガイド

した UML プロファイルは XML 形式のファイルになりますので、作成したプロジェクト以外のプロジェクトでも簡単に利用することができます。
UML プロファイルを作成するには、ツールボックスの「プロファイル」グループを利用します。ツールボックスの最上部にあるメニューボタンをクリックすると、ツールボックスの内容を切り替えることができます。
プロファイルグループを表示したら、まず「プロファイル」パッケージをダイアグラム内に配置し、作成するプロファイルの名前をパッケージの名前として入力します。
(そのためには、一時的なクラス図などを作成し、開いておく必要があります。)「ダイアグラムを追加」を選択すると、モデルブラウザにパッケージが配置された後に、作成するダイアグラムを選択できます。作成するダイアグラムの種類は、クラス図にしてください。プロファイルの中身は、このダイアグラムに対して作成していきます。

作成したダイアグラムの中に、独自に定義する要素の種類を「ステレオタイプ」として定義します。ツールボックスの「プロファイルエディタ」グループにある「ステレオタイプの追加」の項目をダイアグラムにドロップします。以下のような画面が表示されます・

Copyright (c) 2003-2021 Sparx Systems Japan4

UML プロファイル 機能ガイド「名前」の欄には、追加する独自要素の名前を入力します。また、その独自要素の元となる要素を「メタクラス」として追加します。この「メタクラス」として指定する要素の種類は、作成する独自要素で利用できる機能にも関係します。例えば、独自要素がソースコード生成可能なものにする場合には、「メタクラス」は UML のクラスとして指定しなければなりません。

Copyright (c) 2003-2021 Sparx Systems Japan

5

UML プロファイル 機能ガイド

今回は、「クラス」を選択しました。要素のサイズなど、Enterprise Architect 既定の属性について必要に応じて指定し、「次へ」ボタンを押します。
次の画面では、その要素が持つ独自の属性を定義します。右クリックして表示されるメニューから「タグ付き値の追加」を選択し、その要素が保持する情報を指定してください。
(独自に定義する要素に追加する属性は「タグ付き値」になります。)
例えば、以下のように設定します。

Copyright (c) 2003-2021 Sparx Systems Japan

6

UML プロファイル 機能ガイド「次へ」のボタンを押すと、描画スクリプトの設定画面が表示されます。描画スクリプ
トは、ダイアグラム上での要素の表示形式についてスクリプトを利用して自由に定義することができる機能です。詳細は、ヘルプや PDF ドキュメント「MDG テクノロジー 機能ガイド」をご覧下さい。
このドキュメントでは設定せず、先に進みます。
このようにして定義が完了すると、以下のようにステレオタイプ要素とメタクラス要素がダイアグラム内に配置されます。

Copyright (c) 2003-2021 Sparx Systems Japan

7

UML プロファイル 機能ガイド«metaclass»
Class+

isActive: Boolean

通信機器++

プロトコル = TCP
通信速度

なお、この定義は、上記のウィザードを利用せずに、ツールボックスから「ステレオタイプ」と「メタクラス」のそれぞれの要素を配置し、ステレオタイプとメタクラス要素を「プロファイル拡張」(ツールボックスでは「拡張」)の接続で結びつけることもできます。
この場合、「プロファイル拡張」の関係を作成するには、クイックリンク機能が便利です。
クイックリンク機能を利用してメタクラス要素とステレオタイプ要素を結びつけた場合、簡単に「プロファイル拡張」の関係が設定できます。

作成したステレオタイプ要素に対して、色などの書式を変更することができます。色を変更する場合には、要素を右クリックし、「書式設定」→「既定の書式設定」を利用して設Copyright (c) 2003-2021 Sparx Systems Japan8

UML プロファイル 機能ガイド

定してください。このドキュメントでは、以下のように作成しました。
(関連など接続の拡張の場合には、境界の色・境界線の太さのみが有効です。)«metaclass»Interface«metaclass»
Association«metaclass»
Class+

通信ポート

isActive: Boolean++compositionKind: CompositionKind = none
direction: Direction = Source -> Desti...

通信機器++

通信経路

プロトコル = TCP
通信速度

こうして設定が完了したら、モデルブラウザ内でプロファイルパッケージを選択し、「アドイン・拡張」リボン内の「MDG テクノロジー」パネル内にある「独自拡張」ボタンを押し、「パッケージから MDG テクノロジーを自動生成」を選択してください。この機能により、作成した内容をすぐに試すことができます。具体的な方法は次の章をご覧ください。
最終的に UML プロファイルを配布・共有する場合には、UML プロファイルの XML ファイルとして生成する必要があります。ただし、UML プロファイルのみでは、第 3 章の説明にあるようなツールボックスからの要素の作成ができないなど、いくつかの制限があります。MDG テクノロジーとして配布することをおすすめします。
(MDG テクノロジーの概要は、PDF ドキュメント「MDG テクノロジー 機能ガイド」やヘルプをご覧ください。)

3. 作成したプロファイルの利用
次に、「パッケージから MDG テクノロジーを自動生成」の機能を実行した場合に、作成した UML プロファイルを利用します。
モデルブラウザの「リソース」タブ内の「MDG テクノロジー」の下、「プロジェクトのMDG テクノロジー」のフォルダに、第 2 章で作成し自動生成した MDG テクノロジーが表示されていることを確認してください。

Copyright (c) 2003-2021 Sparx Systems Japan

9

UML プロファイル 機能ガイド

このように読み込まれていれば、ツールボックスから要素や接続を作成することができます。今回の例ではダイアグラムの種類は定義していないので、クラス図などの図を作成してください。
(MDG テクノロジーを利用することで、独自の種類の図を追加することができます。)
ツールボックスのウィンドウ右上にあるメニューボタンを押すと、次の画像左側のように作成した「myStereo」グループ(グループ名はパッケージ名と同じ名前)が選択できるようになります。このグループ一覧に作成したグループ名が表示されない場合には、メニューボタンを押すと表示される一覧の一番上にある「パースペクティブの変更」を選択し、さらに表示されるメニューで「全て」を選択してください。ツールボックスの一覧の内容を再構築し、最新の情報に更新できます。なお、場合によっては Enterprise Architect を再起動しないと表示されない場合もあります。
作成した「myStereo」グループを選択することで、次の画像右側のように定義した要素や接続が表示され、配置できるようになります。

Copyright (c) 2003-2021 Sparx Systems Japan10

UML プロファイル 機能ガイド

今回の例での作成例は以下の通りです。
«通信ポート»Interface1«通信機器»Class1«通信経路»

4. UMLプロファイルの作成・応用編
第 2 章では、基本的な UML プロファイルの作成方法を説明しました。この章では、UMLプロファイルの作成をさらに便利にするいくつかの方法をご紹介します。

4.1. タグ付き値

Copyright (c) 2003-2021 Sparx Systems Japan

11

UML プロファイル 機能ガイド

第 2 章の「通信機器」要素に追加した「プロトコル」「通信速度」のように、それぞれのステレオタイプには、既定のタグ付き値を指定することもできます。タグ付き値を指定するには、「ステレオタイプ」要素の属性として指定します。例えば、次のように「属性・操作と付属要素」サブウィンドウからでも参照・設定できます。

このようにしてタグ付き値を指定して UML プロファイルを作成した例は次のとおりです。プロパティサブウィンドウでは、次の画像左側のように、プロパティ項目の一部として表示されます。プロパティダイアログでは、ダイアログの右側に、プロファイル名のグループ(この例では myStereo)のタブが追加され、プロファイルで定義した 2 つのタグ付き値が表示されます。この値を変更することができます。プロファイルの定義時に boolean
型を指定したタグ付き値はコンボボックスから値を選択できます。

Copyright (c) 2003-2021 Sparx Systems Japan

12

UML プロファイル 機能ガイド

4.2. 外見UML プロファイルで作成される要素の外見をあらかじめ定義しておくこともできます。
例えば、次のように外見を変更します。

こうして作成された UML プロファイルから要素を生成すると、同じ外見・大きさになります。

このように、UML プロファイルで定義されるステレオタイプを編集することで、便利なUML プロファイルを作成することができます。ぜひいろいろお試しください。

4.3. 描画スクリプト
描画スクリプトの機能を利用すると、UML プロファイルの要素の外見をより自由に定義

Copyright (c) 2003-2021 Sparx Systems Japan

13

UML プロファイル 機能ガイド

することができます。
ステレオタイプ要素にスクリプトを割り当てるためには、属性「_image」を定義する必要があります。

属性_image には、実際の描画内容を定義します。初期値の欄の横にある参照ボタンを押すことで、描画スクリプトエディタが起動します。このエディタを利用して、内容を入力してください。入力例とその結果の表示は次の画像をご覧ください。
描画スクリプトエディタの概要については、ヘルプをご覧ください。次の画像内のスクリプトも、ヘルプのサンプルを利用しています。

Copyright (c) 2003-2021 Sparx Systems Japan14

UML プロファイル 機能ガイド

4.4. クイックリンク
UML プロファイルで定義した要素の基本的な振る舞いは、元となっているメタクラスによって決まります。例えば、クラス要素を拡張した独自要素は、ソースコード生成機能を呼び出してソースコードを生成することができます。
クイックリンク機能についても同様です。第 2 章の例で定義した要素間でクリックリンクを利用する場合には、以下のように元となっているクラス要素とインタフェース要素間のルールが表示されます。

この内容を変更したい場合、例えば「通信ポート」と「通信機器」の間に作成できる接続を「通信経路」としたい場合には、クイックリンクのルールのカスタマイズが必要です。
以前のバージョンの Enterprise Architect では、CSV 形式でこのルールを定義する必要がありました。最新版の Enterprise Architect では、次の図のように、ステレオタイプ要素間に接続「ステレオタイプ関連」を作成し、「stereotype」の値に作成可能な接続のステレ
オタイプ名を設定するのみで、クイックリンクルールを定義できます。
(接続「ステレオタイプ関連」は、ツールボックスの「プロファイル 接続」グループ内にあります。)

Copyright (c) 2003-2021 Sparx Systems Japan15

UML プロファイル 機能ガイド(「ツールボックスの内容のみ」にチェックが入っている場合、今回作成したツールボックス(このドキュメントの例では myStereo)が表示されていないと、「通信経路」の選択肢は表示されません。)
ただし、この方法の場合には、上の画像のように UML でのルールもそのまま表示されます。このような UML のルールを表示しないようにするためには、メタクラス要素に属性

Copyright (c) 2003-2021 Sparx Systems Japan

16

UML プロファイル 機能ガイド「_HideUmlLinks」を追加し、初期値として「true」を指定する必要があります。

«metaclass»Class«metaclass»Interface-_HideUmlLinks: int = true+-isActive: Boolean_HideUmlLinks: int = true

通信ポート

通信機器
«stereotyped relationship»++

プロトコル = TCP
通信速度

この結果、次の画像のように指定した選択肢のみが表示されるようになります。

なお、この 4.4 節の設定の詳細もヘルプに記載がありますので、ぜひご覧ください。

Copyright (c) 2003-2021 Sparx Systems Japan

17

UML プロファイル 機能ガイド○改版履歴
2007/07/11 Enterprise Architect バージョン 7.0 リリースに伴い、内容を更新。
2008/03/06 Enterprise Architect バージョン 7.1 リリースに伴い、内容を更新。
2009/08/31 ドキュメントのタイトルを変更。
2010/04/16 Enterprise Architect 8.0 のリリースに伴い、内容を更新。
2011/05/18 Enterprise Architect 9.0 のリリースに伴い、内容を更新。
2012/10/26 Enterprise Architect 10.0 のリリースに伴い、内容を更新。
2012/12/27 バージョン 10.0 で追加されたウィザードを利用する内容に差し替え。
2014/03/01 Enterprise Architect 11.0 のリリースに伴い、内容を更新。
2016/10/07 Enterprise Architect 13.0 のリリースに伴い、内容を更新。
2019/12/02 4.4 節を追加。その他最新の内容に更新。
2020/09/02 Enterprise Architect 15.2 のリリースに伴い、内容を更新。
2021/12/27 最新版の内容に合わせて説明を調整。画面を更新。

Copyright (c) 2003-2021 Sparx Systems Japan18