CreatePreflightReport
التوافق، فحص المستندات
اختيار ملف تعريف قارئ 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 خارجي بإجراء فحوصات امتثال ملف PDF/A وPDF/UA-1 القائمة وتنسيق نتائجها في متن تقرير واحد قابل لإعادة الاستخدام. وهذه واجهة التيسير التي تستخدمها عندما يريد التطبيق تقريرًا مقروءًا للإنسان بدلًا من استدعاء CheckFileCompliance وGetStringListCount وGetStringListItem وReleaseStringList يدويًا
الصيغة
Delphi
Function TPDFlib.CreatePreflightReport(Const InputFileName, Password: WideString; ComplianceTests, Options: Integer): WideString;
المعاملات
| InputFileName | المسار الكامل لملف PDF المطلوب التحقق منه. يُفتح الملف للقراءة فقط ولا يُعدَّل |
|---|---|
| Password | كلمة المرور لفتح الملف. مرِّر سلسلة فارغة للمستندات غير المشفرة |
| ComplianceTests | قناع بتات يختار الفحوصات المضمولة. 1 — PDF/A. 2 — PDF/UA-1. 3 — PDF/A وPDF/UA-1 معًا. وتمرير 0 يجري الفحصين أيضًا |
| Options | بتات أعلام تمر إلى كل فحص امتثال أساسي. 0 — الإبلاغ عن كل ملاحظة في كل فحص محدد. 1 — إيقاف كل فحص محدد بعد أول ملاحظة |
قيمة الإرجاع
تُرجع تقرير نص UTF-16 يحتوي ترويسة التقرير وقسمًا عن كل فحص امتثال محدد وملخصًا نهائيًا بأسطر Total issues وResult
ملاحظات
عند اختيار عدة معايير يُحلَّل الملف مرة واحدة وتتشارك عمليتا التدقيق القارئ نفسه وحالة الأمان ورسم كائنات المستند ومخزن الكائنات الكسولة
لا تحل واجهة التقرير محل مدقق PDF/A خارجي مخصص. بل تغلف تشخيصات PDF/A وPDF/UA-1 من الخط الأول المدمجة في المكتبة في تقرير مستقر موجه للتطبيق. استخدم CreatePreflightReportEx عندما يحتاج التطبيق إخراج نصيًا أو JSON أو HTML أو CSV، واستخدم CheckFileCompliance مباشرةً عندما يحتاج مقابض قوائم ملاحظات فردية بدلًا من نص منسق
التقرير النصي الخام هو المصدر القياسي لكل تقرير منسق. ويحتوي بيانات Generated: الوصفية المتقلبة ومسار Input: والفحوصات المحددة ووضع جمع الملاحظات وقسمًا عن كل اختبار امتثال محدد وملخصًا نهائيًا بـ Total issues وResult
لسير عمل سطر الأوامر وتقارير الدفعات راجع Preflight Reports
مثال
var
Report: WideString;
begin
Report := PDF.CreatePreflightReport('output.pdf', '', 1 or 2, 0);
WriteLn(Report);
end;انظر أيضا
Preflight Reports, CreatePreflightReportEx, SavePreflightReport, ComparePreflightReports, CheckFileCompliance, GetPDFUADiagnostics, SetPDFAMode, SetPDFUAMode