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);
        }
    }
}

შენიშვნა: ეს კოდის მაგალითი აჩვენებს ძირითად ფუნქციას. პროექტში მისი გამოყენებამდე, დარწმუნდით, რომ განაახლეთ ყველა ფაილის ბილიკი და კონფიგურაციის მნიშვნელობები, რომ ისინი თქვენი რეალური გარემოს შესაბამისია, გადამოწმეთ, რომ ყველა საჭირო დამოკიდებულება სწორად დაყენებულია, და სრულად ტესტირეთ თქვენი განვითარების გარემოში. თუ რაიმე პრობლემის შეგხვდებით, გთხოვთ მიმართოთ ოფიციალურ დოკუმენტაციას ან დაუკავშირდეთ მხარდაჭერის გუნდს დახმარებისთვის.

ODT ფაილის DIFF-ის შესრულება და შერწყმა 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}") };
    
  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. Restore packages and build - 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 მოთხოვნებისთვის რა ავთენტიკაციის მეთოდი საჭიროა?
    თქვენ უნდა გაქვთ კლიენტის ID და კლიენტის საიდუმლო, რათა მიიღოთ OAuth 2.0 წვდომის ტოკენი. ჩასვით ტოკენი Authorization ჰედერში თითოეულ cURL მოთხოვნაში.

  • შეძენამდე შესაძლებელია SDK-ს გამოცდა?
    შეგიძლიათ დროებით ლიცენზია მოითხოვოთ დროებითი ლიცენზიის გვერდი ბიბლიოთეკის შეფასებისთვის განვითარების პერიოდში.

  • სად შეიძლება ვიპოვოთ მეტი მაგალითები და დეტალური API მითითება?
    ეწვიოთ ოფიციალურ დოკუმენტაციას და API მითითებას სრულყოფილი სახელმძღვანელოების და კოდის მაგალითებისთვის.

დაკავშირებული სტატიები