OperationState
An operation within a job
Fields
Batch component operation, and optional item, fulfilling this job work. This work is not independently executable.
Allocation captured at setup start; later schedule edits do not change execution evidence
Unique identifier
Manufacturing form scope; mutually exclusive with jobId.
Parent job ID
Associated component ID
Associated component group ID
Associated milestone ID
External URL for the calling integration, or the primary identity for unscoped callers.
All linked external identities, including identities belonging to other integrations.
Integration instance that originally created this record, when known.
IaC stack that originally created this record, when known.
External system ID
Operation name
Notes and remarks
Operation type
Possible values (50)
BINDINGHolding the finished components together as one product. The generic kind, for when the specific binding method is not yet decided.
BOOK_BLOCK_MAKINGAssembling the folded signatures into the book block that will later be cased in.
COLLATINGGathering printed sheets or signatures into the correct page order before binding.
COMB_BINDINGBinding with a plastic comb through punched rectangular holes, so the book opens flat and can be reopened to add pages.
CONTOUR_CUTTINGCutting along an arbitrary outline that follows the artwork, rather than to a rectangular trim.
CREASINGPressing a channel into the substrate so it folds along a controlled line without cracking the fibres or the printed surface.
CUTTINGTrimming the sheet to its finished size on a guillotine or three-knife trimmer.
DEBOSSINGPressing a design below the surface of the substrate, the inverse of embossing.
DIE_CUTTINGCutting shapes with a steel die, for outlines a straight guillotine cut cannot make.
DIGITAL_PRINTINGPrinting directly from digital data with no plate, so each impression can differ and short runs carry no plate cost.
DRILLINGMaking round holes through the stack, typically for ring or mechanical binding.
EMBOSSINGRaising a design above the surface of the substrate under heat and pressure.
FOIL_STAMPINGApplying metallic or pigmented foil to the substrate with a heated die.
FOLDINGFolding the printed sheet into signatures or into the finished product's fold pattern.
GLUINGApplying adhesive to join parts of the product, as in a carton seam or a bound spine.
HEAD_BANDINGAttaching the decorative fabric band at the head and tail of a hard-bound book's spine.
INKJET_PRINTINGPrinting by jetting ink droplets onto the substrate, without contact between head and stock.
FLOOD_COATINGApplying a coating over the entire printed area, for protection or overall finish.
LAMINATINGBonding a film over the printed sheet to protect it and change its surface finish.
OFFSET_PRINTINGLithographic printing in which ink passes from plate to blanket to substrate. The high-volume commercial process, with a per-job plate cost.
PACKINGPacking the finished product for storage or despatch.
PERFECT_BINDINGBinding by milling the spine flat and gluing the pages into a wrapped cover, as used for paperbacks.
PERFORATINGCutting a line of small slits so a part can be torn away cleanly by hand.
PRECUTTINGCutting the stock down before printing, to bring it to press size or to split it into working sections.
PRINTINGMarking the substrate with the artwork, when the specific press process is not yet decided.
PUNCHINGMaking shaped holes with a punch tool, for binding elements or for the product's own features.
RING_BINDINGBinding with wire loops through punched holes, so the book opens flat and lies open.
SADDLE_STITCHINGStapling folded signatures through the spine fold. Cheap and fast, but limited to low page counts.
SCORINGImpressing a line to weaken the substrate along a fold, without cutting it.
SEWINGSewing the signatures together with thread, the most durable binding for a book block.
REWINDINGRewinding printed web into delivery rolls with authored count, length and winding requirements.
SLITTINGCutting the web or sheet lengthwise into narrower strips.
SPIRAL_BINDINGBinding with a continuous coil threaded through punched holes.
STITCHINGFastening with wire staples, when the stitching pattern is not specified further.
STRIP_BINDINGBinding with a plastic strip clamped through the punched edge of the stack.
CASE_MAKINGMaking the hard case — boards plus covering material — that a book block is later cased into.
CASING_INFixing the finished book block into its case to complete a hard-bound book.
CUSTOMAn operation the print catalog does not name. Its meaning comes from the operation's own parameters rather than from this kind.
DRYINGAllowing or forcing ink or coating to cure before the next operation can run. Occupies time and space without changing the product.
ENDPAPER_TIPPINGGluing the endpapers to the first and last signatures of a book block.
EYELETSSetting metal eyelets into punched holes, to reinforce them for hanging or lacing.
HEMMINGFolding and securing the edge of a flexible substrate so it will not fray.
PLATEMAKINGImaging the printing plates from the prepared artwork, before the press can run.
ROUNDING_BACKINGShaping a book block's spine into a curve and flaring its shoulders so the case fits and the book opens properly.
SPINE_MILLINGMilling the folded spine off the book block to expose the individual leaves for adhesive binding.
SPOT_VARNISHApplying varnish to selected areas only, to contrast finish against the uncoated areas around them.
KISS_CUTTINGCutting through the face stock of a self-adhesive material but not its liner, so the label lifts off intact.
REVERSE_CUTTINGCutting from the reverse of the sheet, for products viewed through the substrate.
PARTIAL_CUTTINGCutting part-way through the substrate's thickness rather than all the way through.
WHITE_UNDERPRINTLaying white ink beneath the artwork so colours stay opaque on a clear, metallic, or dark substrate.
Type of resource required
Preferred capability (id) for scheduling
Preferred work center for scheduling
Current operation status
Possible values (10)
PENDINGNot yet available for scheduling
AVAILABLEReady to be scheduled
SETUPMachine setup in progress
RUNNINGOperation is running
CLEANUPCleanup/teardown in progress
COMPLETEDSuccessfully completed
FAILEDOperation failed
STOPPEDManually stopped
CANCELLEDOperation cancelled
RESTARTINGRestarting after failure/stop
Net good output of this operation, in quantityUnit: the quantity of the thing it produces (sheets for a sheetfed press, repeats for a roll press producing signatures, pieces for copies). Null unit on legacy operations.
Unit of productionQuantity and of every planned waste figure.
Possible values (15)
CLICKA billing counter rather than a physical measure: one metered page charged under a cost-per-click press or copier contract.
CMCentimetres — metric length, a hundredth of a metre.
FTFeet — imperial length, twelve inches.
GGrams — metric mass, for light items stocked by weight.
IMPRESSIONA production counter rather than a physical measure: one pass of one sheet through a press. Distinct from SHEET, since a sheet printed on both sides can cost two impressions.
INInches — imperial length, the unit paper sizes are quoted in outside metric markets.
KGKilograms — metric mass, the usual unit for reel and other bulk substrate stock.
LBPounds — imperial mass, roughly 0.45 kg.
MMetres — metric length, the usual unit for material bought by the running metre such as a reel or a roll of laminate.
MMMillimetres — metric length, a thousandth of a metre, and the granularity trim sizes and other sheet dimensions are normally given in.
OZOunces — imperial mass, a sixteenth of a pound.
PCPieces: a plain count of discrete items, carrying no dimension at all. The unit stock and transfer quantities fall back to when none is given.
PTPoints — the typographic length unit of one seventy-second of an inch, used for type sizes and rule weights rather than for stock quantities.
REPEATOne printed repeat of a web: a cut-off in web offset, a repeat in flexo and labels. What a roll press counts when it produces signatures.
SHEETA count of substrate sheets, the usual unit for sheet-fed stock. Counts the physical sheets held or moved, not the press passes over them (see IMPRESSION).
Planned waste per makeready, in quantityUnit. Fixed once estimated.
Planned running waste as a percentage of productionQuantity. Fixed once estimated.
Extra output planned to cover later operations' waste, in quantityUnit. Derived; not an input.
Planned feed: productionQuantity plus setup waste, run waste and downstream allowance (summed over items when every item has a planned quantity). Derived; not an input.
Who set plannedSetupWasteQuantity.
Possible values (2)
ESTIMATORCopied from the accepted estimate: the post-calculation benchmark
MANUALSet by a person; automation never overwrites it
Who set plannedRunWastePercent.
Possible values (2)
ESTIMATORCopied from the accepted estimate: the post-calculation benchmark
MANUALSet by a person; automation never overwrites it
The work centre the estimate assumed, for post calculation. Not a scheduling constraint: see requestedWorkCenterId.
Expected duration in seconds
Deadline (ISO8601)
Scheduled start time (ISO8601)
Actual start time (ISO8601)
Scheduled completion time (ISO8601)
Actual completion time (ISO8601)
Additional metadata as JSON object
Kind-specific production parameters (JSON). Schema varies by kind — use getOperationParameterSchema to retrieve the JSON Schema for the target kind.
Sort order within the job
Supplier this operation is subcontracted to (nil = in-house)
Purchase order covering this outsourced operation
Expected lead time in calendar days for outsourced operations
Creation timestamp (ISO8601)
Last update timestamp (ISO8601)
Parent job. Requires job:read permission.
Parent component. Requires component:read permission.
Parent component group. Requires componentGroup:read permission.
Associated milestone. Requires milestone:read permission.
Requested work center. Requires workCenter:read permission.
Physical work units (items) within this operation. Requires operation:read permission.
Custom operation type name (when kind is custom)
The imposition specification the whole operation runs, when linked. Items may run their own; see OperationItem.impositionSpec. Requires impositionSpec:read permission.
Referenced by (15)
- AcceptEstimatePayload.operations
- ComponentGroupState.operations
- ComponentState.operations
- DelegatedWorkPayload.operation
- ExtractProductionOperationsPayload.operations
- JobState.operations
- OperationEdge.node
- OperationItemState.operation
- PlannedOperationState.operation
- ProductionBoardJob.operations
- Query.getOperation
- Query.getOperationBy
- ScheduleAllocationState.operation
- TransitionOperationPayload.operation
- UpsertOperationPayload.operation
Exact type SDL
"""An operation within a job"""
type OperationState {
"""
Batch component operation, and optional item, fulfilling this job work. This work is not independently executable.
"""
producedBy: OperationProducerReference
"""
Allocation captured at setup start; later schedule edits do not change execution evidence
"""
executionAllocation: OperationExecutionAllocation
"""Unique identifier"""
id: OperationID!
"""Manufacturing form scope; mutually exclusive with jobId."""
batchComponentId: BatchComponentID
"""Parent job ID"""
jobId: JobID
"""Associated component ID"""
componentId: ComponentID
"""Associated component group ID"""
componentGroupId: ComponentGroupID
"""Associated milestone ID"""
milestoneId: MilestoneID
"""
External URL for the calling integration, or the primary identity for unscoped callers.
"""
externalUrl: String @iac_computed
"""
All linked external identities, including identities belonging to other integrations.
"""
externalIdentities: [RecordExternalIdentity!]! @iac_computed
"""Integration instance that originally created this record, when known."""
createdByIntegrationId: IntegrationInstanceID @iac_computed @iac_ref(resource: "integration_instance")
"""IaC stack that originally created this record, when known."""
createdByStackId: IaCStackID @iac_computed
"""External system ID"""
externalId: String
"""Operation name"""
name: String!
"""Notes and remarks"""
remarks: String
"""Operation type"""
kind: OperationKind!
"""Type of resource required"""
requiredResourceType: String
"""Preferred capability (id) for scheduling"""
capabilityId: CapabilityID
"""Preferred work center for scheduling"""
requestedWorkCenterId: WorkCenterID
"""Current operation status"""
status: OperationStatus!
"""
Net good output of this operation, in quantityUnit: the quantity of the thing it produces (sheets for a sheetfed press, repeats for a roll press producing signatures, pieces for copies). Null unit on legacy operations.
"""
productionQuantity: Float
"""Unit of productionQuantity and of every planned waste figure."""
quantityUnit: MeasurementUnit
"""Planned waste per makeready, in quantityUnit. Fixed once estimated."""
plannedSetupWasteQuantity: Float
"""
Planned running waste as a percentage of productionQuantity. Fixed once estimated.
"""
plannedRunWastePercent: Float
"""
Extra output planned to cover later operations' waste, in quantityUnit. Derived; not an input.
"""
plannedDownstreamAllowanceQuantity: Float
"""
Planned feed: productionQuantity plus setup waste, run waste and downstream allowance (summed over items when every item has a planned quantity). Derived; not an input.
"""
plannedGrossQuantity: Float
"""Who set plannedSetupWasteQuantity."""
plannedSetupWasteSource: PlannedWasteSource
"""Who set plannedRunWastePercent."""
plannedRunWasteSource: PlannedWasteSource
"""
The work centre the estimate assumed, for post calculation. Not a scheduling constraint: see requestedWorkCenterId.
"""
estimatedWorkCenterId: WorkCenterID
"""Expected duration in seconds"""
expectedDuration: Int
"""Deadline (ISO8601)"""
deadline: ISO8601
"""Scheduled start time (ISO8601)"""
scheduledStartAt: ISO8601
"""Actual start time (ISO8601)"""
actualStartAt: ISO8601
"""Scheduled completion time (ISO8601)"""
scheduledCompletionAt: ISO8601
"""Actual completion time (ISO8601)"""
actualCompletionAt: ISO8601
"""Additional metadata as JSON object"""
metadata: JSONMap
"""
Kind-specific production parameters (JSON). Schema varies by kind — use getOperationParameterSchema to retrieve the JSON Schema for the target kind.
"""
parameters: JSON
"""Sort order within the job"""
sortOrder: Int!
"""Supplier this operation is subcontracted to (nil = in-house)"""
outsourcedSupplierId: SupplierID
"""Purchase order covering this outsourced operation"""
outsourcedPurchaseOrderId: PurchaseOrderID
"""Expected lead time in calendar days for outsourced operations"""
outsourcedLeadTimeDays: Int
"""Creation timestamp (ISO8601)"""
createdAt: ISO8601!
"""Last update timestamp (ISO8601)"""
updatedAt: ISO8601!
"""Parent job. Requires job:read permission."""
job: JobState
"""Parent component. Requires component:read permission."""
component: ComponentState
"""Parent component group. Requires componentGroup:read permission."""
componentGroup: ComponentGroupState
"""Associated milestone. Requires milestone:read permission."""
milestone: MilestoneState
"""Requested work center. Requires workCenter:read permission."""
requestedWorkCenter: WorkCenterState
"""
Physical work units (items) within this operation. Requires operation:read permission.
"""
items: [OperationItemState!]!
"""Custom operation type name (when kind is custom)"""
customKind: String
"""
The imposition specification the whole operation runs, when linked. Items may run their own; see OperationItem.impositionSpec. Requires impositionSpec:read permission.
"""
impositionSpec: ImpositionSpecState
}