How to use parametrisation in Questions

Parametrisation is only available for Assignments of the Digital Test type. Each Question Type can have parameters in the Question Field. Depending on the Question type it is also possible to have parameters in the answer field. For an overview, please see the table below. 

Konijn, A. (2023, January 20). Inserting Parameters in Question types. Ans Support. Retrieved May 3, 2023, from https://support.ans.app/hc/en-us/articles/360010591117-Parameterise-questions.

In the Code Editor you can use Python to create Variables. These Variables can thereafter be used in Questions in combination with the mathematical operations listed below. You can use brackets to specify the order of mathematical operations.

To create a Variable, that has a unique value for each Learner:

1. Go to or create an Assignment.
2. Click New exercise and fill in the name.
3. Click the ellipsis (...-icon) and choose Code Editor from the drop-down.

Konijn, A. (2022, December 12). Use the code editor in an Exercise; step 5. Ans Support. Retrieved May 10, 2023, from https://support.ans.app/hc/en-us/articles/360033627793-Use-the-code-editor-in-an-exercise.

4. Write your code in the black input field. See the example above (please note that the example shows the creation of three Variables; ‘a’, 'b' and ‘c’.)
5. Create a random value for each Learner using the function 'random(x,y,step=z)'.

6. Click Run to check for errors.
7. Click Save.

The Variables ‘a’, 'b’ and ‘c’ (with a unique value for each Learner) from the steps above can be used in a Numerical Question. The steps below show the basic example of linear formula a*b=c. Besides this example, it is possible to use Variables in other Question Types as well, while it is also possible to use a different (set of) Variable(s) in a Numerical Question.

To create a Numerical Question with a Variables:

1. Go to or create an Assignment.
2. Click New Exercise and fill in its name.
3. Click New Question and choose Numerical Question.
4. Click the icon with the three vertical dots and check Use Variable.

5. Click the ellipsis (...-icon) and choose Code Editor from the dropdown.
6. Write your code in the black input field. You could for example use the random function from the previous set of steps.
7. Click Run to test the code.
8. Click Save.
9. Formulate the Question in the Question Content field. You can insert Variables with the Variable button). If you used the random function and the formula ‘c = a * b’ from the previous steps, your Question Content should contain Variable (a) * variable (b).

10. Select the Variable you want to use as correct answer from the Variable dropdown menu. If you used the random function and the Variables ‘a’, 'b’ and ‘c’ from the previous steps, choose c.

11. You can optionally set a margin for the correct answer. You can choose % or Absolute.
12. Click Save.

In this example the incorrect answer options for a multiple Choice Question are parametrised. You create a list (or an array in programming terms) of incorrect answer options, and each Learner is shown a set amount of random answers from the list.

This example uses textual answer options, but you could also use numbers as correct and incorrect answer options.

To create a Multiple Choice Question with parametrisation:

1. Go to or create an Assignment.
2. Click New Exercise and fill in its name.
3. Click the ellipsis (...-icon) and choose Code Editor from the dropdown.
4. Write your code in the black input field. Use the 'Keyed_Response' variable for the correct answer(s). And fill in the incorrect answer options in 'All_Detractors'. See the example below:

5. Click Run to test the code.
6. Click Save.

To add answer options to the Question:

1. Go to or create an Assignment.
2. Click New Exercise and fill in its name.
3. Click New Question and choose Multiple Choice from the list.
4. Formulate the Question in the Question Content field and select One in the Correct Alternatives dropdown menu. 
5. Click + Add Alternative.
6. Click the pencil-icon in the Formulate the alternative field.
7. Click Variable and choose Keyed_Response from the dropdown. 
8. Click Save.
    

9. Add three more Alternatives with + Add Alternative and add Detractor1, Detractor2 and Detractor3 to the respective Formulate the alternative fields with the Variable button. 
10. Make sure the Keyed_Response Alternative receives the highest number of Maximum Points.
11. Click Save.