كيفية إخفاء المستندات في .NET باستخدام GroupDocs Redaction

في هذا الدرس الشامل ستكتشف كيفية إخفاء المستندات في بيئة .NET وتتمكن في الوقت نفسه من إدارة سمات المستندات باستخدام GroupDocs.Redaction وGroupDocs.Search. سواء كنت بحاجة إلى حماية البيانات الحساسة، أو زيادة سرعة البحث، أو تنظيم مكتبات مستندات كبيرة، فإن التقنيات المعروضة هنا توفر لك حلاً جاهزًا للإنتاج يمكنه التوسع إلى مئات الآلاف من الملفات.

إجابات سريعة

• كيف يمكنني إخفاء PDF في .NET؟ قم بتحميل الملف باستخدام Redactor، عرّف RedactionRegion، واستدعِ Redactor.Apply() – ثلاثة أسطر من الشيفرة تتولى العملية الثقيلة.
• هل يمكنني تغيير سمات المستند بعد الفهرسة؟ نعم، استخدم AttributeChangeBatch لإضافة أو تحديث أو إزالة السمات دفعة واحدة.
• ما المكتبات المطلوبة؟ GroupDocs.Redaction + GroupDocs.Search (أحدث إصدارات NuGet).
• هل أحتاج إلى ترخيص للإنتاج؟ يلزم وجود ترخيص GroupDocs صالح؛ يتوفر ترخيص تجريبي مؤقت للتقييم.
• كيف يمكنني تحسين سرعة البحث؟ فعّل المعالجة الدفعية والفهرسة الانتقائية؛ هذه التقنيات يمكن أن تحسن أداء البحث بنسبة تصل إلى 40 % على مجموعات بيانات كبيرة.

ما هو “كيفية إخفاء المستندات”؟

إنه يصف العملية الآلية لتحديد المعلومات الحساسة داخل ملف واستبدالها بمحتوى مخفي—مثل أشرطة سوداء أو مساحة بيضاء—مع الحفاظ على تخطيط المستند الأصلي. يضمن ذلك إخفاء البيانات السرية عن المشاهدين بينما يظل المستند قابلًا للقراءة والوظيفة للمهام اللاحقة.

لماذا نستخدم GroupDocs.Redaction وGroupDocs.Search معًا؟

يدعم GroupDocs.Redaction أكثر من 50 تنسيق ملف (PDF، DOCX، XLSX، PPTX، صور، إلخ) ويمكنه معالجة المستندات حتى 2 GB دون تحميل الملف بالكامل في الذاكرة. يقوم GroupDocs.Search بفهرسة أكثر من 70 مليون مصطلح في الساعة على خادم قياسي، مما يتيح لك تحسين أداء البحث بشكل كبير عند دمجه مع الترشيح القائم على السمات.

المتطلبات المسبقة

• المكتبات المطلوبة: GroupDocs.Search وGroupDocs.Redaction (أحدث إصدارات NuGet).
• بيئة التطوير: Visual Studio 2019 أو أحدث، مستهدفًا .NET Core 3.1 أو .NET 6+.
• المعرفة الأساسية: صsyntax C#، مفاهيم البرمجة الكائنية، وإلمام بمبادئ فهرسة المستندات.

إعداد GroupDocs.Redaction لـ .NET

تثبيت المكتبة

يمكنك إضافة GroupDocs.Redaction إلى مشروعك باستخدام أي من الطرق التالية:

.NET CLI

```bash
dotnet add package GroupDocs.Redaction

Package Manager

```powershell
Install-Package GroupDocs.Redaction

NuGet Package Manager UI

• ابحث عن “GroupDocs.Redaction” وقم بتثبيت أحدث نسخة.

خطوات الحصول على الترخيص

لبدء الاستخدام، يمكنك الحصول على ترخيص مؤقت أو شراء واحد. تتوفر نسخة تجريبية مجانية لاختبار الميزات قبل الالتزام:

1. زر صفحة ترخيص GroupDocs لطلب ترخيص مؤقت.
2. اتبع التعليمات المقدمة لتطبيق الترخيص في تطبيقك.

التهيئة الأساسية والإعداد

Redactor هو الفئة الرئيسية المستخدمة لتحميل مستند وتطبيق عمليات الإخفاء.

using GroupDocs.Redaction;

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

الميزة 1: تغيير سمات المستند

نظرة عامة

تعديل سمات المستند يتيح لك ضبط كيفية ظهور المستندات في نتائج البحث بدقة، مما يمكّن من الترشيح والتصنيف الدقيق.

الخطوة 1: تهيئة الفهرس

Index يمثل مجموعة قابلة للبحث من المستندات والبيانات الوصفية المرتبطة بها.

using GroupDocs.Search.Common;
using GroupDocs.Search.Options;
using GroupDocs.Search.Results;

Index index = new Index("@YOUR_DOCUMENT_DIRECTORY/ChangeAttributes");
index.Add("@YOUR_DOCUMENT_DIRECTORY/DocumentsPath");

الخطوة 2: تعديل السمات

AttributeChangeBatch هي الفئة التي تجمع تحديثات السمات لزيادة الكفاءة.

تعريف: AttributeChangeBatch تجمع عمليات الإضافة، التحديث، والحذف على سمات المستند في معاملة واحدة.

DocumentInfo[] documents = index.GetIndexedDocuments();
AttributeChangeBatch batch = new AttributeChangeBatch();

// Adding "public" to all documents
batch.AddToAll("public");

// Removing "public" from the first document
batch.Remove(documents[0].FilePath, "public");

// Adding "main" and "key" to the first document
batch.Add(documents[0].FilePath, "main", "key");
index.ChangeAttributes(batch);

الخطوة 3: البحث باستخدام مرشحات السمات

يمكنك ترشيح نتائج البحث بناءً على قيم السمات باستخدام SearchOptions.

الإجابة المباشرة: للبحث عن المستندات التي تحتوي على السمة Category = "Legal"، قم بتكوين SearchOptions مع AttributeFilter واستدعِ searcher.Search("contract", options). سيعيد ذلك فقط العقود الموسومة قانونيًا، مما يقلل الضوضاء في النتائج ويحسن أداء البحث.

SearchOptions options = new SearchOptions();
options.SearchDocumentFilter = SearchDocumentFilter.CreateAttribute("main");

// Perform search
string query = "length";
SearchResult result = index.Search(query, options);

الميزة 2: إضافة سمات أثناء الفهرسة

نظرة عامة

إضافة السمات في لحظة الفهرسة يضمن أن كل مستند يُثري بالبيانات الوصفية الصحيحة من البداية، مما يلغي الحاجة إلى تحديثات دفعية لاحقة.

الخطوة 1: إعداد معالج الحدث للفهرسة

تعريف: حدث DocumentIndexed يُطلق في كل مرة يتم فيها إضافة مستند بنجاح إلى الفهرس، مما يسمح بتنفيذ منطق مخصص.

Index index = new Index("@YOUR_DOCUMENT_DIRECTORY/AddAttributesDuringIndexing");

index.Events.FileIndexing += (sender, args) => {
    if (args.DocumentFullPath.EndsWith("Lorem ipsum.pdf")) {
        // Specify attributes for this document
        args.Attributes = new string[] { "main", "key" };
    }
};

// Add documents to index
index.Add("@YOUR_DOCUMENT_DIRECTORY/DocumentsPath");

الخطوة 2: تكوين وإجراء البحث

بعد إرفاق السمات، يمكنك البحث باستخدام تلك الحقول الجديدة.

الإجابة المباشرة: استخدم SearchOptions مع AttributeFilter لاستعلام السمات المضافة حديثًا، على سبيل المثال AttributeFilter("Department", "Finance"). سيعيد ذلك فقط الملفات المتعلقة بالمالية، موضحًا كيفية فهرسة السمات للحصول على نتائج أسرع وأكثر صلة.

SearchOptions options2 = new SearchOptions();
options2.SearchDocumentFilter = SearchDocumentFilter.CreateAttribute("main");

// Execute a targeted search
string query2 = "ipsum";
SearchResult result2 = index.Search(query2, options2);

تطبيقات عملية

فيما يلي ثلاثة سيناريوهات شائعة حيث يضيف إدارة سمات المستند والإخفاء معًا قيمة تجارية ملموسة:

1. إدارة المستندات القانونية – إخفاء الفقرات السرية تلقائيًا ووضع علامات على العقود حسب الاختصاص القضائي، مما يمكّن المحامين من العثور فقط على الملفات ذات الصلة.
2. تنظيم السجلات الطبية – إخفاء معرفات المرضى مع إضافة سمات مثل PatientID وVisitDate لاسترجاع متوافق وسريع.
3. فهرسة منتجات التجارة الإلكترونية – إخفاء معلومات أسعار الموردين ووضع علامات على المنتجات بـ StockStatus أو DiscountRate أثناء الاستيراد الدفعي، مما يسمح باستعلامات المخزون في الوقت الحقيقي.

اعتبارات الأداء

عند التعامل مع مجموعات بيانات كبيرة، احرص على اتباع أفضل الممارسات التالية:

• المعالجة الدفعية: AttributeChangeBatch يقلل من عدد الزيارات إلى الفهرس، مما يقلل وقت المعالجة بنسبة تصل إلى 45 % على دفعات من 100 k مستند.
• الفهرسة الانتقائية: فهرس فقط المستندات التي تحتاج إلى سمات جديدة؛ تخطى الملفات غير المتغيرة لتوفير وحدة المعالجة المركزية وإدخال/إخراج.
• إدارة الذاكرة: حرّر كائنات SearchResult وRedactor وIndexer بمجرد الانتهاء منها لتحرير الموارد غير المُدارة.

المشكلات الشائعة والحلول

الأسئلة المتكررة

س: ما هي أفضل طريقة لإخفاء عدة ملفات PDF دفعيًا؟
ج: قم بتحميل كل ملف باستخدام Redactor، أضف RedactionRegion لكل منطقة حساسة، ثم استدعِ Redactor.Apply() داخل حلقة؛ هذا النهج يعالج آلاف الملفات بأقل استهلاك للذاكرة.

س: هل يمكنني دمج الإخفاء مع ترشيح السمات في استعلام واحد؟
ج: نعم. بعد الإخفاء، يحتفظ المستند ببياناته الوصفية، لذا يمكنك البحث باستخدام كل من مصطلحات النص وAttributeFilter في آن واحد.

س: كيف أتعامل مع المستندات المحمية بكلمة مرور؟
ج: مرّر كلمة المرور إلى مُنشئ Redactor؛ ستقوم المكتبة بفك التشفير، الإخفاء، وإعادة تشفير الملف تلقائيًا.

س: هل يدعم GroupDocs تقنية OCR للصور الممسوحة قبل الإخفاء؟
ج: بالتأكيد. فعّل RedactorOptions.Ocr = true للتعرف على النص في الصور، ثم طبّق قواعد الإخفاء على النص المستخرج.

س: أي إصدارات .NET مدعومة رسميًا؟
ج: تدعم GroupDocs.Redaction وGroupDocs.Search .NET Core 3.1، .NET 5، .NET 6، و.NET 7، بالإضافة إلى .NET Framework 4.6.2+.

الخلاصة

أصبح لديك الآن حل شامل لـ كيفية إخفاء المستندات مع تحسين أداء البحث وكيفية فهرسة السمات باستخدام GroupDocs.Redaction وGroupDocs.Search. باتباع الخطوات أعلاه، يمكنك حماية البيانات الحساسة، إغناء فهرس البحث ببيانات وصفية ذات معنى، والحفاظ على تطبيقات .NET سريعة وآمنة.

آخر تحديث: 2026-06-22
تم الاختبار مع: GroupDocs.Redaction 2.5.0 + GroupDocs.Search 2.5.0 for .NET
المؤلف: GroupDocs

دروس ذات صلة

• إتقان GroupDocs.Redaction .NET: إنشاء فهرس فعال وإدارة الأسماء المستعارة للبحث المتقدم في المستندات
• إتقان إخفاء المستندات وفهرسة البيانات الوصفية باستخدام GroupDocs.Redaction .NET
• إتقان GroupDocs.Redaction .NET: الإعداد ومعالجة الأحداث لإدارة مستندات آمنة