CheckFileCompliance

규격 준수, 문서 검사

PDF/UA 리더 프로필 선택

PDF/UA 검사는 XMP가 pdfuaid:part=2를 식별할 때 part 2를 선택하고 그 외에는 part 1 검사를 유지합니다. 여기 설명된 구형 PDF/UA-1 검사가 part 2에 적용된다는 뜻은 아닙니다

PDF/UA-2 프로필은 핵심 식별, 네임스페이스, 역할, 구조 검사를 구현합니다. 구조화된 보고서는 PDF/UA-2와 ISO 14289-2를 사용하며 fullCertification=false와 검증되지 않은 범위를 밝힙니다

대상 part를 강제하려면 CheckFilePDFUACompliance나 RunPDFUAValidationPipelineTask를, 기능 한도를 살펴보려면 GetPDFUAReadValidationCoverageJSON을 사용하십시오

설명

외부 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 항목을 읽습니다PDF/UA-1 검사(v3.56.0에서 추가됨)는 외부 PDF를 ISO 14289-1에 대해 검사하며 PDF/A

10xxx 코드와 시각적으로 구분되도록 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)가 필요합니다. 이 함수를 1차 검사와 빌드 파이프라인의 회귀 관문으로 사용하십시오. 라이브러리가 문제 목록을 재사용 가능한 텍스트 보고서로 만들게 하려면 CreatePreflightReport나 SavePreflightReport를 사용하십시오. 텍스트, JSON, HTML, CSV 보고서 출력에는 CreatePreflightReportEx나 SavePreflightReportEx를 사용하거나 전체 보고서 워크플로는 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 마커 배치, 버전과 암호화, 세대 0 간접 객체, 제한된 딕셔너리와 필터, 단일 스트림 페이지 프로그램, 순서가 있는 래스터 스트립, 이미지 인코딩, 페이지 커버리지, 실효 해상도를 감사합니다. 공유 검증 파이프라인 파싱을 재사용할 수 있습니다

컴플라이언스 테스트 6은 PDF/X 기반과 PDF/VCR-1 XMP 식별, 단일 직접 템플릿 루트, 선언된 필드, 선택적 페이지 선택 필드, 모든 리프 PassThrough 대체 플레이스홀더, 페이지 바인딩, MCID와 경계 상자를 감사합니다. 공유 검증 파이프라인 파싱을 재사용할 수 있습니다

컴플라이언스 테스트 7은 PDF/E-1 식별과 라이프사이클 메타데이터, 트레일러 식별자, 허용되는 암호화, 출력 인텐트와 장치 색 공간, 콘텐츠 연산자, 폰트, 주석, 폼, 옵셔널 콘텐츠, 액션, 외부 파일 참조, 그래픽 상태, 3D 스트림 제한을 감사합니다. 공유 검증 파이프라인 파싱을 재사용할 수 있습니다