Підтримка синхронізації кількох версій документа 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, які виконують той самий процес diff та merge за допомогою 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. Завантажити вихідні файли - Допоміжний метод UploadFile використовує UploadFileRequest для надсилання кожного локального ODT‑файлу у папку хмарного сховища.

    var uploadRequest = new UploadFileRequest(remotePath, stream);
    api.UploadFile(uploadRequest);
    
  2. Create a CompareData object - This object defines the author, comparison options, and a reference to the revised file. It is passed to 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 dashboard.

  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 access token. Додайте токен у заголовок Authorization кожного запиту cURL.

  • Чи є спосіб спробувати SDK перед покупкою?
    Ви можете запросити тимчасову ліцензію на сторінці тимчасової ліцензії, щоб оцінити бібліотеку під час розробки.

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

Пов’язані статті