Mantenere sincronizzate più versioni di un documento ODT può rapidamente diventare un problema per gli sviluppatori che devono individuare le modifiche e combinare le modifiche automaticamente. Aspose.Words Cloud SDK for .NET rende il confronto e l’unione dei file ODT programmaticamente in .NET semplici e affidabili. Questa guida ti accompagna nel caricamento di due file ODT nello storage di Aspose Cloud, nella generazione di un documento diff, nell’accettare tutte le revisioni per produrre un file unito e nel recuperare il risultato. Vedrai anche le chiamate REST equivalenti usando cURL e imparerai come configurare l’SDK nel tuo progetto .NET.

Esempio completo funzionante per confrontare e unire file ODT programmaticamente in .NET

Questo esempio dimostra come confrontare due file ODT, generare un documento di revisione, accettare tutte le revisioni e scaricare l’ODT finale unito.

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

Nota: Questo esempio di codice dimostra la funzionalità principale. Prima di usarlo nel tuo progetto, assicurati di aggiornare tutti i percorsi dei file e i valori di configurazione per corrispondere al tuo ambiente reale, verifica che tutte le dipendenze richieste siano correttamente installate e testa accuratamente nel tuo ambiente di sviluppo. Se incontri problemi, consulta la documentazione ufficiale o contatta il team di supporto per assistenza.

Eseguire il DIFF e l’unione di file ODT con cURL e l’API REST

Di seguito sono riportati i comandi cURL equivalenti che eseguono lo stesso flusso di lavoro di diff e merge contro l’Aspose.Words Cloud REST API.

  1. Ottieni un token di accesso
    Sostituisci YOUR_CLIENT_ID e YOUR_CLIENT_SECRET con le tue credenziali.
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. Carica il file ODT originale
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. Carica il file ODT revisionato
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. Esegui l’operazione di confronto (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. Accetta tutte le revisioni per creare l’ODT unito
curl -X POST "https://api.aspose.cloud/v4.0/words/Documents/original.odt/acceptAllRevisions" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
  1. Scarica il documento ODT unito
curl -X GET "https://api.aspose.cloud/v4.0/words/storage/file/Documents/original.odt" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o merged.odt

Per ulteriori dettagli sui corpi della richiesta e opzioni aggiuntive, consulta la documentazione ufficiale dell’API.

Come confrontare e unire i file ODT programmaticamente in .NET

Il codice segue una sequenza chiara che rispecchia il flusso di lavoro REST descritto sopra.

  1. Inizializzare il client API - new WordsApi(config) crea un client autenticato utilizzando l’oggetto Configuration che contiene il tuo ClientId e ClientSecret.
var config = new Configuration { ClientId = clientId, ClientSecret = clientSecret };
var wordsApi = new WordsApi(config);
  1. Carica i file sorgente - Il metodo di supporto UploadFile utilizza UploadFileRequest per inviare ogni file ODT locale nella cartella di archiviazione cloud.
var uploadRequest = new UploadFileRequest(remotePath, stream);
api.UploadFile(uploadRequest);
  1. Crea un oggetto CompareData - Questo oggetto definisce l’autore, le opzioni di confronto e un riferimento al file revisionato. Viene passato a CompareDocumentRequest.

    var compareData = new CompareData { Author = "Comparer", CompareOptions = new CompareOptions { … }, FileReference = new FileReference($"{storageFolder}/{revisedFile}") };
    
  2. Esegui l’operazione di confronto - wordsApi.CompareDocument(compareRequest) invia la richiesta al servizio, che aggiunge i segni di revisione al documento originale.

    var compareRequest = new CompareDocumentRequest(originalFile, compareData, storageFolder);
    wordsApi.CompareDocument(compareRequest);
    
  3. Accetta tutte le revisioni - AcceptAllRevisionsRequest indica al servizio di unire le modifiche, producendo un file ODT pulito.

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

Ogni passaggio corrisponde direttamente ai comandi cURL, offrendoti la flessibilità di scegliere tra la libreria .NET e le chiamate HTTP raw.

Installazione e configurazione Aspose.Words Cloud SDK for .NET

  1. Aggiungi il pacchetto NuGet
dotnet add package Aspose.Words-Cloud
  1. Ripristina i pacchetti e compila - L’SDK funziona con .NET 6.0 e versioni successive. Assicurati che il tuo progetto punti a un framework compatibile.

  2. Configura le credenziali - Sostituisci i valori segnaposto nel codice di esempio con il ClientId e il ClientSecret che ottieni dalla tua dashboard di Aspose Cloud.

  3. Scarica l’SDK - Puoi anche scaricare i binari più recenti dalla pagina di rilascio ufficiale: Aspose.Words Cloud SDK for .NET Download.

  4. Licenza per la produzione - Per un uso a lungo termine, ottieni una licenza temporanea o permanente dalla pagina della licenza temporanea.

Domande comuni

  • Come posso confrontare e unire file ODT programmaticamente in .NET usando Aspose.Words Cloud SDK?
    Utilizza le operazioni CompareDocument e AcceptAllRevisions fornite da Aspose.Words Cloud SDK for .NET. Carica entrambi i file ODT, esegui la richiesta di confronto, quindi accetta le revisioni per ottenere il risultato unito.

  • Qual è il metodo di autenticazione richiesto per le chiamate REST API?
    È necessario un client ID e un client secret per ottenere un token di accesso OAuth 2.0. Includi il token nell’intestazione Authorization di ogni richiesta cURL.

  • C’è un modo per provare l’SDK prima di acquistarlo?
    Puoi richiedere una licenza temporanea dalla pagina della licenza temporanea per valutare la libreria durante lo sviluppo.

  • Dove posso trovare più esempi e una documentazione API dettagliata?
    Visita la documentazione ufficiale e il riferimento API per guide complete e esempi di codice.

Articoli correlati