← All types
ProductionOb Object

PreflightReport

The exact PrepressKit preflight analysis result

Fields

Overall verdict: PASS (clean), WARNING, or FAIL (error-severity findings)

Possible values (3)
PASS

No finding worse than INFO was raised. Informational findings may still be present — only WARNING and ERROR move the verdict.

WARNING

At least one WARNING finding and no ERROR. The file is usable but something needs a human decision before it goes to press.

FAIL

At least one ERROR finding. The verdict is the worst severity present, so a single error fails the document however many rules passed.

pageCount

Int!Non-null

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

passed

Boolean!Non-null

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
}