Xerte Community Documentation

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Adaptive Content: Source Interaction > Based on grouping ======

**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 grouping** Interaction Type (selected from a drop-down list - see table below) allows you to group different scorable pages (or from one other learning object), and this page collates all the learner's scores for that grouping.  This means, for example, that if you have two different learning goals (i.e. two groupings) in a learning object, you can relate different interactive tasks to each of those learning goals, and display scores and feedback for each learning goal.


==== New Source Interaction > Based on grouping: 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 grouping** from the drop-down | Drop-down |   |
| Grouping equals | Choose from {**Grouping 1** / Grouping 2 .....} | Text | The Interactivity pages that you want to include must have the same Tracking Grouping label (e.g. Grouping 1) added through the **Tracking **Optional Property.  |


==== Source Interaction > Based on end score: 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 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) | Drop-down | Default - "10"  |
| Show no. of participants || Shows the number of attempts for which scores are recorded | Tick box |   |
| Show no. of questions || Shows the number of questions in the grouping | 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 specification || Shows the question specification | 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. [[https://xerte.org.uk/]]).  | 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 grouping: 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.

^ Sub-property ^ **Description** ^ **Type** ^ **Additional information** ^
| Score text | Text introducing learner's score. | Text | Default - 'Your score is {0}' |
| Answer text | Text introducing learner's answer. | Text | Default - 'Your answer is {0}'  |
| Summary Title | Text for heading above summary of data | Text | Default - 'Summary'  |
| Average Score Label | Text introducing average score for learners completing this Interactivity page  | Text | Default - 'The average score is {0}' |
| Nr of Participants Label | Text introducing number of learners completing this Interactivity page | Text | Default - 'The number of participants is {0}'  |
| 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 | 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  | Text | Default - 'Correct'  |
| Incorrect answer label | Text introducing an incorrect answer  | Text | Default - 'Incorrect'  |
| 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' |
| %%X-Axis label of marks bargraph%% | If either **Bar graph for received marks**, or **Bar graph for combined received marks** or **Horizontal Bar graph for combined received marks **is selected from the Graph type drop-down, the label on the X-axis | Text | Default - 'Score Range [%]' |
| %%Y-Axis label of marks bargraph%% | If either **Bar graph for received marks**, or **Bar graph for combined received marks** or **Horizontal Bar graph for combined received marks **is selected from the Graph type drop-down, the label on the Y-axis | Text | Default - '% of Group' |
| %%X-Axis label of average mark linegraph%% | If **Line graph for average marks of others** is selected from the Graph type drop-down, the label on the X-axis | Text | Default - 'Score Range [%]' |
| Y-Axis label of average mark linegraph | If **Line graph for average marks of others** is selected from the Graph type drop-down, the label on the y-axis  | Text | Default - '% of Group' |
| %%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 **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 **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 **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' |
| %%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' |

**Interaction Blocks** only have an effect on scored pages, so do not add them for an **Open Answer** source interaction.


==== Based on grouping > 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.

{{ :xerte-adaptive-interactionblock.jpg?300 }}

^ **Property** ^ **Description** ^ **Type** ^ **Additional information** ^
| Content | The text or other content that is displayed if the learner's score falls between the parameters set below  | Text+ (Toolbar) | If you want to include adaptive pathways through a learning object, you can include here a link to the page you want learners in this score band to be taken to.\\ \\ |
| Score between | Set the lower and upper scores related to the content displayed (see above), separated by a comma.  | Text | Default - "0,30"  You must also create one or more Interaction Block for score(s) between 30 and 100.\\ |

==== Based on grouping > Interaction Block: Optional Properties ====

^ **Property** ^ **Description** ^ **Type** ^ **Additional information** ^
| Bar Colour | Chooses the colour for the bar associated with this interaction block.  | Colour Picker |   |
| Bar Name | Gives a name or the bar associated with this interaction block.  | Text |   |