保持多個版本的 ODT 文件同步,對於需要自行發現變更並自動合併編輯的開發人員來說,可能很快就會變成頭痛的問題。Aspose.Words Cloud SDK for .NET 讓在 .NET 中以程式方式比較和合併 ODT 檔案變得簡單且可靠。本指南將帶領您將兩個 ODT 檔案上傳至 Aspose Cloud storage,產生差異文件,接受所有修訂以產生合併檔案,並取得結果。您還將看到使用 cURL 的等效 REST 呼叫,並學習如何在您的 .NET 專案中設定 SDK。

完整的工作範例:在 .NET 中以程式方式比較與合併 ODT 檔案

此範例示範如何比較兩個 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);
        }
    }
}

注意: 此程式碼範例示範了核心功能。在將其用於您的專案之前,請確保更新任何檔案路徑和設定值以符合實際環境,驗證所有必要的相依項目已正確安裝,並在開發環境中徹底測試。若您遇到任何問題,請參閱官方文件或聯繫支援團隊以獲得協助。

使用 cURL 和 REST API 執行 ODT 檔案差異比較與合併

以下是等效的 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 文件。

在 .NET 中以程式方式比較與合併 ODT 檔案的運作方式

程式碼遵循一個清晰的順序,映射上述描述的 REST 工作流程。

  1. 初始化 API 客戶端 - new WordsApi(config) 使用包含您的 ClientId 和 ClientSecret 的 Configuration 物件建立已驗證的客戶端。

    var config = new Configuration { ClientId = clientId, ClientSecret = clientSecret };
    var wordsApi = new WordsApi(config);
    
  2. 上傳來源檔案 - 輔助方法 UploadFile 使用 UploadFileRequest 將每個本機 ODT 檔案傳送至雲端儲存資料夾。

    var uploadRequest = new UploadFileRequest(remotePath, stream);
    api.UploadFile(uploadRequest);
    
  3. 建立 CompareData 物件 - 此物件定義作者、比較選項以及修訂檔案的參考。它會傳遞給 CompareDocumentRequest。

    var compareData = new CompareData { Author = "Comparer", CompareOptions = new CompareOptions { … }, FileReference = new FileReference($"{storageFolder}/{revisedFile}") };
    
  4. 執行比較操作 - wordsApi.CompareDocument(compareRequest) 會將請求發送到服務,服務會在原始文件中添加修訂標記。

    var compareRequest = new CompareDocumentRequest(originalFile, compareData, storageFolder);
    wordsApi.CompareDocument(compareRequest);
    
  5. 接受所有修訂 - 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. Configure credentials - 將範例程式碼中的佔位符值替換為您從 Aspose Cloud 儀表板取得的 ClientId 和 ClientSecret。

  3. 下載 SDK - 您也可以從官方發行頁面下載最新的二進位檔案: Aspose.Words Cloud SDK for .NET 下載.

  4. 生產授權 - 若要長期使用,請從temporary license page取得臨時或永久授權。

常見問題

  • 如何在 .NET 中使用 Aspose.Words Cloud SDK 以程式方式比較和合併 ODT 檔案?
    使用由 Aspose.Words Cloud SDK for .NET 提供的 CompareDocument 和 AcceptAllRevisions 操作。上傳兩個 ODT 檔案,執行比較請求,然後接受修訂以獲得合併結果。

  • 需要什麼驗證方法才能呼叫 REST API?
    您需要客戶端 ID 和客戶端密鑰來取得 OAuth 2.0 存取權杖。將該權杖包含在每個 cURL 請求的 Authorization 標頭中。

  • 是否有辦法在購買前先試用 SDK?
    您可以從臨時授權頁面請求臨時授權,以在開發期間評估該庫。

  • 我可以在哪裡找到更多範例和詳細的 API 參考?
    請參閱官方文件和API 參考,以獲取完整的指南和程式碼範例。

相關文章