CheckFileComplianceA

Conformité, inspection de documents

Description

Le A final indique le point d’entrée ANSI (char) de la DLL ; la surface ActiveX/COM n’expose que la forme Unicode. Le comportement est identique à celui de CheckFileCompliance et les arguments de chaîne sont interprétés selon la page de codes SetAnsiMode actuelle

Lit un fichier PDF externe et le valide selon une norme ISO choisie. La valeur renvoyée est soit zéro (le fichier réussit entièrement le contrôle), soit un handle StringListID non nul répertoriant tous les problèmes détectés. Chaque élément comporte un code court, deux-points et un message lisible — exactement le même format de code que celui de GetPDFUADiagnostics. Parcourez le résultat avec GetStringListCount et GetStringListItem

Le test PDF/A couvre les six modes de conformité (PDF/A-1a, PDF/A-1b, PDF/A-2a, PDF/A-2b, PDF/A-3a, PDF/A-3b) et lit les entrées XMP pdfaid:part/pdfaid:conformance pour déterminer le jeu de règles à appliquer

Le test PDF/UA-1 (ajouté dans v3.56.0) vérifie un PDF externe par rapport à ISO 14289-1 et émet des codes de diagnostic dans la plage 10xxx, de sorte qu’ils restent visuellement distincts des codes PDF/A 00xxx

Syntaxe

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

Paramètres

Valeurs de retour

Codes de problème PDF/A (ComplianceTest = 1)

Codes de problème PDF/UA-1 (ComplianceTest = 2)

Remarques

Le test PDF/A est un autocontrôle rapide avant livraison. Il détecte les problèmes de document immédiatement rédhibitoires : mauvaise version PDF, OutputIntent absent, arbre de structure absent au niveau A, chiffrement ou calques en PDF/A-1. Il ne parcourt pas chaque opérateur de flux de contenu et ne vérifie pas l’incorporation des polices ni les espaces colorimétriques de chaque objet peint — ces contrôles exigent un validateur spécialisé tel que veraPDF. Utilisez-le comme premier contrôle et garde de régression. Utilisez CreatePreflightReport ou SavePreflightReport pour obtenir un rapport texte réutilisable, CreatePreflightReportEx ou SavePreflightReportEx pour les formats texte, JSON, HTML ou CSV, ou consultez Preflight Reports pour le flux complet

L’API complémentaire GetPDFUADiagnostics effectue des contrôles analogues de PDF/UA-1 (ISO 14289-1) sur le document en mémoire en cours de création, plutôt que sur un fichier externe

Pour produire une sortie PDF/A avec cette bibliothèque, appelez SetPDFAMode avant tout contenu. La protection de génération de SetPDFAMode bloque les opérations interdites par la partie choisie ; un document ainsi construit réussit donc normalement CheckFileCompliance automatiquement

Exemple

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

Voir aussi

Rapports de contrôle, CreatePreflightReport, CreatePreflightReportEx, SavePreflightReport, SavePreflightReportEx, ComparePreflightReports, SetPDFAMode, GetPDFUADiagnostics, GetStringListCount, GetStringListItem, SetPDFUAMode