GroupDocs.Search & GroupDocs.Redaction ile .NET’te Belgeleri Ara ve Kırp

Modern işletme ortamlarında, search and redact yetenekleri, hassas bilgileri korurken belgelerin kolayca bulunabilir olmasını sağlamak için gereklidir. Bu öğretici, hızlı tam‑metin arama için GroupDocs.Search’i ve gizli verileri güvenli bir şekilde kaldırmak için GroupDocs.Redaction’ı birleştiren sağlam bir .NET çözümü oluşturmanızı adım adım gösterir. Sonunda, kütüphaneleri nasıl kuracağınızı, özel bir metin segmentleyici oluşturacağınızı, yüksek performanslı aramalar yapacağınızı ve kırpmaları güvenli bir şekilde uygulayacağınızı öğreneceksiniz.

Hızlı Yanıtlar

  • “search and redact” ne anlama geliyor? Bu, belgelerdeki metni bulmak ve kalıcı olarak maskelemektir.
  • Hangi kütüphaneler gereklidir? GroupDocs.Search ve .NET için GroupDocs.Redaction.
  • Çok dilli içeriği yönetebilir miyim? Evet—kelimeleri doğru bölmek için özel bir metin segmentleyici kullanın.
  • Arama hızını nasıl artırabilirim? İndeksi bir kez oluşturun, indeksi yeniden kullanın ve optimize search performance ayarını etkinleştirin.
  • İndeksleme başarısız olursa ne olur? Sorun giderme bölümündeki “handle indexing errors” yönergelerini izleyin.

“search and redact” nedir?

“search and redact”, belgeler koleksiyonunda belirli terimleri bulma ve ardından bu terimleri kalıcı olarak gizleyerek veya kaldırarak gizliliği koruma veya düzenleyici uyumluluğu sağlama sürecidir. Hassas bilgileri bulmak için tam‑metin aramayı, içeriği belge düzenini koruyarak değiştiren kırpma araçlarıyla birleştirir.

GroupDocs.Search ve GroupDocs.Redaction’ı Birlikte Kullanmanın Nedenleri?

GroupDocs.Search, 50+ dosya formatını destekler ve tipik sunucu donanımında bir dakikadan kısa sürede 100.000+ belgeyi indeksleyebilir, GroupDocs.Redaction ise PDF, DOCX, PPTX ve daha fazlası üzerinde orijinal düzeni bozmadan kırpma uygulayabilir. Bunları birleştirmek, arama performansını optimize eden ve indeksleme hatalarını sorunsuz bir şekilde yöneten tek‑yığın bir çözüm sağlar.

Ön Koşullar

  • Visual Studio 2022 veya daha yeni bir sürüm, .NET 6+ desteğiyle.
  • NuGet paketleri: GroupDocs.Search ve GroupDocs.Redaction (en son kararlı sürümler).
  • Geçerli bir GroupDocs lisansı (deneme veya satın alınmış).

Gerekli Kütüphaneler

  • GroupDocs.Search – İndeksleme, sorgulama ve özel segmentasyon sağlar.
  • GroupDocs.Redaction – Desteklenen formatlarda metin, görüntü ve meta veri kırpması sunar.

Ortam Kurulum Gereksinimleri

Geliştirme makinenizin, indeksin saklanacağı klasöre yazma izni olduğundan emin olun.

Bilgi Ön Koşulları

  • C# ve .NET proje yapılarıyla aşinalık.
  • Belge işleme kavramlarına temel bir anlayış (isteğe bağlı ancak faydalı).

GroupDocs.Redaction’ı .NET için Nasıl Yüklerim?

Redaction paketini projenize .NET CLI veya NuGet Package Manager kullanarak ekleyebilirsiniz. Komut, en son kararlı sürümü indirir ve proje dosyanıza kaydeder, böylece API hemen kullanılabilir.

dotnet add package GroupDocs.Redaction

GroupDocs için Lisans Nasıl Alınır?

GroupDocs üç lisans seçeneği sunar: değerlendirme için ücretsiz deneme, genişletilmiş geliştirme testi için geçici lisans ve üretim kullanımı için tam ticari lisans. Deneme sınırlı işlevsellik sağlar, geçici anahtar değerlendirme süresini uzatır ve satın alınan lisans tüm özellikleri ve öncelikli desteği açar.

Uygulamamda GroupDocs.Redaction’ı Nasıl Başlatırım?

Redaction sınıfı, desteklenen belgelere kırpma uygulamak için birincil giriş noktasıdır. Bir dosyayı yükler, kırpma nesnelerini hazırlar ve kırpma sürecini yürütür, orijinal düzeni koruyarak değiştirilmiş bir belge döndürür. Renk, bindirme ve meta veri kaldırma gibi kırpma seçeneklerini belirli uyumluluk gereksinimlerine göre yapılandırabilirsiniz.

using GroupDocs.Redaction;

// Initialize Redactor with the document path
Redactor redactor = new Redactor("path/to/document.pdf");

GroupDocs.Search Kullanarak Bir İndeks Nasıl Oluşturulur?

Index sınıfı, diskte depolanan aranabilir bir depo temsil eder. İndeksin oluşturulması, güncellenmesi ve sorgulanmasını yönetir, belgeleri eklemenize, indeksi yeniden oluşturmanıza ve büyük koleksiyonlarda hızlı aramalar yapmanıza olanak tanır. İndeks klasörü yerel veya ağ depolamada bulunabilir ve sıkıştırma ve şifreleme ayarlarını yapılandırarak indekslenen verileri koruyabilirsiniz.

using GroupDocs.Search;

// Specify the index folder path
string indexFolder = @"YOUR_DOCUMENT_DIRECTORY/AdvancedUsage/Indexing/CustomTextSegmenter";

// Initialize the index
Index index = new Index(indexFolder);

Özel Bir Metin Segmentleyici Nedir ve Neden Kullanmalıyım?

Özel bir metin segmentleyici, ham metnin aranabilir token’lara nasıl bölündüğünü belirler. Belirli diller veya alanlar için segmentasyon kurallarını özelleştirerek tokenizasyon doğruluğunu artırırsınız, bu da arama sonuçlarında daha yüksek geri getirme ve alaka düzeyi sağlar. Bu, Japonca veya Arapça gibi karmaşık kelime sınırlarına sahip dillerde, varsayılan tokenlaştırıcıların kelimeleri yanlış bölmesi durumunda özellikle faydalıdır.

// Define a search query using Chinese language text
string query = "考虑"; // The word 'consider' in Chinese

Özel Segmentleyici ile Tam Metin Arama Nasıl Yapılır?

SearchQuery nesnesi, kullanıcının sorgusunu kapsar ve özel segmentleyiciyle eşleşmeleri bulur. Bulanık eşleşme, ifade sorguları ve ağırlıklandırma destekler, belge kimlikleri, eşleşme konumları ve alaka puanları içeren bir sonuç kümesi döndürür. Dosya türü veya tarih aralığı gibi filtreler uygulayarak daha kesin hedefleme için sonuçları daraltabilirsiniz.

// Execute the search on indexed data
SearchResult result = index.Search(query);

// Process results to analyze findings or display them
foreach (FoundDocument doc in result)
{
    Console.WriteLine($"Document: {doc.DocumentInfo.FilePath}");
}

Hassas Metni Bulduktan Sonra Kırpmalar Nasıl Uygulanır?

Redaction API’si, desteklenen belgelerde metin, görüntü ve meta verileri değiştirme veya kaldırma imkanı verir. Hassas terimleri belirledikten sonra kırpma nesneleri oluşturur, uygular ve kırpılmış dosyayı kaydeder, böylece gizli bilgi kalıcı olarak gizlenir. Kırpma seçenekleri arasında siyah kutular bindirme, özel renkler uygulama veya belge yapısını koruyarak tüm nesneleri kaldırma bulunur.

using (Redactor redactor = new Redactor("path/to/document.pdf"))
{
    // Define the redaction settings and criteria
    TextRedaction textRedaction = new TextRedaction("Sensitive Information", new ReplacementOptions("[REDACTED]"));
    
    // Apply the redaction to the document
    RedactorChangeLog log = redactor.Apply(textRedaction);

    if (log.Status != RedactionStatus.Failed)
    {
        redactor.Save();
    }
}

Yaygın Sorunlar ve İndeksleme Hataları Nasıl Ele Alınır

  • İndeks Bulunamadı: İndeks yolunun mevcut olduğunu ve uygulamanın okuma/yazma izinlerine sahip olduğunu doğrulayın.
  • Arama Sonuç Döndürmüyor: İndeksleme sürecini yeniden çalıştırın ve özel segmentleyicinin doğru şekilde kaydedildiğinden emin olun.
  • Kırpma Belirli Formatlarda Başarısız Oluyor: Dosya türünün desteklendiğini doğrulayın; PDF’ler için PDF 2.0 özelliklerini işlemek üzere en son Redaction sürümünü kullanın.

Pratik Uygulamalar

  1. Hukuki Belge Yönetimi: Sözleşmelerde “non‑disclosure” (gizlilik) terimini arayın ve dış paylaşım öncesinde maddeleri otomatik olarak kırpın.
  2. Akademik Araştırma: Manuskriptlerde yayımlanmamış verileri bulun ve hakem değerlendirme süreçleri için gizleyin.
  3. İş Sözleşmeleri: Binlerce anlaşmayı toplu işleyin, kişisel tanımlayıcıları kırpın ve yasal dili koruyun.

Büyük Belge Setleri için Arama Performansını Nasıl Optimize Edebilirim?

Performansı en üst düzeye çıkarmak için belgeleri bir kez indeksleyin ve aynı indeksi sonraki sorgular için yeniden kullanın. Paralel işleme izin verin, önbelleği yapılandırın ve çok çekirdekli sunucularda gecikmeyi azaltmak ve verimliliği artırmak için indeks ayarlarını ayarlayın. Ayrıca, EnableMemoryMapping bayrağını ayarlayarak indeksin bellek eşlemeli olmasını sağlayabilirsiniz; bu, büyük veri kümeleri için okuma işlemlerini hızlandırır.

.NET Belleğini Büyük Dosyalarla Çalışırken Nasıl Yönetirim?

Büyük belgelerle çalışırken etkili bellek yönetimi çok önemlidir. Index ve Redaction nesnelerini using ifadeleriyle sararak belirli bir sürede yok edilmelerini sağlayın ve dosyaları tüm belgeyi belleğe yüklemek yerine akış olarak işleyin. Performans sayaçlarını izlemek, bellek dalgalanmalarını erken tespit etmeye yardımcı olur; böylece toplu iş boyutlarını ayarlayabilir veya çöp toplama ayarlarını optimize edebilirsiniz.

Sıkça Sorulan Sorular

S: GroupDocs.Search’ı metin dışı meta verilerle kullanabilir miyim?
C: Evet—meta veri alanları belge içeriğiyle birlikte indekslenebilir, “author:JohnDoe” gibi aramalara izin verir.

S: GroupDocs.Redaction, bir web API’sinde gerçek zamanlı kırpma destekliyor mu?
C: Evet; küçük dosyalar için Redaction API’sini senkron olarak çağırabilir veya daha büyük işleri asenkron işleme kuyruğuna alabilirsiniz.

S: İndeks bozulursa ne yapmalıyım?
C: Bozuk indeks klasörünü silin ve aynı indeksleme rutinini kullanarak yeniden oluşturun; kütüphane, sorunun kaynağını belirlemenize yardımcı olmak için ayrıntılı hata mesajları kaydeder.

S: Kaydetmeden önce kırpılmış belgeleri önizlemek mümkün mü?
C: Kesinlikle—preview bayrağıyla redaction.Apply() çağırarak geçici bir sürüm oluşturup inceleyebilirsiniz.

S: Hangi .NET sürümleri resmi olarak destekleniyor?
C: GroupDocs.Search ve GroupDocs.Redaction, .NET 6, .NET 5, .NET Core 3.1 ve .NET Framework 4.6.2+ sürümlerini destekler.

Kaynaklar

Son Güncelleme: 2026-06-12
Test Edilen Versiyonlar: GroupDocs.Search 23.11, GroupDocs.Redaction 23.11 for .NET
Yazar: GroupDocs

Install-Package GroupDocs.Redaction

İlgili Öğreticiler