このオプション ページに移動するには、ファイル > レポート... を選択します。
Merge には、ファイル比較からレポートを生成するいくつかの方法があります。レポートは、ディスク上に記録保管したりウェブ サイトに配置したりするのに適した形式の、ファイル比較の静的表現です。
レポートの作成
ファイル比較のレポートを作成するには、［ファイル］メニューの［レポート...］コマンドを使用します。下に示したようなウインドウが現れます。
ウインドウの左側の列に作成できるレポートの種類が表示されます。レポートの種類をクリックすると、そのレポートの種類に対応する設定オプションのページが表示されます。現在選択できるレポートの種類については、［ヘルプ］ボタンをクリックしてください。
選択したレポートの種類に応じたオプションを設定または点検し、レポートを書き出す場所を選択したら、［保存...］ボタンをクリックしてレポートを作成します。
レポートの種類
HTML
HTML レポートは、比較されたファイルに関する情報が含まれおり、比較結果を並べて表示することができます。それらは多くの異なったウェブブラウザーで開くことができ同僚に電子メールで送信したり保存することができます。画面上でファイル比較の外観に影響するほとんどのオプションはレポートの生成時に使用されます。
XML
XML レポートは、比較結果を並べて表示するための比較されたファイルとデータに関する情報が含まれています。画面上でファイル比較の外観に影響するほとんどのオプションはレポートの生成時に使用されます。
このレポートタイプには構成可能なオプションはありません。
UNIX diff
このタイプのレポートは人気が高い UNIX diff プログラムによって作成されたレポートに似ています。編集スクリプト レポート（デフォルトの diff 出力形式）、コンテキスト diff レポート（diff の -c オプション）およびユニファイド diff レポート（diff の -u オプション）の作成が行えます。
Merge による diff スタイル レポートの出力は、実際の diff プログラムで生成されるレポートとは同一ではないことに注意してください。Merge と diff では異なるアルゴリズムを使ってファイル間の変更を判断します。多くの変更については同じように判断しますが、若干異なる場合があります。
ファイル比較レポートの例
さまざまな種類のレポートの例があります。
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 |
レポートが作成された時の主なオプションと正規表現。これらはほとんど説明を要しません。オプション名と値は、AppleScript API ドキュメント中の説明に対応しています。 |
mg:fileDetails |
この要素のインスタンスは比較されたファイルごとに存在し、ファイルの名前、タイトル（たとえば、compare.exe コマンド ライン ユーティリティでタイトルが指定された場合）、パスおよび最終更新日時を提供します。 |
mg:changeSummaries |
HTML レポートの '比較の概要' セクションで使用するための統計情報。（Merge ファイル比較の［比較の統計情報］ウインドウにも表示される）。 |
mg:classes |
この要素のインスタンスは比較されたファイルごとに存在し、それぞれ 4 つの mg:class 子要素、つまりテキスト ブロック（変更なし、削除箇所、挿入箇所、および変更箇所）ごとに 1 つずつ子要素を含み、そのタイプのテキストの表示フォントと色の情報を提供します。
|
行データ
mg:rowData はファイル比較実行の実際の結果を含みます。一つファイルから他のファイルへの変化したテキストのブロックに対応した多くの mg:rowGroup 要素からできています。
それぞれの mg:rowGroup 要素中には一つ以上の mg:rows および（または）mg:omitted 要素があります。
mg:omitted が存在する場合、［前後関係を示す X 行だけを表示する］が有効なために一つ以上の行（行のペアあるいはトリプレット）が比較から省略されたという事実を単に記録します。
各 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 レポートで比較ファイルの先頭から末尾に向かって行を示すように並べられます。