CheckFileCompliance

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

اختيار ملف تعريف قارئ 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 لفحص حدود القدرات

الوصف

يقرأ ملف PDF خارجيًا ويتحقق منه مقابل معيار توافق ISO مختار. القيمة المعادة إما صفر (الملف يجتاز الاختبار المختار بنظافة تامة) أو مقبض StringListID غير صفري يسرد كل مشكلة مكتشفة. كل مُدخل في القائمة هو رمز قصير ونقطتان ورسالة مفهومة للإنسان — وهي صيغة الرمز نفسها المستخدمة تمامًا في GetPDFUADiagnostics. عدّد النتيجة عبر GetStringListCount و GetStringListItemيغطي اختبار PDF/A جميع أوضاع المطابقة الستة (PDF/A-1a و PDF/A-1b و PDF/A-2a و PDF/A-2b و PDF/A-3a و PDF/A-3b) ويقرأ مُدخلَي XMP‏

pdfaid:part/pdfaid:conformance ليقرر مجموعة القواعد التي سيطبقهايتحقق اختبار PDF/UA-1‏ (المضاف في v3.56.0) من ملف PDF خارجي مقابل ISO 14289-1 ويصدر رموز تشخيص في المدى

10xxx كي تبقى منفصلة بصريًا عن رموز PDF/A‏ 00xxx

الصيغة

Delphi

Function TPDFlib.CheckFileCompliance(Const InputFileName, Password: WideString; ComplianceTest, Options: Integer): Integer;

ActiveX

Function PDFlib::CheckFileCompliance(InputFileName As String, Password As String, ComplianceTest As Long, Options As Long) As Long

DLL

int DLCheckFileCompliance(int InstanceID, const wchar_t * InputFileName, const wchar_t * Password, int ComplianceTest, int Options);

المعاملات

قيم الإرجاع

رموز مشكلات PDF/A (ComplianceTest = 1)

رموز مشكلات PDF/UA-1 (ComplianceTest = 2)

ملاحظات

يهدف اختبار PDF/A بوصفه فحصًا ذاتيًا سريعًا قبل التسليم. يلتقط مشكلات مستوى المستند التي تُسقط الملف فورًا (إصدار PDF خاطئ، غياب OutputIntent، غياب شجرة البنية عند المستوى A، التشفير، الطبقات في PDF/A-1). وهو لا يمر على كل عامل في تدفقات المحتوى ولا يتحقق من تضمين الخطوط أو مراجع فضاءات الألوان لكل كائن مرسوم — تلك التحققات تتطلب مدقق PDF/A مخصصًا (مثل veraPDF). استخدم هذه الدالة بوصفها فحصًا من الخط الأول وبوابة انحدار في خطوط البناء. استخدم CreatePreflightReport أو SavePreflightReport عندما تريد من المكتبة تنسيق قوائم المشكلات في تقرير نصي قابل لإعادة الاستخدام. واستخدم CreatePreflightReportEx أو SavePreflightReportEx لإخراج تقرير بنص أو JSON أو HTML أو CSV، أو انظر Preflight Reports لسير عمل التقارير الكاملتجري واجهة API المصاحبة

GetPDFUADiagnostics فحوصات مماثلة لـ PDF/UA (ISO 14289-1) على المستند في الذاكرة قيد البناء حاليًا، بدلًا من ملف خارجيعند إنتاج إخراج PDF/A بهذه المكتبة استدعِ

SetPDFAMode قبل إضافة أي محتوى. يحجب الحارس في جانب التوليد داخل SetPDFAMode العمليات المحظورة من الجزء المختار، لذا فإن المستند المبني بهذه الطريقة يجتاز عادةً CheckFileCompliance تلقائيًا

مثال

// Validate a delivered PDF/A file and print all issues
var
  Issues, Count, I: Integer;
begin
  Issues := PDF.CheckFileCompliance('archive.pdf', '', 1, 0);
  if Issues = 0 then
    WriteLn('archive.pdf: PDF/A conformant')
  else
  begin
    Count := PDF.GetStringListCount(Issues);
    WriteLn('archive.pdf: ', Count, ' PDF/A issue(s) detected:');
    for I := 1 to Count do
      WriteLn('  ', PDF.GetStringListItem(Issues, I));
  end;
end;

// Fast pass/fail gate in a CI pipeline — stop on the first issue
var
  Failed: Boolean;
begin
  Failed := PDF.CheckFileCompliance('build/output.pdf', '', 1, 1) <> 0;
  if Failed then
    Halt(1);
end;

انظر أيضًا

Preflight Reports, CreatePreflightReport, CreatePreflightReportEx, SavePreflightReport, SavePreflightReportEx, ComparePreflightReports, SetPDFAMode, GetPDFUADiagnostics, GetStringListCount, GetStringListItem, SetPDFUAMode

فحص الامتثال 3 يراجع PDF/X (ISO 15930): تعريف الإصدار ونية الإخراج وهندسة الصفحة والخطوط المضمنة ومجموعة الميزات المحظورة؛ ولـ PDF/X-6 يتحقق أيضًا من أعلام التعليقات والمظاهر الثابتة ومظاهر AcroForm والتوقيع واستثناءات XFA ومظاهر مولدة من العارض وموضع الإجراءات وسلاسلها ومجموعة الإجراءات المسمية المسموح بها وكل قيمة UseBlackPtComp

فحص الامتثال 4 يراجع بيانات تعريف تعريف PDF/VT-3 وأساسه من عائلة PDF/X-6 وشجرة DPartRoot وDPart وأسماء DPM وقيمها ومستوى السجل وترتيب الصفحات وتغطية الأوراق الدقيقة؛ وتتشارك فحوص التأليف تمريرة محلل واحدة

فحص الامتثال 5 يراجع موضع وسم PDF/R-1 والإصدار والتشفير وكائنات غير مباشرة من الجيل صفر والقواميس والمرشحات المقيدة وبرامج صفحات أحادية التدفق وشرائح نقطية مرتبة وترميزات الصور وتغطية الصفحة والدقة الفعلية؛ ويمكنه إعادة استخدام تحليل خط تحقق مشترك

فحص الامتثال 6 يراجع أساس PDF/X وتعريف XMP لـ PDF/VCR-1 والجذر القالب المباشر المفرد والحقول المعلنة وحقل اختيار الصفحات الاختياري وكل موضع نائب إحلال PassThrough في الأوراق وربط الصفحات وMCID ومربع الإحاطة؛ ويمكنه إعادة استخدام تحليل خط تحقق مشترك

فحص الامتثال 7 يراجع تعريف PDF/E-1 وبيانات تعريف دورة الحياة ومعرفات trailer والتشفير المسموح ونوايا الإخراج وفضاءات ألوان الأجهزة ومعاملات المحتوى والخطوط والتعليقات والنماذج والمحتوى الاختياري والإجراءات ومراجع الملفات الخارجية وحالات الرسومات وقيود تدفقات 3D؛ ويمكنه إعادة استخدام تحليل خط تحقق مشترك