拡張マトリックスアドイン

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


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




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

特徴

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

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


起動方法

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

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



操作説明

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

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

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

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


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



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



⑮ ソースと中間要素の間の、接続の種類を指定します。(複数指定可)
⑯ ソースと中間要素の間の、接続の方向を指定します。(複数指定可)
⑰ 中間要素の種類を指定します。(複数指定可)
⑱ 中間要素とターゲットの間の、接続の種類を指定します。(複数指定可)
⑲ 中間要素とターゲットの間の、接続の方向を指定します。(複数指定可)



マトリックス表示

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

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

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


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


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


接続の追加・削除
接続の追加・削除は対象セルで以下いずれかの方法で行ないます。
・ダブルクリックする(※1)
・スペースキーを押す(※1)
・右クリックで表示されるコンテキストメニューより選択する(上図参照)
追加時は矢印アイコンが表示され、削除時は矢印アイコンが消えます。作業が終了したら保存ボタンをクリックするとモデルに保存されます。接続の方向が複数指定されている場合、接続の追加・削除はできません。
※1: 接続の種類が1つ指定されている場合に利用できます。


ダイアグラム・要素へジャンプ
ソース・ターゲットのダイアグラム・要素をダブルクリックすると、対象ダイアグラムを開いたり、ダイアグラム上あるいはプロジェクトブラウザ上の対象要素を選択状態にします。



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

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



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

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


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



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

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

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



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

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



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



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

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



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

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

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


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



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


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

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




オプション設定

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


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



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

表示したい要素・接続・ダイアグラムの種類は、以下のようなiniファイルで設定しています。



初期状態では、既定のUMLの種類のみが設定されています(ダイアグラムはUML以外もあり)。
このアドインをインストールすると初期状態のiniファイル(MatrixEX_Default.ini)が、Enterprise Architectのインストールフォルダに配置されます。



要素・接続・ダイアグラムの種類の追加・削除・並べ替え
手順概要としては以下となります。
　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 : "要素" or "接続" or "ダイアグラム"
　　項目2 : 表示名
　　項目3 : 要素・接続・ダイアグラムの種類
　　項目4 : ステレオタイプ
　要素の場合、項目4を*とするとすべてのステレオタイプが対象となります。
　接続の場合、項目4にプロファイル名付きのステレオタイプも利用できます。
　ダイアグラムでUML以外の場合、項目3はプロファイル名、項目4はプロファイルで
　指定したダイアグラムの種類、としても利用できます。
・要素・接続・ダイアグラムの種類は、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を再起動します。



アドインのインストール・アンインストール
How to install or uninstall this addin

このアドインを利用するには、以下のリンクからアドインのファイルをダウンロードして下さい。
To use this addin, please download this addin files from the following link.

Version 1.12.1 (2020/08/12 update)
addin_MatrixEX.zip (日本語版)
addin_MatrixEXEn.zip (English version)


日本語版のインストール・アンインストール方法はこちらをご覧下さい。
Please refer to here for how to install or uninstall this addin English version.


特記事項/Remarks

日本語
・動作環境
　・Enterprise Architect 15.0以降
 　・.NET4.5.2以降
・日本語版と英語版は共存できません。
　インストールしたアドインの言語を変更する場合は、既にインストールされているアドインをアンインストールしてから
　ご希望の言語のアドインをインストールしてください。
・ご利用の前にダウンロードファイルに含まれる Readme を必ずご確認ください。


English
・System Requirements
　・Enterprise Architect 15.0 or later
 　・.NET4.5.2 or later
・English version
　If you use the version 1.7.0 or earlier, please remove \en\MatrixEX.resources.dll in EA install path
　after installing this addin since the layout may not show properly.
・The Japanese version and English version cannot coexist. If you want to change the language of the installed addin,
　uninstall the installed addin, and then install the addin of the launguage that you want to use.
・Be sure to read the Readme which included in download files before using this addin.


リリースメモ

こちらをご覧下さい。


特記事項

  • このアドインは、サポートが有効な期間中のみ無料でダウンロードあるいは利用できます。