Több verzió egy ODT dokumentum szinkronban tartása gyorsan fejfájást okozhat a fejlesztőknek, akiknek változásokat kell észrevenniük és a szerkesztéseket automatikusan össze kell vonniuk. Aspose.Words Cloud SDK for .NET lehetővé teszi az ODT fájlok programozott összehasonlítását és egyesítését .NET környezetben egyszerűen és megbízhatóan. Ez az útmutató végigvezet a két ODT fájl feltöltésén az Aspose Cloud tárolóba, a diff dokumentum generálásán, az összes módosítás elfogadásán egy egyesített fájl létrehozásához, és az eredmény lekérésén. Emellett megtekintheti a megfelelő REST hívásokat cURL segítségével, és megtanulhatja, hogyan konfigurálja az SDK-t .NET projektjében.
Teljes működő példa ODT fájlok összehasonlítására és egyesítésére programozott módon .NET-ben
Ez a példa bemutatja, hogyan lehet két ODT fájlt összehasonlítani, egy revíziós dokumentumot generálni, az összes módosítást elfogadni, és letölteni a végleges egyesített ODT‑t.
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);
}
}
}
Megjegyzés: Ez a kódrészlet a fő funkciót mutatja be. Mielőtt a projektjében használná, győződjön meg róla, hogy frissítette a fájl útvonalakat és konfigurációs értékeket a tényleges környezetnek megfelelően, ellenőrizze, hogy minden szükséges függőség megfelelően telepítve van, és alaposan tesztelje a fejlesztői környezetben. Ha problémákba ütközik, kérjük, tekintse meg a hivatalos dokumentációt vagy lépjen kapcsolatba a támogatási csapattal segítségért.
ODT fájl DIFF és egyesítés cURL-lel és a REST API-val
Az alábbiakban a megfelelő cURL parancsok találhatók, amelyek ugyanazt a diff és merge munkafolyamatot hajtják végre az Aspose.Words Cloud REST API-val.
- Szerezzen hozzáférési tokent
Cserélje leYOUR_CLIENT_IDésYOUR_CLIENT_SECRETa hitelesítő adataival.
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öltsd fel az eredeti ODT fájlt
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öltse fel a módosított ODT fájlt
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"
- Futtassa az összehasonlítás (diff) műveletet
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" }
}'
- Fogadja el az összes módosítást az egyesített ODT létrehozásához
curl -X POST "https://api.aspose.cloud/v4.0/words/Documents/original.odt/acceptAllRevisions" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
- Az egyesített ODT dokumentum letöltése
curl -X GET "https://api.aspose.cloud/v4.0/words/storage/file/Documents/original.odt" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-o merged.odt
A kérés törzseiről és további beállításokról további részletekért tekintse meg a hivatalos API dokumentációt.
Hogyan működik az ODT fájlok összehasonlítása és egyesítése programozott módon a .NET-ben
A kód egyértelmű sorrendet követ, amely tükrözi a fent leírt REST munkafolyamatot.
- Az API kliens inicializálása -
new WordsApi(config)egy hitelesített klienst hoz létre aConfigurationobjektum használatával, amely tartalmazza aClientIdés aClientSecretértékeit.
var config = new Configuration { ClientId = clientId, ClientSecret = clientSecret };
var wordsApi = new WordsApi(config);
-
Forrásfájlok feltöltése - A segítő metódus
UploadFileaUploadFileRequest-et használja, hogy minden helyi ODT fájlt a felhő tároló mappájába küldjön.var uploadRequest = new UploadFileRequest(remotePath, stream); api.UploadFile(uploadRequest); -
Hozzon létre egy
CompareDataobjektumot - Ez az objektum meghatározza a szerzőt, az összehasonlítási beállításokat, és egy hivatkozást a módosított fájlra. ACompareDocumentRequest‑nek adja át.
var compareData = new CompareData { Author = "Comparer", CompareOptions = new CompareOptions { … }, FileReference = new FileReference($"{storageFolder}/{revisedFile}") };
- Hajtsa végre az összehasonlítási műveletet -
wordsApi.CompareDocument(compareRequest)elküldi a kérést a szolgáltatásnak, amely revíziós jelöléseket ad az eredeti dokumentumhoz.
var compareRequest = new CompareDocumentRequest(originalFile, compareData, storageFolder);
wordsApi.CompareDocument(compareRequest);
- Minden módosítás elfogadása -
AcceptAllRevisionsRequestazt mondja a szolgáltatásnak, hogy egyesítse a változtatásokat, és tiszta ODT fájlt állítson elő.var acceptRequest = new AcceptAllRevisionsRequest(originalFile, storageFolder); wordsApi.AcceptAllRevisions(acceptRequest);
Minden lépés közvetlenül a cURL parancsoknak felel meg, lehetővé téve, hogy a .NET könyvtár és a nyers HTTP hívások között válasszon.
Telepítés és konfigurálás Aspose.Words Cloud SDK for .NET
- Adja hozzá a NuGet csomagot
dotnet add package Aspose.Words-Cloud
-
Csomagok visszaállítása és felépítés - Az SDK a .NET 6.0‑nal és újabb verziókkal működik. Győződjön meg róla, hogy a projektje kompatibilis keretrendszert céloz.
-
Hitelesítő adatok konfigurálása - Cserélje le a mintakódban lévő helyőrző értékeket a
ClientIdésClientSecretértékekkel, amelyeket az Aspose Cloud irányítópultjáról kap. -
SDK letöltése - A legújabb binárisok letöltéséhez is használhatja a hivatalos kiadási oldalt: Aspose.Words Cloud SDK for .NET Download.
-
Licenc a termeléshez - Hosszú távú használathoz szerezzen be egy ideiglenes vagy állandó licencet a temporary license page oldalról.
Gyakori kérdések
-
Hogyan hasonlíthatom össze és egyesíthetem programozottan az ODT fájlokat .NET környezetben az Aspose.Words Cloud SDK használatával?
Használja aCompareDocumentésAcceptAllRevisionsműveleteket, amelyeket az Aspose.Words Cloud SDK for .NET biztosít. Töltse fel mindkét ODT fájlt, futtassa a összehasonlítási kérést, majd fogadja el a módosításokat a egyesített eredmény eléréséhez. -
Milyen hitelesítési módszer szükséges a REST API hívásokhoz?
Szüksége van egy ügyfélazonosítóra és ügyféltitokra az OAuth 2.0 hozzáférési token megszerzéséhez. Tartalmazza a tokent azAuthorizationfejlécben minden cURL kérésnél. -
Van lehetőség a SDK kipróbálására a vásárlás előtt?
Kérhet ideiglenes licencet a ideiglenes licenc oldalról a könyvtár fejlesztés közbeni értékeléséhez. -
Hol találhatok további példákat és részletes API‑referenciát?
Látogassa meg a hivatalos dokumentációt és az API‑referenciát a részletes útmutatók és kódmintákért.