Több verzió egy ODT dokumentum szinkronban tartása gyorsan fejfájást okozhat a fejlesztőknek, akiknek változásokat kell észrevenniük és a szerkesztéseket automatikusan össze kell vonniuk. Aspose.Words Cloud SDK for .NET lehetővé teszi az ODT fájlok programozott összehasonlítását és egyesítését .NET környezetben egyszerűen és megbízhatóan. Ez az útmutató végigvezet a két ODT fájl feltöltésén az Aspose Cloud tárolóba, a diff dokumentum generálásán, az összes módosítás elfogadásán egy egyesített fájl létrehozásához, és az eredmény lekérésén. Emellett megtekintheti a megfelelő REST hívásokat cURL segítségével, és megtanulhatja, hogyan konfigurálja az SDK-t .NET projektjében.

Teljes működő példa ODT fájlok összehasonlítására és egyesítésére programozott módon .NET-ben

Ez a példa bemutatja, hogyan lehet két ODT fájlt összehasonlítani, egy revíziós dokumentumot generálni, az összes módosítást elfogadni, és letölteni a végleges egyesített ODT‑t.

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

Megjegyzés: Ez a kódrészlet a fő funkciót mutatja be. Mielőtt a projektjében használná, győződjön meg róla, hogy frissítette a fájl útvonalakat és konfigurációs értékeket a tényleges környezetnek megfelelően, ellenőrizze, hogy minden szükséges függőség megfelelően telepítve van, és alaposan tesztelje a fejlesztői környezetben. Ha problémákba ütközik, kérjük, tekintse meg a hivatalos dokumentációt vagy lépjen kapcsolatba a támogatási csapattal segítségért.

ODT fájl DIFF és egyesítés cURL-lel és a REST API-val

Az alábbiakban a megfelelő cURL parancsok találhatók, amelyek ugyanazt a diff és merge munkafolyamatot hajtják végre az Aspose.Words Cloud REST API-val.

  1. Szerezzen hozzáférési tokent
    Cserélje le YOUR_CLIENT_ID és YOUR_CLIENT_SECRET a hitelesítő adataival.
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. Töltsd fel az eredeti ODT fájlt
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. Töltse fel a módosított ODT fájlt
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. Futtassa az összehasonlítás (diff) műveletet
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. Fogadja el az összes módosítást az egyesített ODT létrehozásához
curl -X POST "https://api.aspose.cloud/v4.0/words/Documents/original.odt/acceptAllRevisions" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
  1. Az egyesített ODT dokumentum letöltése
curl -X GET "https://api.aspose.cloud/v4.0/words/storage/file/Documents/original.odt" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o merged.odt

A kérés törzseiről és további beállításokról további részletekért tekintse meg a hivatalos API dokumentációt.

Hogyan működik az ODT fájlok összehasonlítása és egyesítése programozott módon a .NET-ben

A kód egyértelmű sorrendet követ, amely tükrözi a fent leírt REST munkafolyamatot.

  1. Az API kliens inicializálása - new WordsApi(config) egy hitelesített klienst hoz létre a Configuration objektum használatával, amely tartalmazza a ClientId és a ClientSecret értékeit.
var config = new Configuration { ClientId = clientId, ClientSecret = clientSecret };
var wordsApi = new WordsApi(config);
  1. Forrásfájlok feltöltése - A segítő metódus UploadFile a UploadFileRequest-et használja, hogy minden helyi ODT fájlt a felhő tároló mappájába küldjön.

    var uploadRequest = new UploadFileRequest(remotePath, stream);
    api.UploadFile(uploadRequest);
    
  2. Hozzon létre egy CompareData objektumot - Ez az objektum meghatározza a szerzőt, az összehasonlítási beállításokat, és egy hivatkozást a módosított fájlra. A CompareDocumentRequest‑nek adja át.

var compareData = new CompareData { Author = "Comparer", CompareOptions = new CompareOptions { … }, FileReference = new FileReference($"{storageFolder}/{revisedFile}") };
  1. Hajtsa végre az összehasonlítási műveletet - wordsApi.CompareDocument(compareRequest) elküldi a kérést a szolgáltatásnak, amely revíziós jelöléseket ad az eredeti dokumentumhoz.
var compareRequest = new CompareDocumentRequest(originalFile, compareData, storageFolder);
wordsApi.CompareDocument(compareRequest);
  1. Minden módosítás elfogadása - AcceptAllRevisionsRequest azt mondja a szolgáltatásnak, hogy egyesítse a változtatásokat, és tiszta ODT fájlt állítson elő.
    var acceptRequest = new AcceptAllRevisionsRequest(originalFile, storageFolder);
    wordsApi.AcceptAllRevisions(acceptRequest);
    

Minden lépés közvetlenül a cURL parancsoknak felel meg, lehetővé téve, hogy a .NET könyvtár és a nyers HTTP hívások között válasszon.

Telepítés és konfigurálás Aspose.Words Cloud SDK for .NET

  1. Adja hozzá a NuGet csomagot
dotnet add package Aspose.Words-Cloud
  1. Csomagok visszaállítása és felépítés - Az SDK a .NET 6.0‑nal és újabb verziókkal működik. Győződjön meg róla, hogy a projektje kompatibilis keretrendszert céloz.

  2. Hitelesítő adatok konfigurálása - Cserélje le a mintakódban lévő helyőrző értékeket a ClientId és ClientSecret értékekkel, amelyeket az Aspose Cloud irányítópultjáról kap.

  3. SDK letöltése - A legújabb binárisok letöltéséhez is használhatja a hivatalos kiadási oldalt: Aspose.Words Cloud SDK for .NET Download.

  4. Licenc a termeléshez - Hosszú távú használathoz szerezzen be egy ideiglenes vagy állandó licencet a temporary license page oldalról.

Gyakori kérdések

  • Hogyan hasonlíthatom össze és egyesíthetem programozottan az ODT fájlokat .NET környezetben az Aspose.Words Cloud SDK használatával?
    Használja a CompareDocument és AcceptAllRevisions műveleteket, amelyeket az Aspose.Words Cloud SDK for .NET biztosít. Töltse fel mindkét ODT fájlt, futtassa a összehasonlítási kérést, majd fogadja el a módosításokat a egyesített eredmény eléréséhez.

  • Milyen hitelesítési módszer szükséges a REST API hívásokhoz?
    Szüksége van egy ügyfélazonosítóra és ügyféltitokra az OAuth 2.0 hozzáférési token megszerzéséhez. Tartalmazza a tokent az Authorization fejlécben minden cURL kérésnél.

  • Van lehetőség a SDK kipróbálására a vásárlás előtt?
    Kérhet ideiglenes licencet a ideiglenes licenc oldalról a könyvtár fejlesztés közbeni értékeléséhez.

  • Hol találhatok további példákat és részletes API‑referenciát?
    Látogassa meg a hivatalos dokumentációt és az API‑referenciát a részletes útmutatók és kódmintákért.

Kapcsolódó cikkek