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

特徴

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

• ソース(縦軸)のパッケージ・要素をツリー表示します。
• 要素がどのダイアグラムに配置されているかを確認できます。
• 検索対象にパッケージだけでなくダイアグラムを指定することができます。
  (ダイアグラムに配置されている要素を表示対象にできます)
• 要素・接続の種類を複数指定して一度に確認することができます。
• ソース(縦軸)・ターゲット(横軸)のダイアグラム名や要素名をダブルクリックすると
  該当ダイアグラムを開いたり、プロジェクトブラウザの該当要素を選択状態にします。
• 条件を指定して行・列の色付けをすることができます。
• 条件指定したい要素・接続・ダイアグラムの種類をiniファイルで追加・削除・並べ替えをすることができます。
• Excel・Word・Htmlなどにファイル出力することができます。

起動方法

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

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

操作説明

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

ターゲット(横軸)
�C 検索対象(パッケージorダイアグラム)を指定します。クリックすると参照画面が表示されます。
　 パッケージ指定時は"P"、ダイアグラム指定時は"D"が先頭に表示されます。
�D 表示対象(要素orダイアグラム)を指定します。クリックすると表示が替わります。
�E 表示したい要素・ダイアグラムの種類を指定します。(複数指定可)

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

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

マトリックス表示

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

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

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


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

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

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

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

＜表示例＞ 要素がどのダイアグラムに配置されているかの関係

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

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

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

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

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

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

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

オプション設定

下記オプションを設定することもできます。この設定はEA終了後も保持されます。

　主な設定内容
　・子パッケージを含む
　・要素の名前順に表示する
　・要素を別名で表示する
　・関係の個数で条件指定し、行・列を色づけする
　・モデルブラウザやダイアグラムで選択した要素を選択状態にする
　・子要素の接続を親要素に表示し、子要素を表示しない
　・表示更新ボタンクリック時のみ表示更新する

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

初期状態では、表示条件として選択できる要素・接続・ダイアグラムの種類は、既定のUMLの種類のみとなります(ダイアグラムはUML以外もあり)。選択できる要素・接続・ダイアグラムの種類はすべてiniファイルで設定されており、このアドインをインストールすると初期状態のiniファイルとして、Enterprise Architectのインストールフォルダに MatrixEX_Default.ini が配置されます。MatrixEX_Default.iniの内容(一部抜粋)は以下のようになっています。

お客様自身でiniファイルを作成することで、要素・接続・ダイアグラムの種類の追加・削除・並べ替えを行なうことができます。
作成手順としては、MatrixEX_Default.ini をコピーして別のiniファイルを作成して、要素・接続・ダイアグラムの種類の追加・削除・並べ替えを行ない、そのiniファイルを所定の場所に配置します。iniファイルの仕様・配置については以下をご確認ください。

仕様：

• iniファイル名は MatrixEX_*.ini(*は任意の文字列)とします。
• 1行に1つの要素・接続・ダイアグラムの種類を設定します。
• 設定内容はカンマ区切りで以下となります。
  　"要素"or"接続"or"ダイアグラム", 表示名, 要素・接続・ダイアグラムの種類(※1), ステレオタイプ(※2)
  接続の場合、※2にプロファイル名付きのステレオタイプも利用できます。
  ダイアグラムでUML以外の場合、※1はプロファイル名、※2はプロファイルで指定したダイアグラムの種類、としても利用できます。
• 要素・接続・ダイアグラムの種類は、APIと同様に英語名で指定する必要があります(プロファイル利用時は除く)。指定する文字列につきましては、要素の種類の文字列(サイト下部の「要素の種類名」)、接続の種類の文字列、ダイアグラムの種類の文字列をご確認ください。
• iniファイル内の先頭行から順番に画面の要素・接続・ダイアグラムの種類に表示されます。
• パッケージを要素として表示したい場合は、ダウンロードファイルのsampleフォルダにある MatrixEX_Sample.ini に書かれている要素のパッケージの行を、読み込み対象となるiniファイルにコピー＆ペーストしてください。尚、この変更を行なっても画面の要素の種類にパッケージは表示されませんのでご注意ください。

配置：

• iniファイルはドキュメントフォルダに1つだけ配置します。(例: C:\Users\<ユーザー名>\Documents)
• Enterprise Architectを起動したときに、ドキュメントフォルダにiniファイルがあれば、そのiniファイルの内容が反映されます。iniファイルがなければ、Enterprise Architectのインストールフォルダにあるiniファイル(インストール時はMatrixEX_Default.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.6.0 (2019/10/18 update)
addin_MatrixEX.zip (日本語版/Japanese version)
addin_MatrixEXEn.zip (英語版/English version)

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

・このアドインは、Enterprise Architect14.0 ビルド1420以降で動作します。これより古いバージョン・ビルドでは動作しません。
　This addin works on Enterprise Architect 14.0 build 1420 or later.
・日本語版と英語版は共存できません。インストールしたアドインの言語を変更する場合は、既にインストールされているアドインを
　アンインストールしてからご希望の言語のアドインをインストールしてください。
　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.
・ご利用の前にダウンロードファイルに含まれる Readme を必ずご確認ください。
　Be sure to read the Readme which included in download files before using this addin.

リリースメモ

こちらをご覧下さい。

特記事項

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