💡 完全な動作例は GitHub で入手できます:
metadata-diff-doc-versions-using-groupdocs-metadata-nodejs

Introduction

Metadata comparison は GroupDocs.Metadata の機能で、ドキュメントバージョン間の隠れた変更を明らかにし、監査人が迅速に真正性を検証できるようにします。法務チームが契約書が改ざんされていないことを証明する必要がある場合、作者、編集者、リビジョンのタイムスタンプといった目に見えないプロパティが実際の状況を語ります。

サプライヤー契約書のバッチをレビューしているときにこの問題に直面しました。各ファイルは同じ作成日を主張していましたが、隠れた作者フィールドが異なっており、手作業での監査には何時間もかかっていました。

法務・コンプライアンスの専門家は不変の証拠に依存します。可視テキストが同じであっても、Creator や LastPrinted フィールドの変更は不正な編集を示す可能性があります。これらの変化を早期に検出することで、高額な紛争を防ぎ、規制監査のトレイルを満たすことができます。

Our solution with GroupDocs.Metadata

GroupDocs.Metadata for Node.js は、すべてのサポート対象プロパティを抽出し、2 つのリビジョンを比較し、構造化された差分レポートを生成する単一 API を提供します。SDK は DOCX、PDF、XLSX など多数のフォーマットを箱から出したままサポートするため、各ファイルタイプごとにカスタムパーサーを用意する必要はありません。

Step 1 – Pulling all metadata from a document

以下のヘルパーはファイルを開き、プロパティツリー全体を走査し、プロパティ名 → 値 のシンプルな JavaScript マップを返します。AnySpecification を使用して組み込みフィールドとカスタムフィールドの両方を取得します。

/** Extract all metadata from a file */
function extractAllMetadata(documentPath) {
  const result = {};
  const metadata = new groupdocs.Metadata(documentPath);
  try {
    const properties = metadata.findProperties(new groupdocs.AnySpecification());
    for (let i = 0; i < properties.getCount(); i++) {
      const p = properties.get_Item(i);
      const name = p.getName();
      const value = valueToString(p);
      result[name] = value;
    }
  } finally {
    metadata.close();
  }
  return result;
}

Performance note: 5 MB の DOCX からメタデータを抽出するのに、典型的な 2 GHz CPU で 200 ms 未満で完了します Docs。

Step 2 – Spotting differences between two revisions

両方のバージョンをプレーンオブジェクトとして表現したら、diff ルーチンは added、removed、changed の 3 つのバケットを作成し、便利な totalChanges ゲッターを提供します。

/** Compare two metadata maps */
function compareMetadataSets(pathV1, pathV2) {
  const v1 = extractAllMetadata(pathV1);
  const v2 = extractAllMetadata(pathV2);

  const added = {};
  const removed = {};
  const changed = {};

  for (const k of Object.keys(v2)) {
    if (!(k in v1)) added[k] = v2[k];
    else if (v1[k] !== v2[k]) changed[k] = { from: v1[k], to: v2[k] };
  }
  for (const k of Object.keys(v1)) {
    if (!(k in v2)) removed[k] = v1[k];
  }

  return {
    added,
    removed,
    changed,
    get totalChanges() {
      return Object.keys(this.added).length + Object.keys(this.removed).length + Object.keys(this.changed).length;
    },
  };
}

Step 3 – Ownership and revision insights (optional)

Detecting ownership changes

法務監査では、誰がドキュメントを作成または編集したかに注目します。このヘルパーはそれらのフィールドを抽出し、変化があればフラグを立てます。

/** Ownership change detection */
function detectOwnershipChanges(pathV1, pathV2) {
  const v1 = readOwnership(pathV1);
  const v2 = readOwnership(pathV2);
  const all = new Set([...Object.keys(v1), ...Object.keys(v2)]);
  const changes = {};
  for (const k of all) {
    const oldV = v1[k] !== undefined ? v1[k] : '<missing>';
    const newV = v2[k] !== undefined ? v2[k] : '<missing>';
    if (oldV !== newV) changes[k] = { from: oldV, to: newV };
  }
  return changes;
}

Detecting revision‑history changes

リビジョン番号、総編集時間、最終印刷タイムスタンプは隠れた活動を露呈します。

/** Revision history change detection */
function detectRevisionHistory(pathV1, pathV2) {
  const v1 = readRevision(pathV1);
  const v2 = readRevision(pathV2);
  const all = new Set([...Object.keys(v1), ...Object.keys(v2)]);
  const changes = {};
  for (const k of all) {
    const oldV = v1[k] !== undefined ? v1[k] : '<missing>';
    const newV = v2[k] !== undefined ? v2[k] : '<missing>';
    if (oldV !== newV) changes[k] = { from: oldV, to: newV };
  }
  return changes;
}

Step 4 – Exporting audit reports

CSV export

CSV 形式は Excel や SIEM への取り込みに最適です。フィールドはカンマや改行を正しくエスケープします。

/** Export diff to CSV */
function exportDiffToCsv(diff, outputPath) {
  const rows = ['change_type,property,old_value,new_value'];
  for (const [k, v] of Object.entries(diff.added)) rows.push(`added,${esc(k)},,${esc(v)}`);
  for (const [k, v] of Object.entries(diff.removed)) rows.push(`removed,${esc(k)},${esc(v)},`);
  for (const [k, o] of Object.entries(diff.changed)) rows.push(`changed,${esc(k)},${esc(o.from)},${esc(o.to)}`);
  fs.writeFileSync(outputPath, rows.join('\n') + '\n', 'utf-8');
}

JSON export

JSON は階層構造を保持し、プログラムからの利用に適しています。

/** Export diff to JSON */
function exportDiffToJson(diff, outputPath) {
  const payload = { added: diff.added, removed: diff.removed, changed: diff.changed };
  fs.writeFileSync(outputPath, JSON.stringify(payload, null, 2), 'utf-8');
}

Full driver script

このスクリプトはすべてを結びつけ、簡単なサマリーをコンソールに出力し、CSV と JSON の両方のレポートを書き出します。

const path = require('path');
const fs = require('fs');
const groupdocs = require('@groupdocs/groupdocs.metadata');

function esc(txt) { return /[",\n]/.test(txt) ? `"${txt.replace(/"/g, '""')}"` : txt; }

const diff = compareMetadataSets('resources/document-v1.docx', 'resources/document-v2.docx');
console.log(`Total metadata changes: ${diff.totalChanges}`);

exportDiffToCsv(diff, path.resolve('metadata-diff.csv'));
exportDiffToJson(diff, path.resolve('metadata-diff.json'));

node index.js を実行すると、プロジェクトルートに metadata-diff.csv と metadata-diff.json が作成されます。

How can I compare metadata between two versions of a document?

メタデータは Metadata クラスで各リビジョンをロードし、extractAllMetadata でフラットな name‑to‑value マップを取得し、2 つのマップを compareMetadataSets に渡すことで比較できます。この関数は added、removed、changed の 3 つのコレクションと totalChanges カウンタを返します。DOCX、PDF、XLSX、PPTX など GroupDocs.Metadata がサポートするすべての形式で利用でき、典型的なオフィスファイルであれば 1 秒未満で完了するため、バッチ処理や CI への組み込みに適しています。

Business impact

Metric Manual process Automated with GroupDocs.Metadata
Time per document 約45分（手動レビュー） <30 秒（メタデータ差分）
Error rate 約3 % の見逃し 0 % – すべてのプロパティを検査
Throughput 1 人のレビューアで 20 件/日 1 台の中規模 VM で 1 000 件/日以上
Audit trail 手書きメモ 構造化 CSV/JSON ログ
Cost $X / 時間 × N 人のレビューア 定額ライセンス、実行回数無制限

自動化によりレビュー時間は 99 % 以上 短縮され、人為的ミスが排除され、コンプライアンスダッシュボードに直接統合できる機械可読の監査トレイルが提供されます。

Getting started in your environment

  1. Try it free – 一時的な 30 日間ライセンスを here で取得してください。
  2. Install the SDK – npm install @groupdocs/groupdocs.metadata を実行。
  3. Run the sample – GitHub リポジトリをクローンし、node index.js を実行。
  4. Explore more – 高度なフィルタやカスタムプロパティ処理のための完全な API リファレンスをご覧ください。

Resources