Bir ODT belgesinin birden fazla sürümünü senkronize tutmak, değişiklikleri tespit edip düzenlemeleri otomatik olarak birleştirmesi gereken geliştiriciler için hızla baş ağrısına dönüşebilir. Aspose.Words Cloud SDK for .NET .NET içinde ODT dosyalarını programlı olarak karşılaştırmayı ve birleştirmeyi basit ve güvenilir hâle getirir. Bu kılavuz, iki ODT dosyasını Aspose Cloud depolamasına yüklemenizi, bir fark belgesi (diff) oluşturmanızı, tüm revizyonları kabul ederek birleştirilmiş bir dosya üretmenizi ve sonucu almanızı adım adım gösterir. Ayrıca cURL kullanarak eşdeğer REST çağrılarını görecek ve SDK’yı .NET projenizde nasıl yapılandıracağınızı öğreneceksiniz.
.NET’te ODT Dosyalarını Programlı Olarak Karşılaştırma ve Birleştirme İçin Tam Çalışan Örnek
Bu örnek, iki ODT dosyasını karşılaştırmayı, bir revizyon belgesi oluşturmayı, tüm revizyonları kabul etmeyi ve son birleştirilmiş ODT’yi indirmeyi gösterir.
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);
}
}
}
Not: Bu kod örneği temel işlevselliği göstermektedir. Projenizde kullanmadan önce, dosya yollarını ve yapılandırma değerlerini gerçek ortamınıza uygun şekilde güncellediğinizden, tüm gerekli bağımlılıkların doğru şekilde yüklendiğinden emin olun ve geliştirme ortamınızda kapsamlı bir şekilde test edin. Herhangi bir sorunla karşılaşırsanız, lütfen resmi dokümantasyona bakın veya destek ekibi ile iletişime geçin.
cURL ve REST API ile ODT Dosyası DIFF ve Birleştirme
Aşağıda, Aspose.Words Cloud REST API’ye karşı aynı diff ve birleştirme iş akışını gerçekleştiren eşdeğer cURL komutları bulunmaktadır.
- Erişim belirteci alın
YOUR_CLIENT_IDveYOUR_CLIENT_SECRETdeğerlerini kimlik bilgilerinizle değiştirin.
curl -X POST "https://api.aspose.cloud/connect/token" \
-d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"
- Orijinal ODT dosyasını yükleyin
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"
- Düzenlenmiş ODT dosyasını yükleyin
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"
- Karşılaştırma (diff) işlemini çalıştırın
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" }
}'
- Birleştirilmiş ODT’yi oluşturmak için tüm revizyonları kabul edin
curl -X POST "https://api.aspose.cloud/v4.0/words/Documents/original.odt/acceptAllRevisions" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
- Birleştirilmiş ODT belgesini indirin
curl -X GET "https://api.aspose.cloud/v4.0/words/storage/file/Documents/original.odt" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-o merged.odt
İstek gövdeleri ve ek seçenekler hakkında daha fazla ayrıntı için, resmi API belgeleri adresine bakın.
.NET’te ODT Dosyalarını Programlı Olarak Karşılaştırma ve Birleştirme Nasıl Çalışır
Kod, yukarıda açıklanan REST iş akışını yansıtan net bir sıralamayı izler.
- API istemcisini başlat -
new WordsApi(config)kimlik doğrulamalı bir istemci oluşturur veConfigurationnesnesi,ClientIdveClientSecretdeğerlerinizi tutar.
var config = new Configuration { ClientId = clientId, ClientSecret = clientSecret };
var wordsApi = new WordsApi(config);
-
Kaynak dosyaları yükle - Yardımcı yöntem
UploadFileher yerel ODT dosyasını bulut depolama klasörüne göndermek içinUploadFileRequestkullanır.var uploadRequest = new UploadFileRequest(remotePath, stream); api.UploadFile(uploadRequest); -
CompareDatanesnesi oluşturun - Bu nesne yazar, karşılaştırma seçenekleri ve revize dosyaya bir referans tanımlar.CompareDocumentRequest‘e geçirilir.var compareData = new CompareData { Author = "Comparer", CompareOptions = new CompareOptions { … }, FileReference = new FileReference($"{storageFolder}/{revisedFile}") }; -
Karşılaştırma işlemini yürüt -
wordsApi.CompareDocument(compareRequest)isteği hizmete gönderir, bu da orijinal belgeye revizyon işaretleri ekler.
var compareRequest = new CompareDocumentRequest(originalFile, compareData, storageFolder);
wordsApi.CompareDocument(compareRequest);
- Tüm revizyonları kabul et -
AcceptAllRevisionsRequesthizmete değişiklikleri birleştirmesini söyler ve temiz bir ODT dosyası üretir.
var acceptRequest = new AcceptAllRevisionsRequest(originalFile, storageFolder);
wordsApi.AcceptAllRevisions(acceptRequest);
Her adım, cURL komutlarına doğrudan karşılık gelir ve .NET kütüphanesi ile ham HTTP çağrıları arasında seçim yapma esnekliği sağlar.
Aspose.Words Cloud SDK for .NET’i Kurma ve Yapılandırma
- NuGet paketini ekleyin
dotnet add package Aspose.Words-Cloud
-
Paketleri geri yükleyin ve derleyin - SDK, .NET 6.0 ve sonraki sürümlerle çalışır. Projenizin uyumlu bir çerçeveye hedeflendiğinden emin olun.
-
Kimlik bilgilerini yapılandırın - Örnek koddaki yer tutucu değerleri, Aspose Cloud kontrol panelinizden aldığınız
ClientIdveClientSecretile değiştirin. -
SDK’yı İndirin - Resmi sürüm sayfasından en son ikili dosyaları da indirebilirsiniz: Aspose.Words Cloud SDK for .NET Download.
-
Üretim için lisans - Uzun vadeli kullanım için, geçici veya kalıcı bir lisansı geçici lisans sayfasından edinin.
Sık Sorulan Sorular
-
Aspose.Words Cloud SDK kullanarak .NET’te ODT dosyalarını programlı olarak nasıl karşılaştırabilir ve birleştirebilirim?
Aspose.Words Cloud SDK for .NET tarafından sağlananCompareDocumentveAcceptAllRevisionsişlemlerini kullanın. Her iki ODT dosyasını da yükleyin, karşılaştırma isteğini çalıştırın ve ardından birleştirilmiş sonucu elde etmek için revizyonları kabul edin. -
REST API çağrıları için hangi kimlik doğrulama yöntemi gereklidir?
OAuth 2.0 erişim belirteci almak için bir istemci kimliği ve istemci gizli anahtarına ihtiyacınız var. Belirteci her cURL isteğininAuthorizationbaşlığına ekleyin. -
SDK’yı satın almadan denemenin bir yolu var mı?
Kütüphaneyi geliştirme sırasında değerlendirmek için geçici lisans sayfası üzerinden geçici bir lisans talep edebilirsiniz. -
Daha fazla örnek ve ayrıntılı API referansı nerede bulunur?
Kapsamlı kılavuzlar ve kod örnekleri için resmi belgeleri ve API referansını ziyaret edin.