Differences

This shows you the differences between two versions of the page.

--- adaptivecontent_basedonspecificanswer [2023/01/24 18:17] – created jsmith
+++ adaptivecontent_basedonspecificanswer [2025/02/19 15:57] (current) – [Source Interaction > Based on end score: Optional Properties] jsmith
@@ Line 1: / Line 1: @@
-====== Adaptive Content: Source Interaction > Based on end score ======
+====== Adaptive Content: Source Interaction > Based on specific answer ======
 **Source Interactions** can be thought of as links to Interactivity pages with instructions to record performance on them in specific ways. It is possible to add several Source Interactions to an **Adaptive Content** page to create the effect of a dashboard.
-The **Based on end score** Interaction Type (selected from a drop-down list - see table below) displays a score from a specific Interactivity page, or from a specific question on that page.:?: //Check for accuracy.//
+The **Based on specific answer** Interaction Type (selected from a drop-down list - see table below) displays  an individual learner's answer to __one__ option from __one__ **Multiple Choice Question**, or __one__ question from a **Quiz** or **Media Lesson**, or __one__ Multiple Choice Question on an **Interactive Video** page, compared to answers by other learners who completed the task. If you add a graph it displays answer options and the number of learners who chose each specific answer.
-==== New Source Interaction > Based on end score: Core Properties ====
+==== New Source Interaction > Based on specific answer: Core Properties ====
 ^ **Property** ^ **Description** ^ **Type** ^ **Additional information** ^
 | Title | Title for this Source Interaction | Text |   |
 | Introduction | Text that is displayed before performance data | Text+ |   |
-| Interaction type | Select **Based on end score** from the drop-down | Drop-down |   |
+| Interaction type | Select **Based on specific answer** from the drop-down | Drop-down |   |
-| URL of Xerte source installation | The URL of the Xerte installation from which the data is retrieved - you need to end this with a forward-slash (e.g. [[https://xerte.org.uk/]]). | URL |   |
+| Tracking Label of source | This makes a link between the Interactivity page, whose data you want to display, and this Adaptive Content page.  You need to a) add a Tracking Label **on the Interactivity page**, as an Optional Property and b) enter the same Tracking Label **in the Source Interaction properties**. You must use **unique labels**, with underscores, numbers and letters, but no other types of character. | Text | It is a good idea to use short, but meaningful, Tracking Labels, because these are also displayed to learners on the Results Page.The Tracking Label needs to be in one of the following formats. For a link to __one__ MCQ it has to be **MCQLabel/MCQLabel**.  (e.g. Question1/Question1). For one MCQ in a Quiz, it has to be **QuizTrackingLabel/MCQLabel**, (e.g. Quiz/Question1).  |
-| ID of Xerte learning object | The ID of the Xerte project from which the data is retrieved - this can be the same learning object or another one within the same installation | Number | The ID is automatically generated when the project is created, and can be read from the Project Details. |
-| Tracking Label of source | This makes a link between the Interactivity page, whose data you want to display, and this Adaptive Content page.  You need to a) add a Tracking Label **on the Interactivity page**, as an Optional Property and b) enter the same Tracking Label **in the Source Interaction properties**. You must use **unique labels**, with underscores, numbers and letters, but no other types of character. | Text |   |
-==== Source Interaction > Based on end score: Optional Properties ====
+==== Source Interaction > Based on specific answer: Optional Properties ====
 ^ **Property** ^ Sub-property ^ **Description** ^ **Type** ^ **Additional information** ^
+| Display content from other blocks || Allows learners to see content from other blocks. | Tick box | This can be used, for example, to allow learners to see feedback aimed at all levels of performance. |
 | Filtering | Filter on group from URL | Filter on groupname, where the groupname is extracted from the URL (group=groupname). | Tick box | \\ \\ |
 | ::: | Filter group name | Use this groupname if the groupname is not specified on the URL (group=groupname). You will need to filter on group from URL as well. | Text |   |
 | ::: | Filter on LTI context | Filter on LTI, where the LTI context is retrieved form the the LTI launch or the URL (lti_context_id=id). | Tick box |   |
-| Graph | Show graph | Add this Optional Property if you want the data to be displayed as a bar graph, pie chart, line graph or polar chart.  | Tick box |  |
+| Graph | Show graph | Add this Optional Property if you want the data to be displayed as a bar graph, pie chart, line graph or polar chart. | Tick box |   |
-| ::: | Graph type | Depending on the data you want display or summarise, choose the most appropriate type of graph you want to have displayed. {**Bar graph for given answers/**Bar graph for received marks/ Bar graph for combined received marks/Horizontal bar graph for combined received marks/Pie chart for received marks/Line graph for own received marks/ Line graph for average marks of others/Polar chart for subject overview} **//NOTE check which graph types are available for specific Interactivity types.//** | Drop-down |   |
+| ::: | Graph type | Depending on the data you want display or summarise, choose the most appropriate type of graph you want to have displayed. {**Bar graph for given answers/**Bar graph for received marks/ Bar graph for combined received marks/Horizontal bar graph for combined received marks/Pie chart for received marks/Line graph for own received marks/ Line graph for average marks of others/Polar chart for subject overview} | Drop-down |   |
 | ::: | Show graph explanation | Choose whether or not to display the graph legend/explanation | Tick box |   |
 | ::: | Graph legend/explanation | Design your graph legend or explanation here. | Text+ (Toolbar) | This displays as a panel just to the right of the graph |
 | ::: | Legend panel width | The width of the legend/explanation panel, as a percentage of the Xerte page width | Text |   |
-| ::: | Nr of bars/points | The number of bars (for bar graphs), points (for a line graph) //NOTE The default may be 10?// | Drop-down |   |
+| ::: | Nr of bars/points | The number of bars (for bar graphs), points (for a line graph) | Drop-down | Default - "10" |
-| Opinion Class || This allows data to be retrieved for a specific Class (i.e. category of answer) on an Opinion page.  | Text  |   |
+| Show no. of participants || Shows the number of attempts for which scores are recorded | Tick box |   |
-| Show score/answer || Shows the score or answer of the learner, in relation to the parameters of the Interaction Block  | Tick box | This is not displayed, when you have selected Dashboard Mode (see **Top Level: Optional Properties**)  |
+| Show score/answer || Shows the score or answer of the learner, in relation to the parameters of the Interaction Block | Tick box | This is not displayed, when you have selected Dashboard Mode (see **Top Level: Optional Properties**) |
-| Show nr of participants || Shows the number of learners for whom scores are recorded  | Tick box |   |
+| Source Project | URL of Xerte Source Installation | The URL of the Xerte installation from which the data is retrieved - you need to end this with a forward-slash (e.g. ). | URL | :!: In 3.12 and earlier releases, this was a core property. You only need to add this Optional Property if the data is coming from a page in a __different__ project. The ID is automatically generated when the project is created, and can be read from the Project Details (see Project Properties page) |
+| ::: | ID of Xerte learning object | The ID of the Xerte project from which the data is retrieved - this can be the same learning object or another one within the same installation	. | Number | ::: |
+| Which answers to use within session || {First/Last/Best/**All**} Determines which of a learner's attempts are included in the processing of performance data. | Drop-down |   |
-==== Source Interaction > Based on end score: Language Options ====
+==== Source Interaction > Based on specific answer: Language Options ====
 Some of these relate to the text used to introduce scores, number of questions on an Interactivity page, and numbers of learners completing the page. Others relate to labels on graphs and their axes.
@@ Line 44: / Line 47: @@
 | Nr of Questions Label | Text introducing number of questions on this Interactivity page | Text | Default - 'Total number of questions {0}' |
 | Nr of Correct Questions Label | Text introducing number of correct answers for this learner | Text | Default - 'Total correct {0}'  |
-| Questions Specification Title | :?: | Text | Default - 'Specification'  |
+| Questions Specification Title | This only applies to the **Based on Groupings **Source Interaction | Text | Default - 'Specification'  |
 | Advice Title | Text on heading above any advice displayed (through the Interaction Blocks:?:)  | Text  | Default - 'Advice'  |
-| Correct answer label | :?: Text introducing a correct answer (Is this for the learner or for the task)?  | Text | Default - 'Correct'  |
+| Correct answer label | Text introducing a correct answer  | Text | Default - 'Correct'  |
-| Incorrect answer label | :?: Text introducing an incorrect answer (Is this for the learner or for the task)?  | Text | Default - 'Incorrect'  |
+| Incorrect answer label | Text introducing an incorrect answer  | Text | Default - 'Incorrect'  |
-| Passing percentage | The percentage set as the pass mark | Text | Default - '75' |
+| Passing percentage | The percentage set as the pass mark, only for **Bar graph for combined received marks** or **Horizontal Bar graph for combined received marks**. | Text | Default - '75' |
 | %%X-Axis label of answer bargraph%% | If **Bar graph for given answers** is selected from the Graph type drop-down, the label on the X-axis  | Text | Default - 'Answers given' |
 | %%Y-Axis label of answer bargraph%% | If **Bar graph for given answers** is selected from the Graph type drop-down, the label on the Y-axis  | Text | Default - 'Number of answers' |
@@ Line 57: / Line 60: @@
 | %%X-Axis label of own mark linegraph%% | If **Line graph for own received marks** is selected from the Graph type drop-down, the label on the X-axis  | Text | Default - 'Date' |
 | Y-Axis label of own mark linegraph | If **Line graph for own received marks** is selected from the Graph type drop-down, the label on the Y-axis  | Text | Default - 'Grade [0-10]' |
-| Average Graph Label | If **Line graph for average marks** **of others** is selected from the Graph type drop-down, the label on the graph  | Text | Default - 'Avg. of all attempts' |
+| Average Graph Label | If **Based on 2D Opinion **is selected, this is the label on the graph for the average of __all attempts by all learners__  | Text | Default - 'Avg. of all attempts' |
-| %%Personal Graph Label%% | If **Line graph for own received marks** is selected from the Graph type drop-down, the label showing the learner's last attempt :?:  | Text | Default - 'Your last attempt' |
+| %%Personal Graph Label%% | If **Based on 2D Opinion **is selected, this is the label on the graph for __the individual learner's last attempt__  | Text | Default - 'Your last attempt' |
-| Personal Average Graph Label | If **Line graph for own received marks** is selected from the Graph type drop-down, the label showing the average of all attempts by the learner :?:  | Text | Default - 'Avg. of your attempts' |
+| Personal Average Graph Label | If **Based on 2D Opinion **is selected, this is the label on the graph for the average for __all of the individual learner's attempts__  | Text | Default - 'Avg. of your attempts' |
-| %%Group Average Graph Label%% | If **Based on groupings **is selected as Interaction Type, the text introducing the the group average on this Interactivity page :?:  | Text | Default - 'Group Average' |
+| %%Group Average Graph Label%% | If **Based on groupings **is selected as Interaction Type, the text introducing the the group average on this Interactivity page  | Text | Default - 'Group Average' |
 | %%My Open Answers text%% | If **Open Answer **is selected as Interaction Type, the text introducing the learner's response(s)  | Text | Default - 'My answers' |
 | %%All Open Answers text%% | If **Open Answer **is selected as Interaction Type, the text introducing the responses for all learners completing this Interactivity page.  | Text | Default - 'All open answers' |
-==== Based on end score > Interaction Block: Core Properties ====
+==== Based on specific answer > Interaction Block: Core Properties ====
 You only need to add Interaction Blocks if you want to include differentiated feedback or adaptive pathways, depending on the learner's score on the Interactivity page.  Click on **New Interaction Block** at the foot of the central pane.
@@ Line 76: / Line 79: @@
-===== Further information =====
-:?:\\
-\\