Mantener varias versiones de un documento ODT sincronizadas puede convertirse rápidamente en un dolor de cabeza para los desarrolladores que necesitan detectar cambios y combinar ediciones automáticamente. Aspose.Words Cloud SDK for .NET permite comparar y combinar archivos ODT programáticamente en .NET de manera simple y fiable. Esta guía le muestra cómo cargar dos archivos ODT en el almacenamiento de Aspose Cloud, generar un documento de diferencias, aceptar todas las revisiones para producir un archivo combinado y recuperar el resultado. También verá las llamadas REST equivalentes usando cURL y aprenderá cómo configurar el SDK en su proyecto .NET.

Ejemplo completo y funcional para comparar y combinar archivos ODT programáticamente en .NET

Este ejemplo muestra cómo comparar dos archivos ODT, generar un documento de revisión, aceptar todas las revisiones y descargar el ODT final fusionado.

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: Este ejemplo de código demuestra la funcionalidad principal. Antes de usarlo en su proyecto, asegúrese de actualizar cualquier ruta de archivo y valores de configuración para que coincidan con su entorno real, verifique que todas las dependencias requeridas estén correctamente instaladas y pruebe exhaustivamente en su entorno de desarrollo. Si encuentra algún problema, consulte la documentación oficial o póngase en contacto con el equipo de soporte para obtener ayuda.

Realizar DIFF y fusión de archivos ODT con cURL y la API REST

A continuación se muestran los comandos cURL equivalentes que realizan el mismo flujo de trabajo de diff y merge contra la Aspose.Words Cloud REST API.

  1. Obtener un token de acceso
    Reemplace YOUR_CLIENT_ID y YOUR_CLIENT_SECRET con sus credenciales.
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. Cargar el archivo ODT original
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. Cargar el archivo ODT revisado
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. Ejecutar la operación de comparación (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. Aceptar todas las revisiones para crear el ODT combinado
curl -X POST "https://api.aspose.cloud/v4.0/words/Documents/original.odt/acceptAllRevisions" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
  1. Descargar el documento ODT combinado
curl -X GET "https://api.aspose.cloud/v4.0/words/storage/file/Documents/original.odt" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o merged.odt

Para obtener más detalles sobre los cuerpos de solicitud y opciones adicionales, consulte la documentación oficial de la API.

Cómo funciona la comparación y fusión de archivos ODT programáticamente en .NET

El código sigue una secuencia clara que refleja el flujo de trabajo REST descrito arriba.

  1. Inicializar el cliente API - new WordsApi(config) crea un cliente autenticado usando el objeto Configuration que contiene su ClientId y ClientSecret.
var config = new Configuration { ClientId = clientId, ClientSecret = clientSecret };
var wordsApi = new WordsApi(config);
  1. Cargar archivos de origen - El método auxiliar UploadFile usa UploadFileRequest para enviar cada archivo ODT local a la carpeta de almacenamiento en la nube.

    var uploadRequest = new UploadFileRequest(remotePath, stream);
    api.UploadFile(uploadRequest);
    
  2. Crear un objeto CompareData - Este objeto define el autor, las opciones de comparación y una referencia al archivo revisado. Se pasa a CompareDocumentRequest.

    var compareData = new CompareData { Author = "Comparer", CompareOptions = new CompareOptions { … }, FileReference = new FileReference($"{storageFolder}/{revisedFile}") };
    
  3. Ejecutar la operación de comparación - wordsApi.CompareDocument(compareRequest) envía la solicitud al servicio, que agrega marcas de revisión al documento original.

    var compareRequest = new CompareDocumentRequest(originalFile, compareData, storageFolder);
    wordsApi.CompareDocument(compareRequest);
    
  4. Aceptar todas las revisiones - AcceptAllRevisionsRequest le indica al servicio que combine los cambios, produciendo un archivo ODT limpio.

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

Cada paso corresponde directamente a los comandos cURL, dándole flexibilidad para elegir entre la biblioteca .NET y llamadas HTTP sin procesar.

Instalación y configuración de Aspose.Words Cloud SDK for .NET

  1. Agregar el paquete NuGet
dotnet add package Aspose.Words-Cloud
  1. Restaurar paquetes y compilar - El SDK funciona con .NET 6.0 y versiones posteriores. Asegúrese de que su proyecto apunte a un framework compatible.

  2. Configurar credenciales - Reemplace los valores de marcador de posición en el código de ejemplo con el ClientId y el ClientSecret que obtiene de su panel de Aspose Cloud.

  3. Descargar el SDK - También puedes descargar los binarios más recientes desde la página oficial de lanzamientos: Aspose.Words Cloud SDK for .NET Download.

  4. Licencia para producción - Para uso a largo plazo, adquiera una licencia temporal o permanente desde la página de licencia temporal.

Preguntas comunes

  • ¿Cómo puedo comparar y combinar archivos ODT programáticamente en .NET usando Aspose.Words Cloud SDK?
    Utilice las operaciones CompareDocument y AcceptAllRevisions proporcionadas por Aspose.Words Cloud SDK for .NET. Cargue ambos archivos ODT, ejecute la solicitud de comparación y luego acepte las revisiones para obtener el resultado combinado.

  • ¿Qué método de autenticación se requiere para las llamadas a la API REST?
    Necesita un ID de cliente y un secreto de cliente para obtener un token de acceso OAuth 2.0. Incluya el token en el encabezado Authorization de cada solicitud cURL.

  • ¿Hay alguna forma de probar el SDK antes de comprarlo?
    Puede solicitar una licencia temporal desde la página de licencia temporal para evaluar la biblioteca durante el desarrollo.

  • ¿Dónde puedo encontrar más ejemplos y una referencia detallada de la API?
    Visite la documentación oficial y la referencia de la API para guías completas y ejemplos de código.

Artículos Relacionados