Merge には、ファイル比較からレポートを生成するいくつかの方法があります。レポートは、ディスクまたはウェブサイト上のストレージに適した形式の、ファイル比較の静的な表現です。
下記の関連項目に、現在ファイル比較で作成できるレポートの種類が一覧表示されています。
レポートの作成
ファイル比較のレポートを作成するには、リボンまたはツールバーの[レポート]
ボタンをクリックします。下に示したようなウィンドウが現れます。

作成できるレポートの種類が表示されます。レポートの種類をクリックすると、そのレポートの種類に対応する設定オプションのページが表示されます。現在選択できるレポートの種類については、[?](ヘルプ)ボタンをクリックしてください。
選択したレポートの種類に応じたオプションを設定または点検し、レポートを書き出す場所を選択したら、[保存...]ボタンをクリックしてレポートを作成します。
ファイル比較レポートの例
さまざまな種類のレポートの例があります。
XML ファイル比較レポートについて
XML 比較レポートはほかのアプリケーションからもさらに加工できるので便利です。以下の情報は、主に XML レポートを処理するようなソフトウェアを作成しようとしている方を対象としています。HTML 比較レポートは、同等の XML レポートで XSLT 変換を実行することによって作成されます。したがって、この 2 種類のレポートは非常に密接に関連しています。
ルート要素
XML ファイル比較レポートはトップレベル mg:report 要素に含まれます。
mg:report は mg:metaData と mg:rowData の 2 つの子要素を含みます。
メタデータ
mg:metaData には、レポートが実行されたときに比較していたファイルや有効だった Merge オプションなどの、レポートに関する情報が含まれています。レポートの内容がその生成時の Merge オプションによって影響を受けることを理解することは重要です。mg:metaData の要素は次のとおりです。
| 要素 | 説明 |
|---|---|
mg:title |
レポートのタイトル。 |
mg:id |
レポートの ID。1 回でいくつかのレポートが作成されるとき(たとえば、ファイル比較レポートへのリンクを持ったフォルダー比較レポート)、レポートの番号として使用されます。 |
mg:date |
レポートが作成された日付。 |
mg:options |
レポートが作成されたときの主なオプションと正規表現。これらはほとんど説明を要しません。オプション名と値は、オートメーション API ドキュメント中の説明に対応しています。 |
mg:fileDetails |
この要素のインスタンスは比較されたファイルごとに存在し、ファイルの名前、タイトル(たとえば、compare.exe コマンド ライン ユーティリティでタイトルが指定された場合)、パスおよび最終更新日時を提供します。 |
mg:changeSummaries |
HTML レポートの '比較の概要' セクションで使用するための統計情報(Merge ファイル比較の[比較の統計情報]ウィンドウにも表示される)。 |
mg:classes |
この要素のインスタンスは比較されたファイルごとに存在し、それぞれ 4 つの mg:class 子要素、つまりテキスト ブロック(変更なし、削除箇所、挿入箇所、および変更箇所)ごとに 1 つずつ子要素を含み、そのタイプのテキストの表示フォントと色の情報を提供します。
|
行データ
mg:rowData にはファイル比較実行の実際の結果が含まれます。これは、あるファイルと別のファイル間での変更テキストのブロックに対応した多くの mg:rowGroup 要素で構成されます。
それぞれの mg:rowGroup 要素中には 1 つ以上の mg:rows および(または)mg:omitted 要素があります。
mg:omitted が存在する場合、[前後関係を示す X 行だけを表示する]オプションが有効なために 1 つ以上の行(2 行または 3 行)が比較から省略されたという事実を単に記録します。
各 mg:row には mg:ln 要素のペア(2 者間比較)またはトリプレット(3 者間比較)が含まれています。したがって、mg:row は、それぞれのファイルの 1 行を互いに別のファイルへ関係付ける比較の 1 行を構成します。関連する行がない場合、テキスト ブロックが挿入または削除された場合で、mg:ln 要素は相当するファイルのみに存在します。したがって、(もちろん、行が削除されなかった場合)レポートには、オリジナル ファイルの各テキスト行ごとに正確に 1 つの mg:ln 要素があります。
各 mg:ln 要素はそれがどこに属する(左から右に 1、2、3 の番号)ファイルであるかを示す file 属性を持っています。またそれが属するファイル中の行番号を提供する number 属性を持っています。最後に、行が全体として挿入箇所(‘I’)、削除箇所(‘R’)、変更箇所(‘C’)あるいは変更なし(‘U’)であるとみなされるかどうかを示す class 属性を持っています。
mg:ln 要素は mg:sg 子要素を含むことができます。各 mg:sg が特定のハイライト カラーで文字の連続を表して、行の中で変更箇所を強調して示します。各セグメントは挿入箇所、削除箇所、変更箇所あるいは変更なしのテキストのどのセグメントを表示するかを示す mg:ln に類似した class 属性を持っています。Merge は長く連続したテキストを、それぞれ 10 文字を超えないように隣接したセグメントに分割します。これは XSLT(HTML 比較レポートを作成する)が行の折り返しの範囲を割り当てることを容易にします。
ファイル比較では空白と行終端文字(CR と LF)が重要なので、これらは明示的に mg:s、mg:cr および mg:lf 要素によってセグメントの中でコード化されます。これはこれらの文字についての情報が XML 解析プロセスを切り抜けて残ることを保証します。
mg:rowGroup 要素と mg:row および mg:ln 子要素は XML レポートで比較ファイルの先頭から末尾に向かって行を示すように並べられます。
