ValidatePdfE - TPdf

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

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

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

الصياغة

function ValidatePdfE: TPdfEValidationResult;

الوصف

تجوب ValidatePdfE المستند المفتوح بحثًا عن علامات تنسيق الملف الخاصة بـ PDF/E-1 التي يعرّفها ISO 24517-1:2008

دفق XMP metadata يحتوي على pdfe:ISO_PDFEVersion (§5 + §13.3)
الوصف المطابق pdfaExtension:schemas لمساحة الاسم pdfe، وهو مطلب مخطط الامتداد في XMP Specification 2004 ويَرِد عبر §13.1
إدخال /ISO_PDFEVersion في Document Information Dictionary بقيمة literal-string (§5 SHALL)
تطابق بين قيمة Info dictionary وقيمة XMP (§6.5 / §13.1)
مصفوفة trailer /ID (§6.2)
الإدخالان xmp:CreateDate وxmp:ModifyDate في XMP، والموروثان من ISO 19005-1 §6.7 عبر §13.1

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

Conformance — المستوى المكتشف: pec1 عند العثور على معرّف PDF/E-1 وأن تكون قيمته غير فارغة، أو pecNone عند غياب علامة PDF/E، أو pecUnknown عند فشل التحليل أو وجود العلامة مع غياب القيمة
Issues — مجموعة TPdfEValidationIssues تحتوي صفرًا أو أكثر من القيم التالية: pveiMissingXmpMetadata وpveiMissingPdfEIdentifier وpveiMissingExtensionSchema وpveiMissingInfoVersionEntry وpveiInfoVersionMismatch وpveiMissingTrailerId وpveiMissingXmpDates

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

ملاحظات

ValidatePdfE فحص على مستوى تنسيق الملف — فهو لا يفرض قواعد PDF/E على مستوى المحتوى مثل اكتمال تضمين الخطوط وToUnicode CMaps وReference XObjects / PostScript XObjects / TR / TR2 != Default المحظورة وXFA forms وJavaScript actions وغيرها. وللحصول على مدقق كامل، قرن هذه الطريقة بأداة خارجية مثل callas pdfaPilot أو axesPDF
يبلغ المدقق عن pveiInfoVersionMismatch فقط عندما تكون كلتا القيمتين Info /ISO_PDFEVersion وXMP pdfe:ISO_PDFEVersion موجودتين ومختلفتين. وعندما يكون إدخال Info غائبًا، يبلغ فقط عن pveiMissingInfoVersionEntry من دون أي mismatch زائف
استدعاء ValidatePdfE على مستند غير نشط يعيد سجلًا بقيمة Conformance = pecUnknown ومجموعة Issues فارغة
يتيح PDF/E-1 التشفير (§6.3) بشرط أن تبقى سلاسل trailer /ID كائنات مباشرة. لذلك لا يضع المدقق التشفير ضمن حالات عدم التوافق

مثال

uses System.TypInfo;

var
  Outcome: TPdfEValidationResult;
  Issue: TPdfEValidationIssue;
begin
  Pdf1.FileName := 'C:\Incoming\drawing.pdf';
  Pdf1.Active := True;
  Outcome := Pdf1.ValidatePdfE;
  Memo1.Lines.Add('Level: ' + GetEnumName(TypeInfo(TPdfEConformance),
    Ord(Outcome.Conformance)));
  for Issue in Outcome.Issues do
    Memo1.Lines.Add('- ' + GetEnumName(TypeInfo(TPdfEValidationIssue), Ord(Issue)));
end;

انظر أيضا

PdfEConformance, SaveAsPdfE, SaveAsPdfEToStream, ValidatePdfA, ValidatePdfUa