ValidatePdfUa - TPdf

يحافظ إدخال API هذا على المعرّفات والتواقيع وكتل الكود ومصطلحات PDF بصيغتها الأصلية.

المكون: TPdf · الوحدة: PDFium

يفحص ملف PDF المفتوح حاليًا بحثًا عن علامات التوافق مع PDF/UA-1 ويعيد نتيجةً منظَّمة تتضمن مستوى التوافق المكتشف ومجموعة المشكلات المحددة الموجودة

الصياغة

function ValidatePdfUa: TPdfUaValidationResult;

الوصف

تجوب ValidatePdfUa المستند المفتوح بحثًا عن علامات تنسيق الملف الخاصة بـ PDF/UA-1 التي يعرّفها ISO 14289-1:2014

دفق بيانات وصفية XMP بـ pdfuaid:part = 1 ووصف pdfaExtension:schemas المطابق (§5).
إدخال dc:title الإلزامي داخل حزمة XMP (§7.1).
StructTreeRoot في catalog أو في مكان ما داخل الملف (§7.1)، وهو مطلوب لكي يحمل المستند الوسوم أصلًا
الكتالوج /MarkInfo << /Marked true /Suspects false >> (§7.1).
الكتالوج /ViewerPreferences << /DisplayDocTitle true >> (§7.1).
الكتالوج /Lang مع علامة لغة BCP 47 (§7.2).
مصفوفة /ID في ذيل الملف (Trailer) وغياب التشفير.
xmp:CreateDate / xmp:ModifyDate (مُوصى به لتكافؤ Info/XMP).

النتيجة هي سجل TPdfUaValidationResult

Conformance — المستوى المكتشف: puc1 عند العثور على معرّف PDF/UA-1، أو pucNone عند غياب علامة PDF/UA، أو pucUnknown عند فشل التحليل
Issues — مجموعة TPdfUaValidationIssues تحتوي صفرًا أو أكثر من القيم التالية: pvuaiMissingXmpMetadata وpvuaiMissingPdfUaIdentifier وpvuaiMissingExtensionSchema وpvuaiMissingDcTitle وpvuaiMissingStructTreeRoot وpvuaiMissingMarkInfo وpvuaiSuspectsTrue وpvuaiMissingDisplayDocTitle وpvuaiMissingLang وpvuaiEncryptionPresent وpvuaiMissingTrailerId وpvuaiMissingXmpDates وpvuaiFontNotEmbedded وpvuaiFontMissingToUnicode وpvuaiMissingTabsOrder وpvuaiFigureMissingAlt وpvuaiFormulaMissingAlt وpvuaiNoteMissingId

ValidatePdfUa فحص للقراءة فقط — فهو لا يغيّر المستند ويمكن استدعاؤه بأمان مرات متكررة. استخدمه قبل تسليم PDF إلى نظام أرشفة أو مدقق إتاحة لإظهار حالات عدم التوافق للمشغل. وللتحقق الشائع من "هل هذا PDF/UA-1؟" من دون الحاجة إلى قائمة المشكلات، فضّل الخاصية الأخف PdfUaConformance

ملاحظات

يغطي ValidatePdfUa علامات تنسيق الملف، وبعض استدلالات المحتوى القابلة للفحص بالبايت مثل تضمين الخطوط وToUnicode CMaps وترتيب علامات الصفحة /Tabs /S، وثلاثة فحوص عالية الثقة لشجرة البنية مثل Figure من دون Alt/ActualText وFormula من دون Alt وNote من دون معرّف فريد. لكنه لا يتحقق من بقية قواعد PDF/UA على مستوى المحتوى مثل تداخل العناوين، ووضع علامات Form widget، وخصائص الجدول /TH /Scope، وصحة RoleMap، وترتيب القراءة المنطقي، وغيرها. وللحصول على مدقق كامل، قرن هذه الطريقة بأداة خارجية مثل PAC 2024 أو axesPDF
استدعاء ValidatePdfUa على مستند غير نشط يعيد سجلًا بقيمة Conformance = pucUnknown ومجموعة Issues فارغة
لا يضع المدقق pvuaiSuspectsTrue إلا عندما يظهر /Suspects true صراحةً في /MarkInfo. أما المستندات التي تفتقد مفتاح /Suspects بالكامل فتُعد متوافقة في تلك النقطة لأن المواصفة تحظر فقط true
يفرض SaveAsPdfUa الإدخالين الإلزاميين في ISO 14289-1 7.1 وهما /ViewerPreferences /DisplayDocTitle true و/MarkInfo /Marked true /Suspects false حتى عندما يوفّر المصدر تلك القواميس بشكل ناقص أو كمراجع غير مباشرة (N 0 R)؛ وتُحافَظ المفاتيح الموجودة وتُطبَّع القاموس إلى قاموس مباشر في catalog المعاد كتابته

مثال

uses System.TypInfo;

var
  Outcome: TPdfUaValidationResult;
  Issue: TPdfUaValidationIssue;
begin
  Pdf1.FileName := 'C:\Incoming\report.pdf';
  Pdf1.Active := True;
  Outcome := Pdf1.ValidatePdfUa;
  Memo1.Lines.Add('المستوى: ' + GetEnumName(TypeInfo(TPdfUaConformance),
    Ord(Outcome.Conformance)));
  for Issue in Outcome.Issues do
    Memo1.Lines.Add('- ' + GetEnumName(TypeInfo(TPdfUaValidationIssue), Ord(Issue)));
end;

انظر أيضا

PdfUaConformance, SaveAsPdfUa, SaveAsPdfUaToStream, IsTagged, ValidatePdfA