複数のバージョンのODTドキュメントを同期させることは、変更点を見つけて自動的に編集を統合する必要がある開発者にとって、すぐに頭痛の種になります。Aspose.Words Cloud SDK for .NETは、.NETでODTファイルをプログラム的に比較およびマージすることをシンプルかつ信頼性の高いものにします。このガイドでは、2つのODTファイルをAspose Cloudストレージにアップロードし、差分ドキュメントを生成し、すべてのリビジョンを受け入れてマージされたファイルを作成し、結果を取得する手順を説明します。また、cURL を使用した同等の REST 呼び出しも紹介し、.NET プロジェクトで SDK を構成する方法を学びます。

.NET で ODT ファイルを比較およびマージする完全動作サンプル

この例では、2つの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 ファイルの DIFF とマージ

以下は、Aspose.Words Cloud REST API に対して同じ差分およびマージ ワークフローを実行する等価の cURL コマンドです。

  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) は、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. 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 ファイルをプログラムで比較およびマージするにはどうすればよいですか?
    CompareDocument と AcceptAllRevisions 操作を使用します。これらは Aspose.Words Cloud SDK for .NET が提供しています。両方の ODT ファイルをアップロードし、比較リクエストを実行し、リビジョンを受け入れてマージ結果を取得します。

  • REST API 呼び出しに必要な認証方法は何ですか?
    クライアント ID とクライアント シークレットが必要で、OAuth 2.0 アクセストークンを取得します。各 cURL リクエストの Authorization ヘッダーにトークンを含めてください。

  • 購入前に SDK を試す方法はありますか?
    開発中にライブラリを評価するために、一時ライセンスページから一時ライセンスをリクエストできます。

  • どこでさらに多くの例や詳細な API リファレンスを見つけられますか?
    詳細なガイドとコードサンプルについては、公式ドキュメント と API リファレンス をご覧ください。

関連記事