CreatePreflightReportEx
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 préalable pour un fichier PDF externe et le convertit au format demandé. Il s’agit du complément sensible au format de CreatePreflightReport, qui renvoie toujours le rapport en texte brut
Syntaxe
Delphi
Function TPDFlib.CreatePreflightReportEx(Const InputFileName, Password: WideString; ComplianceTests, Options, ReportFormat: 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 sélectionnant les contrôles à inclure : 1 pour PDF/A, 2 pour PDF/UA, 3 ou 0 pour les deux |
| Options | Indicateurs binaires transmis à chaque contrôle de conformité sélectionné. Transmettez 1 pour arrêter chaque contrôle après son premier problème |
| ReportFormat | Sélecteur de format de sortie 0 — texte brut 1 — objet JSON avec en-tête, sections par contrôle, tableaux de problèmes et résumé 2 — document HTML autonome contenant le rapport échappé 3 — lignes CSV de métadonnées, contrôles, codes, messages et résumé final |
Valeur de retour
Renvoie le rapport généré dans le format sélectionné. Les valeurs ReportFormat inconnues utilisent par défaut le format texte brut
Remarques
Les formats JSON, HTML et CSV sont générés depuis le même rapport texte que CreatePreflightReport ; l'état réussite/échec et le nombre de problèmes restent donc cohérents
L’objet JSON expose les champs d’en-tête, un tableau sections, des tableaux de problèmes et un objet summary. La forme HTML est un document autonome avec le rapport échappé dans un bloc préformaté. La forme CSV utilise les colonnes fixes kind,section,status,code,message et sépare métadonnées, états, problèmes et résumé
Pour le contrat complet du format de rapport et des exemples de ligne de commande de démonstration, consultez Rapports de contrôle en amont
Exemple
JsonReport := PDF.CreatePreflightReportEx('output.pdf', '', 1 or 2, 0, 1);
HtmlReport := PDF.CreatePreflightReportEx('output.pdf', '', 1 or 2, 0, 2);
CsvReport := PDF.CreatePreflightReportEx('output.pdf', '', 1 or 2, 0, 3);Voir aussi
Rapports de contrôle, CreatePreflightReport, SavePreflightReportEx, ComparePreflightReports, CheckFileCompliance