CheckFileComplianceA

Conformidad, inspección de documentos

Descripción

El sufijo A indica el punto de entrada ANSI (char) de la DLL; la superficie ActiveX/COM expone únicamente la forma Unicode. El comportamiento es idéntico a CheckFileCompliance y los argumentos de cadena se interpretan utilizando la página de códigos SetAnsiMode actual

Lee un archivo PDF externo y lo valida conforme al estándar ISO elegido. El valor devuelto es cero (el archivo supera limpiamente la prueba elegida) o un identificador StringListID distinto de cero que enumera todos los problemas detectados. Cada entrada de la lista consta de un código breve, dos puntos y un mensaje legible — exactamente el mismo formato de código que utiliza GetPDFUADiagnostics. Recorra el resultado con GetStringListCount y GetStringListItem

La prueba PDF/A abarca los seis modos de conformidad (PDF/A-1a, PDF/A-1b, PDF/A-2a, PDF/A-2b, PDF/A-3a, PDF/A-3b) y lee las entradas XMP pdfaid:part/pdfaid:conformance para decidir qué conjunto de reglas aplicar

La prueba PDF/UA-1 (añadida en v3.56.0) comprueba ISO 14289-1 y emite códigos 10xxx separados visualmente de los PDF/A 00xxx

Sintaxis

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);

Parámetros

Valores devueltos

Códigos de incidencia de PDF/A (ComplianceTest = 1)

Códigos de incidencia de PDF/UA-1 (ComplianceTest = 2)

Observaciones

La prueba PDF/A es una comprobación rápida previa: detecta versión, OutputIntent, estructura de nivel A, cifrado y capas PDF/A-1. No valida cada operador, fuente o espacio; para ello use un validador dedicado. Para informes use CreatePreflightReport, SavePreflightReport, CreatePreflightReportEx, SavePreflightReportEx o Informes de comprobación previa

La API complementaria GetPDFUADiagnostics realiza comprobaciones análogas de PDF/UA-1 (ISO 14289-1) en el documento en memoria que se está creando, en lugar de hacerlo en un archivo externo

Al generar una salida PDF/A con esta biblioteca, llame a SetPDFAMode antes de añadir contenido. La protección durante la generación incluida en SetPDFAMode bloquea las operaciones prohibidas por la parte elegida, por lo que un documento creado de ese modo normalmente superará CheckFileCompliance de forma automática

Ejemplo

// 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;

Véase también

Informes de comprobación preliminar, CreatePreflightReport, CreatePreflightReportEx, SavePreflightReport, SavePreflightReportEx, ComparePreflightReports, SetPDFAMode, GetPDFUADiagnostics, GetStringListCount, GetStringListItem, SetPDFUAMode