CreatePreflightReport
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
Crée un rapport de contrôle en texte brut pour un fichier PDF externe en exécutant les contrôles existants de conformité PDF/A et PDF/UA-1 et en réunissant leurs résultats dans un corps de rapport réutilisable. Cette API pratique convient lorsqu’une application souhaite un rapport lisible sans appeler manuellement CheckFileCompliance, GetStringListCount, GetStringListItem et ReleaseStringList
Syntaxe
Delphi
Function TPDFlib.CreatePreflightReport(Const InputFileName, Password: WideString; ComplianceTests, Options: Integer): WideString;Paramètres
| InputFileName | Chemin complet du fichier PDF à valider Le fichier est ouvert en lecture seule et n'est pas modifié |
|---|---|
| Password | Mot de passe utilisé pour ouvrir le fichier Transmettez une chaîne vide pour les documents non chiffrés |
| ComplianceTests | Masque de bits des contrôles à inclure. 1 — PDF/A. 2 — PDF/UA-1. 3 — les deux. Transmettre 0 exécute aussi les deux contrôles |
| Options | Indicateurs binaires transmis à chaque contrôle sous-jacent. 0 — Signaler tous les problèmes de chaque contrôle. 1 — Arrêter chaque contrôle au premier problème |
Valeur de retour
Renvoie un rapport UTF-16 contenant l'en-tête, une section par contrôle sélectionné et un résumé final avec les lignes Total issues et Result
Remarques
Lorsque plusieurs normes sont sélectionnées, le fichier n'est analysé qu'une fois et les audits partagent lecteur, état de sécurité, graphe d'objets et cache paresseux
L’API de rapport ne remplace pas un validateur PDF/A externe dédié. Elle rassemble les diagnostics PDF/A et PDF/UA-1 intégrés dans un rapport stable. Utilisez CreatePreflightReportEx pour le texte, JSON, HTML ou CSV, et CheckFileCompliance pour obtenir les handles individuels de listes de problèmes
Le rapport en texte brut est la source canonique de chaque rapport formaté. Il contient les métadonnées volatiles Generated:, un chemin Input:, les contrôles sélectionnés, le mode de collecte, une section par test de conformité et un résumé final avec Total issues et Result
Pour les flux de travail en ligne de commande et de rapports par lot, consultez Preflight Reports
Exemple
var
Report: WideString;
begin
Report := PDF.CreatePreflightReport('output.pdf', '', 1 or 2, 0);
WriteLn(Report);
end;Voir aussi
Rapports de contrôle, CreatePreflightReportEx, SavePreflightReport, ComparePreflightReports, CheckFileCompliance, GetPDFUADiagnostics, SetPDFAMode, SetPDFUAMode