03 Set test options

Last modified by Carina Enke on 13.02.2024

Use various configuration options in the Options tab to customise the test according to your needs.

Editor - Testoptionen konfigurieren_de.png


You can give the learner the opportunity to attempt individual questions multiple times. The number of available attempts will be displayed to the learner when performing the test. They can submit their answer and, if further attempts are possible, answer the same question again.


In the ONYX Editor, you can decide whether the settings for the number of available attempts should be applied to the entire test or only to selected sections or individual questions. Go to the Options tab to configure your desired settings.

If you, for example, set the maximum number of attempts to find a solution to 2, the learner can answer each question in the test twice.


If you wish to set the number of attempts individually for specific sections or questions, disable the option Apply the configuration of the superior element. Now, you can set the number of attempts individually for the section or question.


The default is always one attempt. To allow an unlimited number of attempts, enter 0 in the input field.

New random values

By default, the same variable values and the same order of elements will be used for each attempt to solve a question. If you select the New random values option, random parameters will be recalculated per attempt. This affects both the variables used and the random order.

Recalculate variables

Questions can be changed for each test attempt by using variables. If the random values are recalculated, so are the variable values for each attempt at a question.

Reshuffle random order

The Shuffle option is available for choice interactions, match interactions, matrix interactions and order interactions. If enabled, the predefined responses of these question types will be arranged differently for each test attempt. If random values are recalculated, the order will also be changed for each attempt at a question.

These settings can extend practise and self-test scenarios. If the participant does not solve a question correctly, feedback can be used to provide instructions on how to answer the question and find a solution. The participant can then retry the question in a new attempt. The use of random values such as variables and a new random order will allow the participant to work on a similar question but with new answers or values.

Testrun - Feedbackbeispiele_de.png

Time limit

The author can define a processing time for the entire test or individual test sections. The remaining processing time will be displayed to the participant during the test accurately to the second.

Editor - Zeitlimit festlegen_de.png

After the expiration of this time limit, a message will be displayed to the participant indicating that the sections and questions can no longer be processed. If the processing time for the whole test has expired, the test will automatically be terminated.

Testrun - Hinweismeldung Zeit abgelaufen_de.png

Notes on measuring the processing time
  • The time will be measured on the server
  • The time displayed (client) and the actual time (server) will be synchronised in a small time interval
  • JavaScript will be used for the client-side update of the time display between the interval

How can there be differences in the time display on the user PC and the actual processing time?

Time is measured on a central computer (server), so that it will be independent of any control or manipulation attempts by the user PC (client). For this purpose, the time displayed on the user PC (client) will automatically be synchronised in a small time interval (e. g. every 5 s) with the actual time (server). This means that within this time interval, there may be time delays in the display of content (such as dialogues). For example, the dialogue at the end of the processing time is already displayed even though the user has just been indicated a remaining processing time of 2 seconds in the test. To update the time display on the user PC between the interval, JavaScript will be used. Thus, if the described differences in the time display occur, this is most likely the cause.


The author can choose between a linear and a non-linear navigation. A non-linear navigation allows participants to navigate between questions. In this way, solutions entered for previous questions can still be changed later on.

Editor - Navigationsoptionen_de.png

In the case of a linear navigation, participants have to navigate from question to question using the next and back buttons. As concerns the non-linear navigation, it is also possible to navigate using the displayed navigation tree.


The author can decide how the questions will be presented to the participants. Currently, it is only possible to show either one or all questions of one section on one page (section-based).

Editor - Darstellungsoptionen_de.png

For display on mobile devices, we recommend showing only one question at once.

Comments allow the participants to leave a message for the test assessor. Especially in the case of closed task forms with limited response options, the comment function offers a valuable support possibility for participants, e.g. if they do not understand the task, perceive the task as inaccurate, or do not find their solution in the answers provided to them.

image2017-3-23 21:0:3.png

In the ONYX Editor, you can decide whether the comment settings are supposed to be applied to the entire test or only to selected sections or individual tasks.

The tutor can view the comments in the participant's results view. Further information are provided in the help section "Results view: View participant".

Use comments in the test

To enable the comment function for a test, proceed as follows:

  1. Switch to the Options tab in the test settings.
  2. In the Options section, activate the Allow on question level checkbox under Comments. Now, participants can leave a comment for each question in the test.


You can provide additional functions to participants for taking the test. For example, you can share a calculator or additional documents that can be opened and used in the test.

Editor - Tools_de.png


A simple and a scientific calculator are available. Select the required range of functions under Display.


The trigonometric functions of the scientific calculator are calculated in radians (rad), not in degrees (deg).

Simple calculator

Scientific calculator

Testdurchführung - Einfacher Taschenrechner_de.png

Testdurchführung - Wissenschaftlicher Taschenrechner_de.png

Provide file(s)

Upload one or more PDF documents that can be accessed throughout the test.

Testdurchführung - Zusätzliche Dokumente_de.png


Advanced settings - External files

You may enhance or customise your questions and tests using additional files. 


Layout adjustments using a style sheet file (CSS)

The prerequisite for the use of this function is basic knowledge in HTML and CSS. Save your layout file as a CSS file (.css) and upload it to the Options tab of your question or test. Use the preview to verify whether it will be properly displayed. You can remove the layout file at any time or upload a new one.


Custom layout is only supported in the browser. The export views (PDF export, performance results page) do not allow for proper display of your layout.

Individual layout settings of a question will also affect all other questions on the respective page when the test option Show all questions of this section on one page is configured. This also applies to all detailed assessment views.

When performing a test, the test title is displayed in the upper left pane. You may hide the test title using your own style sheet file (CSS).

Testrun - Testtitel wird angezeigt_de.pngTestrun - Testtitel ausgeblendet_de.png

To do this, use the following CSS statement:

.nav-header h1 {display: none !important;}

Save the statement in a CSS file (.css). Then add the CSS file to the test content by uploading it as a style sheet file to the Layout settings section in the Options tab.