تثبيت Documentize عبر NuGet

كيفية التثبيت عبر وحدة تحكم مدير الحزم NuGet

1. افتح مشروعك:

   • قم بتشغيل Visual Studio وافتح تطبيق .NET الخاص بك.

2. الوصول إلى وحدة تحكم مدير الحزم:

   • انتقل إلى الأدوات > مدير حزم NuGet > وحدة تحكم مدير الحزم.

3. تثبيت الحزمة:

   • لتثبيت أحدث إصدار كامل، أدخل الأمر Install-Package Documentize.
   • لتثبيت أحدث إصدار بما في ذلك الإصلاحات العاجلة، استخدم Install-Package Documentize -prerelease.
   • اضغط Enter لتنفيذ الأمر.

كيفية تحديث الحزمة عبر وحدة تحكم مدير الحزم NuGet

إذا كنت قد قمت بالفعل بتثبيت Documentize عبر NuGet وترغب في التحديث إلى أحدث إصدار:

1. افتح مشروعك:

   • قم بتشغيل Visual Studio وافتح تطبيق .NET الخاص بك.

2. الوصول إلى وحدة تحكم مدير الحزم:

   • انتقل إلى الأدوات > مدير حزم NuGet > وحدة تحكم مدير الحزم.

3. تحديث الحزمة:

   • للتحديث إلى أحدث إصدار كامل، أدخل Update-Package Documentize.
   • للتحديث إلى أحدث إصدار بما في ذلك الإصلاحات العاجلة، استخدم Update-Package Documentize -prerelease.
   • اضغط Enter لتنفيذ الأمر.

كيفية التثبيت عبر واجهة المستخدم الرسومية لمدير الحزم NuGet

1. افتح مشروعك:

   • قم بتشغيل Visual Studio وافتح تطبيق .NET الخاص بك.

2. انتقل إلى إدارة حزم NuGet:

   • من قائمة المشروع، اختر إدارة حزم NuGet.

3. بحث عن Documentize:

   • انتقل إلى علامة التبويب تصفح وادخل Documentize في مربع البحث.

4. تثبيت الحزمة:

   • انقر على تثبيت/تحديث بجانب أحدث إصدار من Documentize.
   • أكد بالضغط على قبول في نافذة منبثقة.

مزايا استخدام NuGet

• إدارة التبعيات تلقائيًا:

  • يدير NuGet التبعيات تلقائيًا، مما يضمن تضمين جميع المكتبات المطلوبة وتحديثها بشكل صحيح. وهذا يقلل من خطر فقدان أو عدم توافق التبعيات.

• تحديثات مبسطة:

  • عملية تحديث الحزم بسيطة مع NuGet، سواء من خلال وحدة تحكم مدير الحزم أو واجهة المستخدم الرسومية. يجعل هذا من السهل الحفاظ على مكتباتك محدثة مع أحدث الميزات وإصلاحات الأخطاء.

• متكامل مع Visual Studio:

  • يتم دمج NuGet بسلاسة مع Visual Studio، يوفر واجهة مستخدم سهلة لإدارة الحزم دون مغادرة بيئة التطوير.

• إدارة الإصدارات:

  • يتيح لك NuGet تحديد وإدارة إصدارات مختلفة من المكتبات، مما يمكنك من العودة بسهولة إلى الإصدارات السابقة أو اختبار الإصدارات الجديدة دون تعطيل تطويرك.

عيوب استخدام NuGet

• مقتصر على Visual Studio:

  • تم تصميم NuGet بشكل أساسي للاستخدام داخل Visual Studio. بالرغم من أنه يمكن استخدامه في بيئات أخرى، إلا أن التكامل هو الأكثر قوة في Visual Studio.

• احتمالية تعارض الإصدارات:

  • في المشاريع الأكبر ذات العديد من التبعيات، قد تصبح إدارة الإصدارات وحل النزاعات معقدة. يوفر NuGet أدوات لإدارة ذلك، ولكنه يتطلب اهتمامًا دقيقًا.

• اعتماد على الشبكة:

  • يتطلب تثبيت وتحديث الحزم اتصالاً بالإنترنت. إذا كنت تعمل في بيئة بها اتصال محدود أو لا يوجد اتصال بالإنترنت، قد تحتاج إلى استخدام طرق غير متصلة أو تحميل الحزم مسبقًا.

• تعقيد للمشاريع الكبيرة:

  • بالنسبة للمشاريع الكبيرة جدًا ذات أشجار التبعيات الواسعة، قد يصبح العبء الناتج عن إدارة الحزم عبر NuGet مرهقًا. في مثل هذه الحالات، قد تكون أدوات أو استراتيجيات إضافية مطلوبة لإدارة التبعيات بفعالية.

تثبيت Documentize عبر MSI

كيفية التثبيت عبر مثبت MSI

1. تحميل مثبت MSI:

   • انقر على v25.7 MSI لتحميل مثبت MSI لأحدث إصدار من Documentize.

2. تشغيل المثبت:

   • انقر نقرًا مزدوجًا على ملف MSI الذي تم تحميله لبدء معالج التثبيت.

3. اتباع معالج التثبيت:

   • اتبع التعليمات الظاهرة على الشاشة التي يقدمها المثبت. قد تحتاج إلى الموافقة على اتفاقية الترخيص واختيار خيارات التثبيت.

4. إكمال التثبيت:

   • بمجرد اكتمال التثبيت، سيتم تثبيت مكتبات Documentize الديناميكية (DLLs) في ذاكرة التخزين المؤقت العامة (GAC) للنظام أو في موقع محدد آخر.

5. التحقق من التثبيت:

   • تحقق من أن المكتبات الديناميكية قد تم تثبيتها بشكل صحيح من خلال التحقق من وجودها في دليل التثبيت المحدد أو في GAC.

مزايا استخدام مثبت MSI

• سهولة الاستخدام:

  • يوفر مثبت MSI عملية تثبيت بسيطة وموجهة. يتولى جميع التكوينات اللازمة ويضع المكتبات الديناميكية في موقع مركزي، مما يسهل استخدام Documentize عبر مشاريع متعددة.

• تثبيت على مستوى النظام:

  • تثبت طريقة MSI Documentize في ذاكرة التخزين المؤقت العامة (GAC) للنظام أو في موقع مركزي آخر. وهذا يسمح لأي تطبيق على النظام بالوصول إلى المكتبات الديناميكية دون الحاجة إلى الإشارة إليها بشكل فردي في كل مشروع.

• تحديثات مؤتمتة:

  • إذا قدمت Documentize مثبتًا محدثًا، يمكنك بسهولة تحديث تثبيتك عن طريق تشغيل ملف MSI الجديد، والذي يتولى عادةً عملية التحديث بسلاسة.

• اتساق:

  • يضمن استخدام مثبت MSI أن جميع الملفات المطلوبة تُثبت بشكل صحيح ومتسق عبر بيئات مختلفة، مما يقلل من خطر فقدان أو عدم مكان المكتبات الديناميكية.

عيوب استخدام مثبت MSI

• مرونة محدودة:

  • يثبت مثبت MSI Documentize في موقع على مستوى النظام، وهو ما قد لا يكون مناسبًا لجميع بيئات التطوير. قد تفتقر هذه الطريقة إلى المرونة لتلبية تكوينات أو إصدارات خاصة بالمشاريع.

• العبء المحتمل:

  • يمكن أن يؤدي تثبيت المكتبات الديناميكية في GAC إلى إدخال عبء وتعقيد، خاصة في السيناريوهات التي قد تحتاج فيها إلى نسخ متعددة من Documentize في وقت واحد.

• إزالة يدوية:

  • إذا كنت بحاجة إلى إلغاء تثبيت Documentize، يجب عليك استخدام برنامج إلغاء التثبيت المقدم من MSI، مما قد يترك ملفات أو تكوينات متبقية إذا لم يتم إدارتها بشكل صحيح.

• تعارضات الإصدارات:

  • يمكن أن تؤدي التثبيتات على مستوى النظام إلى تعارضات في الإصدارات إذا كانت المشاريع المختلفة تتطلب إصدارات مختلفة من Documentize. قد يتطلب إدارة هذه التعارضات تكوينات أو تنظيف إضافي.

تثبيت Documentize عبر ZIP

كيفية التثبيت عبر أرشيف ZIP

1. تنزيل أرشيف ZIP:

   • انقر على v25.7 ZIP لتنزيل أحدث إصدار من Documentize بتنسيق أرشيف.

2. استخراج المحتويات:

   • بعد التنزيل، قم باستخراج محتويات ملف ZIP إلى دليل من اختيارك. يمكنك اختيار الاحتفاظ بهذه الملفات في دليل مشترك أو ضمن هيكل مشروعك.

3. إضافة المراجع إلى مشروعك:

   • افتح مشروعك في بيئة تطويرك (على سبيل المثال، Visual Studio).
   • انتقل إلى مشروع > إضافة مرجع > تصفح وانتقل إلى الدليل حيث قمت باستخراج ملفات DLL.
   • حدد ملفات DLL ذات الصلة وأضفها كمراجع لمشروعك.

4. التحديثات اليدوية:

   • إذا تم إصدار إصدار جديد من Documentize، فستحتاج إلى تنزيل أرشيف ZIP المحدث يدويًا واستبدال ملفات DLL القديمة في مشروعك بالملفات الجديدة.

مزايا استخدام أرشيف ZIP

• تحكم كامل:

  • لديك السيطرة الكاملة على مكان وكيفية تخزين ملفات DLL والإشارة إليها في مشروعك. يمكن أن يكون ذلك مفيدًا إذا كنت تفضل إعدادًا مخصصًا أو تحتاج إلى إدارة التبعيات يدويًا.

• عدم الاعتماد على مديري الحزم:

  • على عكس NuGet، لا تعتمد على مدير حزم للتعامل مع التثبيتات. يمكن أن يكون ذلك مفيدًا في البيئات التي لا تتوفر فيها مديري الحزم أو لا يُفضل استخدامها.

• قابلية النقل:

  • يمكن مشاركة أرشيف ZIP بسهولة ونقله عبر أنظمة مختلفة، مما يجعله مثاليًا للمشاريع التي تحتاج إلى أن تكون قابلة للنقل أو التوزيع دون الاعتماد على أدوات خارجية.

عيوب استخدام أرشيف ZIP

• إدارة يدويه:

  • على عكس NuGet، حيث يتم أتمتة التحديثات وإدارة التبعيات، مع أرشيف ZIP، يجب عليك إدارة التحديثات يدويًا والتأكد من أن جميع ملفات DLL المطلوبة تم الإشارة إليها بشكل صحيح.

• خطر تضارب الإصدارات:

  • إذا كنت تدير مشاريع متعددة أو تعمل في فريق، هناك خطر من تضارب الإصدارات إذا كانت المشاريع المختلفة تستخدم إصدارات مختلفة من ملفات DLL. يتطلب ذلك تتبعًا دقيقًا للإصدارات عبر المشاريع.

• عدم وجود تحديثات تلقائية:

  • لن تتلقى تحديثات تلقائية أو إشعارات عند توفر إصدار جديد. يمكن أن يؤدي ذلك إلى خطر استخدام مكتبات قديمة ما لم تتحقق بانتظام من التحديثات.

بيئة غير ويندوز

العمل مع مكتبات .NET Core DLLs في بيئة غير ويندوز

نظرًا لأن Documentize لـ .NET يوفر دعم .NET Standard 2.0 (.NET Core 2.0)، يمكن استخدامه في تطبيقات Core التي تعمل على أنظمة تشغيل تشبه لينكس. نحن نعمل باستمرار على تحسين دعم .NET Core في واجهة برمجة التطبيقات الخاصة بنا. ومع ذلك، هناك بعض العمليات التي نوصي عملائنا بأدائها للحصول على نتائج أفضل عند استخدام ميزات Documentize لـ .NET. يرجى تثبيت:

• حزمة libgdiplus
• حزمة تحتوي على خطوط متوافقة مع Microsoft: ttf-mscorefonts-installer (على سبيل المثال، sudo apt-get install ttf-mscorefonts-installer). يجب وضع هذه الخطوط في دليل /usr/share/fonts/truetype/msttcorefonts حيث يقوم Documentize لـ .NET بفحص هذا المجلد على أنظمة تشغيل تشبه لينكس. في حال كان نظام التشغيل لديه مجلد/دليل افتراضي آخر للخطوط، يجب عليك استخدام السطر التالي من التعليمات البرمجية قبل إجراء أي عملية باستخدام Documentize:

  Documentize.Pdf.Text.FontRepository.Sources.Add(new FolderFontSource("<مسار المستخدم إلى خطوط Microsoft>"));

v25.7

تحسين قابلية استخدام مستخرج النصوص

• Class TextExtractor: ثابت ولا يتطلب استخدام منشئ.
• Class TextExtractor: سلوك محسّن عند التشغيل في وضع التقييم. لا استثناء مع مستندات تزيد عن 4 صفحات.
• Class TextExtractor: تم إصلاح مشكلات في طريقة Process.
• Class PdfExtractorOptions: تمت إزالته.
• Class TextExtractorOptions: تم إعادة هيكلة.
• Enum TextFormattingMode: تمت إعادة تسميته وتحسينه.

مثال على الاستخدام:

// المثال يوضح كيفية استخراج محتوى النص من مستند PDF.
// إنشاء كائن TextExtractorOptions لتحديد التعليمات
var options = new TextExtractorOptions(TextFormattingMode.Pure);
// إضافة مسار ملف الإدخال
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تنفيذ العملية
var results = TextExtractor.Process(options);
// الحصول على النص المستخرج من كائن ResultContainer
var textExtracted = results.ResultCollection[0].ToString();

تحسين قابلية استخدام محوّل HTML

• Class HtmlConverter: ثابت ولا يتطلب استخدام منشئ.
• Class HtmlConverter: تم إصلاح مشكلات في طريقة Process.
• Class HtmlConverter: تمت إزالة منطق IDisposable.
• Class PdfConverterOptions: تمت إزالته.

أمثلة على الاستخدام:

// المثال يوضح كيفية تحويل PDF إلى مستند HTML.
// إنشاء كائن PdfToHtmlOptions لتحديد نوع بيانات الإخراج كملف مع موارد مضمنة
var options = new PdfToHtmlOptions(PdfToHtmlOptions.SaveDataType.FileWithEmbeddedResources);
// إضافة مسار ملف الإدخال
options.AddInput(new FileDataSource("path_to_input.pdf"));
// تحديد مسار ملف الإخراج
options.AddOutput(new FileDataSource("path_to_output.html"));
// تنفيذ العملية
HtmlConverter.Process(options);

// المثال يوضح كيفية تحويل HTML إلى مستند PDF.
// إنشاء HtmlToPdfOptions
var options = new HtmlToPdfOptions();
// إضافة مسار ملف الإدخال
options.AddInput(new FileDataSource("path_to_input.html"));
// تحديد مسار ملف الإخراج
options.AddOutput(new FileDataSource("path_to_output.pdf"));
// تنفيذ العملية
HtmlConverter.Process(options);

تحسين قابلية استخدام مستخرج الصور

• Class ImageExtractor: ثابت ولا يتطلب استخدام منشئ.

مثال على الاستخدام:

// المثال يوضح كيفية استخراج الصور من مستند PDF.
// إنشاء ImageExtractorOptions لتحديد التعليمات
var options = new ImageExtractorOptions();
// إضافة مسار ملف الإدخال
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تحديد مسار الدليل للإخراج
options.AddOutput(new DirectoryDataSource("path_to_results_directory"));
// تنفيذ العملية
var results = ImageExtractor.Process(options);
// الحصول على مسار نتيجة الصورة
var imageExtracted = results.ResultCollection[0].ToFile();

إصلاحات طفيفة

• إصلاحات داخلية.
• إصلاح الأمثلة والتلميحات لمحّول TIFF.
• تقليل مدة تحسين الصفحة.
• إصلاح: صورة الإخراج غير صحيحة من تحويل PDF إلى PNG.
• إصلاح: عدم عرض الأحرف الصينية بشكل صحيح أثناء تحويل PDF إلى PNG.
• تحسين: الأداء أثناء تحويل PDF إلى HTML.

v25.6

تحسين قابلية استخدام محول TIFF

• Class PdfToTiffOptions: تمت إضافة معلمة إضافية للتحويل - الضغط.
• Class PdfToTiffOptions: تمت إضافة معلمة إضافية للتحويل - عمق اللون.
• Class TiffConverter ثابت ولا يتطلب استخدام مُنشئ.
• تحسين الأمثلة الرئيسية.

أمثلة الاستخدام:

// المثال يوضح كيفية تحويل مستند PDF إلى تنسيق TIFF.
// إنشاء كائن PdfToTiffOptions لتحديد التعليمات
var options = new PdfToTiffOptions();
// إضافة مسار ملف الإدخال
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تحديد مسار دليل الإخراج
options.AddOutput(new DirectoryDataSource("path_to_output_directory"));
// تنفيذ العملية
TiffConverter.Process(options);

// المثال يوضح كيفية تحويل مستند PDF إلى تنسيق TIFF مع معاملات إضافية.
// إنشاء كائن PdfToTiffOptions لتحديد التعليمات
var options = new PdfToTiffOptions();
// إضافة مسار ملف الإدخال
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تحديد مسار دليل الإخراج
options.AddOutput(new DirectoryDataSource("path_to_output_directory"));
// معاملات اختيارية
options.PageList = new List<int> { 1, 3 };
options.MultiPage = true;
options.OutputResolution = 400;
options.Compression = TiffCompression.RLE;
options.ColorDepth = TiffColorDepth.Format24bpp;
// تنفيذ العملية
TiffConverter.Process(options);

إصلاحات طفيفة

• إصلاحات داخلية.

v25.5

إضافة المكون الإضافي الجديد: Form Exporter

• Class FormExporter: يمثل مكون Documentize.FormExporter الذي يُستخدم لتصدير قيم النماذج من مستندات PDF إلى ملف DSV أو CSV
• Class FormExportToDsvOptions: يمثل الخيارات لتصدير قيم مستندات PDF إلى ملف DSV أو CSV من خلال مكون Documentize.FormExporter.

مثال على الاستخدام:

// مثال يوضح كيفية تصدير قيم النماذج إلى ملف CSV.
// إنشاء كائن FormExportToDsvOptions لضبط التعليمات
var options = new FormExportToDsvOptions(',', true);
// إضافة مسار ملف الإدخال
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تعيين مسار ملف الإخراج
options.AddOutput(new FileDataSource("path_to_result_csv_file.csv"));
// تنفيذ العملية
FormExporter.Process(options);

تحسين قابلية الاستخدام في الأمان

• الفئة ثابتة ولا تتطلب استخدام مُنشئ.
• تحسين الأمثلة الرئيسية.

أمثلة على الاستخدام:

// المثال يوضح كيفية تشفير مستند PDF.
// إنشاء كائن EncryptionOptions لضبط التعليمات
var options = new EncryptionOptions("123456", "qwerty");
// إضافة مسار ملف الإدخال
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تعيين مسار ملف الإخراج
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// تنفيذ العملية
Security.Process(options);

// المثال يوضح كيفية فك تشفير مستند PDF.
// إنشاء كائن DecryptionOptions لضبط التعليمات
var options = new DecryptionOptions("123456");
// إضافة مسار ملف الإدخال
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تعيين مسار ملف الإخراج
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// تنفيذ العملية
Security.Process(options);

إصلاحات طفيفة

• تحسين تلميحات الفئة والتراخيص.

v25.4

تحسين قابلية استخدام المحسّن

• الصنف ثابت ولا يتطلب استخدام مُنشئ.
• تحسين المثال الرئيسي.
• إضافة أمثلة إضافية.

استخدام الأمثلة:

// المثال يوضح كيفية تحسين مستند PDF.
// إنشاء كائن OptimizeOptions لتعيين التعليمات
var options = new OptimizeOptions();
// إضافة مسار الملف المدخل
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تعيين مسار الملف الناتج
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// إجراء العملية
Optimizer.Process(options);

// المثال يوضح كيفية تدوير مستند PDF.
// إنشاء كائن RotateOptions لتعيين التعليمات
var options = new RotateOptions();
// تعيين الدوران الجديد
options.Rotation = Rotation.On90;
// إضافة مسار الملف المدخل
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تعيين مسار الملف الناتج
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// إجراء العملية
Optimizer.Process(options);

// المثال يوضح كيفية تغيير حجم مستند PDF.
// إنشاء كائن ResizeOptions لتعيين التعليمات
var options = new ResizeOptions();
// تعيين حجم الصفحة الجديد
options.PageSize = PageSize.A3;
// إضافة مسار الملف المدخل
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تعيين مسار الملف الناتج
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// إجراء العملية
Optimizer.Process(options);

// المثال يوضح كيفية ضغط مستند PDF.
// إنشاء كائن CompressOptions لتعيين التعليمات
var options = new CompressOptions();
// إضافة مسار الملف المدخل
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تعيين مسار الملف الناتج
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// إجراء العملية
Optimizer.Process(options);

تحسين قابلية استخدام الملحق المفسر

• الصنف ثابت ولا يتطلب استخدام مُنشئ.
• تحسين المثال الرئيسي.

استخدام الأمثلة:

// المثال يوضح كيفية تقسيم مستند PDF.
// إنشاء كائن SplitOptions لتعيين التعليمات
var options = new SplitOptions();
// إضافة مسار الملف المدخل
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تعيين مسارات الملفات الناتجة
options.AddOutput(new FileDataSource("path_to_result_pdf_file_1.pdf"));
options.AddOutput(new FileDataSource("path_to_result_pdf_file_2.pdf"));
// إجراء العملية
Splitter.Process(options);

تحسين قابلية استخدام الملحق الموحد

• الصنف ثابت ولا يتطلب استخدام مُنشئ.
• تحسين المثال الرئيسي.

استخدام الأمثلة:

// المثال يوضح كيفية دمج مستندين PDF.
// إنشاء كائن MergeOptions لتعيين التعليمات
var options = new MergeOptions();
// إضافة مسارات الملفات المدخلة
options.AddInput(new FileDataSource("path_to_your_pdf_file_1.pdf"));
options.AddInput(new FileDataSource("path_to_your_pdf_file_2.pdf"));
// تعيين مسار الملف الناتج
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// إجراء العملية
Merger.Process(options);

إصلاحات طفيفة

• تحسين تلميحات الصفوف.

v25.3

إضافة إضافة جديدة: مُسطّح النموذج

• Class FormFlattener: يمثل إضافة Documentize.FormFlattener المستخدمة لتسطح الحقول في مستندات PDF.
• Class FormFlattenerOptions: تمثل الخيارات لتسطح الحقول في المستند بواسطة إضافة Documentize.FormFlattener.

مثال على الاستخدام:

//المثال يوضح كيفية تسطح الحقول في ملف PDF.  
// إنشاء كائن FormFlattenerOptions لتحديد التعليمات  
var options = new FormFlattenerOptions();  
// إضافة مسار ملف الإدخال  
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));  
// تعيين مسار ملف الإخراج  
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));  
//معامل اختياري لتخطي الحقل الذي يحمل الاسم "Surname".
options.SkipFields.Add("Surname");  
// تنفيذ العملية  
FormFlattener.Process(options);  

//المثال يوضح كيفية الحصول على أسماء الحقول من ملف PDF.  
var fieldNames = FormFlattener.GetFieldNames("path_to_your_pdf_file.pdf");  

إصلاحات طفيفة

• تحسين تلميحات الصفوف والأمثلة.

v25.2

إضافة ملحق جديد: مولد جدول المحتويات

• Class TocGenerator: يمثل ملحق Documentize.TocGenerator. يُستخدم لإضافة جدول محتويات إلى مستندات PDF.
• Class TocOptions: يمثل الخيارات لإضافة جدول محتويات إلى المستند بواسطة ملحق Documentize.TocGenerator.
• Class TocHeading: يمثل الخيارات للعناوين أو العناوين الفرعية لجدول المحتويات في المستند بواسطة ملحق Documentize.TocGenerator.

مثال على الاستخدام:

// المثال يوضح كيفية إضافة جدول محتويات إلى ملف PDF.
var options = new TocOptions();
// تعيين العنوان
options.Title = "جدول محتويات";
// توليد الروابط في العلامات
options.GenerateBookmarks = true;
// تصميم العناوين
options.Headings.Add(new TocHeading("المقدمة", 2, false, 1));
options.Headings.Add(new TocHeading("الفصل الأول", 3, true, 1));
options.Headings.Add(new TocHeading("الفصل الثاني", 4, true, 1));
options.Headings.Add(new TocHeading("مثال A", 4, true, 2));
options.Headings.Add(new TocHeading("مثال B", 4, true, 2));
options.Headings.Add(new TocHeading("مثال C", 4, true, 2));
options.Headings.Add(new TocHeading("مثال D", 4, true, 2));
options.Headings.Add(new TocHeading("الفصل الثالث", 5, true, 1));
// إضافة مسار ملف الإدخال
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تعيين مسار الملف الناتج
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// تنفيذ العملية
TocGenerator.Process(options);

إصلاحات طفيفة

• تحسين تلميحات الفصول والأمثلة.
• تحديث العلامات المائية.
• تحسين تحويل PDF إلى XSLX.
• تحسين تحويل PDF إلى PDF/A-1a.

v25.1

تحسين المكون الإضافي: ImageExtractor

• إضافة تجميع المخرجات إلى ImageExtractorOptions.
• إضافة دعم لمدخلات متعددة إلى ImageExtractorOptions.
• إصلاح تدفقات المخرجات المغلقة.

مثال على الاستخدام:

// انشاء كائن ImageExtractor لاستخراج الصور
var plugin = new ImageExtractor();
// انشاء ImageExtractorOptions
var opt = new ImageExtractorOptions();
// إضافة مسار ملف المدخل
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تعيين دليل المخرجات
opt.AddOutput(new DirectoryDataSource("path_to_results_directory"));
// تنفيذ عملية الاستخراج
var resultContainer = plugin.Process(opt);
// الحصول على الصورة من كائن ResultContainer
var imageExtracted = resultContainer.ResultCollection[0].ToFile();

إصلاحات صغيرة

• تحسين تلميحات الفئات والأمثلة.
• التحقق من صحة توقيع PDF.
• تحسين دعم الأحرف الصينية.

v24.12

أضيفت ملحق جديد: محول PDF إلى PNG

• الفئة PngConverter: تمثل ملحق Documentize.PngConverter. تستخدم لتحويل مستندات PDF إلى تنسيق PNG.
• الفئة PdfToPngOptions: تمثل خيارات محول PDF إلى PNG لملحق Documentize.PngConverter.

مثال على الاستخدام:

// إنشاء PngConverter
var plugin = new PngConverter();
// إنشاء كائن PdfToPngOptions لتحديد التعليمات
var opt = new PdfToPngOptions();
// إضافة مسار ملف الإدخال
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تعيين مسار ملف الإخراج
opt.AddOutput(new DirectoryDataSource("path_to_results_directory"));
// تنفيذ العملية
plugin.Process(opt);

أضيفت ملحق جديد: محول PDF إلى TIFF

• الفئة TiffConverter: تمثل ملحق Documentize.TiffConverter. تستخدم لتحويل مستندات PDF إلى تنسيق TIFF.
• الفئة PdfToTiffOptions: تمثل خيارات محول PDF إلى TIFF لملحق Documentize.TiffConverter.

مثال على الاستخدام:

// إنشاء TiffConverter
var plugin = new TiffConverter();
// إنشاء كائن PdfToTiffOptions لتحديد التعليمات
var opt = new PdfToTiffOptions();
// إضافة مسار ملف الإدخال
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تعيين مسار ملف الإخراج
opt.AddOutput(new DirectoryDataSource("path_to_results_directory"));
// تنفيذ العملية
plugin.Process(opt);

أضيفت ملحق جديد: مُولد جدول PDF

• الفئة TableGenerator: تمثل ملحق Documentize.TableGenerator. تستخدم لإضافة جدول إلى مستند PDF.
• الفئة TableBuilder: تمثل البناء للجدول في صفحة PDF.
• الفئة TableRowBuilder: تمثل البناء لصف الجدول.
• الفئة TableRowBuilder: تمثل البناء لخلية الجدول.

مثال على الاستخدام:

// إنشاء TableGenerator
var plugin = new TableGenerator();
// إنشاء كائن TableOptions لتحديد التعليمات
TableOptions opt = new TableOptions().InsertPageBefore(1)
   .AddTable()
        .AddRow()
            .AddCell().AddParagraph("Name")
            .AddCell().AddParagraph("Age")
        .AddRow()
            .AddCell().AddParagraph("Bob")
            .AddCell().AddParagraph("12")
        .AddRow()
            .AddCell().AddParagraph("Sam")
            .AddCell().AddParagraph("20")
        .AddRow()
            .AddCell().AddParagraph("Sandy")
            .AddCell().AddParagraph("26")
        .AddRow()
            .AddCell().AddParagraph("Tom")
            .AddCell().AddParagraph("12")
        .AddRow()
            .AddCell().AddParagraph("Jim")
            .AddCell().AddParagraph("27");
// إضافة مسار ملف الإدخال
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تعيين مسار ملف الإخراج
opt.AddOutput(new FileDataSource("path_to_the_converted_file.pdf"));
// تنفيذ العملية
plugin.Process(opt);

إعادة تسمية الفئة PdfDoc إلى DocConverter

• الفئة DocConverter: تمثل ملحق Documentize.DocConverter. تستخدم لتحويل مستندات PDF إلى تنسيق DOC/DOCX.

مثال على الاستخدام:

// إنشاء DocConverter
var plugin = new DocConverter();
// إنشاء كائن PdfToDocOptions لتحديد التعليمات
var opt = new PdfToDocOptions();
// إضافة مسار ملف الإدخال
opt.AddInput(new FileDataSource(inputPath));
// تعيين مسار ملف الإخراج
opt.AddOutput(new FileDataSource(outputPath));
// تنفيذ العملية
plugin.Process(opt);

v24.11

إضافة مكون إضافي جديد: محول PDF إلى JPEG

• الهدف: تم تصميم فئة JpegConverter لتحويل مستندات PDF إلى تنسيق JPEG، مما يسهل على المستخدمين التعامل مع الصور المشتقة من مستندات PDF ومشاركتها.
• الباني:
  • JpegConverter(): يقوم بتهيئة مثيل جديد من محول JPEG.

مثال على الاستخدام:

var plugin = new JpegConverter();
var opt = new PdfToJpegOptions();
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
opt.AddOutput(new DirectoryDataSource("path_to_results_directory"));
plugin.Process(opt);

• الطريقة:
  • Process(PdfToJpegOptions options): يبدأ عملية تحويل JPEG باستخدام الخيارات المحددة.

إضافة فئة DirectoryDataSource

• الهدف: تتيح فئة DirectoryDataSource للمستخدمين إدارة بيانات الدليل لعمليات التحميل والحفظ داخل المكونات الإضافية.
• الباني:
  • DirectoryDataSource(string path): يقوم بتهيئة كائن بيانات دليل جديد باستخدام المسار المحدد.

مثال على الاستخدام:

var directorySource = new DirectoryDataSource("path_to_your_directory");

• الخصائص:
  • DataType: يسترجع نوع مصدر البيانات.
  • Path: يحصل على مسار الدليل الحالي للبيانات.

إضافة فئة PdfToJpegOptions

• الهدف: تحتوي هذه الفئة على خيارات لتكوين عملية تحويل JPEG، مما يسمح للمستخدمين بتحديد الدقة، قوائم الصفحات، وجودة الصورة.
• الباني:
  • PdfToJpegOptions(): يقوم بتهيئة مثيل خيارات جديد لمحول JPEG.

الخصائص:

• OutputResolution: يحدد دقة الصور الناتجة عن JPEG.
• PageList: قائمة بالصفحات للتحويل من PDF.
• Quality: يحدد جودة ناتج JPEG.

v24.10

إضافة ملحق جديد: محول PDF/A

• تم تقديم ميزة جديدة لتحويل PDF/A، مما يسمح للمستخدمين بتحويل ملفات PDF القياسية بسهولة إلى مستندات متوافقة مع PDF/A.

مثال على الاستخدام:

var options = new PdfAConvertOptions
{
    PdfAVersion = PdfAStandardVersion.PDF_A_3B
};

options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
options.AddOutput(new FileDataSource("path_to_the_converted_file.pdf"));

var plugin = new PdfAConverter();
plugin.Process(options);

إصلاحات الأخطاء

• تم إصلاح مشكلات تتعلق بفئة FileResult والتي أدت إلى مسارات مخرجات غير صحيحة.
• تم حل أخطاء صغيرة تؤثر على HtmlConverter عند التعامل مع ملفات كبيرة.

تحسينات

• تحسين أداء PdfExtractor و ImageExtractor للحصول على أوقات معالجة أسرع.
• تحديث فئة RotateOptions لدعم زوايا دوران إضافية.

v24.9

تم الإصدار