Operation

Dla: Programista

Przykłady na tej stronie używają adresu . Zmień adres

Typ obiektowyOperation

A production operation on an element, for example printing or laminating, done on one machine.

Pola

Pole	Typ	Opis
`colorProfileId`	`ID`	Identifier of the color profile (an entry of `referenceData(type: COLOR_PROFILE)`); null when not set.
`comments`	`[OperationComment!]!`	Notes for production on the operation. An empty list when there are none.
`description`	`String`	What the operation is, in the print shop words; null when empty.
`element`	`Element`	The element the operation makes. Always set for an API key; null in the app for a person who may not see the product.
`elementId`	`ID!`	Identifier of the element the operation belongs to.
`endedAt`	`DateTime`	When production completed the operation; null while it is not completed.
`finishingTypeId`	`ID`	Identifier of the finishing type (an entry of `referenceData(type: FINISHING_TYPE)`); null when not set.
`id`	`ID!`	Identifier of the operation (UUID).
`machineId`	`ID!`	Identifier of the machine that does the operation.
`operationTypeId`	`ID`	Identifier of the operation type (an entry of `referenceData(type: OPERATION_TYPE)`); null when not set.
`order`	`Order`	The order the operation belongs to. Always set for an API key; null in the app for a person who may not see the order.
`orderId`	`ID!`	Identifier of the order the operation belongs to (through its element and product).
`previousOperation`	`Operation`	The operation right before this one in its element (`previousOperationId`). Whether the operation may start depends on EVERY earlier operation of the element, not only this one: read `readyToStart`.
`previousOperationId`	`ID`	Identifier of the operation that precedes this one in the production order of its element (the nearest lower `sequenceOrder`); null for the first operation of the element and for an operation without a position.
`price`	`Float!`	Net price of the whole operation (its full `quantity`, not per unit), in the order currency. Wymaga zakresu `prices:read`.
`product`	`Product`	The product the operation belongs to. Always set for an API key; null in the app for a person who may not see the product.
`productId`	`ID!`	Identifier of the product the operation belongs to (through its element).
`productionStatus`	`ProductionStatus!`	Where production of the operation stands: COMPLETED once `endedAt` is set or the whole `quantity` is done, IN_PROGRESS while its task runs, PAUSED when its task is paused or part of the quantity is done, NOT_STARTED otherwise. Wymaga zakresu `production:read`.
`quantity`	`Float!`	How many units the operation processes, in `unit`.
`quantityCompleted`	`Float!`	How many units production has completed so far, in `unit` (0 before production starts).
`readyToStart`	`Boolean!`	Whether the shop floor may take the operation up now, by the same rule the machine queue in Prynt uses: every earlier operation of its element (a lower `sequenceOrder`) is finished, that is completed (`endedAt`) with its whole `quantity` done. Material positions (paper, board or a tool issued from the warehouse, and any operation on a warehouse machine) never hold the next ones back; an operation without a position is always ready. It can be false while the previous operation has `productionStatus` COMPLETED: completed without the whole quantity. It changes when ANOTHER operation of the element is finished, without moving this operation's `updatedAt`; `Order.updatedAt` moves then, so sync `orders(updatedFrom)` as well. Wymaga zakresu `production:read`.
`sequenceOrder`	`Int`	Position of the operation within its element; only the order of values matters: the first operation has the lowest value (0 or 1, depending on how the order was made). Null for an operation saved without a position (older data); such operations come last.
`tasks`	`[Task!]!`	Production tasks of the operation, oldest first: one for each time the shop floor took it up (a partly done operation gets a new task). An empty list (never null) before production starts. Wymaga zakresu `production:read`.
`timePerUnitSeconds`	`Int!`	Estimated machine time per unit of `quantity`, in seconds; the whole operation takes `timePerUnitSeconds * quantity`.
`unit`	`Unit!`	Unit of `quantity` and `quantityCompleted`.
`updatedAt`	`DateTime!`	When the operation last changed: its own fields (quantities, time, machine, position, completion) or its production tasks (one created, started, paused, resumed, completed or cancelled). Changes of the order, product or element it belongs to move `Order.updatedAt`, not this. Writing back the same values (a technology saved unchanged in Prynt) does not move it. Filter on it with `updatedFrom` to fetch only what changed since your last sync. Operations saved before 0.33.0 carry the moment of that upgrade.

Operation

Pola

Używane w