At holde flere versioner af et ODT dokument synkroniseret kan hurtigt blive et hovedpine for udviklere, der skal opdage ændringer og automatisk kombinere redigeringer. Aspose.Words Cloud SDK for .NET gør det enkelt og pålideligt at sammenligne og flette ODT-filer programmatisk i .NET. Denne vejledning guider dig gennem upload af to ODT-filer til Aspose Cloud-lagring, generering af et diff-dokument, accept af alle revisioner for at producere en flettet fil og hentning af resultatet. Du vil også se de tilsvarende REST‑kald ved hjælp af cURL og lære, hvordan du konfigurerer SDK’en i dit .NET‑projekt.

Fuld fungerende eksempel på sammenligning og sammenlægning af ODT-filer programmatisk i .NET

Dette eksempel demonstrerer, hvordan man sammenligner to ODT-filer, genererer et revisionsdokument, accepterer alle revisioner og downloader den endelige sammenlagte 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);
        }
    }
}

Bemærk: Dette kodeeksempel demonstrerer kernefunktionaliteten. Før du bruger det i dit projekt, skal du sikre dig, at du opdaterer alle filstier og konfigurationsværdier, så de matcher dit faktiske miljø, verificere at alle nødvendige afhængigheder er korrekt installeret, og teste grundigt i dit udviklingsmiljø. Hvis du støder på problemer, så henvis til den officielle dokumentation eller kontakt supportteamet for assistance.

Udfør ODT-fil DIFF og flet med cURL og REST API

Nedenfor er de tilsvarende cURL‑kommandoer, der udfører den samme diff‑ og flettearbejdsgang mod Aspose.Words Cloud REST API.

  1. Få en adgangstoken
    Erstat YOUR_CLIENT_ID og YOUR_CLIENT_SECRET med dine legitimationsoplysninger.
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. Upload den originale ODT-fil
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. Upload den reviderede ODT-fil
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. Kør sammenligningsoperationen (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. Accepter alle revisioner for at oprette den flettede ODT
curl -X POST "https://api.aspose.cloud/v4.0/words/Documents/original.odt/acceptAllRevisions" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
  1. Download det sammenlagte ODT-dokument
curl -X GET "https://api.aspose.cloud/v4.0/words/storage/file/Documents/original.odt" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o merged.odt

For flere detaljer om anmodningskroppe og yderligere muligheder, se den officielle API-dokumentation.

Sådan fungerer sammenligning og sammensmeltning af ODT-filer programmatisk i .NET

Koden følger en klar sekvens, der spejler REST‑arbejdsflowet beskrevet ovenfor.

  1. Initialiser API‑klienten – new WordsApi(config) opretter en godkendt klient ved hjælp af Configuration‑objektet, som indeholder din ClientId og ClientSecret.
var config = new Configuration { ClientId = clientId, ClientSecret = clientSecret };
var wordsApi = new WordsApi(config);
  1. Upload kildefiler - Hjælpermetoden UploadFile bruger UploadFileRequest til at sende hver lokal ODT‑fil til cloud‑lagringsmappen.

    var uploadRequest = new UploadFileRequest(remotePath, stream);
    api.UploadFile(uploadRequest);
    
  2. Opret et CompareData-objekt - Dette objekt definerer forfatteren, sammenligningsindstillingerne og en reference til den reviderede fil. Det videregives til CompareDocumentRequest.

    var compareData = new CompareData { Author = "Comparer", CompareOptions = new CompareOptions { … }, FileReference = new FileReference($"{storageFolder}/{revisedFile}") };
    
  3. Udfør sammenligningsoperationen - wordsApi.CompareDocument(compareRequest) sender anmodningen til tjenesten, som tilføjer revisionsmærker til det originale dokument.

    var compareRequest = new CompareDocumentRequest(originalFile, compareData, storageFolder);
    wordsApi.CompareDocument(compareRequest);
    
  4. Accepter alle revisioner - AcceptAllRevisionsRequest fortæller tjenesten at flette ændringerne, hvilket resulterer i en ren ODT-fil.

var acceptRequest = new AcceptAllRevisionsRequest(originalFile, storageFolder);
wordsApi.AcceptAllRevisions(acceptRequest);

Hvert trin svarer direkte til cURL‑kommandoerne og giver dig fleksibilitet til at vælge mellem .NET‑biblioteket og rå HTTP‑kald.

Installation og konfiguration Aspose.Words Cloud SDK for .NET

  1. Tilføj NuGet-pakken
dotnet add package Aspose.Words-Cloud
  1. Gendan pakker og byg - SDK’en fungerer med .NET 6.0 og senere. Sørg for, at dit projekt målretter et kompatibelt framework.

  2. Konfigurer legitimationsoplysninger - Erstat pladsholderværdierne i eksempelkoden med ClientId og ClientSecret, som du får fra dit Aspose Cloud dashboard.

  3. Download SDK’en - Du kan også downloade de seneste binære filer fra den officielle udgivelsesside: Aspose.Words Cloud SDK for .NET Download.

  4. Licens til produktion - For langsigtet brug, anskaff en midlertidig eller permanent licens fra den midlertidige licensside.

Almindelige spørgsmål

  • Hvordan kan jeg sammenligne og flette ODT-filer programmatisk i .NET ved hjælp af Aspose.Words Cloud SDK?
    Brug CompareDocument og AcceptAllRevisions operationerne, som leveres af Aspose.Words Cloud SDK for .NET. Upload begge ODT-filer, udfør sammenligningsanmodningen, og accepter derefter revisionerne for at få det flettede resultat.

  • Hvilken godkendelsesmetode kræves for REST API‑anmodninger?
    Du har brug for en klient‑ID og en klienthemmelighed for at få en OAuth 2.0‑adgangstoken. Inkluder tokenet i Authorization‑headeren for hver cURL‑anmodning.

  • Er der en måde at prøve SDK’en før køb?
    Du kan anmode om en midlertidig licens fra den midlertidige licensside for at evaluere biblioteket under udvikling.

  • Hvor kan jeg finde flere eksempler og en detaljeret API-reference?
    Besøg den officielle dokumentation og API-referencen for omfattende vejledninger og kodeeksempler.

Relaterede artikler