（アドインのダウンロードはこちら、リリースメモはこちら）

拡張マトリックスアドインを利用すると、さまざまな条件で、パッケージ内やダイアグラム上の要素間の関係を確認できます。また、要素が配置されているダイアグラムや、要素の分類子と要素内に配置されている要素の関係を確認できます。

ここでは以下の内容についてご紹介します。

• 特徴
• 起動方法
• 操作説明
• マトリックス表示
  • ＜表示例＞ パッケージ内とダイアグラム上の要素間の関係
  • ＜表示例＞ パッケージ内とパッケージ内の要素間の関係
  • ＜表示例＞ 要素が配置されているダイアグラムの確認
  • ＜表示例＞ パッケージを要素として表示
  • ＜表示例＞ 要素の分類子と要素内に配置されいてる要素の関係
  • ＜表示例＞ 2接続先の要素の関係
• ツリーの展開・折りたたみ
• ショートカット要素の作成とマトリックス画像出力
• オプション設定
• 要素・接続・ダイアグラムの種類の追加・削除・並べ替え・表示名変更
• アドインのインストール・アンインストール (How to install or uninstall this addin)
• リリースメモ

特徴

Enterprise Architect標準の関係マトリックス機能では実現できない、以下のような表示・機能が含まれます。

• ソース(縦軸)をツリー表示
• 要素が配置されているダイアグラムの確認
• 要素の分類子と要素内に配置されている要素の関係を表示
• 2接続先の要素の関係を表示
• 検索対象にパッケージだけでなくダイアグラムも指定可能
• 要素・接続の種類を複数指定
• ソース(縦軸)・ターゲット(横軸)のダイアグラム名や要素名から、該当ダイアグラムや該当要素へジャンプ
• 条件指定による行・列の色付け
• 条件指定したい要素・接続・ダイアグラムの種類をiniファイルで追加・削除・並べ替え
• Excel・Word・Htmlなどのファイル出力

起動方法

アドインをインストール後、プロジェクトを開いている状態で「アドイン・拡張」リボン内の「アドインメニュー」パネルにある「拡張マトリックス」をクリックすると、拡張マトリックス画面が表示されます。

アドインのダウンロードにつきましてはこちらをご覧ください。

操作説明

ソース(縦軸)
�@ 検索対象(パッケージ/ダイアグラム)を指定します。クリックすると参照画面が表示されます。
　 パッケージ指定時は「P」、ダイアグラム指定時は「D」が先頭に表示されます。
�A 表示対象(要素)が表示されます。
�B 表示したい要素の種類を指定します。

ターゲット(横軸)
�C 検索対象(パッケージ/ダイアグラム)を指定します。クリックすると参照画面が表示されます。
　 パッケージ指定時は「P」、ダイアグラム指定時は「D」が先頭に表示されます。
�D 表示対象(要素/ダイアグラム/要素内の要素/2接続)を指定します。
　※「2接続」は、ソース − 中間要素 − ターゲット のように、ソースから2接続先のターゲット
　　との関係を表示します。
�E 表示したい要素・ダイアグラムの種類を指定します。(複数指定可)
　 ※�Dで要素内の要素を指定時は、要素の種類・ダイアグラムの種類の両方を指定できます。

�F 接続の種類を指定します。(�Dが要素の場合のみ有効、複数指定可)
�G 接続の方向を指定します。(�Dが要素の場合のみ有効、複数指定可)

�H 既存プロファイルを読み込み、�@〜�Gに反映します。
�I �@〜�Gの内容でマトリックスを表示します。
�J マトリックス内で編集した接続情報をモデルに保存します。
�K オプション
　・出力：表示されているマトリックスの内容をファイル出力します。
　・プロファイル：�@〜�Gの内容のプロファイルを作成したり、既存プロファイルの更新・削除をします。
　・検索行を表示：マトリックス内に検索行を表示します。
　・オプション：検索対象の子パッケージを含むなどのオプションを指定します。詳細はこちらをご覧ください。
�L �@〜�G、�I〜�Jを折りたたみます。


�Dで「2接続」を指定した場合、以下の画面に切り替わります。

�M 2接続の条件を指定する以下の画面が表示されます。

�N ソースと中間要素の間の、接続の種類を指定します。(複数指定可)
�O ソースと中間要素の間の、接続の方向を指定します。(複数指定可)
�P 中間要素の種類を指定します。(複数指定可)
�Q 中間要素とターゲットの間の、接続の種類を指定します。(複数指定可)
�R 中間要素とターゲットの間の、接続の方向を指定します。(複数指定可)

マトリックス表示

表示可能な条件が指定されると自動的に以下のように検索結果がマトリックスで表示されます。
(オプション設定によっては表示更新ボタンをクリックする必要があります)

表示条件を変更すると変更した表示条件の検索結果が表示されます。
また、表示更新ボタンをクリックすると検索結果を最新情報に更新します。

表示更新時にマトリックスのソース側はツリーが展開された状態で表示されます。
ただし、パッケージの配下に要素がなく、子パッケージ以下にも要素がないパッケージは
展開しない状態で表示し、要素に着目しやすいようになっています。


以下にマトリックス表示例をご紹介します。

＜表示例＞ パッケージ内とダイアグラム上の要素間の関係

＜表示例＞ パッケージ内とパッケージ内の要素間の関係

オプション指定でターゲット側に子パッケージ以下の要素を表示できます。
ただし、上図と同じようにすべての要素が同じ階層で表示されます。

＜表示例＞ 要素が配置されているダイアグラムの確認

オプション指定でターゲット側に子パッケージ以下のダイアグラムを表示できます。
ただし、上図と同じようにすべてのダイアグラムが同じ階層で表示されます。

下図のように分類子としての利用状況を確認できます。

＜表示例＞ パッケージを要素として表示

パッケージの行・列には接続の集計値が表示されますが、下図のようにパッケージを要素として表示したり、接続を追加・削除したりできます。

上図のようにパッケージを要素として表示したい場合、iniファイルの編集が必要です。編集方法につきましてはこちらをご覧ください。

＜表示例＞ 要素の分類子と要素内に配置されいてる要素の関係

ターゲット側は要素内に配置された要素のみが表示されます。(上図ではレーン内に配置された要素)

＜表示例＞ 2接続先の要素の関係

ツリーの展開・折りたたみ

ツリーの展開・折りたたみは下図のようにツリーのコンテキストメニュー(右クリック)からもできます。

ショートカット要素の作成とマトリックス画像出力

ショートカット要素の作成

プロファイルを指定したショートカット要素をパッケージやダイアグラムに作成することできます。
たとえば、ダイアグラムに配置したショートカット要素をダブルクリックすると、指定されたプロファイルで
拡張マトリックス画面を表示することができます。

ショートカット要素の作成

ショートカット要素をダブルクリックして拡張マトリックス画面を表示

ショートカット要素にマトリックス画像を出力

上記で作成したショートカット要素の付属ドキュメントにマトリックス画像を出力することできます。
付属ドキュメントに出力したマトリックス画像は、EA標準のドキュメント生成で出力することができます。

オプション設定

下記オプションを設定できます。この設定はEA終了後も保持されます。(一部の項目は除く)

　主な設定内容
　・子パッケージを含む
　・要素の名前順に表示する
　・要素を別名で表示する
　・子要素を親要素と並列に表示(ソース側)
　・関係の個数で条件指定し、行・列を色づけする
　・モデルブラウザやダイアグラムで選択した要素を選択状態にする
　・子要素の接続を親要素に表示し、子要素を表示しない
　・表示更新ボタンクリック時のみ表示更新する
　・モデル更新時に検索結果を自動更新する
　　(アドイン起動時は常にオフとなります)

要素・接続・ダイアグラムの種類の追加・削除・並べ替え・表示名変更

表示する要素・接続・ダイアグラムの種類は、以下のようなiniファイルで設定しており
追加・削除・並べ替え・表示名変更を行なうことができます。

このアドインをインストールすると初期状態のiniファイル (MatrixEX_Default.ini) が
Enterprise Architectのインストールフォルダに配置されます。

初期状態では、既定のUMLの種類のみが設定されています。(ダイアグラムはUML以外もあり)

iniファイルの編集方法

手順

1. MatrixEX_Default.ini をコピーして所定の場所に配置します。
2. 1でコピーしたiniファイルを編集します。

iniファイルの配置場所や仕様については下記詳細をご覧ください。

詳細

配置場所とファイル名：
・iniファイルはドキュメントフォルダに1つだけ配置します。(例: C:\Users\<ユーザー名>\Documents)
・iniファイル名は MatrixEX_*.ini とします。(*は任意の文字列)

　※Enterprise Architectを起動したときに、ドキュメントフォルダのiniファイルの内容が反映されます。
　　ドキュメントフォルダにiniファイルがなければ、Enterprise Architectのインストールフォルダにある
　　iniファイルの内容が反映されます。
　※同一フォルダ内にiniファイルが複数配置されている場合はエラーとなります。

ファイル仕様：
・1行に1つの要素・接続・ダイアグラムの種類を設定します。
・設定項目はカンマ区切りで以下となります。
　　項目1 : 「要素」「接続」「ダイアグラム」のいずれか
　　項目2 : 表示名
　　項目3 : 要素・接続・ダイアグラムの種類
　　項目4 : ステレオタイプ

　　※項目1
　　　・「要素」の場合、項目4を「*」とするとすべてのステレオタイプが対象となります。
　　　・「接続」の場合、項目4にプロファイル名付きのステレオタイプも利用できます。
　　　・「ダイアグラム」でUML以外の場合、項目3にプロファイル名、項目4にプロファイルで
　　　　指定したダイアグラムの種類、を指定することもできます。

　　※項目3
　　・APIと同様に英語名で指定する必要があります。(プロファイル利用時は除く)
　　　指定する文字列は、要素の種類の文字列 (サイト下部の「要素の種類名」)、
　　　接続の種類の文字列、ダイアグラムの種類の文字列をご確認ください。

・iniファイルの先頭行から順番に画面の要素・接続・ダイアグラムの種類に表示されます。
・パッケージを要素として表示したい場合は、ダウンロードファイルのsampleフォルダにある
　MatrixEX_Sample.ini に書かれている要素のパッケージの行を、読み込み対象となるiniファイルに
　コピー＆ペーストしてください。尚、この変更を行なっても画面の要素の種類にパッケージは
　表示されませんのでご注意ください。

その他

・アドインをインストールすると、Enterprise Architectのインストールフォルダにある MatrixEX_Default.ini は
　常に上書きされます。お客様自身でiniファイルを作成するときは必ず上記のドキュメントフォルダにiniファイルを
　配置してください。
・要素・接続・ダイアグラムの種類の検索はiniファイルに記載された種類のみとなります。
　画面で「(すべてを選択)」を指定した場合、画面の要素・接続・ダイアグラムの種類にリスト表示されている
　種類すべて、という意味になります。リスト表示されていない種類は検索対象となりませんのでご注意ください。
・既定のUMLの種類以外を追加する場合のサンプルとして、ダウンロードファイルのsampleフォルダにある
　MatrixEX_Sample.ini がございますのでご活用ください。

利用しているiniファイルを最新バージョンに修正する方法

新しいバージョンのアドインをインストールすると現在利用しているiniファイルが古く、修正が必要の可能性あり、の旨のメッセージが表示されることがあります。メッセージが表示された場合、iniファイルを修正しないとiniファイルの設定が正しく反映されなかったり、アドインが正しく動作しないことがあります。そのため、以下の手順でiniファイルの内容確認および修正をしてください。
　1. メッセージに表示されている現在利用している、iniファイルを開きます。(Aとします)
　2. iniファイルの変更履歴の中で
　　　・[追加]の行を利用したい場合は、Aに追加します。
　　　・[変更]に該当する行がAにあれば、変更履歴より該当行をコピーし、Aの該当行に上書きコピーします。
　　　・[削除]に該当する行がAにあれば、削除したい場合はAの該当行を削除します。
　3. 修正が終了したらEAを再起動します。