Page tree
Skip to end of metadata
Go to start of metadata

A simple coupling of the ONYX Testsuite with the Moodle learning platform allows you to use your ONYX tests as Moodle course activity.

The ONYX Testsuite can be enabled as an external tool by your Moodle system administrator. Selecting and integrating ONYX test content into courses will then be a snap. Participants will just have to authenticate themselves to the Moodle learning platform once, and their ONYX test content will be fully integrated into their Moodle course. With the ONYX Testsuite, comprehensive results analysis for your participants’ test data will be available to you.

If you do not wish to enable the ONYX Testsuite for your Moodle learning platform, you can also integrate your ONYX test content via weblink. For more detailed information, please refer to the help section "Testing on the web and by email".


Provide test

You (the author and supervisor) should plan the following steps to integrate an ONYX test as a course element into your Moodle course:

Create a test in the ONYX Editor

Create your ONYX test with the ONYX Editor and benefit from the diverse question types and individual configuration options. For more detailed information, please refer to the help section "Create content".

Use the central, public ONYX Editor instance (https://www.onyx-editor.de/) for a quick and easy start.

Publish the test in the ONYX Editor

Publish your ONYX test to enable access for your participants. Publication is achieved in the same way as when "publishing a test" for testing on the web and by email.
Most important for your publication is the test link. It can be adjusted and corresponds to the ID you (the author) must specify for the integration of the ONYX test into Moodle.

ONYX - öffentlicher Link zum Test

You may customise the test procedure according to your usage scenario. For your test scenario, you can decide which feedback and assessment information you wish to display to the test participants while running the test. A detailed description of the configuration parameters can be found in the help section "Test procedure configuration".

Integrate the test into Moodle

If the system administrator has enabled the ONYX Testsuite as an external tool in your Moodle learning platform, you can integrate your ONYX test as an "External tool" activity.

The integration of your ONYX test into your Moodle course content is done in the Moodle learning platform. Proceed as follows:

1. Log in to Moodle. Please note that you need the right to edit courses.

2. Switch to the Moodle course into which you wish to integrate your ONYX test and click on  to open the editing mode of the course. Then select the option "Add material or activity" at the desired place in the course. 

Element dem Moodle Kurs hinzufügen

3. Select the activity "External tool" from the dialogue "Add Material or Activity". Confirm your choice.

4. A dialogue for configuring the external tool opens. Enter a title for your ONYX test, which will also be the title of the course activity in Moodle. In ONYX, the title you specified when creating the test in the ONYX Editor will be displayed. We recommend using the same title in both systems.

Select the ONYX Testsuite as "Type of external tool". Please note that the Moodle system administrator specifies the name of the external tool, which is why the designation may differ.

Dialog Externes Tool hinzufügen

5. To reference your desired test, you now need the test link you chose when publishing your ONYX test in the ONYX Editor. The test link will be added as a "custom parameter". Select the option  from the "Basic entries" section and enter the test link in the "Custom parameters" field like this: Test=test link.

Testlink als Parameter zum Tool eintragen

6. Now click on  to check the test. You will then be able to see your ONYX test, run it and attempt it. The test's display, as well as feedback and assessment information, will match your specified test configuration for the test publication.

Testaufruf im Moodlekurs

7. The ONYX test will now be displayed as an activity within your course and can be edited. Changes to the test content or the test configuration can be made in the publish view of the ONYX Editor.

Test als Element des Kurses

Run test

To run a test in Moodle, go to the relevant course and start the course activity with the test. The test opens in a new view.

Detailed information can be found in the section Test procedure from the participants’ point of view.

Assess test

The ONYX Editor provides you with extensive test assessment functions and the possibility to export results.
Though it depends on the configuration by the Moodle system administrator, Moodle generally transmits the participants’ first and last names as well as their email address. This participant-related data will be stored with the result data in the ONYX Editor and displayed in all results views.

Auswertungsansicht eines Tests

Detailed information can be found in the section Manage and evaluate publications.

Moodle currently does not support the return of results for external tools. Access to the total score or passing status for a participant’s test run within the Moodle learning platform is therefore not possible. All of the result data is currently stored together with the participant data provided by Moodle in the ONYX Editor, where it can be evaluated in detail.

Enable ONYX Testsuite in Moodle

The ONYX Testsuite can be enabled as an external tool by the Moodle system administrator.

To configure the ONYX Testsuite as an external tool, proceed as follows:

1. Log in to Moodle. Please note that you need administration rights.

2. Open the "Settings" menu to access the "Website administration".

Administratoreneinstellungen aufrufen

3. Go to the "External tools registration" using the path:  Website administration > Plugins > Activities > External tool > Manage tools

Externe Tools verwalten

In the "Add tool" box, click on the link "Manage registration of external tools".

Neues Tool hinzufügen

In older Moodle versions, please use the following direct access path:
Website administration > Plugins > Activities > External tool > Registration of external tools

Tool in älteren Versionen hinzufügen

4. Select the option "Configuration of a newly registered external tool".

Konfiguration des neuen Tools

5. Now enter the configuration for the ONYX Testsuite.

Use our centrally provided ONYX Editor instance for a quick and easy start. Please note that the specified demo system is not suitable for productive use.
You wish to connect one of our ONYX Editor instances to your Moodle learning platform? Let us know, we will gladly give you access.


a. Enter "ONYX Testsuite" as the name of the tool provider.

b. Enter the link to the LTI registration page of the used ONYX Editor as registration URL.

c. Select at least the following rights for the ONYX Testsuite:

  • basic-lti-launch-request
  • ResourceLink.*
  • Result.autocreate
  • Result.sourcedid
  • User.ID

d. Select at least the following services for the ONYX Testsuite:

  • Memberships
  • Tool Consumer Profile
  • Tool Proxy
  • Tool Settings

Konfiguration der ONYX - Testsuite

Save your configuration.

6. The ONYX Testsuite is now listed as an external tool in the configuration. Select the register action to enable registration.

Tool aktivieren

7. If the registration was successful, the ONYX Testsuite will be displayed as "Accepted".

Akzeptierte Tools

8.  Go to the "Manage external tool types" using the path: Website administration > Plugins > Activities > External tool > Manage Tools

In the "Add tool" box, click on the link "Manage preconfigured tools".

In older Moodle versions, please use the following direct access path:
Website administration > Plugins > Activities > External tool > Manage external tools types


9. 
Switch to the “Pending” tab. Select the accept action to enable all users access to the ONYX Testsuite as an external tool.

10. Once all steps have been successfully completed, the ONYX Testsuite will be displayed in the list of configured tools.

Aktive externe Tools

Please also note the instructions on the Moodle help pages for configuring external tools:
https://docs.moodle.org/30/de/Externes_Tool_konfigurieren

  • No labels