Preflight Reports
Vaatimustenmukaisuus, asiakirjojen tarkastus, automaatio
Yleiskatsaus
PDF Library for Delphi voi ajaa sisäänrakennetut PDF/A- ja PDF/UA-1-tiedostovaatimustenmukaisuustarkistuksensa ulkoista PDF:iä vasten ja muuttaa tuloksen uudelleenkäytettäväksi raporttitulosteeksi. Käytä raportti-API:ita, kun sovellus tai rakennusputki tarvitsee samat diagnostiikat kuin CheckFileCompliance mutta ei halua hallita merkkijonoluettelokahvoja suoraan
Raporttiputki on tarkoituksella kerroksellinen. CheckFileCompliance pysyy matalan tason API:na, joka palauttaa ongelmaluettelokahvoja. CreatePreflightReport muotoilee valitut tarkistukset vakaaksi tavallisen tekstin kappaleeksi. CreatePreflightReportEx muuntaa saman tekstriaportin tekstiksi, JSONiksi, HTMLiksi tai CSV:ksi, joten kaikilla muodoilla on sama läpäisy/epäonnistuminen -tila ja ongelmamäärä
Kirjaston API:t
| CheckFileCompliance | Suorittaa yhden valitun vaatimustenmukaisuustarkistuksen PDF-tiedostolle ja palauttaa 0 hyväksytylle tai StringListIDn, joka sisältää ongelmarivit. |
|---|---|
| CreatePreflightReport | Ajaa PDF/A-, PDF/UA-1- tai molemmat tarkistukset ja palauttaa tavallisen tekstin raportin otsikkometatiedoilla, yhdellä osiolla kutakin tarkistusta kohden ja loppuyhteenvedolla |
| CreatePreflightReportEx | Palauttaa saman raportin teksti- (0), JSON- (1), HTML- (2) tai CSV-muodossa (3). Tuntemattomat muotoarvot palaen tekstiin |
| SavePreflightReport | Kirjoittaa tavallisen tekstin raportin UTF-8:na ja luo ylähakemiston tarvittaessa |
| SavePreflightReportEx | Kirjoittaa teksti-, JSON-, HTML- tai CSV-raportin UTF-8:na ja luo ylähakemiston tarvittaessa |
| ComparePreflightReports | Vertaa kahta selkokielistä raporttia, ohittaa vaihtelevat Generated:-aikaleimarivit ja palauttaa tiivistetyn diffin vain, kun vakaa sisältö on muuttunut. |
Muotosopimus
| Text | Kanoninen raporttikappale. Se sisältää kentät Generated, Input, Checks, Issue mode, yhden osion kutakin valittua tarkistusta kohden ja Summary-lohkon arvoilla Total issues ja Result |
|---|---|
| JSON | Yksi objekti, jossa on kentät title, generated, input, checks, issueMode, sections ja summary. Jokaisessa osiossa on nimi, tila ja ongelmarkijonojen taulukko. |
| HTML | Erillinen UTF-8 HTML-asiakirja. Tekstriaportti escapetetaan HTMLiin ja näytetään esimuotoillussa lohkossa, jolloin raportin sisältö on näkyvissä ilman että sitä tulkitaan merkinnäksi |
| CSV | Rivit käyttävät kiinteitä sarakkeita kind,section,status,code,message. meta-rivit kantavat otsikkokenttiä, check-rivit PASS/FAIL-osiotilan, issue-rivit erottavat numeeriset ongelmakoodit viesteistä, ja summary-rivit kantavat lopulliset määrät |
Vaatimustenmukaisuuden valinta
Raportti-API:t käyttävät bittimaskia ComplianceTestsille: 1 valitsee PDF/A:n, 2 valitsee PDF/UA-1:n ja 3 valitsee molemmat. Arvon 0 antaminen ajaa myös molemmat tarkistukset. Options käyttää tällä hetkellä bittiä 1 pysähtyäkseen kunkin valitun tarkistuksen ensimmäiseen ongelmaan; anna arvo 0 kerätäksesi kaikki raportoidut ongelmat
Command-Line Demo
Delphin PreflightReport-konsolidemo näyttää raporttityönkulun lisäämättä sovelluskohtaista käyttöliittymää. Se voi validoida yhden PDF:n, tuottaa muotoiltua tulostetta, vertailla uutta tekstriaporttia perustilaan tai käsitellä hakemiston eräajona
PreflightReport.exe --input "C:\PDFs\invoice.pdf" --output "C:\Reports\invoice.preflight.txt"
PreflightReport.exe --input "C:\PDFs\invoice.pdf" --output "C:\Reports\invoice.preflight.json" --json
PreflightReport.exe --input "C:\PDFs\invoice.pdf" --output "C:\Reports\invoice.preflight.csv" --format csv
PreflightReport.exe --input "C:\PDFs\invoice.pdf" --output "C:\Reports\invoice.preflight.txt" --compare "C:\Baselines\invoice.preflight.txt"
PreflightReport.exe --input-dir "C:\PDFs" --output-dir "C:\Reports" --recursive --format htmlYksitiedostotila palauttaa poistumiskoodin 0, kun valitut tarkistukset raportoivat ei ongelmia, koodin 1 komentorivi- tai ajoaikavirheistä ja koodin 2, kun mikä tahansa ongelma raportoidaan tai perustilavertailu eroaa. Hakemistotila kirjoittaa yhden <basename>.preflight.<ext>-tiedoston per PDF ja lisää tiedoston preflight-summary.csv, jossa on lähtepolku, läpäisy/epäonnistuminen -tila, ongelmamäärä ja raporttipolku
Comparison Notes
Funktio ComparePreflightReports on määritelty tavallisen tekstin raporteille. Sille pitää antaa perustilan tekstriaportti ja uusi tuotettu tekstriaportti, vaikka saman ajon ihmisiä varten tarkoitettu tuloste olisi JSONia, HTMLia tai CSV:ia. Vertailija normalisoi Generated:-rivit, koska aikaleimat muuttuvat jokaisella ajolla; kaikki muut vakait rivit vertaillaan järjestyksessä pienellä katseetuikkunalla, jotta lisäys- ja poistorivien diffit pysyvät luettavina
Katso myös
CheckFileCompliance, CreatePreflightReport, CreatePreflightReportEx, SavePreflightReport, SavePreflightReportEx, ComparePreflightReports, GetPDFUADiagnostics