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.
- Obtener un token de acceso
ReemplaceYOUR_CLIENT_IDyYOUR_CLIENT_SECRETcon 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"
- 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"
- 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"
- 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" }
}'
- 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"
- 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.
- Inicializar el cliente API -
new WordsApi(config)crea un cliente autenticado usando el objetoConfigurationque contiene suClientIdyClientSecret.
var config = new Configuration { ClientId = clientId, ClientSecret = clientSecret };
var wordsApi = new WordsApi(config);
-
Cargar archivos de origen - El método auxiliar
UploadFileusaUploadFileRequestpara enviar cada archivo ODT local a la carpeta de almacenamiento en la nube.var uploadRequest = new UploadFileRequest(remotePath, stream); api.UploadFile(uploadRequest); -
Crear un objeto
CompareData- Este objeto define el autor, las opciones de comparación y una referencia al archivo revisado. Se pasa aCompareDocumentRequest.var compareData = new CompareData { Author = "Comparer", CompareOptions = new CompareOptions { … }, FileReference = new FileReference($"{storageFolder}/{revisedFile}") }; -
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); -
Aceptar todas las revisiones -
AcceptAllRevisionsRequestle 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
- Agregar el paquete NuGet
dotnet add package Aspose.Words-Cloud
-
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.
-
Configurar credenciales - Reemplace los valores de marcador de posición en el código de ejemplo con el
ClientIdy elClientSecretque obtiene de su panel de Aspose Cloud. -
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.
-
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 operacionesCompareDocumentyAcceptAllRevisionsproporcionadas 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 encabezadoAuthorizationde 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.