Skip to end of metadata
Go to start of metadata

The course element Test allows the testing of knowledge using different answer formats. The results will be displayed to the author in the assessment tool and can be downloaded via the data archiving.

The learning platform currently supports two different test formats. You can choose between the internal and the ONYX test format. The ONYX Testsuite enables convenient test creation and comes with a large range of functions.

In the new, mobile responsive user interface, internal tests and surveys are no longer supported. However, you can easily convert existing test content in the internal format to ONYX and continue to use it.

Convert to ONYX

Existing internal tests can easily be converted to the ONYX format.

  1. In the course editor, go to the detailed view of the test you want to convert.
  2. Select the function from the menu on the right.
  3. A copy of the test content is created in ONYX format.
  4. Enter a title and description for the new (converted) test content.

The original test content and all references will remain unchanged during the conversion. The converted test content is saved as a copy and can then be integrated into a course by changing the referencing.

Within a course, you can now replace the existing internal test with the new (converted) test content in ONYX format as follows:

  1. Open the corresponding course and switch to the course editor.
  2. Select the relevant course element of the type Test or Self-test and switch to the tab Test configuration.
  3. Select the option Replace file to exchange the current internal test for the new (converted) test content in ONYX format.

Usage: Learners' View


In the course elemen Test, you have the possibility to start and run a test configured by the course author. Afterwards, you can view your assessment and retry the test depending on the course author's settings.

Überblick Kursbaustein Test

Functions for users

Start and finish test

In the course element Test, you have the possibility to answer test questions in different formats. Start a test attempt as follows:

Open the course element Test.

Click on Start test.

A test can only be started if not all attempts have been used and no visibility or access restrictions prevent it.

Start test button


The test is opened and started immediately unless any release restrictions prevent it. Now you can start answering the questions. To advance to the next question, click on Forward. Depending on the author's configuration, you can also select questions from the navigation pane.

The test is run in the ONYX web interface. Further information can be found in the chapter Onyx >Test implementation from the participants' point of view .

Opened test

To close the test, click on Finish test.

Please note that no further processing is possible after finishing the test.

Finish test button

View assessment

Depending on the configuration of the course element, you will be able to view assessment information on the test home page in the course upon finishing the test. If the button Show evaluation (or in the case of an exam, the button Exam summary) is displayed, you will be able to open one or all of your attempts and view the assessment data you have received.

Depending on the course author's settings, the following assessment information may be available:

  • Passed status: Passed/ not passed
  • Score: points achieved/ maximum points possible
  • Mark in numbers
  • Mark in words
  • Score to pass
  • Result: Best/ last result will be scored
  • Checksum
  • Test date

If the test contains question formats that need to be assessed manually by the author, you will receive a corresponding note on open assessments.

Ansicht Bewertung

Configuration: Authors' View

In the course editor

The following functions are available to you in the course editor:

Add a course element test

To integrate a course element into your course, proceed as follows:

Open the course you want to edit.

Use the pencil icon at the top of the page to open the editing mode.

Switch from the course view to the editing mode


Select a course element from the menu on the right.

Select course element


In the new window, you can define the position of the new course element within your course structure (left navigation pane). The available positions are marked with an insert icon.

To insert the new course element into an existing substructure, you need to open the substructure by clicking on the small triangle symbol next to its title. The area will open and you will again see insert icons at the positions which are available.

Click on the insert icon at the desired position within the structure. The selected area will be highlighted.

Confirm your choice with Insert course element.

Insert course element into the course tree


The element will be inserted into the course structure at the selected position.

Depending on the course element, you have to make additional configurations or add content in order to complete the configuration.

For these changes to take effect, you must publish the course. The course element will then also become available in the course view.

Configure and publish course element

General configuration settings

In the course editor, you will find the following configuration tabs:

Title and description

Course editor settings in the tab title and description

You need to enter a title for the course element. The title can comprise a maximum of 100 characters. All special characters and numbers are permitted. The title will appear in the navigation menu of the course and also as a heading in the content area.

(warning)  If you change the title of the first course element, the new content will only be applied to the main course node and then displayed in the opened course. If you wish to edit the course title or description, you can do so using the more settings menu of the course.

SubtitleYou can enter a subtitle for the course element with a maximum of 255 characters. All special characters and numbers are permitted. The title will appear as a tooltip in the navigation menu and - if selected and configured accordingly - as a subtitle in the content area.

Here you can describe the course element. The description will appear in the content area below the title.

Depending on the settings configured in the element Display, this additional text is displayed to the user when opening the course element. The user can expand or collapse the view of the text.


Define which information about the course element should be displayed in the course view. In addition to the content, you can optionally display the title and description. All course elements are provided with a reasonable presetting, which mostly includes the setting Title, description and content. You can adjust this setting in accordance with the options available for each course element. For an example of the different setting options, refer to the help page Displaying information about the course element.

Set link for this course element

Each course element can be accessed via fixed link addresses. Therefore, an internal and an external URL is assigned to each course element. These direct links to concrete elements can be used within courses or provided to learners. The URLs are located below the title and description of the element and will appear upon selecting Set link for this course element.  

  • External link: To refer to this course element from outside of the course or learning platform, you can use the external link and insert it, for example as a href attribute, into the desired HTML page.
  • Internal link: To set a link to another course element within the same course, you can insert the internal link as a href attribute into the desired HTML page.
IDYou will need the ID number of the course element (on the bottom right), for example, if you wish to use the expert mode in the visibility or access tab.


In the areas Visibility and Access, authors and course owners can individually determine the presentation of course elements. If no input is made in the access area, the content of a course element will by default be visible to all course participants after publishing the element. Apart from the general options listed below, additional configuration options are available depending on the course element.

The following general options are available for the configuration of visibility and access:

Course editor - Tab visibility and access

General configuration optionsDescription
Blocked for learners

If you select this checkbox, all other configuration options will disappear. The course element content is now exclusively accessible for tutors and administrators of the course.

Block access or visibility for learners
Depending on dateMark this checkbox to specify a particular access time. You can set individual dates or date ranges by filling in only one or both input fields respectively. You can also create or delete dates via the + and - buttons.

Set access or visibility rights depending on dates

Depending on group

Select this checkbox to restrict the accessibility of the course element to learning groups or learning areas. You can then select existing groups and areas or create new ones.

If you set restrictions with the configuration option "depending on group", the corresponding course element will be restricted for all non-members of the group. This includes, for example, users who have not yet confirmed the group invitation or who are on the waiting list for a group. Such users cannot yet see or access the restricted course element.

Set access or visibility rights depending on groups

Depending on assessmentHere, you will find all assessable course elements. These include, for example, the elements test, assessment, task, or structure. 

If you select the option Check for "passed", you will be able to choose a course element from the input field Course element, which the user must have passed as a prerequisite to accessing this course element. 

If you select the option Check score, you can indicate a number of points in the input field "Passing score", which have to be achieved in order to be able to access the course element.

Set access or visibility rights depending on assessments

Depending on attribute

The visibility of this option is system-dependent.

Via this option, you can set visibility or access rights according to user attributes. Only users who meet the predefined attributes will be able to see the course element or have access to its content. Multiple attributes need to be linked with an operator (AND/OR).

Different kinds of relational operators might be available depending on the selected attribute. For example:

  • "contains the value"
  • "does not contain value"
  • "has exactly the value"
  • "does not have value"
  • "starts with value"
  • "ends with value"
  • "greater than" (>)
  • "less than" (<)
  • "greater than/equals" (<=)
  • "less than/equals" (>=)

A list of all available attributes of several selected institutions can be found on the page Overview of the OPAL-Shibboleth attributes.

Set access or visibility rights depending on attributes

Apply rules also for author, owner and tutorThis option does not become visible until one of the other options has been selected. If you activate the checkbox, the same access rules which apply to users will also be valid for tutors and course administrators.

Apply rules also for author, owner and tutor

PasswordThis option is only available in the area Access and can either be applied to the whole course or a structural element of the course. Enter the desired password, which users will need to use in order to gain access to the course content, in the text field.

Set access or visibility rights depending on passwords

Display expert modeClick on the button Display expert mode to open an input field, which allows you to perform a more complex configuration according to your needs. For more detailed information about the expert mode, see the help page Publishing within Courses (Expert Mode).
Set access or visibility rights in the expert mode
Advanced configuration optionsIn the case of individual course element types, there are further attributes to configure access to editing rights for course participants.

If various restrictive single options are set, they will be linked with AND, i.e. all conditions of the single options must be met for the user to see and have access to the course element. The only exceptions are the single options Attributes. In this case, various restrictive single options can also be linked with OR. The OR linking only requires the fulfilment of one condition in order to enable visibility or access, unless other restrictive single options prevent this.

All restrictions are also automatically valid for all subordinate course elements.

Note about hiding access restrictions

If a course element is visible, but there are

  • current or future access restrictions or
  • restricted rights for the course element,

the user will be informed accordingly when accessing the course element. This information helps the user to learn more about the functions available, e.g. which functions will be available at what time and under what conditions.

If required, however, you can hide this information text (from the user) for each course element individually.

Notification message about existing access and authorisation restrictions in the course view:

Course element with notification message about authorisation restrictions


To hide this message, open the course editor and switch to the Visibility tab of the respective course element.

In the section Information if course node is visible but not accessible (max. 248 characters), remove the check mark in front of the entry Show access restrictions below the text field.

Publish your changes.

Course editor setting to hide notification message


The note will no longer be visible in the course view.

Course element without notification message about authorisation restrictions

For individual course element types, there are further attributes which can be used to regulate access to editing rights for course participants.

The following editing rights can be restricted or extended using the general configuration attributes (depending on date, group, etc.):

  • Assignment
  • Edit task folder  
  • Drop box - Delete own solutions
  • Drop box  
  • Return box
  • Assessment
  • Sample solution
  • Read  
  • Read and write
  • Moderate
File Dialogue
  • Only file download / read in the forum  
  • File up- and download/ read and write in the forum
  • Edit or delete files / Moderate in the forum
  • Read  
  • Read and write
  • Moderate
  • Read  
  • Add and edit dates
Link List
  • Display  
  • Display and add
  • Display, edit, and delete
  • Display  
  • Display and edit
  • Read
  • Write
  • Manage
  • Download
  • Upload
  • Delete
  • Read  
  • Read and write
  • Moderate
  • Display  
  • Display and edit
  • Display
  • Add

Configurable in the tab Visibility :

  • Conduct test
  • View assessment
  • View results
  • Read  
  • Add and edit articles

Test configuration

In this tab, you have the possibility to store a test resource and to configure settings for the implementation of the test.
Detailed instructions are given in the following section Test configuration.


Here you can configure various settings for the assessment of the test. All options are explained in detail in the section Assessment.

MultilingualismIn this tab, different translations can be added to individual course element areas.

Test configuration

Choose test

This tab allows you to add a test resource to your test course element. You can choose from the following options:

  • Select test (option 1)
  • Create test (option 2)
  • Import test (option 3)

  1. Open the course editor of the course element Test and go to the tab Test configuration.
  2. Click on Choose test.
Choose test button
3. A page with functions for selecting, creating, and importing a test resource opens. Choose one of the three options:
Overview of the three options

Select test (option 1)

  • Select an existing test resource from the overview and click on Choose test behind the test you wish to add.
Choose test resource

Create test (option 2)

  • Click on the Create button located below the heading Search for referenceable learning resources.

  • The dialogue for creating test resources opens. Enter a title and optionally a description in the appropriate text fields.
  • Click on Save.
  • If necessary, upload an image for the detailed view of the new resource.
  • Click on Finish to complete the creation process.
Create test

Import test (option 3)

  • Click on the Import button located below the heading Search for referenceable learning resources.

  • The dialogue for uploading test resources opens. Use the buttons Select folder or Upload file to navigate to the location of the file you want to import. Confirm your choice with Upload and complete the necessary data for the new test resource.

Import test
4. The resource will now be displayed in the tab Test configuration under Current choice.
Current choice
  • To detailed view: Use this button to switch to the detailed view of the added test resource. Among other things, you will find information on the supervisors and access rights in this area. For further information, refer to the help page Functions of the detailed view.

  • Replace: Click this button to replace the stored test resource with another test resource. The same window opens as described above in the section Choose test. You can now select, create, or import a test resource. If there is a newer test version available, you can also update the old version using this path. For more information, see the section Replace test version.
  • Edit: Click this button to open the test resource in the ONYX editor. In this area, you have the option to edit test content and to create and configure additional tasks. For further information on working with the ONYX editor and the available question formats, refer to the chapter Create tests with the ONYX TestsuiteIf a newer test version exists, the older version can no longer be edited. The Edit button will then be disabled.
Functions after adding a test resource
Using test output variables
Open this link in the Test Configuration tab to display the test output variables (outcomes) of the selected Onyx test. These variables can be used for visibility and access rules (expert syntax) and as placeholders in certificate templates.
Output variables
Add information text

You can provide the learner with an information text for the test. This text will be displayed in the course view above the Start test button.

Information text for the test

  1. Open the course editor of the course element Test and go to the tab Test configuration.
  2. Then click on Select or create page.
Select or create page button

A window with functions for creating or selecting an HTML page as well as for uploading an HTML file opens. Decide on one of the following options:

Three options


Enter the name of the new file in the appropriate text field, select a different character set if necessary, and then click the Create button.

Create a new HTML page

The editor window for creating a new HTML page opens. Alternatively, you can also open the editor window manually by clicking the Open page in editor button.

Enter the desired content. You can also use the numerous formatting options in the Text editor.

Then click on Save.

Fill in the new HTML page

Click on the button Select page.

Select page button

An overview of all HTML pages available in the storage folder opens. Mark the desired file by clicking on its title and confirm your selection with Select.

Select file from storage folder
  • Click on the button Select file.
  • Now select a file from your computer and upload it.
  • Confirm the process with Upload.
Upload file

The selected file will be uploaded to the storage folder, automatically linked, and displayed under Selected page.

Selected page

After adding an HTML page, you have the following options: 

Open page in editor: 

  • Click on this button to make changes to your HTML page.

Replace page:

  • Click on this button to create, select, or upload anew HTML page. Follow the steps outlined above.

Delete page:

  • If the HTML page has been added to a course element as an information page, you can completely clear this assignment using the Delete Page button.

Functions after adding an HTML page

Running the test

After you have added a test, you have the option to configure various settings for its implementation.

Configuration of the test implementation

Show navigation tree

This checkbox is enabled by default.  

Disable the option to hide the navigation tree with the question titles during the test.

Restrict number of attempts

By activating this checkbox, the number of possible attempts at a solution will be restricted to a number you have specified. Enter this number in the appropriate form field.  

If this option is not activated, the test can be repeated indefinitely.

After task submission

Decide whether you want to show feedback or an assessment by activating the corresponding checkbox.

If you enable the option Show feedback, the user will be given feedback after submitting a task.

Feedback can only be displayed if it has been previously stored in the test resource. For more information about providing feedback on Onyx tests, see the page Set feedback .

If you enable the option Show assessment, the user will be informed about whether their answer is correct or incorrect after submitting a task.  

You can choose whether the user should only be shown the achieved score or whether the correct and incorrect answers or even the solution should be displayed. To do this, select the appropriate option.

After test completion

Decide whether you want to show feedback or an assessment by activating the corresponding checkbox.

If you enable the option Show feedback, the user will be given feedback after completing the test.

Feedback can only be displayed if it has been previously stored in the test resource. For more information about providing feedback on Onyx tests, see the page Set feedback .

If you enable the option Show achieved score and passed level, the user will be informed about whether their answers have been correct or incorrect after completing the test.

SuspendIf this checkbox is enabled, participants will be able to pause the test. In this case, all given answers are saved, and the participant can continue the test later.
Show item titles

This checkbox is enabled by default. All task titles will be displayed as stored in the test resource.  

Clear this checkbox if you prefer neutral task titles instead. The original question titles will then be replaced with neutral ones such as "Task 1", Task 2", etc. and numbered linearly.

Confirm your configuration with Save.

Sample images of the effects of individual configuration parameters can be obtained from the page ONYX Testsuite>Configuration of the test implementation.

After finishing the test

You can influence the user's navigation after finishing a test by determining the course element to which they will be directed.

Configure jump address

To do this, mark the checkbox Jump to another course node. The selection list Select course node opens. Click on the triangle to display the available entries. Select the desired course element from the list and confirm your settings with Save.

After the submission and successful storage of the test, the user will automatically jump to the selected course element. However, this does not apply to test attempts that are cancelled, interrupted, or performed in exam mode.

Exam mode

You can run tests in an exam mode. This mode allows additional options and accompanying functions for implementing tests.

Correction mode and new test version

The integrated test resource can also be changed or enhanced. However, if there are already user results for the resource in the system, it must be ensured that these results match the test version. Therefore, the following options are available for making changes:

  • This mode can be used for small changes, such as spelling corrections. Essential test content, however, cannot be modified. This means that it is not possible to add new tasks or change test or task options or assessments.

  • This option can be used to make significant changes to the test content. All editing functions can be used and all implementing options can be adapted.

Both options will be displayed when opening a resource with existing user results for editing. If the option correction mode is used, no further changes or publishing of the course element will be necessary. The modified version will be immediately accessible to users starting the exam. However, if a new test version is created, the old test version must be actively replaced so that the new one will be displayed to the user. As long as this is not the case, the user will be shown the old version when opening the resource.

Replace test version

Replacing a new test version is analogous to replacing any other test resource:


If a newer test version exists, a notification message will appear in the course editor. The link in the title of the notification message leads directly to the corresponding course element.

Notification message with a link to the course element

Use the Replace button in the tab Test configuration to apply the new version.

Replace button

A dialogue opens from which you can select the newer test version or another test resource. To use the new version of the resource, click on Choose.

Select current test version from the dialogue

If test results are available for this course element, you will have the opportunity to save these results and download them if necessary in the next step.

In the last step of the wizard, you can optionally send an email to the users concerned.

Download test results
5Publish the course element to make the new version available in the course view.
Publish course element


Here you have the option to configure various settings for the assessment.

Determine which test result will be adopted for a course element Test and which assessment information will be shared with the user.

Assessment tab

Passing score

Configure the score required to pass a test. 

If you use an ONYX resource, the threshold score set for the test will be automatically displayed here. If necessary, please change this score directly in the ONYX resource. Changes made in the Assessment tab may lead to conflict and undesirable behaviour.

ResultDecide whether the latest attempt will be counted or whether the user can improve on their test result, which means that the best attempt will get rated. If there are several attempts with the same score, the most recent attempt with this score will be included in the assessment.
Score info

Show on test homepage

If this checkbox is enabled, the user will see a box displaying their central results on the test home page after submitting the test. These include the passed status, the score, and the mark in numbers and words.

You can assign marks manually for individual users in the assessment form, by bulk assessment for many users or by using a grading key.

Score info

The passed status will also be displayed in the course navigation.

If this checkbox is not enabled, the passed status will neither be visible on the test home page nor in the course navigation.

Passed status in the navigation
Detailed test overview

Select which assessment information will be shared with the user:

Show on test homepage

Users may review each task of the completed test attempt and their saved answers. Feedback information about the tasks (if any) will also be displayed here. They can open the detailed test overview from within the course run using the Show evaluation button.

If there are several test attempts available, either the latest or best attempt will be used for the evaluation (see configuration option Result).

Please note ...

In the detailed test overview, the learner will automatically see at least the assessment information that they have already seen while taking the test. By default, the task/test evaluation is disabled in the test configuration tab, so the learner will not see any evaluation and feedback information during a test attempt. In this case, this information will also not be displayed in the test overview unless the configuration option Show all assessment information has been enabled.

If you have activated the task/test evaluation in the test configuration tab, the learner will already see assessment and feedback information during a test attempt. In this case, this information will also be displayed in the test overview, regardless of the configuration option Show all assessment information.

Show detailed test overview to users

User view of a test attempt

Show all assessment information

If this checkbox is enabled, the user will be able to see the evaluation of their answers if it was not already visible during the test (see also Test procedure configuration>Task evaluation or test evaluation or note about the configuration option Show on test homepage).

Show all assessment information of a test attempt to a user

Show all results

The user is not only shown the test result relevant for evaluation, but also a table with all test attempts completed so far. The table can be opened using the link Show evaluation of all attempts. The individual test results will show when clicking on the date of the respective attempt.

Show all test attempts

The visibility of the assessment information configured here also depends on the settings in the Visibility tab. For example, you may control when exactly users get access to assessment information.

Use certificatesYou can automatically provide users with a certificate if they have successfully passed a test course element. For more detailed information, see the help page Certificates.
In the course view

In the course view, you have access to all functions available to users. Detailed information can be found in the section Functions for users.

Button Prüfungssteuerung
If you have activated the test in exam mode using the exam control, you will also see the button To the exam mode underneath the test. This button opens an area that allows you to monitor and coordinate the course participants' test history.

For more information, see the page Exam control.

The following table provides a brief overview of the locations where available test functions are configured.

FunctionOPALONYX editorAdditional information
Create test resourcexx

OPAL: Test Configuration

ONYX: Create test

Create individual tasks
xCreate tasks
Assign tasks to a test
xCreate test
Assign test resource to a course elementx
Test Configuration

Set visibility and access restrictions for a course element

Restrict test implementation to IP addresses or IP rangesx
Create feedback

Set test feedback

Set task feedback

Show feedback (task feedback, test feedback)x
Test Configuration
Assessment (point configuration for the task)
xSet assessment
Assessment (passing score, absolute score, or relative score)
xSet test assessment
Layout of the task
xSet task options
Layout: Hide test title
xSet test options

Attempts at a solution (runnable test attempts)

Test Configuration

Attempts at a solution

(within the started test attempts, for test sections, or individual tasks)


Set test options

Set section options

Set task options

Reset task variables with each new attempt
xSet test options
Time limit for the entire test or individual sections

Set test options

Set section options

Random selection of test questions
xSet section options
Random arrangement
xSet section options
Linear or non-linear navigation
xSet test options
Visibility of the section structure
xSet section options

Currently, it is only possible to show either one or all questions on one page


xSet test options
Allow comments for the entire test, selected sections, or individual tasks

Set test options

Set section options

Set task options

Visibility of the navigation tree during the test attemptx
Test Configuration
Determine the last or best attempt as test resultx
Set results display in the course viewx
Create PDF certificate for a passed test course elementx
Start test attemptx
Allow interrupting a test attemptx
Test Configuration
Show concrete or neutral task titlesx
Test Configuration
Set jump target after test completionx
Test Configuration
Configure exam modex
Test Configuration, Prüfungsmodus
Use exam browser and create exam codex
Print confirmation page after completing the examx


Assessment Tool

Result view for participants (test, exam)x
Result view for tutorsx
Assessment Tool
View participant commentsx
Assessment Tool
View variable assignment of a conducted test attemptx
Assessment Tool
View Maxima outputx
Assessment Tool
Display of system errorsx
Assessment Tool
Perform manual assessmentx
Assessment Tool
Show statistical evaluation x
Assessment Tool
Export of participant resultsx
Assessment tool 1