PreflightReport
The exact PrepressKit preflight analysis result
Fields
Overall verdict: PASS (clean), WARNING, or FAIL (error-severity findings)
Possible values (3)
PASSNo finding worse than INFO was raised. Informational findings may still be present — only WARNING and ERROR move the verdict.
WARNINGAt least one WARNING finding and no ERROR. The file is usable but something needs a human decision before it goes to press.
FAILAt least one ERROR finding. The verdict is the worst severity present, so a single error fails the document however many rules passed.
Number of pages in the document
File size in bytes (string; GraphQL Int is 32-bit)
Pages successfully analysed (≤ pageCount). A page that fails to render is reported as a structural issue and excluded here.
PDF version from the file header, e.g. "1.7"
The /Producer string — the library that wrote the PDF; empty when absent
Name of the preflight profile the document was analysed against
True only when status is PASS — i.e. no errors and no warnings
Every finding raised by the profile, at any severity
The full forensic document inventory, produced regardless of verdict
Which profile and engine version produced this report, and when
PDF/X conformance verdict; null unless a PDF/X profile was used (PDF_X1A / PDF_X3 / PDF_X4 / PDF_X_CLAIMED)
Referenced by (2)
Exact type SDL
"""The exact PrepressKit preflight analysis result"""
type PreflightReport {
"""
Overall verdict: PASS (clean), WARNING, or FAIL (error-severity findings)
"""
status: PreflightStatus!
"""Number of pages in the document"""
pageCount: Int!
"""File size in bytes (string; GraphQL Int is 32-bit)"""
fileSize: String!
"""
Pages successfully analysed (≤ `pageCount`). A page that fails to render is reported as a structural issue and excluded here.
"""
pagesAnalyzed: Int!
"""
PDF version from the file header, e.g. "1.7"
"""
pdfVersion: String!
"""
The `/Producer` string — the library that wrote the PDF; empty when absent
"""
producer: String!
"""Name of the preflight profile the document was analysed against"""
profileUsed: String!
"""True only when `status` is PASS — i.e. no errors and no warnings"""
passed: Boolean!
"""Every finding raised by the profile, at any severity"""
issues: [PreflightIssue!]!
"""The full forensic document inventory, produced regardless of verdict"""
inventory: DocumentInventory!
"""Which profile and engine version produced this report, and when"""
provenance: RunProvenance!
"""
PDF/X conformance verdict; null unless a PDF/X profile was used (PDF_X1A / PDF_X3 / PDF_X4 / PDF_X_CLAIMED)
"""
conformance: ConformanceVerdict
}