← All types
Ob Object

ProductionReportState

Production observation. May be partner-sourced, manual, or system-generated; binding refs are optional.

Fields

Immutable output-only correction referencing an original accepted report; mutually exclusive with acceptance. Use productionOutputBalance to discover all direct corrections and effective quantities.

Immutable accepted physical inputs and outputs; null for observation-only reports.

TypeID of the production report (prr_…). Stable for the lifetime of the row.

name

StringNullable

Display name.

Source integration that produced the report.

userId

UserIDNullable

User associated with this report (typically the operator on duty).

Free-form operator identifier from the source system, when no user maps to it.

jobId

JobIDNullable

Binding ref: TypeID of the Job this report was produced for (job_…). Null until the report is bound; only the binding mutation may set it.

Binding ref: TypeID of the Component this report was produced for (cmp_…). Null until the report is bound.

Binding ref: TypeID of the Operation the report describes (opr_…). Null until the report is bound.

Binding ref: TypeID of the OperationItem the report describes (opi_…). Null until the report is bound.

Binding ref: TypeID of the WorkCenter (machine/cell) the output came from (wcr_…). Null until the report is bound.

When the report was bound to canonical entities (ISO8601).

How the binding refs were established (ingested / manual / auto). Null while the report is still unbound.

Possible values (3)
INGESTED

Arrived already bound — operation refs were known at write time.

MANUAL

A human bound it via mutation.

AUTO

A binding rule resolved it automatically.

True iff no binding refs are set.

Binding-grade external references from the source system, used by the binding mutation to resolve this report against canonical entities. Null when the source supplied none.

Partner-internal grouping keys as a JSON object (key → value strings).

When the reported run began (ISO8601). Null when the source system reported counts without timing.

When the reported run finished (ISO8601). Null for a run that is still open or for a source that reported no timing.

Engaged production time in seconds — machine actually running. Distinct from the endedAt - startedAt wall clock, which can include pauses.

Waste produced by this run in countUnit. Null when the source did not report it.

The part of wasteCount produced during setup (makeready); run waste is the remainder. Null when the source did not split it.

True when the report is the final statement of the run. Final reports cannot be edited; a later revision supersedes them.

Earlier report this revision replaces, or null for the first report of the run.

The source's identifier for this record, or null when the report has no external identity.

Source revision of the imported snapshot.

Saleable output produced by this run in countUnit. Waste is reported separately when known.

Quantity the run was planned to produce, in countUnit — the denominator for completion against goodCount. Null when the source reported no plan.

Unit that goodCount and totalPlanned are counted in (e.g. sheets, metres). CUSTOM means the real unit name is in customCountUnit.

Possible values (39)
NONE

No unit

PERCENT

Percentage (0-100)

RATIO

Ratio (0.0-1.0)

BOOLEAN

Boolean (0 or 1)

COUNT

Generic count

PIECES

Discrete pieces/items

MILLIMETERS

Millimeters

METERS

Meters

INCHES

Inches

FEET

Feet

METERS_PER_MINUTE

Meters per minute

FEET_PER_MINUTE

Feet per minute

UNITS_PER_MINUTE

Units per minute (generic)

UNITS_PER_HOUR

Units per hour (generic)

CELSIUS

Degrees Celsius

FAHRENHEIT

Degrees Fahrenheit

KELVIN

Kelvin

BAR

Bar

PSI

Pounds per square inch

KILOPASCAL

Kilopascal

GRAMS

Grams

KILOGRAMS

Kilograms

POUNDS

Pounds

MILLILITERS

Milliliters

LITERS

Liters

SQUARE_METERS

Square meters

SQUARE_FEET

Square feet

MILLISECONDS

Milliseconds

SECONDS

Seconds

MINUTES

Minutes

HOURS

Hours

VOLTS

Volts

AMPS

Amperes

WATTS

Watts

KILOWATT_HOURS

Kilowatt-hours

BYTES

Bytes

KILOBYTES

Kilobytes

MEGABYTES

Megabytes

CUSTOM

Vertical-specific or user-defined unit — provide the unit name in customUnit

Vertical-specific count unit name, meaningful only when countUnit is CUSTOM. Null otherwise.

Mean production rate over the run, as a value plus its speed unit. Null when the source reported no speed.

Machine- or partner-defined error code raised during the run. Null for a run that reported no error.

Human-readable description of the error named by errorCode. Null when no error occurred.

How serious the reported error was. Null when no error occurred.

Possible values (4)
INFO

Informational notice

WARNING

Warning — production can continue

ERROR

Error — production impaired

FATAL

Fatal — production stopped

The kind of operation this report describes (e.g. printing, cutting). Determines which operationData paths are meaningful. Optional — partner reports may omit it, and it can be inferred from the bound operation later.

Possible values (44)
PRINT_OFFSET_SHEETFED

Offset Sheetfed Press

PRINT_OFFSET_WEB

Offset Web Press

PRINT_TONER_SHEETFED

Toner Sheetfed Press

PRINT_TONER_WEB

Toner Web Press

PRINT_INKJET_SHEETFED

Inkjet Sheetfed Press

PRINT_INKJET_WEB

Inkjet Web Press

PRINT_WIDE_FORMAT

Wide Format Printer

PRINTER_LARGE_FORMAT

Large Format Printer

REWINDING

Rewinding

BINDING_SADDLE_STITCH

Saddle Stitcher

BINDING_PERFECT

Perfect Binder

BINDING_WIRE_O

Wire-O Binder

BINDING_SPIRAL

Spiral/Coil Binder

BINDING_COMB

Comb Binder

FOLDING

Folder

FOLDER

Folder (Inline)

CUTTING

Cutter

CUTTER_THREE_KNIFE

Three-Knife Trimmer

COATING_LAMINATING

Laminator

COATING_FLOOD

Flood Coater

SPOT_UV_VARNISH

Spot UV Varnish

DIE_CUTTING

Die Cutter

SCORING_CREASING

Scoring/Creasing

PERFORATING

Perforator

DRILLING

Drill

PUNCHING

Punch

EMBOSS_DEBOSS

Embosser/Debosser

FOIL_STAMPING

Foil Stamper

COLLATING

Collator

SEWING

Sewing Machine

BOOK_BLOCK_MAKER

Book Block Maker

CASE_MAKING

Case Maker

CASING_IN

Casing-In Machine

ROUNDING_BACKING

Rounding & Backing

ENDPAPER_TIPPING

Endpaper Tipping

GLUING

Gluing

HEAD_BANDING

Head Banding

SPINE_MILLING

Spine Miller

CTP

Computer-to-Plate

PLATEMAKING

Platemaking

DRYING

Dryer (General)

DRYING_UV

UV Dryer

DRYING_IR

IR Dryer

PACKING

Packing

Whether this report describes real production output or a non-production run (setup, proof, calibration, test). Null means unspecified — treated as PRODUCTION by downstream filters.

Possible values (5)
PRODUCTION

Real production output. Default semantic when runKind is null.

SETUP

Press setup / makeready before a production run.

PROOF

Proof print for customer or operator approval.

CALIBRATION

Colour / density / register characterisation, no job-specific intent.

TEST

Catch-all non-production run (machine check, ink flush, training run).

Capability-keyed flat path map. Native JSON object with JSON-Pointer-style keys; numeric values are emitted as JSON numbers.

metadata

JSONNullable

Freeform integration metadata. Native JSON — numbers stay numbers, nested structures preserved verbatim.

When the report row was written (ISO8601). This is ingestion time, not production time — use startedAt for when the run actually happened.

When the row last changed (ISO8601). Payload columns are immutable after first write, so this only moves when the binding refs are set.

Consumption rows attached to this report (ink, substrate, …). Requires productionReport:read.

Fingerprint of the source snapshot the report was imported from, used to detect duplicates.

Location of the reported process within the source document, such as a JDF node path.

What the source snapshot covered, such as the process and output resource it reported.

Diagnostics recorded while interpreting the source; optional detail that cleanup may remove.

How the reported times were derived from the source; optional detail that cleanup may remove.

Retained copy of the source document, when tenant debugging retention kept one.

Width of the print run, with unit provenance preserved.

Length of the print run, with unit provenance preserved.

Total area printed.

Substrate display name as reported by the source.

Substrate type / material as reported by the source.

Substrate roll/sheet width.

Substrate roll/sheet length.

Substrate caliper / thickness.

Substrate basis weight.

FK to the typed Substrate catalog entry, when one was matched.

Horizontal print resolution (DPI). Read from operationData["/dpi/horizontal"].

Vertical print resolution (DPI). Read from operationData["/dpi/vertical"].

Number of print passes. Read from operationData["/passes"].

Print mode (vendor-specific string). Read from operationData["/mode"].

Bidirectional/unidirectional. Read from operationData["/direction"].

Color matching policy. Read from operationData["/colorPolicy"].

Ink-save method. Read from operationData["/saveInkMethod"].

Speed mode (vendor-specific string). Read from operationData["/speedMode"].

Referenced by (6)
Exact type SDL
"""
Production observation. May be partner-sourced, manual, or system-generated; binding refs are optional.
"""
type ProductionReportState {
  """
  Immutable output-only correction referencing an original accepted report; mutually exclusive with acceptance. Use productionOutputBalance to discover all direct corrections and effective quantities.
  """
  correction: ProductionCorrection
  """
  Immutable accepted physical inputs and outputs; null for observation-only reports.
  """
  acceptedPortion: ProductionAcceptedPortion
  """
  TypeID of the production report (`prr_…`). Stable for the lifetime of the row.
  """
  id: ProductionReportID!
  """Display name."""
  name: String
  """Source integration that produced the report."""
  integrationInstanceId: IntegrationInstanceID
  """User associated with this report (typically the operator on duty)."""
  userId: UserID
  """
  Free-form operator identifier from the source system, when no user maps to it.
  """
  operatorIdentifier: String
  """
  Binding ref: TypeID of the Job this report was produced for (`job_…`). Null until the report is bound; only the binding mutation may set it.
  """
  jobId: JobID
  """
  Binding ref: TypeID of the Component this report was produced for (`cmp_…`). Null until the report is bound.
  """
  componentId: ComponentID
  """
  Binding ref: TypeID of the Operation the report describes (`opr_…`). Null until the report is bound.
  """
  operationId: OperationID
  """
  Binding ref: TypeID of the OperationItem the report describes (`opi_…`). Null until the report is bound.
  """
  operationItemId: OperationItemID
  """
  Binding ref: TypeID of the WorkCenter (machine/cell) the output came from (`wcr_…`). Null until the report is bound.
  """
  workCenterId: WorkCenterID
  """When the report was bound to canonical entities (ISO8601)."""
  boundAt: ISO8601
  """
  How the binding refs were established (ingested / manual / auto). Null while the report is still unbound.
  """
  bindingMethod: ProductionReportBindingMethod
  """True iff no binding refs are set."""
  isUnbound: Boolean!
  """
  Binding-grade external references from the source system, used by the binding mutation to resolve this report against canonical entities. Null when the source supplied none.
  """
  externalRefs: [ExternalRef!]
  """Partner-internal grouping keys as a JSON object (key → value strings)."""
  groupingKeys: [Dictionary!]!
  """
  When the reported run began (ISO8601). Null when the source system reported counts without timing.
  """
  startedAt: ISO8601
  """
  When the reported run finished (ISO8601). Null for a run that is still open or for a source that reported no timing.
  """
  endedAt: ISO8601
  """
  Engaged production time in seconds — machine actually running. Distinct from the `endedAt - startedAt` wall clock, which can include pauses.
  """
  actualPrintingDurationSeconds: Float
  """
  Waste produced by this run in `countUnit`. Null when the source did not report it.
  """
  wasteCount: Float
  """
  The part of `wasteCount` produced during setup (makeready); run waste is the remainder. Null when the source did not split it.
  """
  setupWasteCount: Float
  """
  True when the report is the final statement of the run. Final reports cannot be edited; a later revision supersedes them.
  """
  isFinal: Boolean
  """
  Earlier report this revision replaces, or null for the first report of the run.
  """
  supersedesReportId: ProductionReportID
  """
  The source's identifier for this record, or null when the report has no external identity.
  """
  sourceSeries: String
  """Source revision of the imported snapshot."""
  sourceRevision: String
  """
  Saleable output produced by this run in `countUnit`. Waste is reported separately when known.
  """
  goodCount: Float
  """
  Quantity the run was planned to produce, in `countUnit` — the denominator for completion against `goodCount`. Null when the source reported no plan.
  """
  totalPlanned: Float
  """
  Unit that `goodCount` and `totalPlanned` are counted in (e.g. sheets, metres). CUSTOM means the real unit name is in `customCountUnit`.
  """
  countUnit: MetricUnit
  """
  Vertical-specific count unit name, meaningful only when `countUnit` is CUSTOM. Null otherwise.
  """
  customCountUnit: String
  """
  Mean production rate over the run, as a value plus its speed unit. Null when the source reported no speed.
  """
  averageSpeed: Speed
  """
  Machine- or partner-defined error code raised during the run. Null for a run that reported no error.
  """
  errorCode: String
  """
  Human-readable description of the error named by `errorCode`. Null when no error occurred.
  """
  errorMessage: String
  """How serious the reported error was. Null when no error occurred."""
  errorSeverity: ProgressErrorSeverity
  """
  The kind of operation this report describes (e.g. printing, cutting). Determines which `operationData` paths are meaningful. Optional — partner reports may omit it, and it can be inferred from the bound operation later.
  """
  capabilityCode: CapabilityCode
  """
  Whether this report describes real production output or a non-production run (setup, proof, calibration, test). Null means unspecified — treated as PRODUCTION by downstream filters.
  """
  runKind: RunKind
  """
  Capability-keyed flat path map. Native JSON object with JSON-Pointer-style keys; numeric values are emitted as JSON numbers.
  """
  operationData: JSON
  """
  Freeform integration metadata. Native JSON — numbers stay numbers, nested structures preserved verbatim.
  """
  metadata: JSON
  """
  When the report row was written (ISO8601). This is ingestion time, not production time — use `startedAt` for when the run actually happened.
  """
  createdAt: String!
  """
  When the row last changed (ISO8601). Payload columns are immutable after first write, so this only moves when the binding refs are set.
  """
  updatedAt: String!
  """
  Consumption rows attached to this report (ink, substrate, …). Requires productionReport:read.
  """
  consumption: [ProductionReportConsumptionState!]!
  """
  Fingerprint of the source snapshot the report was imported from, used to detect duplicates.
  """
  sourceFingerprint: String
  """
  Location of the reported process within the source document, such as a JDF node path.
  """
  sourcePath: String
  """
  What the source snapshot covered, such as the process and output resource it reported.
  """
  sourceCoverage: String
  """
  Diagnostics recorded while interpreting the source; optional detail that cleanup may remove.
  """
  sourceDiagnostics: String
  """
  How the reported times were derived from the source; optional detail that cleanup may remove.
  """
  sourceTimeDetails: String
  """
  Retained copy of the source document, when tenant debugging retention kept one.
  """
  sourceFileId: FileID
  """Width of the print run, with unit provenance preserved."""
  widthPrinted: Length
  """Length of the print run, with unit provenance preserved."""
  lengthPrinted: Length
  """Total area printed."""
  areaPrinted: Area
  """Substrate display name as reported by the source."""
  substrateName: String
  """Substrate type / material as reported by the source."""
  substrateType: String
  """Substrate roll/sheet width."""
  substrateWidth: Length
  """Substrate roll/sheet length."""
  substrateLength: Length
  """Substrate caliper / thickness."""
  substrateThickness: Length
  """Substrate basis weight."""
  substrateWeight: PaperWeight
  """FK to the typed Substrate catalog entry, when one was matched."""
  substrateId: SubstrateID
  """
  Horizontal print resolution (DPI). Read from operationData["/dpi/horizontal"].
  """
  printDpiHorizontal: Int
  """
  Vertical print resolution (DPI). Read from operationData["/dpi/vertical"].
  """
  printDpiVertical: Int
  """Number of print passes. Read from operationData["/passes"]."""
  printPasses: Int
  """Print mode (vendor-specific string). Read from operationData["/mode"]."""
  printMode: String
  """Bidirectional/unidirectional. Read from operationData["/direction"]."""
  printDirection: String
  """Color matching policy. Read from operationData["/colorPolicy"]."""
  printColorPolicy: String
  """Ink-save method. Read from operationData["/saveInkMethod"]."""
  printSaveInkMethod: String
  """
  Speed mode (vendor-specific string). Read from operationData["/speedMode"].
  """
  printSpeedMode: String
}