Das Synchronisieren mehrerer Versionen eines ODT Dokuments kann für Entwickler, die Änderungen erkennen und Bearbeitungen automatisch kombinieren müssen, schnell zu einem Kopfzerbrechen werden. Das Aspose.Words Cloud SDK for .NET ermöglicht das programmatische Vergleichen und Zusammenführen von ODT-Dateien in .NET einfach und zuverlässig. Dieser Leitfaden führt Sie durch das Hochladen von zwei ODT-Dateien in den Aspose Cloud‑Speicher, das Erzeugen eines Diff‑Dokuments, das Akzeptieren aller Revisionen, um eine zusammengeführte Datei zu erstellen, und das Abrufen des Ergebnisses. Sie sehen außerdem die entsprechenden REST‑Aufrufe mit cURL und erfahren, wie Sie das SDK in Ihrem .NET‑Projekt konfigurieren.
Vollständiges funktionierendes Beispiel für den Vergleich und das Zusammenführen von ODT-Dateien programmgesteuert in .NET
Dieses Beispiel zeigt, wie man zwei ODT‑Dateien vergleicht, ein Revisionsdokument erstellt, alle Revisionen akzeptiert und das endgültige zusammengeführte ODT herunterlädt.
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);
}
}
}
Hinweis: Dieses Codebeispiel demonstriert die Kernfunktionalität. Bevor Sie es in Ihrem Projekt verwenden, stellen Sie sicher, dass Sie alle Dateipfade und Konfigurationswerte an Ihre tatsächliche Umgebung anpassen, überprüfen Sie, dass alle erforderlichen Abhängigkeiten ordnungsgemäß installiert sind, und testen Sie gründlich in Ihrer Entwicklungsumgebung. Wenn Sie auf Probleme stoßen, lesen Sie bitte die offizielle Dokumentation oder wenden Sie sich an das Support-Team für Unterstützung.
ODT-Datei DIFF und Merge mit cURL und der REST-API ausführen
Im Folgenden finden Sie die entsprechenden cURL‑Befehle, die denselben Diff‑ und Merge‑Workflow gegen die Aspose.Words Cloud REST API ausführen.
- Zugriffstoken abrufen
Ersetzen SieYOUR_CLIENT_IDundYOUR_CLIENT_SECRETdurch Ihre Anmeldeinformationen.
curl -X POST "https://api.aspose.cloud/connect/token" \
-d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"
- Laden Sie die ursprüngliche ODT-Datei hoch
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"
- Laden Sie die überarbeitete ODT-Datei hoch
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"
- Führen Sie den Vergleich (diff)-Vorgang aus
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" }
}'
- Alle Revisionen akzeptieren, um das zusammengeführte ODT zu erstellen
curl -X POST "https://api.aspose.cloud/v4.0/words/Documents/original.odt/acceptAllRevisions" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
- Laden Sie das zusammengeführte ODT-Dokument herunter
curl -X GET "https://api.aspose.cloud/v4.0/words/storage/file/Documents/original.odt" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-o merged.odt
Weitere Details zu Anforderungskörpern und zusätzlichen Optionen finden Sie in der offiziellen API‑Dokumentation.
Wie das Vergleichen und Zusammenführen von ODT-Dateien programmgesteuert in .NET funktioniert
Der Code folgt einer klaren Reihenfolge, die den oben beschriebenen REST‑Workflow widerspiegelt.
- Initialisieren Sie den API-Client -
new WordsApi(config)erstellt einen authentifizierten Client unter Verwendung desConfiguration‑Objekts, das IhreClientIdundClientSecretenthält.
var config = new Configuration { ClientId = clientId, ClientSecret = clientSecret };
var wordsApi = new WordsApi(config);
-
Quelldateien hochladen - Die Hilfsmethode
UploadFileverwendetUploadFileRequest, um jede lokale ODT-Datei in den Cloud‑Speicherordner zu senden.var uploadRequest = new UploadFileRequest(remotePath, stream); api.UploadFile(uploadRequest); -
Create a
CompareDataobject - Dieses Objekt definiert den Autor, die Vergleichsoptionen und einen Verweis auf die überarbeitete Datei. Es wird anCompareDocumentRequestübergeben.
var compareData = new CompareData { Author = "Comparer", CompareOptions = new CompareOptions { … }, FileReference = new FileReference($"{storageFolder}/{revisedFile}") };
-
Führen Sie die Vergleichsoperation aus -
wordsApi.CompareDocument(compareRequest)sendet die Anforderung an den Dienst, der Revisionsmarkierungen zum Originaldokument hinzufügt.var compareRequest = new CompareDocumentRequest(originalFile, compareData, storageFolder); wordsApi.CompareDocument(compareRequest); -
Alle Revisionen akzeptieren -
AcceptAllRevisionsRequestteilt dem Dienst mit, die Änderungen zusammenzuführen und eine bereinigte ODT-Datei zu erzeugen.
var acceptRequest = new AcceptAllRevisionsRequest(originalFile, storageFolder);
wordsApi.AcceptAllRevisions(acceptRequest);
Jeder Schritt entspricht direkt den cURL‑Befehlen und gibt Ihnen die Flexibilität, zwischen der .NET‑Bibliothek und rohen HTTP‑Aufrufen zu wählen.
Installation und Konfiguration von Aspose.Words Cloud SDK für .NET
- Fügen Sie das NuGet-Paket hinzu
dotnet add package Aspose.Words-Cloud
-
Pakete wiederherstellen und bauen - Das SDK funktioniert mit .NET 6.0 und höher. Stellen Sie sicher, dass Ihr Projekt ein kompatibles Framework verwendet.
-
Anmeldeinformationen konfigurieren - Ersetzen Sie die Platzhalterwerte im Beispielcode durch die
ClientIdundClientSecret, die Sie aus Ihrem Aspose Cloud Dashboard erhalten. -
Download the SDK - Sie können die neuesten Binärdateien auch von der offiziellen Release‑Seite herunterladen: Aspose.Words Cloud SDK for .NET Download.
-
Lizenz für die Produktion - Für den langfristigen Einsatz erwerben Sie eine temporäre oder permanente Lizenz von der temporären Lizenzseite.
Häufige Fragen
-
Wie kann ich ODT-Dateien programmgesteuert in .NET mit Aspose.Words Cloud SDK vergleichen und zusammenführen?
Verwenden Sie dieCompareDocument- undAcceptAllRevisions-Operationen, die vom Aspose.Words Cloud SDK for .NET bereitgestellt werden. Laden Sie beide ODT-Dateien hoch, führen Sie die Vergleichsanfrage aus und akzeptieren Sie anschließend die Revisionen, um das zusammengeführte Ergebnis zu erhalten. -
Welche Authentifizierungsmethode ist für die REST-API-Aufrufe erforderlich?
Sie benötigen eine Client-ID und ein Client-Secret, um ein OAuth 2.0-Zugriffstoken zu erhalten. Fügen Sie das Token in denAuthorization-Header jeder cURL-Anfrage ein. -
Gibt es eine Möglichkeit, das SDK vor dem Kauf zu testen?
Sie können eine temporäre Lizenz von der temporären Lizenzseite anfordern, um die Bibliothek während der Entwicklung zu evaluieren. -
Wo kann ich weitere Beispiele und eine detaillierte API-Referenz finden?
Besuchen Sie die offizielle Dokumentation und die API-Referenz für umfassende Anleitungen und Codebeispiele.