CheckFileComplianceA

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

الوصف

الحرف المُلحق A يُشير إلى نقطة دخول ANSI (char) في DLL؛ بينما تكشف واجهة ActiveX/COM الشكل Unicode فقط. السلوك مطابق لـ CheckFileCompliance وتُفسَّر وسائط السلاسل النصية باستخدام صفحة الرموز الحالية لـ SetAnsiMode

يقرأ ملف 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 DLCheckFileComplianceA(InstanceID: Integer; InputFileName, Password: PAnsiChar; ComplianceTest, Options: Integer): Integer;

DLL

int DLCheckFileComplianceA(int InstanceID, const char * InputFileName, const char * Password, int ComplianceTest, int Options);

المعاملات

قيم الإرجاع

PDF/A issue codes (ComplianceTest = 1)

PDF/UA-1 issue codes (ComplianceTest = 2)

ملاحظات

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

تجري الواجهة المرافقة GetPDFUADiagnostics فحوصًا مماثلة لـ PDF/UA-1‏ (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