保持多個版本的 ODT 文件同步,對於需要自行發現變更並自動合併編輯的開發人員來說,可能很快就會變成頭痛的問題。Aspose.Words Cloud SDK for .NET 讓在 .NET 中以程式方式比較和合併 ODT 檔案變得簡單且可靠。本指南將帶領您將兩個 ODT 檔案上傳至 Aspose Cloud storage,產生差異文件,接受所有修訂以產生合併檔案,並取得結果。您還將看到使用 cURL 的等效 REST 呼叫,並學習如何在您的 .NET 專案中設定 SDK。
完整的工作範例:在 .NET 中以程式方式比較與合併 ODT 檔案
此範例示範如何比較兩個 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);
}
}
}
注意: 此程式碼範例示範了核心功能。在將其用於您的專案之前,請確保更新任何檔案路徑和設定值以符合實際環境,驗證所有必要的相依項目已正確安裝,並在開發環境中徹底測試。若您遇到任何問題,請參閱官方文件或聯繫支援團隊以獲得協助。
使用 cURL 和 REST API 執行 ODT 檔案差異比較與合併
以下是等效的 cURL 命令,可對 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 文件。
在 .NET 中以程式方式比較與合併 ODT 檔案的運作方式
程式碼遵循一個清晰的順序,映射上述描述的 REST 工作流程。
-
初始化 API 客戶端 -
new WordsApi(config)使用包含您的ClientId和ClientSecret的Configuration物件建立已驗證的客戶端。var config = new Configuration { ClientId = clientId, ClientSecret = clientSecret }; var wordsApi = new WordsApi(config); -
上傳來源檔案 - 輔助方法
UploadFile使用UploadFileRequest將每個本機 ODT 檔案傳送至雲端儲存資料夾。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 及更高版本上運作。請確保您的專案目標為相容的框架。
-
Configure credentials - 將範例程式碼中的佔位符值替換為您從 Aspose Cloud 儀表板取得的
ClientId和ClientSecret。 -
下載 SDK - 您也可以從官方發行頁面下載最新的二進位檔案: Aspose.Words Cloud SDK for .NET 下載.
-
生產授權 - 若要長期使用,請從temporary license page取得臨時或永久授權。
常見問題
-
如何在 .NET 中使用 Aspose.Words Cloud SDK 以程式方式比較和合併 ODT 檔案?
使用由 Aspose.Words Cloud SDK for .NET 提供的CompareDocument和AcceptAllRevisions操作。上傳兩個 ODT 檔案,執行比較請求,然後接受修訂以獲得合併結果。 -
需要什麼驗證方法才能呼叫 REST API?
您需要客戶端 ID 和客戶端密鑰來取得 OAuth 2.0 存取權杖。將該權杖包含在每個 cURL 請求的Authorization標頭中。 -
是否有辦法在購買前先試用 SDK?
您可以從臨時授權頁面請求臨時授權,以在開發期間評估該庫。