نگهداری همگام‌سازی چندین نسخه از یک سند 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. یک شیء CompareData ایجاد کنید - این شیء نویسنده، گزینه‌های مقایسه و یک ارجاع به فایل اصلاح‌شده را تعریف می‌کند. این شیء به CompareDocumentRequest ارسال می‌شود.

var compareData = new CompareData { Author = "Comparer", CompareOptions = new CompareOptions { … }, FileReference = new FileReference($"{storageFolder}/{revisedFile}") };
  1. اجرای عملیات مقایسه - 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. پیکربندی اعتبارنامه‌ها - مقادیر جایگزین در کد نمونه را با ClientId و ClientSecret که از داشبورد Aspose Cloud خود دریافت می‌کنید، جایگزین کنید.

  3. Download the 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 چه روش احراز هویتی مورد نیاز است؟
    برای دریافت توکن دسترسی OAuth 2.0 به یک client ID و client secret نیاز دارید. توکن را در هدر Authorization هر درخواست cURL قرار دهید.

  • آیا راهی برای امتحان SDK قبل از خرید وجود دارد؟
    می‌توانید برای ارزیابی کتابخانه در طول توسعه، یک مجوز موقت از صفحه مجوز موقت درخواست کنید.

  • کجا می‌توانم مثال‌های بیشتر و مرجع دقیق API را پیدا کنم؟
    برای راهنمایی‌های جامع و نمونه‌های کد، به مستندات رسمی و مرجع API مراجعه کنید.

مقالات مرتبط