CreatePreflightReportEx

التوافق، فحص المستندات

اختيار ملف تعريف قارئ PDF/UA

تختار فحوص PDF/UA الجزء 2 حين يُعرّف XMP القيمة pdfuaid:part=2 وتحتفظ في غير ذلك بفحوص الجزء 1؛ ولا يُفهم من وصف فحوص PDF/UA-1 القديمة هنا أنها تنطبق على الجزء 2

ينفذ ملف تعريف PDF/UA-2 فحوص التعريف ومساحات الأسماء والأدوار والبنية الأساسية؛ وتستخدم التقارير المهيكلة PDF/UA-2 وISO 14289-2 وتفصح عن fullCertification=false وعن النطاق غير الموثَّق

استخدم CheckFilePDFUACompliance أو RunPDFUAValidationPipelineTask لفرض جزء هدف، وGetPDFUAReadValidationCoverageJSON لفحص حدود القدرات

الوصف

ينشئ تقرير preflight لملف PDF خارجي ويحول التقرير إلى صيغة الإخراج المطلوبة. وهذا هو الرفيق المدرك للصيغة لـ CreatePreflightReport الذي يُرجع دائمًا التقرير النصي الخام

الصيغة

Delphi

Function TPDFlib.CreatePreflightReportEx(Const InputFileName, Password: WideString; ComplianceTests, Options, ReportFormat: Integer): WideString;

المعاملات

InputFileNameالمسار الكامل لملف PDF المطلوب التحقق منه. يُفتح الملف للقراءة فقط ولا يُعدَّل
Passwordكلمة المرور لفتح الملف. مرِّر سلسلة فارغة للمستندات غير المشفرة
ComplianceTestsقناع بت يحدد الفحوصات المضمّنة: 1 لـ PDF/A، و2 لـ PDF/UA، و3 أو 0 لكليهما
Optionsبتات أعلام تُمرَّر إلى كل فحص امتثال محدد. مرِّر 1 لإيقاف كل فحص بعد أول ملاحظة فيه
ReportFormatمنتقي صيغة الإخراج.

0 — نص خام.
1 — كائن JSON بحقول ترويسة وأقسام لكل فحص ومصفوفات ملاحظات وحقول ملخص.
2 — مستند HTML مستقل يحتوي تقرير النص المهرّب.
3 — صفوف CSV بالبيانات الوصفية والفحوصات المحددة ورموز ورسائل الملاحظات وصفوف الملخص النهائية

قيمة الإرجاع

تُرجع التقرير المولد بالصيغة المحددة. وتعود قيم ReportFormat غير المعروفة إلى صيغة النص الخام

ملاحظات

تُولَّد صيغ JSON وHTML وCSV من التقرير النصي نفسه الذي يستخدمه CreatePreflightReport فتبقى حالة النجاح/الفشل وعدد الملاحظات متسقة عبر جميع صيغ التقرير

يكشف كائن JSON حقول ترويسة ومصفوفة sections ومصفوفات سلاسل ملاحظات وكائن summary. وصيغة HTML مستند مستقل يهرّب تقرير النص داخل كتلة منسقة مسبقًا. وتستخدم صيغة CSV أعمدة kind,section,status,code,message ثابتة وتفصل البيانات الوصفية وحالة الفحص وصفوف الملاحظات وصفوف الملخص لتحليل جداول بيانات أو CI

لعقد صيغة التقرير الكاملة وأمثلة سطر الأوامر التجريبية راجع Preflight Reports

مثال

JsonReport := PDF.CreatePreflightReportEx('output.pdf', '', 1 or 2, 0, 1);
HtmlReport := PDF.CreatePreflightReportEx('output.pdf', '', 1 or 2, 0, 2);
CsvReport := PDF.CreatePreflightReportEx('output.pdf', '', 1 or 2, 0, 3);

انظر أيضا

Preflight Reports, CreatePreflightReport, SavePreflightReportEx, ComparePreflightReports, CheckFileCompliance