The structure editor

Editing a test or section: parts, sections, items, selection and ordering, and locking.

For authors

Press Edit on a test or section page and its Structure tab becomes the structure editor: the tree, a toolbar, and a properties panel for whatever you select. As in the item editor, you work in a draft until you Save.

The toolbar

• Add offers what fits the selection: Test part, sections in or after the selected one, Items from the bank…, and the Selection rule and Ordering rule for a section.
• Insert adds any other element the standard allows there: time limits, branch rules, preconditions, rubric blocks, outcome processing.
• Locked (on tests): see Locking a test.
• Check, Save, Close and Discard, as in the item editor.

Adding items

Select a section and choose Add › Items from the bank…. Search the bank, tick items and add them. They are added as references: editing an item later changes it in every test using it.

Rearranging

Drag parts, sections and items to move them. The order on screen is the order a candidate is given. Click anything to see its properties: a section’s title and whether candidates see it, an item reference’s identifier, and so on.

Selection and ordering

• A selection rule gives each candidate some of a section’s children. It starts selecting all of them, so nothing changes until you lower select. Mark a child required to always include it, and allow with replacement to let one be drawn twice.
• An ordering rule shuffles the section’s children for each candidate. Mark a child fixed to keep its position.

A section holds at most one of each. If a rule could never be satisfied, such as selecting 5 from 3, the section’s header says so and the test cannot be launched until it is corrected.

Locking a test

Tick Locked when a test is ready for candidates. AIB saves and closes your draft, then locks the test:

• the test cannot be edited;
• nor can any item it uses, or any section it reaches, or any stimulus those items show.

Unlocking is the checkbox beside Edit on the test page, and needs a tenant admin. A test cannot be locked while anyone has a draft of it open.