Η διατήρηση πολλαπλών εκδόσεων ενός εγγράφου ODT συγχρονισμένων μπορεί γρήγορα να γίνει πηγή άγχους για προγραμματιστές που χρειάζεται να εντοπίζουν αλλαγές και να συνδυάζουν επεξεργασίες αυτόματα. Aspose.Words Cloud SDK for .NET καθιστά τη σύγκριση και συγχώνευση αρχείων ODT προγραμματιστικά σε .NET απλή και αξιόπιστη. Αυτός ο οδηγός σας καθοδηγεί στη μεταφόρτωση δύο αρχείων ODT στο Aspose Cloud storage, στη δημιουργία ενός εγγράφου diff, στην αποδοχή όλων των αναθεωρήσεων για την παραγωγή ενός συγχωνευμένου αρχείου και στην ανάκτηση του αποτελέσματος. Θα δείτε επίσης τις ισοδύναμες κλήσεις REST χρησιμοποιώντας cURL και θα μάθετε πώς να ρυθμίσετε το SDK στο .NET έργο σας.
Πλήρες λειτουργικό παράδειγμα για τη σύγκριση και συγχώνευση αρχείων ODT προγραμματιστικά σε .NET
Αυτό το παράδειγμα δείχνει πώς να συγκρίνετε δύο αρχεία ODT, να δημιουργήσετε ένα έγγραφο αναθεώρησης, να αποδεχτείτε όλες τις αναθεωρήσεις και να κατεβάσετε το τελικό συγχωνευμένο ODT.
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);
}
}
}
Σημείωση: Αυτό το παράδειγμα κώδικα δείχνει τη βασική λειτουργικότητα. Πριν το χρησιμοποιήσετε στο έργο σας, βεβαιωθείτε ότι έχετε ενημερώσει όλες τις διαδρομές αρχείων και τις τιμές διαμόρφωσης ώστε να ταιριάζουν με το πραγματικό σας περιβάλλον, επιβεβαιώστε ότι όλες οι απαιτούμενες εξαρτήσεις είναι σωστά εγκατεστημένες, και δοκιμάστε διεξοδικά στο περιβάλλον ανάπτυξής σας. Εάν αντιμετωπίσετε οποιοδήποτε πρόβλημα, παρακαλούμε ανατρέξτε στην επίσημη τεκμηρίωση ή επικοινωνήστε με την ομάδα υποστήριξης για βοήθεια.
Εκτέλεση DIFF αρχείου ODT και συγχώνευση με cURL και το REST API
Ακολουθούν οι ισοδύναμες εντολές cURL που εκτελούν την ίδια ροή εργασίας diff και merge εναντίον του Aspose.Words Cloud REST API.
- Αποκτήστε ένα διακριτικό πρόσβασης
ΑντικαταστήστεYOUR_CLIENT_IDκαιYOUR_CLIENT_SECRETμε τα διαπιστευτήριά σας.
curl -X POST "https://api.aspose.cloud/connect/token" \
-d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"
- Ανεβάστε το αρχικό αρχείο ODT
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"
- Ανεβάστε το διορθωμένο αρχείο ODT
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"
- Εκτελέστε τη λειτουργία σύγκρισης (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" }
}'
- Αποδεχτείτε όλες τις αλλαγές για να δημιουργήσετε το συγχωνευμένο ODT
curl -X POST "https://api.aspose.cloud/v4.0/words/Documents/original.odt/acceptAllRevisions" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
- Κατεβάστε το συγχωνευμένο έγγραφο ODT
curl -X GET "https://api.aspose.cloud/v4.0/words/storage/file/Documents/original.odt" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-o merged.odt
Για περισσότερες λεπτομέρειες σχετικά με τα σώματα των αιτημάτων και τις πρόσθετες επιλογές, δείτε την επίσημη τεκμηρίωση API.
Πώς η Σύγκριση και η Συγχώνευση Αρχείων ODT Προγραμματιστικά σε .NET Λειτουργεί
Ο κώδικας ακολουθεί μια σαφή ακολουθία που αντικατοπτρίζει τη ροή εργασίας REST που περιγράφηκε παραπάνω.
- Αρχικοποίηση του πελάτη API -
new WordsApi(config)δημιουργεί έναν αυθεντικοποιημένο πελάτη χρησιμοποιώντας το αντικείμενοConfigurationπου περιέχει τοClientIdκαι τοClientSecretσας.
var config = new Configuration { ClientId = clientId, ClientSecret = clientSecret };
var wordsApi = new WordsApi(config);
- Μεταφόρτωση αρχείων προέλευσης - Η βοηθητική μέθοδος
UploadFileχρησιμοποιεί τοUploadFileRequestγια να στείλει κάθε τοπικό αρχείο ODT στον φάκελο αποθήκευσης στο cloud.
var uploadRequest = new UploadFileRequest(remotePath, stream);
api.UploadFile(uploadRequest);
-
Δημιουργήστε ένα αντικείμενο
CompareData- Αυτό το αντικείμενο ορίζει τον συγγραφέα, τις επιλογές σύγκρισης και μια αναφορά στο αναθεωρημένο αρχείο. Περνιέται στοCompareDocumentRequest.var compareData = new CompareData { Author = "Comparer", CompareOptions = new CompareOptions { … }, FileReference = new FileReference($"{storageFolder}/{revisedFile}") }; -
Εκτελέστε τη λειτουργία σύγκρισης -
wordsApi.CompareDocument(compareRequest)στέλνει το αίτημα στην υπηρεσία, η οποία προσθέτει σημάδια αναθεώρησης στο αρχικό έγγραφο.var compareRequest = new CompareDocumentRequest(originalFile, compareData, storageFolder); wordsApi.CompareDocument(compareRequest); -
Αποδοχή όλων των αλλαγών -
AcceptAllRevisionsRequestπροτρέπει την υπηρεσία να συγχωνεύσει τις αλλαγές, δημιουργώντας ένα καθαρό αρχείο ODT.
var acceptRequest = new AcceptAllRevisionsRequest(originalFile, storageFolder);
wordsApi.AcceptAllRevisions(acceptRequest);
Κάθε βήμα αντιστοιχεί άμεσα στις εντολές cURL, δίνοντάς σας ευελιξία να επιλέξετε μεταξύ της βιβλιοθήκης .NET και των ακατέργαστων κλήσεων HTTP.
Εγκατάσταση και Διαμόρφωση Aspose.Words Cloud SDK for .NET
- Προσθέστε το πακέτο NuGet
dotnet add package Aspose.Words-Cloud
-
Επαναφορά πακέτων και κατασκευή - Το SDK λειτουργεί με .NET 6.0 και νεότερα. Βεβαιωθείτε ότι το έργο σας στοχεύει σε συμβατό πλαίσιο.
-
Διαμόρφωση διαπιστευτηρίων - Αντικαταστήστε τις τιμές κράτησης θέσης στον κώδικα παραδείγματος με το
ClientIdκαι τοClientSecretπου λαμβάνετε από τον πίνακα ελέγχου Aspose Cloud. -
Λήψη του SDK - Μπορείτε επίσης να κατεβάσετε τα πιο πρόσφατα δυαδικά αρχεία από την επίσημη σελίδα κυκλοφορίας: Aspose.Words Cloud SDK for .NET Λήψη.
-
Άδεια για παραγωγή - Για μακροπρόθεσμη χρήση, αποκτήστε μια προσωρινή ή μόνιμη άδεια από τη σελίδα προσωρινής άδειας.
Συχνές Ερωτήσεις
-
Πώς μπορώ να συγκρίνω και να συγχωνεύσω αρχεία ODT προγραμματιστικά σε .NET χρησιμοποιώντας το Aspose.Words Cloud SDK;
Χρησιμοποιήστε τις λειτουργίεςCompareDocumentκαιAcceptAllRevisionsπου παρέχονται από το Aspose.Words Cloud SDK for .NET. Ανεβάστε και τα δύο αρχεία ODT, εκτελέστε το αίτημα σύγκρισης, και, στη συνέχεια, αποδεχτείτε τις αλλαγές για να λάβετε το συγχωνευμένο αποτέλεσμα. -
Ποια μέθοδος ελέγχου ταυτότητας απαιτείται για τις κλήσεις REST API;
Χρειάζεστε ένα client ID και client secret για να αποκτήσετε ένα token πρόσβασης OAuth 2.0. Συμπεριλάβετε το token στην κεφαλίδαAuthorizationκάθε αίτησης cURL. -
Υπάρχει τρόπος να δοκιμάσετε το SDK πριν από την αγορά;
Μπορείτε να ζητήσετε προσωρινή άδεια από τη σελίδα προσωρινής άδειας για να αξιολογήσετε τη βιβλιοθήκη κατά τη διάρκεια της ανάπτυξης. -
Πού μπορώ να βρω περισσότερα παραδείγματα και λεπτομερή αναφορά API;
Επισκεφθείτε την επίσημη τεκμηρίωση και την αναφορά API για ολοκληρωμένους οδηγούς και δείγματα κώδικα.