Как сравнить метаданные документа с помощью GroupDocs.Metadata в Node.js

💡 Полный рабочий пример доступен на GitHub:
metadata-diff-doc-versions-using-groupdocs-metadata-nodejs

Введение

Сравнение метаданных — это возможность GroupDocs.Metadata, позволяющая выявлять скрытые изменения между версиями документов, что дает аудиторам возможность быстро проверять подлинность. Когда юридическим командам необходимо доказать, что контракт не был подделан, невидимые свойства — автор, редактор, временные метки правок — часто рассказывают истинную историю.

Я столкнулся с этой проблемой, проверяя пакет договоров с поставщиками; каждый файл указывал одну и ту же дату создания, но скрытые поля автора различались, и ручной аудит занял бы часы.

Почему скрытые метаданные важны для юридических команд

Юридические и комплаенс‑специалисты полагаются на неизменяемые доказательства. Даже если видимый текст остаётся тем же, изменение поля Creator или LastPrinted может свидетельствовать о неавторизованных правках. Выявление таких сдвигов на ранних этапах предотвращает дорогостоящие споры и удовлетворяет требования регуляторных аудитов.

Наше решение с GroupDocs.Metadata

GroupDocs.Metadata для Node.js предоставляет единый API, который извлекает каждое поддерживаемое свойство, сравнивает две версии и формирует структурированные отчёты о различиях. SDK работает с DOCX, PDF, XLSX и многими другими форматами «из коробки», поэтому нет необходимости писать собственные парсеры для каждого типа файлов.

Шаг 1 – Получение всех метаданных из документа

Вспомогательная функция ниже открывает файл, проходит по всему дереву свойств и возвращает обычный JavaScript‑объект вида имя свойства → значение. Она использует AnySpecification для захвата как встроенных, так и пользовательских полей.

/** Извлечь все метаданные из файла */
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;
}

Примечание о производительности: извлечение метаданных из DOCX размером 5 МБ занимает менее 200 мс на типичном процессоре 2 ГГц Docs.

Шаг 2 – Выявление различий между двумя версиями

Когда обе версии представлены в виде простых объектов, процедура сравнения формирует три группы — added (добавленные), removed (удалённые) и changed (изменённые) — и предоставляет удобный геттер totalChanges.

/** Сравнить две карты метаданных */
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;
    },
  };
}

Шаг 3 – Информация о владении и версиях (необязательно)

Обнаружение изменений владения

Юридические аудиторы часто сосредотачиваются на том, кто создал или отредактировал документ. Эта вспомогательная функция изолирует соответствующие поля и помечает любые отклонения.

/** Обнаружение изменений владения */
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;
}

Обнаружение изменений истории версий

Номер ревизии, общее время редактирования и метки времени последней печати раскрывают скрытую активность.

/** Обнаружение изменений истории версий */
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;
}

Шаг 4 – Экспорт аудиторских отчетов

Экспорт в CSV

Формат CSV удобен для Excel или импорта в SIEM. Поля экранируются, чтобы корректно обрабатывать запятые и переводы строк.

/** Экспорт различий в 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

JSON сохраняет иерархическую структуру для программного потребления.

/** Экспорт различий в 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');
}

Полный скрипт‑драйвер

Скрипт связывает все части, выводит краткое резюме и записывает отчёты в 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 в корне проекта.

Как сравнить метаданные между двумя версиями документа?

Вы сравниваете метаданные, загружая каждую ревизию с помощью класса Metadata, извлекая плоскую карту «имя → значение» через extractAllMetadata и передавая две карты в compareMetadataSets. Функция возвращает три коллекции — добавленные, удалённые и изменённые — плюс счётчик totalChanges. Это работает с любым форматом, поддерживаемым GroupDocs.Metadata (DOCX, PDF, XLSX, PPTX и т.д.) и завершается значительно быстрее секунды для типичных офисных файлов, что делает его пригодным для пакетной обработки или интеграции в CI.

Влияние на бизнес

Автоматизация сокращает время проверки более чем на 99 %, устраняет человеческие ошибки и предоставляет машинно‑читаемый журнал аудита, который напрямую интегрируется в дашборды комплаенса.

Начало работы в вашей среде

1. Попробовать бесплатно – получите временную 30‑дневную лицензию здесь.
2. Установить SDK – npm install @groupdocs/groupdocs.metadata.
3. Запустить пример – клонируйте репозиторий GitHub и выполните node index.js.
4. Изучить подробнее – см. полную справку API для продвинутых фильтров и обработки пользовательских свойств.

Ресурсы

• Документация GroupDocs.Metadata
• Справочник API для Node.js через Java
• Запрос временной лицензии
• Пример проекта на GitHub
• Форум сообщества