إن الحفاظ على مزامنة إصدارات متعددة من مستند ODT يمكن أن يتحول بسرعة إلى صداع للمطورين الذين يحتاجون إلى اكتشاف التغييرات ودمج التعديلات تلقائيًا. يجعل Aspose.Words Cloud SDK for .NET مقارنة ودمج ملفات ODT برمجيًا في .NET أمرًا بسيطًا وموثوقًا. يوضح هذا الدليل كيفية رفع ملفين ODT إلى تخزين Aspose Cloud، وإنشاء مستند diff، وقبول جميع المراجعات لإنتاج ملف مدمج، واسترجاع النتيجة. سترى أيضًا مكالمات 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 المكافئة التي تنفّذ نفس سير عمل الفرق والدمج ضد 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);
    
  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}") };
  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. تنزيل 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. قم بتضمين الرمز في رأس Authorization لكل طلب cURL.

  • هل هناك طريقة لتجربة SDK قبل الشراء؟
    يمكنك طلب ترخيص مؤقت من صفحة الترخيص المؤقت لتقييم المكتبة أثناء التطوير.

  • أين يمكنني العثور على مزيد من الأمثلة والمرجع التفصيلي للواجهة البرمجية؟
    قم بزيارة الوثائق الرسمية ومرجع الواجهة البرمجية للحصول على أدلة شاملة وعينات من الشيفرة.

مقالات ذات صلة