Sometimes a second part may stand in for the first, but only if a supervisor agrees: two BRK-01 brackets, say, with BRK-02 as an approved substitute. The starter rule Accept a substitute only when a supervisor approves it sets the part and quantity a slot takes for orders with one option, and names one substitute.
Use the starter rule
You need the Author role, and the draft needs a saved revision whose configuration passes its checks: a draft with no revision yet, or one whose configuration has errors, has nothing for the blanks to offer. The rule goes into the draft's next revision. Nothing changes at the stations until a Reviewer activates a release that contains it, and kits already started stay on the plan they began with.
- Open Configuration and find the draft.
- Under Starter rules in the draft's section, choose the kit in Kit if the draft has more than one. Find Accept a substitute only when a supervisor approves it. It is in Approved substitutes. You can also type a word from its title in Search starter rules and Help.
- Fill in the blanks in the card's sentence, "When the order has …, … takes … of …, and … counts instead only if a supervisor accepts it, checked as ….":
- Option: one value of one of the kit's options.
- Slot: one of the kit's slots.
- Quantity: how many of the part each kit takes, from 1 to 999.
- Part: the part the slot normally takes.
- Approved substitute: a different part that may stand in for it.
- Checking policy: one of the configuration's policies where a supervisor accepts a substitute. The card is offered only where the configuration has such a policy; add one in Configuration JSON first if it has none.
- Choose Use this rule. The button waits until every blank has a value.
KitProof saves the draft's next revision, with the rule added to the kit as its next rule (R08 after R07) and a note naming the starter rule and its version. It is the same rule you would get by writing it into Configuration JSON yourself and choosing Save revision. No AI is asked, and nothing is made live. Beside the draft, the page says which starter rule the revision began from.
If someone saved a newer revision of the draft after you opened the page, the card is refused: reload the page, check what changed, then use the card again.
Where SmartFACT Automation is connected to KitProof, you can also arrive here from New requirement there, which offers the cards of the draft saved most recently, for its first kit that a card fits. Its Use this rule makes nothing: it opens Configuration on that draft and kit with this card alone and its blanks filled in, and the page names the kit. Check the kit and the blanks, then choose Use this rule on the page. See every starter rule shows all the cards.
Where describing conditions in words is switched on for your site, the card also offers Reword with AI. It adds the same rule, then opens Describe in words under Rule conditions on that rule with the card's sentence in When does this rule apply?. It sends nothing: you change the sentence and choose Propose condition yourself, and that request counts against the limits shown like any other. Where describing in words is not available, the card offers Use this rule alone.
What the rule does
For an order with the option, the kit's checklist asks for the part and quantity. At the station, scanning the substitute pauses for a supervisor, who approves it from their own sign-in; the part is then scanned again and counted, and the kit's record shows the substitute. Any other part is rejected. Decide alternatives, manual counts and waivers describes the supervisor's part. Where the slot already has rules, the new rule takes priority 10 above the highest of them, so for an order with the option it decides the slot.
For the Control box installation kit at Brighouse works, "When the order has mount RAIL, the mount slot (Match mounting method) takes 1 of Rail mount kit (RAIL-KIT), and Approved alternative rail mount kit (ALT-RAIL) counts instead only if a supervisor accepts it, checked as rail (a supervisor accepts a substitute)" asks rail-mounted kits for the rail mount kit, with the alternative kit only on a supervisor's approval.
Check the examples
A starter rule saves no example, because an expected kit is yours to state from the approved specification: KitProof never works it out for you. Before you create a candidate, save examples under Independent examples that show the rule working, each with its complete expected outcome:
- one order with the option, whose expected kit states the part, its quantity, the substitute and the policy's approval;
- one order without it, whose expected kit fills the slot as its other rules do.
The proof also needs the substitute exercised: an order where this rule decides the slot.
Mark each one reviewed as a separate step. Your existing examples are run again against the new revision. An example written before the rule may now fail, and that is the point: decide whether the rule or the example is wrong before you change either, and give a reason when you change an expectation.
Publish it
Under Release candidates, choose Create candidate from revision, which names the revision the starter rule made, then Verify. Every current example is run, every one must be reviewed, and the proof also needs every rule seen both matching and not matching, so the new rule needs both kinds of example. Then a Reviewer, another person, checks the proof and activates the candidate with an authenticator code from the last five minutes. Prove and activate configuration describes the review. A rule from a starter rule is reviewed like any other.
Change it later
Nothing about a starter rule makes its rule permanent. Change the rule's values or its condition in Configuration JSON, or remove it, and save the change as a new revision; set its condition with Build it yourself under Rule conditions if you prefer. Prove and activate the new revision in the same way. Kits already checked keep the requirements they were checked against.
If the card is refused
A refused card saves nothing, and the page says why:
- "Not done: that card no longer fits this revision of the draft, or its starter rule has changed." The draft's revision or KitProof's starter rule changed after the page was opened. Reload the page and fill the card in again.
- "Not done: draft changed", with the draft's current revision number under it: another author saved the draft after you opened the page. Reload it, check what they changed, then use the card again.
- "Not done: the approved substitute must be a different part from the one the slot takes." Choose another part for one of the two blanks.
- "Not done: the kit already has that rule, so the card would change nothing." A rule of the kit already gives the slot the same part, quantity, substitute and policy for that option.