ARCNM Nest Run Start
arcnm_nest_run_startDestructive
Start a job nest that was kept as a draft — one created with arcnm_nest_run_create while this month's runs were used, which is stored, not queued, and never starts by itself. By default (apply=false) this only reads the job nest and says whether it is a draft and what starting it would nest. apply=true (needs parts:write) queues it: it spends one of this month's runs and is nested at today's stock and prices in the background — poll arcnm_nest_run_status, then read arcnm_nest_run_result. While the month's runs are still used, the start is refused and the job nest stays a draft. Only a draft starts, and only once; the same call within 24 hours answers the start it already made.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| apply | No | ||
| run_id | Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lines | No | ||
| copies | No | ||
| groups | No | The plan: each material and thickness it would nest. | |
| run_id | No | The job nest started or kept as a draft; null for a plan of a new selection. | |
| status | No | queued once started; draft when kept, not queued, because this month's runs are used. | |
| applied | Yes | True when the call wrote: the job nest was started, or kept as a draft (status 'draft'); false for a plan, which stores nothing. | |
| guidance | Yes | ||
| left_out | No | The plan: calculations of the batch or folder it would not take, each with why. | |
| kept_as_draft | No | This month's runs are used: the job nest is (or, for a plan, would be) kept as a draft — stored, not queued, spending no run — until arcnm_nest_run_start starts it. | |
| environment_id | Yes |