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

Use the various configuration options in the tab Options to adapt questions according to your needs.

Content

Attempts

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.

Shuffle

The answers for most question forms are by default arranged in random order. As a result, the question will appear different for each test participant and attempt. However, for some questions, it may be desirable that the answers will not be randomly arranged. In these cases, the setting Shuffle can be disabled in the Options tab.

For match interactions, it is further possible to disable the shuffle option per answer set.

Orientation and swapping elements

The answers for most question types are by default arranged in vertical order, i. e. one above the other. But you can also configure the orientation to be horizontal. However, in the case of a larger number of possible answers, a horizontal orientation is not recommended for visual reasons and because it might impair the usability of tests on mobile devices such as smartphones.

For match interactions, it is further possible to swap the location of the source and target elements, in addition to configuring the horizontal and vertical orientation. This allows the implementation of concrete technical content, for example mathematical or chemical equations. If the beginning of the equation is provided and the participant has to find the correct end of the equation or its solution, we recommend enabling the configuration Swap source and target elements.

By default, the source elements will be assigned by the participants. The assignment is done from left to right. Therefore, the participant has to match the source elements on the left with the correct target elements on the right.

By activating the option Swap source and target elements, it will be the other way round, i. e. the target elements have to be assigned by the participants. This also implies that the source elements will now be provided on the right and the target elements on the left.


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.

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 comments".


Use comments in a question

To use the comment function for a question, proceed as follows:

  1. Switch to the Options tab in the desired area.
  2. In the section Options, disable the option Apply the configuration of the superior element under Comment and either select the setting Allow on question level to enable comments for the desired area or Not allowed to disable comments explicitly for this area.


Extended settings

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

Upload CSS file

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.

Note

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.


Examples of using a layout file for ONYX test questions:

  • ONYX allows you to customise the question design with CSS. Using CSS, you can also place elements on the screen. This makes it possible to place gaps on a background graphic.

    Note

    Placing gaps on a graphic only works in the browser. The export views (PDF export, exam overview page, etc.) do not allow for a correct question display. A prerequisite for placing individual gaps on a graphic is basic knowledge of HTML and CSS.

    The graphic match interaction question type is also suitable for implementing many scenarios.

    Content

    The procedure for placing gaps on a background graphic is explained using the example of a question about Saxony. A map of the Free State of Saxony serves as a background graphic. Three gaps are placed on the map so that the names of the cities can be entered directly in the correct place on the map.

    Map of Saxony

    STEP 1: Create new question in text entry format

    The ONYX Editor supports various text entry formats (e. g. text entry, numerical input, calculation, formula comparison). Placing the gaps on a background graphic works the same for all formats. In the following, instructions on how to place gaps are provided for a simple text entry interaction. To create a new question, click on the "New question” button. Then select the "text entry interaction" question type and enter a title for your question.


    STEP 2: Edit question and add content

    All question content can be added via the HTML input field in the Text entry interaction section. Start by entering your question text, e. g. "Name the three independent cities of the state of Saxony".

    Now add the background graphic on which the gaps should be placed later.

    Then add any number of gaps directly below the graphic. Define the correct solution and the maximum score for each gap. You can also configure additional settings.

    Note

    The gaps need to be placed directly below the graphic.


    STEP 3: Place gaps on graphic I (HTML)

    Placing the gaps on the background graphic is achieved by CSS positioning. The only prerequisite is the definition of CSS classes in the HTML source code. You can view and edit the HTML source code of your question using the "Source code” option of the HTML editor.

    Note: To make it easier for you to edit the HTML code, you should insert line breaks so that each element (<p>, <span>, <img />, etc.) is on a separate line.

    Text entry interaction

    Source code


    You can identify your graphic by the following HTML code:

    Gap
    <img src="media?r=mMjc2MzQ1MzI ... />

    The gaps are marked in the HTML as follows:

    Gap
    <img id="RESPONSE_1" class="mce_onyx_gap" src="img/icons/gap-placeholder.png" alt="" />


    You need to set a container (<div>) with the class "gap-container" around the graphic and your gaps.

    Gap
    <div class="gap-container">
    [graphic]
    [gaps]
    </div>

    If you require CSS placement on the background graphic for several questions in the test, add [TITLEofQUESTION] to the class name. Insert an identifier for “TITLEofQUESTION” that is unique throughout the test.

    Gap
    <div class="gap-container [TITLEofQUESTION]">
    [graphic]
    [gaps]
    </div>

    Make sure that <div> encloses your graphic and all gaps. Do not forget the closing tag (</div>) following the last gap.

    Gap container

    Now add another container around each individual gap. For all containers (<span>), the class "gap” should be assigned. Another class should be assigned to identify each gap individually. We recommend to number your gaps in order, starting with class "gap1” for the first gap, "gap2" for the second gap and so on.

    Gap
    <span class="gap [gapID]"> </span>

    Important

    Please ensure not to alter the existing HTML code when editing the gaps. An incorrect adjustment in the HTML can render the whole question unusable.

    Examples
    <span class="gap gap1"> </span>
    <span class="gap gap2"> </span>

    Source code


    STEP 4: Place gaps on graphic II (CSS)

    To place your gaps on the background graphic, you now need to specify the exact position. This is done in a separate CSS file that can be uploaded to each question.

    You can use the following CSS statements as a template for individual questions in the test:

    Gap
    .gap-container {position: relative;}
    .gap {position: absolute;} 
    
    .[gapID] {top: [x]px; left: [y]px;} 

    If you place gaps for several questions in the test using CSS and have thus used the class name "gap-container [TITLEofQUESTION]" in the HTML of the question, then deploy this template:

    Note

    Ensure there is a space between the question and the gap name.

    Now insert your values for top and left in the statements related to the individual gaps (.gap1, .gap2, etc.) to determine their position. Add as many statements as there are gaps defined in your question.

    Save your file to a CSS file (.css) and add it to your question on the Options tab in the ONYX Editor.

    Use the preview in the ONYX Editor to verify whether the question is properly displayed.

    Gap
    .gap-container {position: relative;}
    .gap {position: absolute;} 
    
    .[TITLEofQUESTION] .[gapID] {top: [x]px; left: [y]px;}
    Example
    .gap-container {position: relative;}
    .gap {position: absolute;} 
    
    
    .Application1 .gap1 {top: 100px; left: 255px;} 
    .Application1 .gap2 {top: 50px; left: 75px;} 
    .Application1 .gap3 {top: 180px; left: 90px;}

  • ONYX allows you to customise an assignment item's design with CSS. By using CSS, users can individually alter assignment item attributes, such as size and spacing, in match interactions.


    Note

    The individual layout of the assignment items, in terms of size and spacing, works only within the browser. The configured layout is not available for export (PDF export, performance results page, etc.). The prerequisite for the use of this function is basic knowledge in HTML and CSS.

    Content

     

    The procedure for changing the size and the spacing of assignment items is explained by the example of an assignment task on the subject of Johann Wolfgang von Goethe. The assignment items contain text quotations from the works of the poet. The default display of the assignment task restricts the assignment items to 300 pixels (px) width and provides only a small distance to the edge in order to optimise the space requirement and to optimally integrate picture media. For long text passages, however, a wider display of the boxes and an increased distance to the edge may be desired.

    The increased width of the assignment items, for example, complicates the navigation during tests taken on devices with small screens, e.g. smartphones.

    1.  STEP: Create a new match interaction

    The configuration is possible for the assignment items of a simple match interaction. To create the task, proceed as usual. Detailed instructions can be found in the help section Match interaction.

    2.  STEP: Configure assignment items (CSS)

    The individual configuration for the size and distance of the content to the edge of the assignment items is done in a separate CSS file, which you can upload to any task.

    You can use the following CSS statements as a template:

    CSS setting
    .interaction-match .dragCont {min-width: 500px;}
    .interaction-match .dragCont div {padding: 10px;}

    The setting (min-width) defines the size of the assignment items. The default setting, if no CSS configuration is present, is 300 px.

    The setting (padding) defines the distance of the content to the edge of the assignment items. The default setting, if no CSS configuration is present, is 0 px.

    3.  STEP: Add the CSS file to the task

    Save your CSS statement in a CSS file *.css. The CSS file can be uploaded to the tab Options under Layout setting. Detailed instructions can be found in the help section Create task > Layout settings.

  • The right/wrong marking in ONYX is always carried out with the icons for correct and incorrect answers. For some questions, the user can derive the correct solution from this marking. If no right/wrong marking is to be carried out in the entire test, this can be configured in the question assessment settings by enabling the option "points achieved".

    If the marking in the test is to be prevented only for specific questions, this can be achieved using CSS markup.


    Hide right/wrong marking (no red or green tick and no red cross will be displayed)

    To do this, use the following CSS statement:

    .evaluation {display: none}

    Hide marking for correct answers (no red tick will be displayed)

    To do this, use the following CSS statement:

    .notansweredbutcorrect {display: none}

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