Skip to content
SmartFACT HelpHandbooksWatch and practise
Handbooks: WorkSteps

How to include a step when an option is selected

Use a starter rule to include an optional block's steps for units whose order has one option.

Review edition · 13 November 2026 · For Author, Reviewer

On this page

Some steps belong only to some units: the wall brackets on a wall-mounted enclosure, a cleaning step for a stainless body. In WorkSteps those steps sit in an optional block of the procedure, and the block's condition decides which units get them. The starter rule Include a block when an option is selected sets that condition in one sentence.

Use the starter rule

You need the Author role, and the procedure needs a saved draft revision: a procedure you have only just created has nothing for the blanks to offer yet. The rule goes into the next draft revision. Units keep the instructions of the release they were issued with, and new units keep following the published release until a Reviewer publishes a new one.

  1. Open Procedures and open the procedure.
  2. Under Starter rules, find Include a block when an option is selected. It is in Recommended and in Options. You can also type a word from its title in Search starter rules and Help.
  3. Fill in the blanks in the card's sentence, "Include … when … is selected.":
    • Optional block: one of the procedure's optional blocks, such as the mounting extra block.
    • Option: one value of one of the procedure's required options, such as Mounting: wall. A yes-or-no option appears once, by its label, and means yes.
  4. Choose Use this rule. The button waits until every blank has a value.

WorkSteps saves the next draft revision with the rule in it, with the note "Began from the starter rule Include a block when an option is selected (version 1)". No AI is asked, and nothing is published, assigned or issued. The page then says the revision began from this starter rule and what to check next.

If Draft definition has changes you have not saved, the cards wait: a starter rule always starts from the saved revision. Save your changes or reload the page first.

Where SmartFACT Automation is connected to WorkSteps, you can also arrive here from New requirement there, which offers the cards of the procedure whose draft was saved most recently. Its Use this rule makes nothing: it opens that procedure's page with this card alone and its blanks filled in, and the page names the procedure. Check the procedure and the blanks, then choose Use this rule on the page. See every starter rule shows all the cards.

Where describing a condition in words is switched on for your site, the card also offers Reword with AI. It sends nothing: it puts the card's sentence into Describe this condition in words under Slot conditions, where you read it and choose Propose a condition yourself. That request counts against your limits like any other. Where describing in words is not available, the card offers Use this rule alone.

What the rule does

The rule replaces the block's condition: the block's steps are included for a unit whose order has the option you chose, and left out for every other unit. A unit whose order does not give the option at all cannot be issued: WorkSteps never guesses a missing option.

In the Instrument enclosure EN-400 procedure, "Include the mounting extra block when Mounting: wall is selected" puts Fit the wall brackets on every wall-mounted unit's traveller, and a bench-mounted unit gets its instructions without it.

Check the examples

A starter rule saves no example, because an expected route is yours to state from the approved method: WorkSteps never works it out for you. Before you lock the revision, save examples under Examples that show the rule working:

  • one unit whose order has the option, whose expected route includes the block's steps;
  • one unit whose order has another value of the same option, whose expected route leaves them out.

Beside the new revision the page offers Start an example for each of these. It puts a unit's options in Example JSON and leaves the expected route empty for you to complete; then choose Add example. Check every option and enter the expected steps, requirements and parameters from the approved method before you save it.

Your existing examples are run again against the new revision. An example written for the old rule may now fail, and that is the point: decide whether the rule or the example is wrong before you change either.

Publish it

Under Review, choose Lock revision … and verify, which names the revision the starter rule made. Every saved example is run, and the proof also needs each optional block both included and left out by some example. Then hand the candidate to a Reviewer. Verify and publish a procedure describes the review. A rule from a starter rule is reviewed like any other, and an author who publishes their own revision must have the Reviewer role and give a reason.

Change it later

Nothing about a starter rule makes its rule permanent. Under Slot conditions, choose the block and build any other condition, or use another starter rule on the same block: each replaces the block's condition. Save the change as a new draft revision and publish it in the same way. Units already issued keep the instructions they were issued with.

If the card is refused

  • This starter rule has changed since the page was opened. WorkSteps has a newer version of the starter rule. Reload the page and fill the card in again.
  • Someone saved a newer revision. Another author saved the draft after you opened the page. Reload it, check what they changed, then use the card again.
  • The draft already has this rule, so nothing was saved. The card would make exactly the rule the draft has now.