保持多个ODT文档的同步对于需要发现更改并自动合并编辑的开发人员来说,可能很快就会变成头疼的问题。Aspose.Words Cloud SDK for .NET 使在 .NET 中以编程方式比较和合并 ODT 文件变得简单可靠。本指南将带您完成将两个 ODT 文件上传到 Aspose Cloud 存储、生成差异文档、接受所有修订以生成合并文件以及检索结果的过程。您还将看到使用 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);
  1. 上传源文件 - 辅助方法 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);
  1. 接受所有修订 - 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. 配置凭证 - 将示例代码中的占位符值替换为您从 Aspose Cloud 仪表板获取的 ClientId 和 ClientSecret。

  3. 下载 SDK - 您也可以从官方发布页面下载最新的二进制文件: Aspose.Words Cloud SDK for .NET Download.

  4. 生产许可证 - 对于长期使用,请从临时许可证页面获取临时或永久许可证。

常见问题

  • 如何在 .NET 中使用 Aspose.Words Cloud SDK 以编程方式比较和合并 ODT 文件?
    使用由 Aspose.Words Cloud SDK for .NET 提供的 CompareDocument 和 AcceptAllRevisions 操作。上传两个 ODT 文件,执行比较请求,然后接受修订以获取合并后的结果。

  • 需要什么身份验证方法来调用 REST API?
    您需要客户端 ID 和客户端密钥来获取 OAuth 2.0 访问令牌。将令牌包含在每个 cURL 请求的 Authorization 标头中。

  • 是否有办法在购买前试用 SDK?
    您可以从temporary license page请求临时许可证,以在开发期间评估该库。

  • 我在哪里可以找到更多示例和详细的 API 参考?
    请访问官方文档和API 参考,以获取全面的指南和代码示例。