ImpositionSpecState
An imposition specification owned by exactly one Component or BatchComponent
Fields
Optional immutable selected-plan origin; null for legacy authored scenarios. Exact pages and revision are never inferred from sortOrder.
Historical qualified declaration omitted from the current list but retained for traceability; not a production or publication status.
Unique identifier
Exclusive BatchComponent owner, when this is a manufacturing form specification
Retained carrier stock facts for a form; independent of warehouse allocation
Original qualified signature declarations used by the carrier Layout
Parent component ID
External system identifier for the calling integration, or the creating integration's identifier for unscoped callers.
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 specification, when known.
IaC stack that originally created this specification, when known.
IaC stack currently managing this specification's configuration and deletion.
Optional name for this imposition scenario
Description of this imposition scenario
For a BatchComponent, selects its sole active production layout. For a Component, a legacy assessment marker that does not select an entire signature plan
Pages per sheet (up-count)
Sheets required per form run
Total number of form runs
Total page count
Sheet-work scheme
Possible values (5)
WORK_AND_TURNWork-and-turn (both sides from same plate, sheet flipped on long edge)
WORK_AND_TUMBLEWork-and-tumble (both sides from same plate, sheet flipped on short edge)
SHEETWISESheetwise / work-and-back (separate plates for each side)
WEB_PERFECTWeb perfecting (both sides printed inline)
OTHEROther scheme
Page orientation for planning
Possible values (3)
PORTRAITPortrait orientation
LANDSCAPELandscape orientation
BEST_FITBest-fit (automatic orientation selection)
How the section is bound. Page order on a folded signature depends on it (saddle-stitch nests, perfect-bound gathers); without it the sheet can only be imposed sequentially.
Possible values (7)
SADDLE_STITCHSaddle stitch: all sheets nest inside each other
PERFECT_BOUNDPerfect binding: gathered signatures glued at spine
CASE_BOUNDCase binding: sewn or glued signatures in hard cover
WIRE_BOUNDWire binding: pages bound with wire spiral or comb
FLATWORKFlatwork: no binding, step-and-repeat
FOLDEDSingle fold, no gathering or binding
OTHEROther or unspecified binding method
Horizontal gutter between up-positions; each Length carries its own unit.
Vertical gutter between up-positions.
Full sheet placement geometry (cells, fold lines, trim marks, surfaces). Computed by the imposing engine, reconstructed from pagesUp/scheme/orientation for a hand-authored spec, or imported through the layout input. Read layoutStatus before trusting it.
The same stored geometry as layout, as the JSON the layout input accepts — for copying a layout to another specification or handing it to another tool unchanged. Query layout to read individual parts.
Provenance of layout — and the gate on imposing this spec. ENGINE, SYNTHESIZED and IMPORTED are renderable; PROVISIONAL (press sheet inferred, no substrate on the component) and NONE are refused by the impose_pdf workflow node.
Possible values (5)
ENGINEComputed by the imposing engine against a resolved substrate. Renderable.
IMPORTEDAuthored outside CoCoCo and saved through layout, which checked that its geometry places. Renderable. Never rebuilt from the authored fields; only a new layout replaces it.
SYNTHESIZEDRebuilt from the authored pagesUp/scheme/orientation against the component's real substrate size. Renderable.
PROVISIONALRebuilt, but with no substrate to size the press sheet against — the sheet was inferred from the imposed grid. Cell placement and page order are correct; the sheet is a guess. Cannot be imposed until the stock is confirmed.
NONENo geometry — the spec carries too little to place a cell. Cannot be imposed.
Sort order within the component's imposition specs
Creation timestamp (ISO8601)
Last update timestamp (ISO8601)
Parent component. Requires component:read permission.
Referenced by (9)
Exact type SDL
"""
An imposition specification owned by exactly one Component or BatchComponent
"""
type ImpositionSpecState {
"""
Optional immutable selected-plan origin; null for legacy authored scenarios. Exact pages and revision are never inferred from sortOrder.
"""
signatureOrigin: PrintSignatureOrigin
"""
Historical qualified declaration omitted from the current list but retained for traceability; not a production or publication status.
"""
signatureArchived: Boolean!
"""Unique identifier"""
id: ImpositionSpecID!
"""
Exclusive BatchComponent owner, when this is a manufacturing form specification
"""
batchComponentId: BatchComponentID
"""
Retained carrier stock facts for a form; independent of warehouse allocation
"""
material: WorkMaterialContext
"""Original qualified signature declarations used by the carrier Layout"""
batchFormSources: BatchFormSources
"""Parent component ID"""
componentId: ComponentID
"""
External system identifier for the calling integration, or the creating integration's identifier for unscoped callers.
"""
externalId: String
"""
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 specification, when known.
"""
createdByIntegrationId: IntegrationInstanceID @iac_computed
"""IaC stack that originally created this specification, when known."""
createdByStackId: IaCStackID @iac_computed
"""
IaC stack currently managing this specification's configuration and deletion.
"""
managedByStackId: IaCStackID @iac_computed
"""Optional name for this imposition scenario"""
name: String
"""Description of this imposition scenario"""
description: String
"""
For a BatchComponent, selects its sole active production layout. For a Component, a legacy assessment marker that does not select an entire signature plan
"""
isPrimary: Boolean!
"""Pages per sheet (up-count)"""
pagesUp: Int
"""Sheets required per form run"""
sheetsPerForm: Int
"""Total number of form runs"""
totalForms: Int
"""Total page count"""
totalPages: Int
"""Sheet-work scheme"""
scheme: ImpositionScheme
"""Page orientation for planning"""
orientation: ImpositionOrientation
"""
How the section is bound. Page order on a folded signature depends on it (saddle-stitch nests, perfect-bound gathers); without it the sheet can only be imposed sequentially.
"""
bindingType: BindingType
"""
Horizontal gutter between up-positions; each `Length` carries its own unit.
"""
gutterH: Length
"""Vertical gutter between up-positions."""
gutterV: Length
"""
Full sheet placement geometry (cells, fold lines, trim marks, surfaces). Computed by the imposing engine, reconstructed from pagesUp/scheme/orientation for a hand-authored spec, or imported through the `layout` input. Read `layoutStatus` before trusting it.
"""
layout: SheetLayout
"""
The same stored geometry as `layout`, as the JSON the `layout` input accepts — for copying a layout to another specification or handing it to another tool unchanged. Query `layout` to read individual parts.
"""
layoutScalar: LayoutScalar
"""
Provenance of `layout` — and the gate on imposing this spec. ENGINE, SYNTHESIZED and IMPORTED are renderable; PROVISIONAL (press sheet inferred, no substrate on the component) and NONE are refused by the impose_pdf workflow node.
"""
layoutStatus: ImpositionLayoutStatus!
"""Sort order within the component's imposition specs"""
sortOrder: Int!
"""Creation timestamp (ISO8601)"""
createdAt: String!
"""Last update timestamp (ISO8601)"""
updatedAt: String!
"""Parent component. Requires component:read permission."""
component: ComponentState
}