← All types

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

id

OperationID!Non-null

Unique identifier

Manufacturing form scope; mutually exclusive with jobId.

jobId

JobIDNullable

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

name

String!Non-null

Operation name

Notes and remarks

Operation type

Possible values (50)
BINDING

Holding the finished components together as one product. The generic kind, for when the specific binding method is not yet decided.

BOOK_BLOCK_MAKING

Assembling the folded signatures into the book block that will later be cased in.

COLLATING

Gathering printed sheets or signatures into the correct page order before binding.

COMB_BINDING

Binding with a plastic comb through punched rectangular holes, so the book opens flat and can be reopened to add pages.

CONTOUR_CUTTING

Cutting along an arbitrary outline that follows the artwork, rather than to a rectangular trim.

CREASING

Pressing a channel into the substrate so it folds along a controlled line without cracking the fibres or the printed surface.

CUTTING

Trimming the sheet to its finished size on a guillotine or three-knife trimmer.

DEBOSSING

Pressing a design below the surface of the substrate, the inverse of embossing.

DIE_CUTTING

Cutting shapes with a steel die, for outlines a straight guillotine cut cannot make.

DIGITAL_PRINTING

Printing directly from digital data with no plate, so each impression can differ and short runs carry no plate cost.

DRILLING

Making round holes through the stack, typically for ring or mechanical binding.

EMBOSSING

Raising a design above the surface of the substrate under heat and pressure.

FOIL_STAMPING

Applying metallic or pigmented foil to the substrate with a heated die.

FOLDING

Folding the printed sheet into signatures or into the finished product's fold pattern.

GLUING

Applying adhesive to join parts of the product, as in a carton seam or a bound spine.

HEAD_BANDING

Attaching the decorative fabric band at the head and tail of a hard-bound book's spine.

INKJET_PRINTING

Printing by jetting ink droplets onto the substrate, without contact between head and stock.

FLOOD_COATING

Applying a coating over the entire printed area, for protection or overall finish.

LAMINATING

Bonding a film over the printed sheet to protect it and change its surface finish.

OFFSET_PRINTING

Lithographic printing in which ink passes from plate to blanket to substrate. The high-volume commercial process, with a per-job plate cost.

PACKING

Packing the finished product for storage or despatch.

PERFECT_BINDING

Binding by milling the spine flat and gluing the pages into a wrapped cover, as used for paperbacks.

PERFORATING

Cutting a line of small slits so a part can be torn away cleanly by hand.

PRECUTTING

Cutting the stock down before printing, to bring it to press size or to split it into working sections.

PRINTING

Marking the substrate with the artwork, when the specific press process is not yet decided.

PUNCHING

Making shaped holes with a punch tool, for binding elements or for the product's own features.

RING_BINDING

Binding with wire loops through punched holes, so the book opens flat and lies open.

SADDLE_STITCHING

Stapling folded signatures through the spine fold. Cheap and fast, but limited to low page counts.

SCORING

Impressing a line to weaken the substrate along a fold, without cutting it.

SEWING

Sewing the signatures together with thread, the most durable binding for a book block.

REWINDING

Rewinding printed web into delivery rolls with authored count, length and winding requirements.

SLITTING

Cutting the web or sheet lengthwise into narrower strips.

SPIRAL_BINDING

Binding with a continuous coil threaded through punched holes.

STITCHING

Fastening with wire staples, when the stitching pattern is not specified further.

STRIP_BINDING

Binding with a plastic strip clamped through the punched edge of the stack.

CASE_MAKING

Making the hard case — boards plus covering material — that a book block is later cased into.

CASING_IN

Fixing the finished book block into its case to complete a hard-bound book.

CUSTOM

An operation the print catalog does not name. Its meaning comes from the operation's own parameters rather than from this kind.

DRYING

Allowing or forcing ink or coating to cure before the next operation can run. Occupies time and space without changing the product.

ENDPAPER_TIPPING

Gluing the endpapers to the first and last signatures of a book block.

EYELETS

Setting metal eyelets into punched holes, to reinforce them for hanging or lacing.

HEMMING

Folding and securing the edge of a flexible substrate so it will not fray.

PLATEMAKING

Imaging the printing plates from the prepared artwork, before the press can run.

ROUNDING_BACKING

Shaping a book block's spine into a curve and flaring its shoulders so the case fits and the book opens properly.

SPINE_MILLING

Milling the folded spine off the book block to expose the individual leaves for adhesive binding.

SPOT_VARNISH

Applying varnish to selected areas only, to contrast finish against the uncoated areas around them.

KISS_CUTTING

Cutting through the face stock of a self-adhesive material but not its liner, so the label lifts off intact.

REVERSE_CUTTING

Cutting from the reverse of the sheet, for products viewed through the substrate.

PARTIAL_CUTTING

Cutting part-way through the substrate's thickness rather than all the way through.

WHITE_UNDERPRINT

Laying 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)
PENDING

Not yet available for scheduling

AVAILABLE

Ready to be scheduled

SETUP

Machine setup in progress

RUNNING

Operation is running

CLEANUP

Cleanup/teardown in progress

COMPLETED

Successfully completed

FAILED

Operation failed

STOPPED

Manually stopped

CANCELLED

Operation cancelled

RESTARTING

Restarting 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)
CLICK

A billing counter rather than a physical measure: one metered page charged under a cost-per-click press or copier contract.

CM

Centimetres — metric length, a hundredth of a metre.

FT

Feet — imperial length, twelve inches.

G

Grams — metric mass, for light items stocked by weight.

IMPRESSION

A 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.

IN

Inches — imperial length, the unit paper sizes are quoted in outside metric markets.

KG

Kilograms — metric mass, the usual unit for reel and other bulk substrate stock.

LB

Pounds — imperial mass, roughly 0.45 kg.

M

Metres — metric length, the usual unit for material bought by the running metre such as a reel or a roll of laminate.

MM

Millimetres — metric length, a thousandth of a metre, and the granularity trim sizes and other sheet dimensions are normally given in.

OZ

Ounces — imperial mass, a sixteenth of a pound.

PC

Pieces: a plain count of discrete items, carrying no dimension at all. The unit stock and transfer quantities fall back to when none is given.

PT

Points — the typographic length unit of one seventy-second of an inch, used for type sizes and rule weights rather than for stock quantities.

REPEAT

One 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.

SHEET

A 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)
ESTIMATOR

Copied from the accepted estimate: the post-calculation benchmark

MANUAL

Set by a person; automation never overwrites it

Who set plannedRunWastePercent.

Possible values (2)
ESTIMATOR

Copied from the accepted estimate: the post-calculation benchmark

MANUAL

Set 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.

sortOrder

Int!Non-null

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)

job

JobStateNullable

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)
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
}