UpsertComponentInput
Input for creating or updating a component
Fields
ID for update; omit for create
Parent job ID (required)
Parent component group ID (optional — leave nil for ungrouped components)
Internal component number
External system ID
HTTP(S) link to this record in the external system. Requires an external identity. Omit to preserve the existing link, or pass null to clear it. Removing the external identity also removes its link.
Component name (required)
Component description
Component classification (required)
Possible values (9)
CONTENTGeneral content pages
COVERCover component
INSERTBound-in insert
MAINMain component of a single-component job
TEXTText block pages
DUST_JACKETDust jacket wrapper for case-bound books
ENDPAPEREndpapers/pastedowns
OUTSERTOutsert/wrap-around component
OTHERUncategorized component
Number of units (required)
Sort order (defaults to 0)
Override creation timestamp (ISO8601). Honored only on create — passing on update is rejected.
Override update timestamp (ISO8601). Honored on create or update; defaults to now.
Total number of pages
Desired substrate/paper ID
Actual substrate/paper ID
Color specification for front and back. Omit to leave it unchanged; null clears it.
Layout specification with layers. Omit to leave it unchanged; null clears it.
Media/paper specification. Omit to leave it unchanged; null clears it.
Finished size after trimming (width and height). Omit to leave it unchanged; null clears it.
Finishing specification (varnish, die, foil, emboss). Omit to leave it unchanged; null clears it.
Referenced by (1)
Exact type SDL
"""Input for creating or updating a component"""
input UpsertComponentInput {
"""ID for update; omit for create"""
id: ComponentID
"""Parent job ID (required)"""
jobId: JobID!
"""
Parent component group ID (optional — leave nil for ungrouped components)
"""
componentGroupId: ComponentGroupID
"""Internal component number"""
componentNumber: String
"""External system ID"""
externalId: String
"""
HTTP(S) link to this record in the external system. Requires an external identity. Omit to preserve the existing link, or pass null to clear it. Removing the external identity also removes its link.
"""
externalUrl: String
"""Component name (required)"""
name: String!
"""Component description"""
description: String
"""Component classification (required)"""
kind: ComponentKind!
"""Number of units (required)"""
quantity: Int!
"""Sort order (defaults to 0)"""
sortOrder: Int
"""
Override creation timestamp (ISO8601). Honored only on create — passing on update is rejected.
"""
createdAt: ISO8601
"""
Override update timestamp (ISO8601). Honored on create or update; defaults to now.
"""
updatedAt: ISO8601
"""Total number of pages"""
totalPages: Int
"""Desired substrate/paper ID"""
desiredSubstrateId: SubstrateID
"""Actual substrate/paper ID"""
actualSubstrateId: SubstrateID
"""
Color specification for front and back. Omit to leave it unchanged; null clears it.
"""
colors: ComponentColorInfoInput
"""
Layout specification with layers. Omit to leave it unchanged; null clears it.
"""
layout: ComponentLayoutInput
"""Media/paper specification. Omit to leave it unchanged; null clears it."""
media: MediaInput
"""
Finished size after trimming (width and height). Omit to leave it unchanged; null clears it.
"""
finishedSize: MediaInput
"""
Finishing specification (varnish, die, foil, emboss). Omit to leave it unchanged; null clears it.
"""
finishing: FinishingSpecInput
}