Підтримка синхронізації кількох версій документа ODT може швидко стати головним болем для розробників, яким потрібно виявляти зміни та автоматично об’єднувати правки. Aspose.Words Cloud SDK for .NET робить порівняння та злиття ODT‑файлів програмно в .NET простим і надійним. У цьому посібнику ви крок за кроком завантажите два ODT‑файли в сховище Aspose Cloud, створите документ різниці, приймете всі правки для отримання злитого файлу та отримаєте результат. Ви також побачите еквівалентні 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‑файлу у папку хмарного сховища.var uploadRequest = new UploadFileRequest(remotePath, stream); api.UploadFile(uploadRequest); -
Create a
CompareDataobject - This object defines the author, comparison options, and a reference to the revised file. It is passed toCompareDocumentRequest.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 dashboard. -
Завантажити SDK - Ви також можете завантажити останні бінарні файли з офіційної сторінки релізу: Aspose.Words Cloud SDK for .NET Download.
-
Ліцензія для продакшн - Для довгострокового використання придбайте тимчасову або постійну ліцензію на сторінці сторінка тимчасової ліцензії.
Поширені питання
-
Як можна порівнювати та об’єднувати ODT‑файли програмно в .NET за допомогою Aspose.Words Cloud SDK?
Використовуйте операціїCompareDocumentіAcceptAllRevisions, які надає Aspose.Words Cloud SDK for .NET. Завантажте обидва ODT‑файли, виконайте запит порівняння, а потім прийміть правки, щоб отримати об’єднаний результат. -
Який метод автентифікації потрібен для викликів REST API?
Вам потрібен client ID та client secret для отримання OAuth 2.0 access token. Додайте токен у заголовокAuthorizationкожного запиту cURL. -
Чи є спосіб спробувати SDK перед покупкою?
Ви можете запросити тимчасову ліцензію на сторінці тимчасової ліцензії, щоб оцінити бібліотеку під час розробки. -
Де я можу знайти більше прикладів та докладну довідку API?
Відвідайте офіційну документацію та довідку API для всебічних посібників і прикладів коду.