CheckFileCompliance

Conformité, inspection de documents

Sélection du profil de lecteur PDF/UA

Les contrôles PDF/UA sélectionnent la partie 2 lorsque le XMP identifie pdfuaid:part=2 et conservent sinon les contrôles de la partie 1 ; les contrôles PDF/UA-1 historiques décrits ici ne sont nullement implicites pour la partie 2

Le profil PDF/UA-2 implémente les contrôles de base d’identification, d’espaces de noms, de rôles et de structure ; les rapports structurés utilisent PDF/UA-2 et ISO 14289-2 et indiquent fullCertification=false ainsi que le périmètre non vérifié

Utilisez CheckFilePDFUACompliance ou RunPDFUAValidationPipelineTask pour forcer une partie cible, et GetPDFUAReadValidationCoverageJSON pour inspecter les limites de capacités

Description

Lit un fichier PDF externe et le valide par rapport à une norme de conformité ISO choisie. La valeur renvoyée vaut soit zéro (le fichier passe proprement le test choisi), soit un handle StringListID non nul qui recense chaque anomalie détectée. Chaque entrée de la liste est un code court, deux-points, et un message lisible — exactement le même format de code que celui utilisé par GetPDFUADiagnostics. Énumérez le résultat avec GetStringListCount et GetStringListItemLe 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écider quel jeu de règles appliquerLe test PDF/UA-1 (ajouté en v3.56.0) vérifie un PDF externe par rapport à ISO 14289-1 et émet des codes de diagnostic dans la plage

10xxx afin qu'ils restent visuellement séparés des codes PDF/A 00xxx

Syntaxe

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

Paramètres

Valeurs de retour

Codes d'anomalie PDF/A (ComplianceTest = 1)

Codes d'anomalie PDF/UA-1 (ComplianceTest = 2)

Remarques

Le test PDF/A est conçu comme une vérification automatique rapide avant livraison. Il repère les anomalies au niveau du document qui disqualifient d'emblée un fichier (version PDF erronée, OutputIntent absent, arborescence de structure absente au niveau A, chiffrement, calques en PDF/A-1). Il ne parcourt pas chaque opérateur de flux de contenu et ne vérifie ni l'incorporation des polices ni les références d'espaces colorimétriques de chaque objet peint — ces validations requièrent un validateur PDF/A dédié (tel que veraPDF). Utilisez cette fonction comme contrôle de première ligne et comme barrière de régression dans les pipelines de build. Utilisez CreatePreflightReport ou SavePreflightReport lorsque vous voulez que la bibliothèque mette en forme les listes d'anomalies dans un rapport texte réutilisable. Utilisez CreatePreflightReportEx ou SavePreflightReportEx pour une sortie de rapport en texte, JSON, HTML ou CSV, ou consultez Preflight Reports pour le workflow de rapport completL'API associée

GetPDFUADiagnostics effectue des contrôles analogues pour PDF/UA (ISO 14289-1) sur le document en mémoire en cours de construction, plutôt que sur un fichier externeLorsque vous produisez une sortie PDF/A avec cette bibliothèque, appelez

SetPDFAMode avant d'ajouter du contenu. Le garde-fou côté génération intégré à SetPDFAMode bloque les opérations interdites par la partie choisie, si bien qu'un document construit ainsi passera 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

Preflight Reports, CreatePreflightReport, CreatePreflightReportEx, SavePreflightReport, SavePreflightReportEx, ComparePreflightReports, SetPDFAMode, GetPDFUADiagnostics, GetStringListCount, GetStringListItem, SetPDFUAMode

Le test de conformité 3 audite PDF/X (ISO 15930) : identification d'édition, intention de sortie, géométrie de page, polices incorporées et l'ensemble des fonctionnalités interdites ; pour PDF/X-6, il valide aussi les indicateurs d'annotations et les apparences fixes, les apparences AcroForm et signature, les exclusions XFA et d'apparences générées par la visionneuse, le placement des actions, les chaînes d'actions, l'ensemble des actions nommées permises et chaque valeur UseBlackPtComp

Le test de conformité 4 audite les métadonnées d'identification PDF/VT-3, sa base de la famille PDF/X-6, le graphe DPartRoot et DPart, les noms et valeurs DPM, le niveau d'enregistrement, l'ordre des pages et la couverture exacte des feuilles ; les vérifications composées partagent une passe d'analyseur

Le test de conformité 5 audite le placement des marqueurs PDF/R-1, la version et le chiffrement, les objets indirects de génération zéro, les dictionnaires et filtres restreints, les programmes de page à flux unique, les bandes raster ordonnées, les codages d'image, la couverture de pages et la résolution effective ; il peut réutiliser une passe d'analyse de pipeline de validation partagée

Le test de conformité 6 audite la fondation PDF/X et l'identification XMP PDF/VCR-1, la racine de modèle directe unique, les champs déclarés, le champ de sélection de pages optionnel et chaque espace réservé de remplacement PassThrough de feuille, la liaison de pages, les MCID et les boîtes englobantes ; il peut réutiliser une passe d'analyse de pipeline de validation partagée

Le test de conformité 7 audite l'identification et les métadonnées de cycle de vie PDF/E-1, les identifiants de trailer, le chiffrement permis, les intentions de sortie et les espaces colorimétriques de périphérique, les opérateurs de contenu, les polices, les annotations, les formulaires, le contenu optionnel, les actions, les références à des fichiers externes, les états graphiques et les restrictions de flux 3D ; il peut réutiliser une passe d'analyse de pipeline de validation partagée