← All types

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.

name

StringNullable

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

pagesUp

IntNullable

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_TURN

Work-and-turn (both sides from same plate, sheet flipped on long edge)

WORK_AND_TUMBLE

Work-and-tumble (both sides from same plate, sheet flipped on short edge)

SHEETWISE

Sheetwise / work-and-back (separate plates for each side)

WEB_PERFECT

Web perfecting (both sides printed inline)

OTHER

Other scheme

Page orientation for planning

Possible values (3)
PORTRAIT

Portrait orientation

LANDSCAPE

Landscape orientation

BEST_FIT

Best-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_STITCH

Saddle stitch: all sheets nest inside each other

PERFECT_BOUND

Perfect binding: gathered signatures glued at spine

CASE_BOUND

Case binding: sewn or glued signatures in hard cover

WIRE_BOUND

Wire binding: pages bound with wire spiral or comb

FLATWORK

Flatwork: no binding, step-and-repeat

FOLDED

Single fold, no gathering or binding

OTHER

Other 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)
ENGINE

Computed by the imposing engine against a resolved substrate. Renderable.

IMPORTED

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

SYNTHESIZED

Rebuilt from the authored pagesUp/scheme/orientation against the component's real substrate size. Renderable.

PROVISIONAL

Rebuilt, 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.

NONE

No geometry — the spec carries too little to place a cell. Cannot be imposed.

sortOrder

Int!Non-null

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
}