Mantendo várias versões de um documento ODT sincronizadas pode rapidamente se tornar um problema para desenvolvedores que precisam identificar mudanças e combinar edições automaticamente. Aspose.Words Cloud SDK for .NET torna a comparação e mesclagem de arquivos ODT programaticamente em .NET simples e confiável. Este guia orienta você a fazer upload de dois arquivos ODT para o armazenamento Aspose Cloud, gerar um documento de diferenças, aceitar todas as revisões para produzir um arquivo mesclado e recuperar o resultado. Você também verá as chamadas REST equivalentes usando cURL e aprenderá como configurar o SDK em seu projeto .NET.

Exemplo completo de funcionamento para comparar e mesclar arquivos ODT programaticamente em .NET

Este exemplo demonstra como comparar dois arquivos ODT, gerar um documento de revisão, aceitar todas as revisões e baixar o ODT final mesclado.

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 exemplo de código demonstra a funcionalidade principal. Antes de usá-lo em seu projeto, certifique-se de atualizar quaisquer caminhos de arquivo e valores de configuração para corresponder ao seu ambiente real, verifique se todas as dependências necessárias estão corretamente instaladas e teste minuciosamente em seu ambiente de desenvolvimento. Se encontrar algum problema, consulte a documentação oficial ou entre em contato com a equipe de suporte para obter assistência.

Executar DIFF e Mesclagem de Arquivo ODT com cURL e a API REST

A seguir estão os comandos cURL equivalentes que executam o mesmo fluxo de trabalho de diff e merge contra a Aspose.Words Cloud REST API.

  1. Obtenha um token de acesso
    Substitua YOUR_CLIENT_ID e YOUR_CLIENT_SECRET pelas suas credenciais.
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. Carregue o arquivo 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. Carregue o arquivo 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. Execute a operação de comparação (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. Aceitar todas as revisões para criar o ODT mesclado
curl -X POST "https://api.aspose.cloud/v4.0/words/Documents/original.odt/acceptAllRevisions" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
  1. Baixe o documento ODT mesclado
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 obter mais detalhes sobre os corpos de solicitação e opções adicionais, consulte a documentação oficial da API.

Como a comparação e mesclagem de arquivos ODT programaticamente em .NET funciona

O código segue uma sequência clara que reflete o fluxo de trabalho REST descrito acima.

  1. Inicializar o cliente da API - new WordsApi(config) cria um cliente autenticado usando o objeto Configuration que contém seu ClientId e ClientSecret.
var config = new Configuration { ClientId = clientId, ClientSecret = clientSecret };
var wordsApi = new WordsApi(config);
  1. Carregar arquivos de origem - O método auxiliar UploadFile usa UploadFileRequest para enviar cada arquivo ODT local para a pasta de armazenamento na nuvem.

    var uploadRequest = new UploadFileRequest(remotePath, stream);
    api.UploadFile(uploadRequest);
    
  2. Criar um objeto CompareData - Este objeto define o autor, as opções de comparação e uma referência ao arquivo revisado. Ele é passado para CompareDocumentRequest.

    var compareData = new CompareData { Author = "Comparer", CompareOptions = new CompareOptions { … }, FileReference = new FileReference($"{storageFolder}/{revisedFile}") };
    
  3. Execute a operação de comparação - wordsApi.CompareDocument(compareRequest) envia a solicitação ao serviço, que adiciona marcas de revisão ao documento original.

    var compareRequest = new CompareDocumentRequest(originalFile, compareData, storageFolder);
    wordsApi.CompareDocument(compareRequest);
    
  4. Aceitar todas as revisões - AcceptAllRevisionsRequest informa ao serviço para mesclar as alterações, produzindo um arquivo ODT limpo.

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

Cada etapa corresponde diretamente aos comandos cURL, oferecendo flexibilidade para escolher entre a biblioteca .NET e chamadas HTTP brutas.

Instalando e Configurando Aspose.Words Cloud SDK for .NET

  1. Adicione o pacote NuGet
dotnet add package Aspose.Words-Cloud
  1. Restaurar pacotes e compilar - O SDK funciona com .NET 6.0 e posterior. Certifique‑se de que seu projeto tenha como alvo uma estrutura compatível.

  2. Configure credentials - Substitua os valores de placeholder no código de exemplo pelos ClientId e ClientSecret que você obtém no seu painel do Aspose Cloud.

  3. Baixar o SDK - Você também pode baixar os binários mais recentes na página oficial de lançamentos: Aspose.Words Cloud SDK for .NET Download.

  4. Licença para produção - Para uso de longo prazo, adquira uma licença temporária ou permanente na página de licença temporária.

Perguntas Frequentes

  • Como posso comparar e mesclar arquivos ODT programaticamente em .NET usando Aspose.Words Cloud SDK?
    Use as operações CompareDocument e AcceptAllRevisions fornecidas pelo Aspose.Words Cloud SDK for .NET. Faça upload de ambos os arquivos ODT, execute a solicitação de comparação e, em seguida, aceite as revisões para obter o resultado mesclado.

  • Qual método de autenticação é necessário para as chamadas da API REST?
    Você precisa de um ID de cliente e um segredo de cliente para obter um token de acesso OAuth 2.0. Inclua o token no cabeçalho Authorization de cada solicitação cURL.

  • Existe uma maneira de experimentar o SDK antes de comprar?
    Você pode solicitar uma licença temporária na página de licença temporária para avaliar a biblioteca durante o desenvolvimento.

  • Onde posso encontrar mais exemplos e referência detalhada da API?
    Visite a documentação oficial e a referência da API para guias abrangentes e exemplos de código.

Artigos Relacionados