Поддержание синхронности нескольких версий документа ODT может быстро превратиться в головную боль для разработчиков, которым необходимо обнаруживать изменения и автоматически объединять правки. Aspose.Words Cloud SDK for .NET упрощает сравнение и слияние ODT‑файлов программно в .NET, делая процесс простым и надёжным. В этом руководстве вы узнаете, как загрузить два ODT‑файла в хранилище Aspose Cloud, создать документ‑разницу, принять все правки для получения объединённого файла и получить результат. Вы также увидите эквивалентные REST‑вызовы с использованием cURL и узнаете, как настроить SDK в вашем .NET‑проекте.

Полный рабочий пример сравнения и объединения ODT‑файлов программно в .NET

Этот пример демонстрирует, как сравнить два файла ODT, создать документ с изменениями, принять все изменения и загрузить окончательный объединённый ODT.

using System;
using System.IO;
using Aspose.Words.Cloud.Sdk;
using Aspose.Words.Cloud.Sdk.Model;
using Aspose.Words.Cloud.Sdk.Model.Requests;

class Program
{
    static void Main()
    {
        // ==== Set up Aspose.Words Cloud SDK ====
        var clientId = "YOUR_CLIENT_ID";
        var clientSecret = "YOUR_CLIENT_SECRET";

var config = new Configuration
        {
            ClientId = clientId,
            ClientSecret = clientSecret
        };

var wordsApi = new WordsApi(config);

// ==== Define file names and storage folder ====
        string storageFolder = "Documents";
        string originalFile = "original.odt";
        string revisedFile = "revised.odt";
        string compareResultFile = "compareResult.odt";
        string mergedFile = "merged.odt";

// ==== Upload local ODT files to Aspose Cloud storage ====
        UploadFile(wordsApi, Path.Combine(Environment.CurrentDirectory, originalFile),
            $"{storageFolder}/{originalFile}");
        UploadFile(wordsApi, Path.Combine(Environment.CurrentDirectory, revisedFile),
            $"{storageFolder}/{revisedFile}");

// ==== Perform comparison (diff) ====
        var compareData = new CompareData
        {
            Author = "Comparer",
            CompareOptions = new CompareOptions
            {
                IgnoreCaseChanges = false,
                IgnoreComments = false,
                IgnoreFormatting = false,
                IgnoreHeadersAndFooters = false,
                IgnoreTables = false,
                IgnoreFields = false,
                IgnoreFootnotes = false,
                IgnoreTextboxes = false,
                IgnoreInsertedParagraphs = false,
                IgnoreDeletedParagraphs = false
            },
            FileReference = new FileReference($"{storageFolder}/{revisedFile}")
        };

var compareRequest = new CompareDocumentRequest(originalFile, compareData, storageFolder);
        wordsApi.CompareDocument(compareRequest);

// ==== Download the document that now contains revisions (diff result) ====
        var downloadDiff = new DownloadFileRequest($"{storageFolder}/{originalFile}");
        using (var diffStream = wordsApi.DownloadFile(downloadDiff))
        using (var fileStream = File.Create(Path.Combine(Environment.CurrentDirectory, compareResultFile)))
        {
            diffStream.CopyTo(fileStream);
        }

// ==== Accept all revisions to produce the merged document ====
        var acceptRequest = new AcceptAllRevisionsRequest(originalFile, storageFolder);
        wordsApi.AcceptAllRevisions(acceptRequest);

// ==== Download the merged ODT document ====
        var downloadMerged = new DownloadFileRequest($"{storageFolder}/{originalFile}");
        using (var mergedStream = wordsApi.DownloadFile(downloadMerged))
        using (var fileStream = File.Create(Path.Combine(Environment.CurrentDirectory, mergedFile)))
        {
            mergedStream.CopyTo(fileStream);
        }

// ==== Simple verification ====
        var info = new FileInfo(mergedFile);
        Console.WriteLine($"Merged document saved as '{mergedFile}' (size: {info.Length} bytes).");
    }

static void UploadFile(WordsApi api, string localPath, string remotePath)
    {
        using (var stream = File.OpenRead(localPath))
        {
            var uploadRequest = new UploadFileRequest(remotePath, stream);
            api.UploadFile(uploadRequest);
        }
    }
}

Примечание: Этот пример кода демонстрирует базовую функциональность. Прежде чем использовать его в вашем проекте, убедитесь, что обновили все пути к файлам и значения конфигурации, чтобы они соответствовали вашей реальной среде, проверьте, что все необходимые зависимости правильно установлены, и тщательно протестируйте в вашей среде разработки. Если вы столкнётесь с какими‑либо проблемами, обратитесь к официальной документации или свяжитесь с командой поддержки для получения помощи.

Выполнить DIFF ODT‑файла и объединить с помощью cURL и REST API

Ниже приведены эквивалентные команды cURL, которые выполняют тот же процесс сравнения и слияния с использованием Aspose.Words Cloud REST API.

  1. Получите токен доступа
    Замените YOUR_CLIENT_ID и YOUR_CLIENT_SECRET на свои учётные данные.
curl -X POST "https://api.aspose.cloud/connect/token" \
     -d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"
  1. Загрузите оригинальный файл ODT
curl -X PUT "https://api.aspose.cloud/v4.0/words/storage/file/Documents/original.odt" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/octet-stream" \
     --data-binary "@original.odt"
  1. Загрузите отредактированный файл ODT
curl -X PUT "https://api.aspose.cloud/v4.0/words/storage/file/Documents/revised.odt" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/octet-stream" \
     --data-binary "@revised.odt"
  1. Запустите операцию сравнения (diff)
curl -X POST "https://api.aspose.cloud/v4.0/words/Documents/original.odt/compare" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "author": "Comparer",
           "compareOptions": {
               "ignoreCaseChanges": false,
               "ignoreComments": false,
               "ignoreFormatting": false,
               "ignoreHeadersAndFooters": false,
               "ignoreTables": false,
               "ignoreFields": false,
               "ignoreFootnotes": false,
               "ignoreTextboxes": false,
               "ignoreInsertedParagraphs": false,
               "ignoreDeletedParagraphs": false
           },
           "fileReference": { "href": "Documents/revised.odt" }
         }'
  1. Принять все исправления, чтобы создать объединённый ODT
curl -X POST "https://api.aspose.cloud/v4.0/words/Documents/original.odt/acceptAllRevisions" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
  1. Скачать объединённый документ ODT
curl -X GET "https://api.aspose.cloud/v4.0/words/storage/file/Documents/original.odt" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o merged.odt

Для получения более подробной информации о телах запросов и дополнительных параметрах см. официальную документацию API.

Как работает сравнение и объединение ODT‑файлов программно в .NET

Код следует четкой последовательности, отражающей описанный выше рабочий процесс REST.

  1. Инициализировать клиент API - new WordsApi(config) создает аутентифицированный клиент, используя объект Configuration, который содержит ваш ClientId и ClientSecret.
var config = new Configuration { ClientId = clientId, ClientSecret = clientSecret };
var wordsApi = new WordsApi(config);
  1. Upload source files - Вспомогательный метод UploadFile использует UploadFileRequest для отправки каждого локального ODT‑файла в папку облачного хранилища.

    var uploadRequest = new UploadFileRequest(remotePath, stream);
    api.UploadFile(uploadRequest);
    
  2. Создайте объект CompareData - Этот объект определяет автора, параметры сравнения и ссылку на исправленный файл. Он передаётся в CompareDocumentRequest.

    var compareData = new CompareData { Author = "Comparer", CompareOptions = new CompareOptions { … }, FileReference = new FileReference($"{storageFolder}/{revisedFile}") };
    
  3. Выполнить операцию сравнения - wordsApi.CompareDocument(compareRequest) отправляет запрос в сервис, который добавляет метки правок в оригинальный документ.

    var compareRequest = new CompareDocumentRequest(originalFile, compareData, storageFolder);
    wordsApi.CompareDocument(compareRequest);
    
  4. Принять все правки - AcceptAllRevisionsRequest сообщает сервису объединить изменения, создавая чистый файл ODT.

var acceptRequest = new AcceptAllRevisionsRequest(originalFile, storageFolder);
wordsApi.AcceptAllRevisions(acceptRequest);

Каждый шаг напрямую соответствует командам cURL, предоставляя вам гибкость выбора между библиотекой .NET и прямыми HTTP‑вызовами.

Установка и настройка Aspose.Words Cloud SDK for .NET

  1. Добавьте пакет NuGet
dotnet add package Aspose.Words-Cloud
  1. Восстановить пакеты и собрать - SDK работает с .NET 6.0 и более новыми версиями. Убедитесь, что ваш проект нацелен на совместимую платформу.

  2. Настройте учетные данные - Замените значения‑заполнители в примере кода на ClientId и ClientSecret, полученные из вашей панели управления Aspose Cloud.

  3. Скачать SDK – Вы также можете скачать последние бинарные файлы со страницы официального релиза: Aspose.Words Cloud SDK for .NET Download.

  4. Лицензия для продакшн - Для длительного использования приобретите временную или постоянную лицензию на странице страница временной лицензии.

Общие вопросы

  • Как я могу программно сравнивать и объединять ODT‑файлы в .NET с помощью Aspose.Words Cloud SDK?
    Используйте операции CompareDocument и AcceptAllRevisions, предоставляемые Aspose.Words Cloud SDK for .NET. Загрузите оба ODT‑файла, выполните запрос сравнения, затем примите изменения, чтобы получить объединённый результат.

  • Какой метод аутентификации требуется для вызовов REST API?
    Вам нужен client ID и client secret для получения токена доступа OAuth 2.0. Включите токен в заголовок Authorization каждого запроса cURL.

  • Есть ли способ попробовать SDK перед покупкой?
    Вы можете запросить временную лицензию на странице временной лицензии, чтобы оценить библиотеку во время разработки.

  • Где можно найти больше примеров и подробную справку по API?
    Посетите официальную документацию и справку по API для получения подробных руководств и примеров кода.

Связанные статьи