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.
Display name.
Source integration that produced the report.
User associated with this report (typically the operator on duty).
Free-form operator identifier from the source system, when no user maps to it.
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)
INGESTEDArrived already bound — operation refs were known at write time.
MANUALA human bound it via mutation.
AUTOA 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)
NONENo unit
PERCENTPercentage (0-100)
RATIORatio (0.0-1.0)
BOOLEANBoolean (0 or 1)
COUNTGeneric count
PIECESDiscrete pieces/items
MILLIMETERSMillimeters
METERSMeters
INCHESInches
FEETFeet
METERS_PER_MINUTEMeters per minute
FEET_PER_MINUTEFeet per minute
UNITS_PER_MINUTEUnits per minute (generic)
UNITS_PER_HOURUnits per hour (generic)
CELSIUSDegrees Celsius
FAHRENHEITDegrees Fahrenheit
KELVINKelvin
BARBar
PSIPounds per square inch
KILOPASCALKilopascal
GRAMSGrams
KILOGRAMSKilograms
POUNDSPounds
MILLILITERSMilliliters
LITERSLiters
SQUARE_METERSSquare meters
SQUARE_FEETSquare feet
MILLISECONDSMilliseconds
SECONDSSeconds
MINUTESMinutes
HOURSHours
VOLTSVolts
AMPSAmperes
WATTSWatts
KILOWATT_HOURSKilowatt-hours
BYTESBytes
KILOBYTESKilobytes
MEGABYTESMegabytes
CUSTOMVertical-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)
INFOInformational notice
WARNINGWarning — production can continue
ERRORError — production impaired
FATALFatal — 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_SHEETFEDOffset Sheetfed Press
PRINT_OFFSET_WEBOffset Web Press
PRINT_TONER_SHEETFEDToner Sheetfed Press
PRINT_TONER_WEBToner Web Press
PRINT_INKJET_SHEETFEDInkjet Sheetfed Press
PRINT_INKJET_WEBInkjet Web Press
PRINT_WIDE_FORMATWide Format Printer
PRINTER_LARGE_FORMATLarge Format Printer
REWINDINGRewinding
BINDING_SADDLE_STITCHSaddle Stitcher
BINDING_PERFECTPerfect Binder
BINDING_WIRE_OWire-O Binder
BINDING_SPIRALSpiral/Coil Binder
BINDING_COMBComb Binder
FOLDINGFolder
FOLDERFolder (Inline)
CUTTINGCutter
CUTTER_THREE_KNIFEThree-Knife Trimmer
COATING_LAMINATINGLaminator
COATING_FLOODFlood Coater
SPOT_UV_VARNISHSpot UV Varnish
DIE_CUTTINGDie Cutter
SCORING_CREASINGScoring/Creasing
PERFORATINGPerforator
DRILLINGDrill
PUNCHINGPunch
EMBOSS_DEBOSSEmbosser/Debosser
FOIL_STAMPINGFoil Stamper
COLLATINGCollator
SEWINGSewing Machine
BOOK_BLOCK_MAKERBook Block Maker
CASE_MAKINGCase Maker
CASING_INCasing-In Machine
ROUNDING_BACKINGRounding & Backing
ENDPAPER_TIPPINGEndpaper Tipping
GLUINGGluing
HEAD_BANDINGHead Banding
SPINE_MILLINGSpine Miller
CTPComputer-to-Plate
PLATEMAKINGPlatemaking
DRYINGDryer (General)
DRYING_UVUV Dryer
DRYING_IRIR Dryer
PACKINGPacking
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)
PRODUCTIONReal production output. Default semantic when runKind is null.
SETUPPress setup / makeready before a production run.
PROOFProof print for customer or operator approval.
CALIBRATIONColour / density / register characterisation, no job-specific intent.
TESTCatch-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.
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
}