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

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

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

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

特徴

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

操作・検索

• モデルブラウザからパッケージをマトリックス内に直接ドラッグ＆ドロップ
• 検索対象としてダイアグラムを指定
• 要素の名前・ステレオタイプ・タグ付き値を条件指定
• 要素・接続の種類を複数指定

表示

• ツリー表示(ソース側のみ。ただしターゲット側も階層が分かる表示)
• 要素が配置されているダイアグラムの確認　※表示例はこちら
• 要素の分類子と要素内に配置されている要素の関係を表示　※表示例はこちら
• 2接続先の要素の関係を表示　※表示例はこちら
• 条件指定による行・列の色付け

その他

• ソース・ターゲットの表示項目から、該当のパッケージ・要素・ダイアグラムへジャンプ
• マトリックス画像を付属ドキュメントに出力
• 条件指定したい要素・接続・ダイアグラムの種類をiniファイルで追加・削除・並べ替え
• Excel・Rtf・Htmlなどのファイル出力

起動方法

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

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

操作説明

マトリックスにデータを表示する方法は2つあります。

1. モデルブラウザからパッケージをマトリックス内にドラッグ＆ドロップする (D&Dマトリックス)
2. 検索パネルで条件指定する (通常マトリックス)

方法1(D&Dマトリックス) と 方法2(通常マトリックス)は併用できないため、 操作方法を途中で変更した場合、マトリックス内の表示データはクリアされます。

以下、D&Dマトリックス、検索パネルについて説明します。

D&Dマトリックス

モデルブラウザからパッケージをマトリックス内にドラッグ＆ドロップします。
複数のパッケージをドラッグ＆ドロップすることで、複数のパッケージを表示することができます。
（ドラッグ＆ドロップは1パッケージごとになります）

・ドラッグ＆ドロップ対象はパッケージのみとなります。
・表示対象は要素のみとなります。
・検索パネルで要素・接続の種類・方向の設定が必要です。
・ドロップしたパッケージがソース・ターゲットどちらに反映されるかについては、以下のとおりです。
　・表示データなしの場合、ドロップした位置がマトリックス内の左端(ソース)と上端(ターゲット)で近い方に反映されます。
　・表示データなしの場合、ツリー列あるいは列ヘッダにドロップすると追加反映されます。
・表示済パッケージと同じパッケージや親・子パッケージをドロップした場合の動作は、以下のとおりです。
　・同じパッケージをドロップした場合、もし配下に非表示としたものがあれば再表示します。
　・表示済パッケージの子パッケージをドロップした場合、表示済パッケージの配下にドロップしたパッケージが表示されます。
　・表示済パッケージの親パッケージをドロップした場合、親パッケージの配下に表示済パッケージが表示されます。
（マトリックス全体でモデルブラウザの表示に近づける動作となります）

コンテキストメニュー(右クリック)から、行・列を非表示にしたり、表示データをクリアすることができます。

行や列を非表示にすると、画面更新やプロファイル保存した場合も非表示が維持されます。

検索パネル

　マトリックス表示したい要素・接続の条件を指定します。項目によっては、モデルブラウザからドラッグ&ドロップで
　指定することも可能です。(オプションを有効にする必要があります)

#	項目	補足説明	D&D マトリックス
ソース(縦軸)
�@	検索対象	- クリックして表示される画面で、パッケージあるいはダイアグラムを指定します。  - パッケージ指定時は「P」、ダイアグラム指定時は「D」が先頭に表示されます。  - モデルブラウザからドラッグ&ドロップでも指定可能です。※	未使用
�A	表示対象	- 「要素」が固定表示されます。	←
�B	表示要素の種類	- 複数指定ができます。  - モデルブラウザからドラッグ&ドロップでも指定可能です。(複数指定可)※	←
�C	表示要素の詳細	- 表示要素の名前・ステレオタイプ・タグ付き値を指定することができます。	←
ターゲット(横軸)
�D	検索対象	- �@同様	未使用
�E	表示対象	- 「要素」「ダイアグラム」「要素内の要素」「2接続」を指定します。  - 「2接続」の操作説明はこちらをご覧ください。	「要素」のみ
�F	表示要素の種類	- �Dで「要素内の要素」を指定時は、要素の種類・ダイアグラムの種類の両方を指定できます。  - 複数指定ができます。  - モデルブラウザからドラッグ&ドロップでも指定可能です。(要素は複数指定可)※	←
�G	表示要素の詳細	- �C同様	←
�H	接続の種類	- �Dが要素の場合のみ有効で、複数指定ができます。	←
�I	接続の方向	- �Dが要素の場合のみ有効で、複数指定ができます。	←
�J	プロファイル	- 既存プロファイルを読み込み、�@〜�Iに反映します。	←
�K	表示更新	- �@〜�Iの内容あるいはドラッグ&ドロップの内容でマトリックスを表示(更新)します。	←
�L	保存	- マトリックス内で編集した接続情報をモデルに保存します。	←
�M	オプション	- 出力：マトリックスの内容をファイル出力します。  - プロファイル：表示条件のプロファイルの作成・更新・削除、ショートカット要素の作成をします。  - オプション：検索対象の子パッケージを含むなどのオプションを指定します。	←
�N	▲	- �@〜�I、�K〜�Lを折りたたみます。	←

※オプションを有効にする必要があります

「要素の詳細」画面
　要素の種類ごとに名前・ステレオタイプ・タグ付き値の条件を指定します。(ソース・ターゲットそれぞれで指定)

#	項目	補足説明
�@	検索項目	- [種類行] 要素の種類を表示します。(OR条件)  - [条件行]「要素名」「ステレオタイプ」「タグ付き値」を指定します。(種類内でAND条件)  　※種類行のみ(条件行なし)の要素の種類は、全件検索となります。
�A	タグ名	- 検索したいタグ名を選択あるいは入力します。(完全一致検索)  - �@が「タグ付き値」の場合のみ編集可能です。
�B	条件	- �@の内容により以下の表示となります。(編集不可) 　・要素名　　　　：含む 　・ステレオタイプ：同じ 　・タグ付き値　　：含む
�C	値	- �@の内容により以下となります。 　・要素名　　　　：検索したい要素名を入力します。(部分一致検索) 　・ステレオタイプ：検索したいステレオタイプを選択あるいは入力します。(完全一致検索) 　・タグ付き値　　：検索したいタグ付き値の値を入力します。(部分一致検索) 　　　　　　　　　　未入力の場合は�Aで指定したタグ名を持つ要素を検索します。
�D	コンテキストメニュー	- 条件一覧の枠内で右クリックすると以下のメニューが表示されます。    (右クリックした場所で操作可能なメニューのみが表示されます。) 　・条件を追加：条件行を追加します。 　・条件を削除：条件行を削除します。 　・種類を追加：要素の種類を追加します。 　・種類を削除：要素の種類を削除します。
�E	集計行を表示しない	- 有効な場合、マトリックスに集計行を表示しません。(ターゲットの場合は集計列)
�F	クリア	- 条件をクリアします。(種類を除く)

※検索パネルで「表示要素の種類」を変更した場合、「要素の詳細」画面の設定は初期化されますのでご注意ください。

2接続の設定
　検索パネルでターゲットの表示対象を「2接続」にすると、以下の画面に切り替わります。




「2接続の設定」画面
　ソースとターゲットの間にある中間要素との接続の種類・方向、中間要素の種類を指定します。

#	項目	補足説明
�@	2接続の設定	- 「2接続の設定」画面を表示します。
�A	接続の種類 (ソース-中間要素)	- 複数指定ができます。
�B	接続の方向 (ソース-中間要素)	- 複数指定ができます。
�C	中間要素の種類	- 複数指定ができます。
�D	接続の種類 (中間要素-ターゲット)	- 複数指定ができます。
�E	接続の方向 (中間要素-ターゲット)	- 複数指定ができます。

マトリックス表示

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

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

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

要素の並び順は、デフォルトではモデルブラウザ上の表示と同じです。
(ただしAPIで正確な並び順を取得できない場合は、名前順に表示しています。
 並び順を取得できない理由につきましてはこちらをご覧ください。)


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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ショートカット要素の利用

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

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

ショートカット要素からマトリックスの表示

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

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

マトリックスのファイル出力

表示したマトリックスの内容を、Excel・Rtf・Htmlなどのファイルに出力することができます。Excel・CSVで出力する場合は、マトリックス内の空欄セル（関係を持たない）を、空欄あるいはゼロのどちらで出力するか設定することができます。

プロファイルのエクスポート・インポート

プロファイルのエクスポート・インポートは、前述のショートカット要素のXMI出力・入力で行ないます。 XMI入力で作成されたショートカット要素をダブルクリックすると、プロファイルが作成されて拡張マトリックス画面に設定内容が表示されます。

もしショートカット要素と同名のプロファイルが既に存在している場合は、既存プロファイルを利用します。

※本機能はバージョン1.14.1以降で利用できます。

独自の表現形式

セルの矢印表示をCRUDのような独自の表現形式で表示・編集することができます。
これにより接続の存在だけでなく、接続の追加情報も表現することができます。

※ターゲット表示対象「要素」の場合のみ表示できます。
※オプション設定によっては表示できないケースがあります。
※本機能はEA標準の関係マトリックスの「表現」と互換性があります。
※本機能はバージョン2.1.0以降で利用できます。

CRUD表示例

独自表現の編集方法

独自表現の追加方法

オプション設定

下記オプションを設定できます。この設定はEA終了後も保持されます。(ただし、**印の項目は保持されません)

　設定内容
　・子パッケージを含む
　・要素を名前(別名)・タグ付き値の順に表示する
　・要素を別名で表示する
　・子要素を親要素と並列に表示
　　（子要素の種類のみ指定で子要素のみを表示）
　・関係の個数で条件指定し、行・列を色づけする
　・モデルブラウザやダイアグラムで選択した要素を選択状態にする
　・表示要素がないパッケージは表示しない
　・子要素の接続を親要素に表示し、子要素を表示しない
　・表示更新ボタンクリック時のみ検索結果を更新する
　・要素の編集、接続の作成・編集時に検索結果を自動更新する **
　　（アドイン起動時は常にオフとなります）
　・ドラッグ&ドロップを有効にする
　・表現形式（形式の追加を含む）

検索条件の種類表示のカスタマイズ
(要素・接続・ダイアグラムの種類の追加・削除・並べ替え・表示名変更)

検索条件として選択できる要素・接続・ダイアグラムの種類は、以下のようにiniファイルで設定しています。


※上記のMatrixEX_Default.iniは説明の便宜上、初期状態から編集しています。

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

このiniファイルを所定の場所にコピーして編集することで、選択できる種類の
追加・削除・並べ替え・表示名変更を行なうことができます。

iniファイルの編集方法は以下のとおりです。

iniファイルの編集方法

1. EAが起動していれば、終了します。
2. EAのインストールフォルダにある MatrixEX_Default.ini をドキュメントフォルダにコピーします。
• ドキュメントフォルダの例: C:\Users\<ユーザー名>\Documents
• iniファイル名は MatrixEX_*.ini とします。(*は任意の文字列)
• iniファイルはドキュメントフォルダに1つだけ配置します。複数配置されている場合はエラーとなります。
• EAを起動したときに、ドキュメントフォルダのiniファイルの内容が反映されます。
  ドキュメントフォルダにiniファイルがなければ、EAのインストールフォルダにある
  iniファイルの内容が反映されます。
3. ドキュメントフォルダにコピーしたiniファイルを、以下を参考に編集します。
   • iniファイルは、1行に1つの要素・接続・ダイアグラムの種類を設定します。
     1行ごとに以下のように4つの項目をカンマ区切りで設定します。
     
     項目1 : 「要素」「接続」「ダイアグラム」のいずれか
     項目2 : 表示名
     項目3 : 要素・接続・ダイアグラムの種類　※1 ※2
     項目4 : ステレオタイプ　※1
     
     ※1:項目1により設定方法が異なります。詳細は以下の設定例をご覧ください。
     ※2:APIと同様に英語名で指定する必要があります。(プロファイル利用時は除く)
     指定する文字列は、要素の種類の文字列 (サイト下部の「要素の種類名」)、
     接続の種類の文字列、ダイアグラムの種類の文字列をご確認ください。
     
     
   • 要素の設定例
     
     
     
   • 接続の設定例
     
     
     
   • ダイアグラムの設定例
     
     
     
   • iniファイルの先頭行から順番に画面の要素・接続・ダイアグラムの種類に表示されます。
   • パッケージを要素として表示したい場合は、ダウンロードファイルのsampleフォルダにある
     MatrixEX_Sample.ini に書かれている要素のパッケージの行を、読み込み対象となるiniファイルに
     コピー＆ペーストしてください。検索対象がパッケージの場合のみ、パッケージが要素として
     マトリックスに表示されます。尚、この変更を行なっても画面の要素の種類にパッケージは
     表示されませんのでご注意ください。
     
4. EAを起動します。

特記事項
・既定のUMLの種類以外を追加する場合のサンプルとして、ダウンロードファイルのsampleフォルダにある
　MatrixEX_Sample.ini がございますのでご活用ください。
・アドインをインストールすると、EAのインストールフォルダにある MatrixEX_Default.ini は
　常に上書きされます。お客様自身でiniファイルを作成するときは必ず上記のドキュメントフォルダにiniファイルを
　配置してください。
・要素・接続・ダイアグラムの種類の検索はiniファイルに記載された種類のみとなります。
　画面で「(すべてを選択)」を指定した場合、画面の要素・接続・ダイアグラムの種類にリスト表示されている
　種類すべて、という意味になります。リスト表示されていない種類は検索対象となりませんのでご注意ください。
・EAのバグを回避するため、iniファイルで「接続,追跡,Abstraction,EAUML::trace」を設定し、
　画面の条件で「追跡」を指定した場合に、接続の種類 = Dependency も合わせて検索結果として表示されます。
　また、検索結果の表示後に接続を作成する場合は、接続の種類 = Abstraction として接続が作成されます。
　尚、iniファイルで「接続,追跡,Dependency,EAUML::trace」が設定されている場合は、上記動作はせずiniファイルで
　設定された接続のみを条件として動作します。（※本動作はバージョン1.14.2以降が対象となります）

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

利用しているiniファイルが古いと、以下のメッセージが表示されることがあります。


これは新しいバージョンのアドインをインストールしたときに、iniファイルの更新があったことを示しています。
利用しているiniファイルが古いとアドインが正しく動作しないことがあるため、以下の手順でiniファイルを編集してください。

1. EAが起動していれば、終了します。
2. iniファイルの変更履歴を確認し、以下を参考に必要に応じて、上記画面の「利用しているiniファイル」(Aとします)を編集します。
   ・[追加]の行を利用したい場合は、Aに追加します。
   ・[変更]に該当する行がAにあれば、変更履歴より該当行をコピーし、Aの該当行に上書きコピーします。
   ・[削除]に該当する行がAにあれば、削除したい場合はAの該当行を削除します。
3. EAのインストールフォルダにある MatrixEX_Default.ini の1行目をコピーして、Aの1行目を上書きします。（バージョン情報が記載されいてる1行目を更新します）
4. EAを起動します。