文書の比較

Word APIの文書の比較は、Microsoft Wordで作成した、2つの文書を比較して差分を確認する機能です。
差分の確認方法として、以下の3つを用意しています。

文書の比較

2つの文書を比較して、挿入・削除部分に下線等の修飾をした文書を作成します。
作成された文書から差分箇所を確認することができます。

Microsoft Wordの文書の比較の例

Microsoft Wordの文書の比較機能を使用した例です。
[校閲]-[比較]で表示される[文書の比較]ダイアログに比較対象のファイルを選択することによって、文書の比較をすることができます。
以下の図は、Microsoft Wordで、原本(左)と改訂版(右)を比較した結果(中央)の例です。
原本の赤枠部分は改訂版で削除された箇所を表しています。
改訂版の青枠部分は改訂版で追加された箇所を表しています。

Compare documents by Microsoft Word Results1 Image

Compare documents by Microsoft Word Results2 Image

Word APIの文書の比較の例

Word APIも同様に、文書を比較し挿入・削除部分に下線等の修飾をした文書を出力することができます。
以下の図は、Word APIで、原本(左)と改訂版(右)を比較した結果(中央)の例です。
原本の赤枠部分は改訂版で削除された箇所を表しています。
改訂版の青枠部分は改訂版で追加された箇所を表しています。

Compare documents by WordAPI Results1 Image

Compare documents by WordAPI Results2 Image

変更割合の取得

Word APIでは、2つの文書を比較して、以下の割合を百分率で取得します。
変更割合は本文領域の差異のみを取得します。

  • 一致(Same Ratio)
  • 削除(Deleted Ratio)
  • 挿入(Inserted Ratio)

Word APIの変更割合の取得の例

Word APIで以下の画像の変更割合を取得を実行すると、一致・削除・挿入は以下の通りを取得します。

  • Same Ratio is 60%
  • Deleted Ratio is 31%
  • Inserted Ratio is 9%

Compare documents by WordAPI Results1 Image

Compare documents by WordAPI Results2 Image

新旧対照表の作成

Word APIでは、2つの文書を比較して、差分箇所の新旧対照表を作成します。
作成される新旧対照表は、左の列を改定後欄、右の列を改訂前欄からなる表です。
各行に表示される内容は、差分内容によって以下の文字飾りを行います。
新旧対照表は本文領域の差異のみから作成します。

変更内容 改訂後欄 改訂前欄
削除された段落 [削除] 二重傍線が引かれた文字列
追加された段落 二重傍線が引かれた文字列 [追加]
変更された段落 差異箇所に下線が引かれた変更後の文字列 差異箇所に下線が引かれた変更前の文字列

Word APIの新旧対照表の作成の例

以下の図は、Word APIで原本(左)と改訂版(右)を比較して作成した新旧対照表(中央)の例です。

Comparison Table result

サンプルファイル

[Install directory]/samples/templates/文書比較.zipに文書の比較のサンプルファイルを含んでおります。