Variable assignment and sections

The Assignment tab defines the task form: which variables the solver sees, which they can change, which they must fill in and how they are arranged into sections. Only tasks of the To be solved by user type have this tab. The editor shows the form as the solver will see it, and you add variables to it, move them and change their width.

An empty place on the form has a + icon that adds a variable directly to that place. Remove an empty row with the − icon at its edge.

Usage modes

Variables that you do not add to the form are not visible to the solver in the task. A dynamic condition can also change the variable mode while the task is being solved.

Variable settings

Width 8 is available only in a full-width section. Widths 1 and 2 are not available for tall fields such as multi-line text, the rich text editor, multi-select lists, document preview and dynamic rows. Widths 2, 3 and 4 are disabled when there is no room in the row. When you widen a variable, the editor moves the adjacent variables automatically.

Adding a variable

Clicking Assign variable or + opens a menu:

• the search field filters variables by name,
• Create variable opens a dialog for creating a new template variable; once created, you will find it in the menu, but you must add it to the form yourself,
• Empty space adds an empty row to the given side of the section,
• the list shows variables that are not yet on the form, with their field type (Text Field, Number, Calendar, Select, Checkbox and others).

Click a variable to place it in the selected spot. If a variable is already there, it moves down.

Sections

Sections group variables under a heading. A section is either full width of the form, or half width with a second section possibly next to it. Variables that are not in any section are at the top without a heading.

Add a new section with the Add section button between sections, Add adjacent section next to a section, or Add adjacent section below under a half-width section. In the dialog, either select an existing template section in the Select existing section field, or enter a New section name. The More language variants link opens the names in other languages and the AI translation button translates them if AI is enabled in the system.

A section without variables cannot be saved. When saving the task, the warning “Section must not be empty” is shown for each empty section and the task is not saved.

Getting started

When you first open the Assignment tab of a task with an empty form, the editor asks How do you want to start assigning variables?

• Import from another task takes over the form from another task of this template.
• Start from scratch closes the dialog and you build the form yourself.

How to build a form

1. Open the task and click the Assignment tab.
2. Click Add section and enter a name for the new section, for example Trip details.
3. In the section, click Assign variable and select a variable. Repeat for other variables.
4. Click the label or use the variable settings to choose mode R, W or M.
5. In the variable settings, adjust the width so that the fields fit side by side.
6. Click Save.

Related: Instructions, sections and testing a task, Dynamic conditions: builder, Multi-instance.