Việc giữ đồng bộ nhiều phiên bản của tài liệu ODT có thể nhanh chóng trở thành một cơn đau đầu cho các nhà phát triển cần phát hiện thay đổi và tự động kết hợp các chỉnh sửa. Aspose.Words Cloud SDK for .NET giúp việc so sánh và hợp nhất các tệp ODT một cách lập trình trong .NET trở nên đơn giản và đáng tin cậy. Hướng dẫn này sẽ đưa bạn qua quá trình tải lên hai tệp ODT lên lưu trữ Aspose Cloud, tạo tài liệu diff, chấp nhận tất cả các sửa đổi để tạo ra tệp hợp nhất, và lấy kết quả. Bạn cũng sẽ thấy các lời gọi REST tương đương bằng cURL, và học cách cấu hình SDK trong dự án .NET của mình.
Ví dụ Hoạt động đầy đủ về So sánh và Hợp nhất các tệp ODT bằng lập trình trong .NET
Ví dụ này minh họa cách so sánh hai tệp ODT, tạo tài liệu sửa đổi, chấp nhận tất cả các sửa đổi và tải xuống tệp ODT đã hợp nhất cuối cùng.
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);
}
}
}
Lưu ý: Ví dụ mã này minh họa chức năng cốt lõi. Trước khi sử dụng trong dự án của bạn, hãy chắc chắn cập nhật mọi đường dẫn tệp và giá trị cấu hình để phù hợp với môi trường thực tế của bạn, xác minh rằng tất cả các phụ thuộc cần thiết đã được cài đặt đúng cách, và kiểm tra kỹ lưỡng trong môi trường phát triển. Nếu bạn gặp bất kỳ vấn đề nào, vui lòng tham khảo tài liệu chính thức hoặc liên hệ với đội hỗ trợ để được trợ giúp.
Thực hiện ODT File DIFF và Hợp nhất với cURL và REST API
Dưới đây là các lệnh cURL tương đương thực hiện cùng quy trình diff và merge đối với Aspose.Words Cloud REST API.
- Nhận token truy cập
Thay thếYOUR_CLIENT_IDvàYOUR_CLIENT_SECRETbằng thông tin xác thực của bạn.
curl -X POST "https://api.aspose.cloud/connect/token" \
-d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"
- Tải lên tệp ODT gốc
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"
- Tải lên tệp ODT đã chỉnh sửa
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"
- Thực hiện thao tác so sánh (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" }
}'
- Chấp nhận tất cả các sửa đổi để tạo ODT đã hợp nhất
curl -X POST "https://api.aspose.cloud/v4.0/words/Documents/original.odt/acceptAllRevisions" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
- Tải xuống tài liệu ODT đã hợp nhất
curl -X GET "https://api.aspose.cloud/v4.0/words/storage/file/Documents/original.odt" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-o merged.odt
Để biết thêm chi tiết về nội dung yêu cầu và các tùy chọn bổ sung, xem tài liệu API chính thức.
Cách so sánh và hợp nhất các tệp ODT bằng lập trình trong .NET
Mã nguồn tuân theo một chuỗi rõ ràng phản ánh quy trình làm việc REST đã mô tả ở trên.
- Khởi tạo client API -
new WordsApi(config)tạo một client đã xác thực bằng cách sử dụng đối tượngConfigurationchứaClientIdvàClientSecretcủa bạn.
var config = new Configuration { ClientId = clientId, ClientSecret = clientSecret };
var wordsApi = new WordsApi(config);
-
Tải lên các tệp nguồn - Phương thức trợ giúp
UploadFilesử dụngUploadFileRequestđể gửi mỗi tệp ODT cục bộ lên thư mục lưu trữ đám mây.var uploadRequest = new UploadFileRequest(remotePath, stream); api.UploadFile(uploadRequest); -
Tạo một đối tượng
CompareData- Đối tượng này xác định tác giả, các tùy chọn so sánh và một tham chiếu tới tệp đã sửa đổi. Nó được truyền choCompareDocumentRequest.var compareData = new CompareData { Author = "Comparer", CompareOptions = new CompareOptions { … }, FileReference = new FileReference($"{storageFolder}/{revisedFile}") }; -
Thực hiện thao tác so sánh -
wordsApi.CompareDocument(compareRequest)gửi yêu cầu tới dịch vụ, dịch vụ sẽ thêm các dấu sửa đổi vào tài liệu gốc.var compareRequest = new CompareDocumentRequest(originalFile, compareData, storageFolder); wordsApi.CompareDocument(compareRequest); -
Chấp nhận tất cả các sửa đổi -
AcceptAllRevisionsRequestcho biết dịch vụ sẽ hợp nhất các thay đổi, tạo ra một tệp ODT sạch sẽ.var acceptRequest = new AcceptAllRevisionsRequest(originalFile, storageFolder); wordsApi.AcceptAllRevisions(acceptRequest);
Mỗi bước tương ứng trực tiếp với các lệnh cURL, cho phép bạn linh hoạt lựa chọn giữa thư viện .NET và các cuộc gọi HTTP thô.
Cài đặt và cấu hình Aspose.Words Cloud SDK for .NET
- Thêm gói NuGet
dotnet add package Aspose.Words-Cloud
-
Khôi phục gói và xây dựng - SDK hoạt động với .NET 6.0 trở lên. Đảm bảo dự án của bạn nhắm tới một framework tương thích.
-
Cấu hình thông tin xác thực - Thay thế các giá trị placeholder trong mã mẫu bằng
ClientIdvàClientSecretmà bạn lấy từ bảng điều khiển Aspose Cloud của mình. -
Tải xuống SDK - Bạn cũng có thể tải xuống các binary mới nhất từ trang phát hành chính thức: Aspose.Words Cloud SDK for .NET Tải xuống.
-
Giấy phép cho môi trường sản xuất - Đối với việc sử dụng lâu dài, hãy mua một giấy phép tạm thời hoặc vĩnh viễn từ trang giấy phép tạm thời.
Câu hỏi thường gặp
-
Làm thế nào tôi có thể so sánh và hợp nhất các tệp ODT một cách lập trình trong .NET bằng Aspose.Words Cloud SDK?
Sử dụng các thao tácCompareDocumentvàAcceptAllRevisionsđược cung cấp bởi Aspose.Words Cloud SDK for .NET. Tải lên cả hai tệp ODT, thực hiện yêu cầu so sánh, sau đó chấp nhận các sửa đổi để nhận kết quả hợp nhất. -
Phương pháp xác thực nào được yêu cầu cho các cuộc gọi REST API?
Bạn cần một client ID và client secret để lấy token truy cập OAuth 2.0. Bao gồm token trong tiêu đềAuthorizationcủa mỗi yêu cầu cURL. -
Có cách nào để thử SDK trước khi mua không?
Bạn có thể yêu cầu giấy phép tạm thời từ trang giấy phép tạm thời để đánh giá thư viện trong quá trình phát triển. -
Bạn có thể tìm thêm ví dụ và tài liệu tham chiếu API chi tiết ở đâu?
Truy cập tài liệu chính thức và tài liệu tham chiếu API để có hướng dẫn chi tiết và các mẫu mã.