CheckFileComplianceA

규정 준수, 문서 검사

설명

끝의 A는 ANSI(char) DLL 진입점을 나타내며 ActiveX/COM 표면은 Unicode 형식만 노출합니다. 동작은 CheckFileCompliance와 동일하고 문자열 인수는 현재 SetAnsiMode 코드 페이지를 사용해 해석됩니다

외부 PDF 파일을 읽고 선택한 ISO 적합성 표준에 따라 검증합니다 반환값은 0(파일이 선택한 검사를 문제없이 통과함) 또는 감지된 모든 문제를 나열하는 0이 아닌 StringListID 핸들입니다 목록의 각 항목은 짧은 코드, 콜론 및 사람이 읽을 수 있는 메시지로 구성되며 GetPDFUADiagnostics에서 사용하는 코드 형식과 정확히 같습니다 GetStringListCount 및 GetStringListItem으로 결과를 열거합니다

PDF/A 테스트는 여섯 가지 적합성 모드(PDF/A-1a, PDF/A-1b, PDF/A-2a, PDF/A-2b, PDF/A-3a, PDF/A-3b)를 모두 다루며 pdfaid:part/pdfaid:conformance XMP 항목을 읽어 적용할 규칙 집합을 결정합니다

v3.56.0에 추가된 PDF/UA-1 테스트는 외부 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 문제 코드(ComplianceTest = 1)

PDF/UA-1 문제 코드(ComplianceTest = 2)

비고

PDF/A 테스트는 전송 전 빠른 자체 검사용입니다. 파일을 즉시 부적격하게 만드는 문서 수준 문제(잘못된 PDF 버전, 누락된 OutputIntent, A 수준에서 누락된 구조 트리, 암호화, PDF/A-1의 계층)를 감지합니다. 모든 콘텐츠 스트림 연산자를 순회하거나 각 페인트 객체의 글꼴 포함 또는 색상 공간 참조를 검증하지는 않습니다. 이러한 검증에는 veraPDF 같은 전용 PDF/A 검증기가 필요합니다. 이 함수를 1차 검사 및 빌드 파이프라인의 회귀 게이트로 사용하세요. 라이브러리가 문제 목록을 재사용 가능한 텍스트 보고서로 만들게 하려면 CreatePreflightReport 또는 SavePreflightReport를 사용하세요. 텍스트, JSON, HTML 또는 CSV 보고서 출력에는 CreatePreflightReportEx 또는 SavePreflightReportEx를 사용하거나 전체 보고서 워크플로는 Preflight Reports를 참조하세요

보조 API 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;

참고 항목

프리플라이트 보고서, CreatePreflightReport, CreatePreflightReportEx, SavePreflightReport, SavePreflightReportEx, ComparePreflightReports, SetPDFAMode, GetPDFUADiagnostics, GetStringListCount, GetStringListItem, SetPDFUAMode