MS Word dosyalarını karşılaştırın

Microsoft Word, kullanıcıların Word belgelerini karşılaştırmasını ve yeni eklenen değişiklikleri tanımlamasını sağlayan “Karşılaştır” seçeneğini destekler. Bu özellik, Word belgelerinde yan yana bir Metin karşılaştırma işlemi gerçekleştirebildiğiniz için kullanışlıdır. Ancak, metin farkı denetleyicisinin programatik bir çözümü çok daha hızlı ve daha verimli olabilir ve toplu metin farkı işlemlerini kolayca gerçekleştirebilir. Bu makalede, farklılıkları bulabilmemiz için REST-API kullanarak bir Metin karşılaştırma işlemi gerçekleştireceğiz.

Metin Karşılaştırma API’si

Aspose.Words Cloud SDK for .NET, önde gelen MS Word biçimlerini (DOC, DOCX, DOCM vb.) diğer desteklenen biçimlere dönüştürmenize, düzenlemenize ve oluşturmanıza olanak tanır. Aynı zamanda, Word belgelerini karşılaştırma ve farkı vurgulama olanağı da sağlar. Şimdi SDK’yi kullanmak için lütfen paket yöneticisi konsolunda aşağıdaki komutu kullanarak NuGet kütüphanesinden yükleyin:

Install-Package Aspose.Words-Cloud

Daha fazla bilgi için, Aspose.Cloud SDK’ları nasıl kurulur hakkında daha fazla bilgi için aşağıdaki bağlantıyı ziyaret etmeyi düşünebilirsiniz. Şimdi kurulumdan sonra, Aspose.Cloud panosunu ziyaret ederek ücretsiz bir hesap oluşturmamız da gerekiyor. GitHub veya Google hesabınızla kaydolun veya Yeni Hesap Oluştur düğmesine tıklayın. Sayfada görüntülenen İstemci Kimlik Bilgileri sonraki bölümlerde kullanılacaktır.

C# kullanarak çevrimiçi Metin Karşılaştır

Aşağıda, C# .NET kod parçacığı kullanılarak iki Word belgesinin nasıl karşılaştırılacağına ilişkin ayrıntıları açıklayan adımlar ve kod parçacığı verilmiştir.

  • Öncelikle ClientID ve ClientSecret bilgilerini kod içerisinde tanımlamamız gerekiyor.
  • İkinci olarak, ClientID ve ClientSecret ayrıntılarını argüman olarak sağlayarak Configuration sınıfının bir nesnesini oluşturun.
  • Üçüncüsü, WordsApi sınıfından bir nesne oluşturun ve Configuration örneğini bir argüman olarak geçirin.
  • Şimdi CompareData sınıfının bir örneğini oluşturalım.
  • Sonuç dosyasında tanımlanan kişinin adını özel olarak belirlemek için CompareData sınıfının Author özelliğini kullanın.
  • CompareData sınıfının ComparingWithDocument özelliği, içeriğin karşılaştırılacağı hedef belgeyi belirtmek için kullanılır.
  • Şimdi, girdi/kaynak dosyasını, CompareData nesnesini ve sonuç dosya adını argüman olarak alan CompareDocumentRequest sınıfının bir örneğini oluşturun.
  • Son olarak, karşılaştırma işlemini başlatmak için CompareDocument(..) metodunu çağırın.
String MyClientID = "c235e685-1aab-4cda-a95b-54afd63eb87f"; // Get Client Id from https://dashboard.aspose.cloud/
String MyClientSecret = "b8da4ee37494f2ef8da3c727f3a0acb9"; // Get Client Secret from https://dashboard.aspose.cloud/

// Yapılandırma sınıfının bir örneğini oluşturun 
// ve kişiselleştirilmiş Müşteri Kimliğinizi ve Müşteri Gizli Bilgilerinizi sağlayın
var config = new Configuration { ClientId = MyClientID, ClientSecret = MyClientSecret };
// WordsAPI nesnesini Yapılandırma örneğini kullanarak başlatın
var wordsApi = new WordsApi(config);
// ilk giriş belgesi
string firstDocument = "file-sample.docx";
// Karşılaştırılacak ikinci belge
string secondFile = "file-sample-updated.docx";
// sonuç dosyasının adı
string resultantFile = "Out_ComparedTestDocs.docx";

// CompareData sınıfının bir örneğini oluşturun
CompareData compareData = new CompareData();
// farklılıkları tanımlayan yazar olarak kullanılacak isim
compareData.Author = "Nayyer";
// karşılaştırılacak belgeyi belirtin
compareData.ComparingWithDocument = secondFile;
compareData.DateTime = DateTime.Now;
// Kaynak, karşılaştırılacak belge ve sonuç dosya adını sağlayarak İstek örneği oluşturun
CompareDocumentRequest request = new CompareDocumentRequest(firstDocument, compareData, null, null, null, null, resultantFile);
// belge karşılaştırmasını başlat
DocumentResponse result = wordsApi.CompareDocument(request);

Yukarıdaki örneklerde kullanılan örnek dosyalar aşağıdaki bağlantılardan indirilebilir.

cURL Komutlarını Kullanarak Word Belgelerini Karşılaştırın

Bu bölümde, cURL komutlarını kullanarak Word belgelerinin nasıl karşılaştırılacağına dair adımları öğreneceğiz. API’lerimize yalnızca yetkili personel erişebildiğinden, lütfen İstemci Kimliği ve İstemci Gizli Ayrıntıları temelinde bir JWT erişim belirteci oluşturmak için aşağıdaki komutu yürütün.

 curl -v "https://api.aspose.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=c235e685-1aab-4cda-a95b-54afd63eb87f&client_secret=b8da4ee37494f2ef8da3c727f3a0acb9" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accept: application/json"

Aşağıda verilen cURL komutu, cURL komutunu kullanarak çevrimiçi dosya karşılaştırmasının nasıl gerçekleştirileceğini gösterir. CompareDocument yöntemine erişir ve bu işlemin sonucu, düzenleme ve biçim revizyonlarının sayısı olarak izleme değişikliklerini içeren çıktı belgesine yazılır. Lütfen çıktı belgesi ayrıntılarını sağlamazsanız revizyonların orijinal belgeye kaydedileceğini unutmayın.

curl -X PUT "https://api.aspose.cloud/v4.0/words/file-sample.docx/compareDocument?destFileName=ComparisonResult.docx" \
-H  "accept: application/json" 
-H  "Authorization: Bearer <JWT Token>" \
-H  "Content-Type: application/json" \
-d "{\"ComparingWithDocument\":\"file-sample-updated.docx\",\"Author\":\"Nayyer\",\"DateTime\":\"2021-04-27T16:50:55.869Z\",\"CompareOptions\":{\"IgnoreCaseChanges\":true,\"IgnoreTables\":true,\"IgnoreFields\":true,\"IgnoreFootnotes\":true,\"IgnoreComments\":true,\"IgnoreTextboxes\":true,\"IgnoreFormatting\":true,\"IgnoreHeadersAndFooters\":true,\"Target\":\"Current\"}}"

Komut çalıştırıldığında silinen bilgiler ayrı ayrı belirtilir ve yeni eklenen içerik sarı renkle vurgulanır.

Orijinal ve Değiştirilmiş belge önizlemesi

Resim 1:- Orijinal Belgenin ve Değiştirilmiş Belgenin Önizlemesi.

Metin Karşılaştırma Önizlemesi

Resim 2:- Metin Karşılaştırma Önizlemesi.

Çözüm

Bu makalede, Aspose.Words Cloud API’sini kullanarak word belgelerini karşılaştırma adımlarını açıkladık. Lütfen API’lere swagger arayüzü üzerinden de erişilebileceğini unutmayın. Ayrıca, Cloud SDK’larımız açık kaynaklıdır ve tam kaynak kodları GitHub adresinden indirilebilir.

Ayrıca API tarafından sunulan diğer heyecan verici özellikler hakkında daha fazla bilgi için Ürün Belgeleri’ni ziyaret etmenizi öneririz. Geri bildiriminiz bizim için çok önemlidir. Bu nedenle lütfen Destek Forumlarımızı kullanarak bizimle iletişime geçmekten çekinmeyin.

Ayrıca bakınız

Aşağıdaki bağlantıları ziyaret ederek şu konularda bilgi edinebilirsiniz: